/bash/virt-cat
/bash/virt-customize
/bash/virt-df
-/bash/virt-dib
/bash/virt-diff
/bash/virt-drivers
/bash/virt-edit
/customize/test-settings-*.sh
/customize/virt-customize
/df/virt-df
-/dib/.depend
-/dib/output_format_*.mli
-/dib/virt-dib
/drivers/.depend
+/drivers/hwdata_config.ml
/drivers/virt-drivers
/diff/virt-diff
/edit/virt-edit
SUBDIRS += resize
SUBDIRS += sparsify
SUBDIRS += sysprep
-SUBDIRS += dib
endif
# bash-completion
po/POTFILES-ml: configure.ac
rm -f $@ $@-t
cd $(srcdir); \
- find builder common/ml* customize dib drivers get-kernel resize sparsify sysprep -name '*.ml' | \
+ find builder common/ml* customize drivers get-kernel resize sparsify sysprep -name '*.ml' | \
grep -v '^builder/templates/' | \
grep -v '^common/mlv2v/' | \
grep -v -E '.*_tests\.ml$$' | \
# OCaml tools. Note 'common/ml*' and 'customize' contain shared code
# used by other OCaml tools, so these must come first.
@HAVE_OCAML_TRUE@am__append_3 = customize builder builder/templates \
-@HAVE_OCAML_TRUE@ drivers get-kernel resize sparsify sysprep \
-@HAVE_OCAML_TRUE@ dib
+@HAVE_OCAML_TRUE@ drivers get-kernel resize sparsify sysprep
# Perl tools.
@HAVE_TOOLS_TRUE@am__append_4 = win-reg
common/mlvisit common/mlxml common/mltools common/mldrivers \
common/mlcustomize test-data align cat diff df edit format \
inspector make-fs customize builder builder/templates drivers \
- get-kernel resize sparsify sysprep dib bash win-reg docs po \
+ get-kernel resize sparsify sysprep bash win-reg docs po \
po-docs
am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/config.h.in \
$(srcdir)/config.sh.in $(srcdir)/ocaml-dep.sh.in \
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
po/POTFILES-ml: configure.ac
rm -f $@ $@-t
cd $(srcdir); \
- find builder common/ml* customize dib drivers get-kernel resize sparsify sysprep -name '*.ml' | \
+ find builder common/ml* customize drivers get-kernel resize sparsify sysprep -name '*.ml' | \
grep -v '^builder/templates/' | \
grep -v '^common/mlv2v/' | \
grep -v -E '.*_tests\.ml$$' | \
For discussion, development, patches, etc. please use the mailing list:
- http://www.redhat.com/mailman/listinfo/libguestfs
+ https://lists.libguestfs.org
Copyright (C) 2009-2023 Red Hat Inc.
If you have problems, you may need to regenerate the build system entirely.
To do so, use the procedure documented by the package, typically 'autoreconf'.])])
-# gettext.m4 serial 72 (gettext-0.21.1)
-dnl Copyright (C) 1995-2014, 2016, 2018-2020 Free Software Foundation, Inc.
+# build-to-host.m4 serial 1
+dnl Copyright (C) 2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+dnl Written by Bruno Haible.
+
+dnl When the build environment ($build_os) is different from the target runtime
+dnl environment ($host_os), file names may need to be converted from the build
+dnl environment syntax to the target runtime environment syntax. This is
+dnl because the Makefiles are executed (mostly) by build environment tools and
+dnl therefore expect file names in build environment syntax, whereas the runtime
+dnl expects file names in target runtime environment syntax.
+dnl
+dnl For example, if $build_os = cygwin and $host_os = mingw32, filenames need
+dnl be converted from Cygwin syntax to native Windows syntax:
+dnl /cygdrive/c/foo/bar -> C:\foo\bar
+dnl /usr/local/share -> C:\cygwin64\usr\local\share
+dnl
+dnl gl_BUILD_TO_HOST([somedir])
+dnl This macro takes as input an AC_SUBSTed variable 'somedir', which must
+dnl already have its final value assigned, and produces two additional
+dnl AC_SUBSTed variables 'somedir_c' and 'somedir_c_make', that designate the
+dnl same file name value, just in different syntax:
+dnl - somedir_c is the file name in target runtime environment syntax,
+dnl as a C string (starting and ending with a double-quote,
+dnl and with escaped backslashes and double-quotes in
+dnl between).
+dnl - somedir_c_make is the same thing, escaped for use in a Makefile.
+
+AC_DEFUN([gl_BUILD_TO_HOST],
+[
+ AC_REQUIRE([AC_CANONICAL_BUILD])
+ AC_REQUIRE([AC_CANONICAL_HOST])
+ AC_REQUIRE([gl_BUILD_TO_HOST_INIT])
+
+ dnl Define somedir_c.
+ gl_final_[$1]="$[$1]"
+ dnl Translate it from build syntax to host syntax.
+ case "$build_os" in
+ cygwin*)
+ case "$host_os" in
+ mingw*)
+ gl_final_[$1]=`cygpath -w "$gl_final_[$1]"` ;;
+ esac
+ ;;
+ esac
+ dnl Convert it to C string syntax.
+ [$1]_c=`echo "$gl_final_[$1]" | sed -e "$gl_sed_double_backslashes" -e "$gl_sed_escape_doublequotes"`
+ [$1]_c='"'"$[$1]_c"'"'
+ AC_SUBST([$1_c])
+
+ dnl Define somedir_c_make.
+ [$1]_c_make=`echo "$[$1]_c" | sed -e "$gl_sed_escape_for_make_1" -e "$gl_sed_escape_for_make_2"`
+ dnl Use the substituted somedir variable, when possible, so that the user
+ dnl may adjust somedir a posteriori when there are no special characters.
+ if test "$[$1]_c_make" = '\"'"${gl_final_[$1]}"'\"'; then
+ [$1]_c_make='\"$([$1])\"'
+ fi
+ AC_SUBST([$1_c_make])
+])
+
+dnl Some initializations for gl_BUILD_TO_HOST.
+AC_DEFUN([gl_BUILD_TO_HOST_INIT],
+[
+ gl_sed_double_backslashes='s/\\/\\\\/g'
+ gl_sed_escape_doublequotes='s/"/\\"/g'
+changequote(,)dnl
+ gl_sed_escape_for_make_1="s,\\([ \"&'();<>\\\\\`|]\\),\\\\\\1,g"
+changequote([,])dnl
+ gl_sed_escape_for_make_2='s,\$,\\$$,g'
+])
+
+# gettext.m4 serial 77 (gettext-0.22)
+dnl Copyright (C) 1995-2014, 2016, 2018-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
dnl Macro to add for using GNU gettext.
dnl Usage: AM_GNU_GETTEXT([INTLSYMBOL], [NEEDSYMBOL], [INTLDIR]).
-dnl INTLSYMBOL must be one of 'external', 'use-libtool'.
-dnl INTLSYMBOL should be 'external' for packages other than GNU gettext, and
-dnl 'use-libtool' for the packages 'gettext-runtime' and 'gettext-tools'.
-dnl If INTLSYMBOL is 'use-libtool', then a libtool library
-dnl $(top_builddir)/intl/libintl.la will be created (shared and/or static,
+dnl INTLSYMBOL must be one of 'external', 'use-libtool', 'here'.
+dnl INTLSYMBOL should be 'external' for packages other than GNU gettext.
+dnl It should be 'use-libtool' for the packages 'gettext-runtime' and
+dnl 'gettext-tools'.
+dnl It should be 'here' for the package 'gettext-runtime/intl'.
+dnl If INTLSYMBOL is 'here', then a libtool library
+dnl $(top_builddir)/libintl.la will be created (shared and/or static,
dnl depending on --{enable,disable}-{shared,static} and on the presence of
dnl AM-DISABLE-SHARED).
dnl If NEEDSYMBOL is specified and is 'need-ngettext', then GNU gettext
AC_DEFUN([AM_GNU_GETTEXT],
[
dnl Argument checking.
- m4_if([$1], [], , [m4_if([$1], [external], , [m4_if([$1], [use-libtool], ,
+ m4_if([$1], [], , [m4_if([$1], [external], , [m4_if([$1], [use-libtool], , [m4_if([$1], [here], ,
[errprint([ERROR: invalid first argument to AM_GNU_GETTEXT
-])])])])
+])])])])])
m4_if(m4_if([$1], [], [old])[]m4_if([$1], [no-libtool], [old]), [old],
[errprint([ERROR: Use of AM_GNU_GETTEXT without [external] argument is no longer supported.
])])
m4_if([$2], [], , [m4_if([$2], [need-ngettext], , [m4_if([$2], [need-formatstring-macros], ,
[errprint([ERROR: invalid second argument to AM_GNU_GETTEXT
])])])])
- define([gt_included_intl],
- m4_if([$1], [external], [no], [yes]))
+ define([gt_building_libintl_in_same_build_tree],
+ m4_if([$1], [use-libtool], [yes], [m4_if([$1], [here], [yes], [no])]))
gt_NEEDS_INIT
AM_GNU_GETTEXT_NEED([$2])
AC_REQUIRE([AM_PO_SUBDIRS])dnl
- m4_if(gt_included_intl, yes, [
- AC_REQUIRE([AM_INTL_SUBDIR])dnl
- ])
dnl Prerequisites of AC_LIB_LINKFLAGS_BODY.
AC_REQUIRE([AC_LIB_PREPARE_PREFIX])
dnl Ideally we would do this search only after the
dnl if test "$USE_NLS" = "yes"; then
dnl if { eval "gt_val=\$$gt_func_gnugettext_libc"; test "$gt_val" != "yes"; }; then
- dnl tests. But if configure.in invokes AM_ICONV after AM_GNU_GETTEXT
+ dnl tests. But if configure.ac invokes AM_ICONV after AM_GNU_GETTEXT
dnl the configure script would need to contain the same shell code
dnl again, outside any 'if'. There are two solutions:
dnl - Invoke AM_ICONV_LINKFLAGS_BODY here, outside any 'if'.
dnl - Control the expansions in more detail using AC_PROVIDE_IFELSE.
dnl Since AC_PROVIDE_IFELSE is not documented, we avoid it.
- m4_if(gt_included_intl, yes, , [
+ m4_if(gt_building_libintl_in_same_build_tree, yes, , [
AC_REQUIRE([AM_ICONV_LINKFLAGS_BODY])
])
dnl Set USE_NLS.
AC_REQUIRE([AM_NLS])
- m4_if(gt_included_intl, yes, [
- BUILD_INCLUDED_LIBINTL=no
+ m4_if(gt_building_libintl_in_same_build_tree, yes, [
USE_INCLUDED_LIBINTL=no
])
LIBINTL=
dnl If we use NLS figure out what method
if test "$USE_NLS" = "yes"; then
gt_use_preinstalled_gnugettext=no
- m4_if(gt_included_intl, yes, [
+ m4_if(gt_building_libintl_in_same_build_tree, yes, [
AC_MSG_CHECKING([whether included gettext is requested])
AC_ARG_WITH([included-gettext],
[ --with-included-gettext use the GNU gettext library included here],
if { eval "gt_val=\$$gt_func_gnugettext_libc"; test "$gt_val" != "yes"; }; then
dnl Sometimes libintl requires libiconv, so first search for libiconv.
- m4_if(gt_included_intl, yes, , [
+ m4_if(gt_building_libintl_in_same_build_tree, yes, , [
AM_ICONV_LINK
])
dnl Search for libintl and define LIBINTL, LTLIBINTL and INCINTL
if { eval "gt_val=\$$gt_func_gnugettext_libc"; test "$gt_val" = "yes"; } \
|| { { eval "gt_val=\$$gt_func_gnugettext_libintl"; test "$gt_val" = "yes"; } \
&& test "$PACKAGE" != gettext-runtime \
- && test "$PACKAGE" != gettext-tools; }; then
+ && test "$PACKAGE" != gettext-tools \
+ && test "$PACKAGE" != libintl; }; then
gt_use_preinstalled_gnugettext=yes
else
dnl Reset the values set by searching for libintl.
INCINTL=
fi
- m4_if(gt_included_intl, yes, [
+ m4_if(gt_building_libintl_in_same_build_tree, yes, [
if test "$gt_use_preinstalled_gnugettext" != "yes"; then
dnl GNU gettext is not found in the C library.
dnl Fall back on included GNU gettext library.
if test "$nls_cv_use_gnu_gettext" = "yes"; then
dnl Mark actions used to generate GNU NLS library.
- BUILD_INCLUDED_LIBINTL=yes
USE_INCLUDED_LIBINTL=yes
LIBINTL="m4_if([$3],[],\${top_builddir}/intl,[$3])/libintl.la $LIBICONV $LIBTHREAD"
LTLIBINTL="m4_if([$3],[],\${top_builddir}/intl,[$3])/libintl.la $LTLIBICONV $LTLIBTHREAD"
POSUB=po
fi
- m4_if(gt_included_intl, yes, [
- dnl In GNU gettext we have to set BUILD_INCLUDED_LIBINTL to 'yes'
- dnl because some of the testsuite requires it.
- BUILD_INCLUDED_LIBINTL=yes
-
+ m4_if(gt_building_libintl_in_same_build_tree, yes, [
dnl Make all variables we use known to autoconf.
- AC_SUBST([BUILD_INCLUDED_LIBINTL])
AC_SUBST([USE_INCLUDED_LIBINTL])
AC_SUBST([CATOBJEXT])
])
- dnl For backward compatibility. Some Makefiles may be using this.
- INTLLIBS="$LIBINTL"
- AC_SUBST([INTLLIBS])
+ m4_if(gt_building_libintl_in_same_build_tree, yes, [], [
+ dnl For backward compatibility. Some Makefiles may be using this.
+ INTLLIBS="$LIBINTL"
+ AC_SUBST([INTLLIBS])
+ ])
dnl Make all documented variables known to autoconf.
AC_SUBST([LIBINTL])
AC_SUBST([LTLIBINTL])
AC_SUBST([POSUB])
+
+ dnl Define localedir_c and localedir_c_make.
+ dnl Find the final value of localedir.
+ gt_save_prefix="${prefix}"
+ gt_save_datarootdir="${datarootdir}"
+ gt_save_localedir="${localedir}"
+ dnl Unfortunately, prefix gets only finally determined at the end of
+ dnl configure.
+ if test "X$prefix" = "XNONE"; then
+ prefix="$ac_default_prefix"
+ fi
+ eval datarootdir="$datarootdir"
+ eval localedir="$localedir"
+ gl_BUILD_TO_HOST([localedir])
+ localedir="${gt_save_localedir}"
+ datarootdir="${gt_save_datarootdir}"
+ prefix="${gt_save_prefix}"
])
AC_DEFUN([AM_GNU_GETTEXT_REQUIRE_VERSION], [])
# host-cpu-c-abi.m4 serial 15
-dnl Copyright (C) 2002-2022 Free Software Foundation, Inc.
+dnl Copyright (C) 2002-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
HOST_CPU_C_ABI_32BIT="$gl_cv_host_cpu_c_abi_32bit"
])
-# iconv.m4 serial 24
-dnl Copyright (C) 2000-2002, 2007-2014, 2016-2022 Free Software Foundation,
+# iconv.m4 serial 26
+dnl Copyright (C) 2000-2002, 2007-2014, 2016-2023 Free Software Foundation,
dnl Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl Define AM_ICONV using AC_DEFUN_ONCE, in order to avoid warnings like
dnl "warning: AC_REQUIRE: `AM_ICONV' was expanded before it was required".
-dnl This is tricky because of the way 'aclocal' is implemented:
-dnl - It requires defining an auxiliary macro whose name ends in AC_DEFUN.
-dnl Otherwise aclocal's initial scan pass would miss the macro definition.
-dnl - It requires a line break inside the AC_DEFUN_ONCE and AC_DEFUN expansions.
-dnl Otherwise aclocal would emit many "Use of uninitialized value $1"
-dnl warnings.
AC_DEFUN_ONCE([AM_ICONV],
[
AM_ICONV_LINK
ICONV_CONST="const"
fi
])
+
+ dnl A summary result, for those packages which want to print a summary at the
+ dnl end of the configuration.
+ if test "$am_func_iconv" = yes; then
+ if test -n "$LIBICONV"; then
+ am_cv_func_iconv_summary='yes, in libiconv'
+ else
+ am_cv_func_iconv_summary='yes, in libc'
+ fi
+ else
+ if test "$am_cv_func_iconv" = yes; then
+ am_cv_func_iconv_summary='not working, consider installing GNU libiconv'
+ else
+ am_cv_func_iconv_summary='no, consider installing GNU libiconv'
+ fi
+ fi
])
# intlmacosx.m4 serial 8 (gettext-0.20.2)
-dnl Copyright (C) 2004-2014, 2016, 2019-2022 Free Software Foundation, Inc.
+dnl Copyright (C) 2004-2014, 2016, 2019-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
AC_SUBST([INTL_MACOSX_LIBS])
])
-# lib-ld.m4 serial 10
-dnl Copyright (C) 1996-2003, 2009-2022 Free Software Foundation, Inc.
+# lib-ld.m4 serial 11
+dnl Copyright (C) 1996-2003, 2009-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
AC_REQUIRE([AC_CANONICAL_HOST])dnl
AC_ARG_WITH([gnu-ld],
- [AS_HELP_STRING([--with-gnu-ld],
+ [AS_HELP_STRING([[--with-gnu-ld]],
[assume the C compiler uses GNU ld [default=no]])],
[test "$withval" = no || with_gnu_ld=yes],
[with_gnu_ld=no])dnl
])
# lib-link.m4 serial 33
-dnl Copyright (C) 2001-2022 Free Software Foundation, Inc.
+dnl Copyright (C) 2001-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
additional_libdir3=
fi
dnl Search the library and its dependencies in $additional_libdir and
- dnl $LDFLAGS. Using breadth-first-seach.
+ dnl $LDFLAGS. Use breadth-first search.
LIB[]NAME=
LTLIB[]NAME=
INC[]NAME=
])
# lib-prefix.m4 serial 20
-dnl Copyright (C) 2001-2005, 2008-2022 Free Software Foundation, Inc.
+dnl Copyright (C) 2001-2005, 2008-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
])
# nls.m4 serial 6 (gettext-0.20.2)
-dnl Copyright (C) 1995-2003, 2005-2006, 2008-2014, 2016, 2019-2022 Free
+dnl Copyright (C) 1995-2003, 2005-2006, 2008-2014, 2016, 2019-2023 Free
dnl Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
AC_SUBST([USE_NLS])
])
-# pkg.m4 - Macros to locate and utilise pkg-config. -*- Autoconf -*-
-# serial 11 (pkg-config-0.29.1)
+# pkg.m4 - Macros to locate and use pkg-config. -*- Autoconf -*-
+# serial 12 (pkg-config-0.29.2)
dnl Copyright © 2004 Scott James Remnant <scott@netsplit.com>.
dnl Copyright © 2012-2015 Dan Nicholson <dbn.lists@gmail.com>
dnl See the "Since" comment for each macro you use to see what version
dnl of the macros you require.
m4_defun([PKG_PREREQ],
-[m4_define([PKG_MACROS_VERSION], [0.29.1])
+[m4_define([PKG_MACROS_VERSION], [0.29.2])
m4_if(m4_version_compare(PKG_MACROS_VERSION, [$1]), -1,
[m4_fatal([pkg.m4 version $1 or higher is required but ]PKG_MACROS_VERSION[ found])])
])dnl PKG_PREREQ
dnl PKG_CHECK_MODULES(), but does not set variables or print errors.
dnl
dnl Please remember that m4 expands AC_REQUIRE([PKG_PROG_PKG_CONFIG])
-dnl only at the first occurence in configure.ac, so if the first place
+dnl only at the first occurrence in configure.ac, so if the first place
dnl it's called might be skipped (such as if it is within an "if", you
dnl have to call PKG_CHECK_EXISTS manually
AC_DEFUN([PKG_CHECK_EXISTS],
AC_ARG_VAR([$1][_LIBS], [linker flags for $1, overriding pkg-config])dnl
pkg_failed=no
-AC_MSG_CHECKING([for $1])
+AC_MSG_CHECKING([for $2])
_PKG_CONFIG([$1][_CFLAGS], [cflags], [$2])
_PKG_CONFIG([$1][_LIBS], [libs], [$2])
See the pkg-config man page for more details.])
if test $pkg_failed = yes; then
- AC_MSG_RESULT([no])
+ AC_MSG_RESULT([no])
_PKG_SHORT_ERRORS_SUPPORTED
if test $_pkg_short_errors_supported = yes; then
- $1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "$2" 2>&1`
- else
- $1[]_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "$2" 2>&1`
+ $1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "$2" 2>&1`
+ else
+ $1[]_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "$2" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD
+ # Put the nasty error message in config.log where it belongs
+ echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD
- m4_default([$4], [AC_MSG_ERROR(
+ m4_default([$4], [AC_MSG_ERROR(
[Package requirements ($2) were not met:
$$1_PKG_ERRORS
_PKG_TEXT])[]dnl
])
elif test $pkg_failed = untried; then
- AC_MSG_RESULT([no])
- m4_default([$4], [AC_MSG_FAILURE(
+ AC_MSG_RESULT([no])
+ m4_default([$4], [AC_MSG_FAILURE(
[The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
path to pkg-config.
To get pkg-config, see <http://pkg-config.freedesktop.org/>.])[]dnl
])
else
- $1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS
- $1[]_LIBS=$pkg_cv_[]$1[]_LIBS
+ $1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS
+ $1[]_LIBS=$pkg_cv_[]$1[]_LIBS
AC_MSG_RESULT([yes])
- $3
+ $3
fi[]dnl
])dnl PKG_CHECK_MODULES
])
# progtest.m4 serial 9 (gettext-0.21.1)
-dnl Copyright (C) 1996-2003, 2005, 2008-2022 Free Software Foundation, Inc.
+dnl Copyright (C) 1996-2003, 2005, 2008-2023 Free Software Foundation, Inc.
dnl This file is free software; the Free Software Foundation
dnl gives unlimited permission to copy and/or distribute it,
dnl with or without modifications, as long as this notice is preserved.
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
virt-customize \
virt-diff \
virt-df \
- virt-dib \
virt-drivers \
virt-edit \
virt-filesystems \
# common options like -d is handled by this common script. However
# this script cannot deal with commands that use --ro/--rw
# (eg. virt-rescue). Those tools have to be handled individually.
-virt-builder virt-cat virt-customize virt-df virt-dib virt-diff virt-drivers \
+virt-builder virt-cat virt-customize virt-df virt-diff virt-drivers \
virt-edit virt-filesystems virt-format virt-get-kernel virt-inspector \
virt-log virt-ls \
virt-resize virt-sparsify virt-sysprep \
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
virt-customize \
virt-diff \
virt-df \
- virt-dib \
virt-drivers \
virt-edit \
virt-filesystems \
# common options like -d is handled by this common script. However
# this script cannot deal with commands that use --ro/--rw
# (eg. virt-rescue). Those tools have to be handled individually.
-virt-builder virt-cat virt-customize virt-df virt-dib virt-diff virt-drivers \
+virt-builder virt-cat virt-customize virt-df virt-diff virt-drivers \
virt-edit virt-filesystems virt-format virt-get-kernel virt-inspector \
virt-log virt-ls \
virt-resize virt-sparsify virt-sysprep \
} &&
complete -o default -F _virt_customize virt-customize
-_virt_dib ()
-{
- _guestfs_virttools "virt-dib" 0
-} &&
-complete -o default -F _virt_dib virt-dib
-
_virt_df ()
{
_guestfs_virttools "virt-df" 1
# Comma-separated list of Bugzilla IDs.
bugids=$(
git log "$1" |
- egrep -io 'RHBZ#[0-9]+|https?://bugzilla.redhat.com/[a-z\.\?/_=]*[0-9]+' |
+ grep -Eio 'RHBZ#[0-9]+|https?://bugzilla.redhat.com/[a-z\.\?/_=]*[0-9]+' |
sed 's/^[^0-9]*//' |
sort -u |
tr '\n' ',' |
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
delete_output_file := false;
(* Print the stats calculated above. *)
- Pervasives.flush Pervasives.stdout;
- Pervasives.flush Pervasives.stderr;
+ Stdlib.flush Stdlib.stdout;
+ Stdlib.flush Stdlib.stderr;
Option.iter print_string stats
| _ ->
let common_args = [
"location", None; (* Follow 3xx redirects. *)
- "url", Some uri; (* URI to download. *)
] in
let quiet_args = [ "silent", None; "show-error", None ] in
"write-out", Some "%{http_code}" (* HTTP status code to stdout. *)
];
- Curl.create ~curl:t.curl ~tmpdir:t.tmpdir !curl_args in
+ Curl.create ~curl:t.curl ~tmpdir:t.tmpdir !curl_args uri in
let lines = Curl.run curl_h in
if List.length lines < 1 then
else List.push_back_list curl_args quiet_args
);
- Curl.create ~curl:t.curl ~tmpdir:t.tmpdir !curl_args in
+ Curl.create ~curl:t.curl ~tmpdir:t.tmpdir !curl_args uri in
ignore (Curl.run curl_h)
);
if verbose () then (
printf "index file (%s) after parsing (C parser):\n" uri;
- List.iter (Index.print_entry Pervasives.stdout) entries
+ List.iter (Index.print_entry Stdlib.stdout) entries
);
entries
| Some gpgkey ->
message (f_"Signing index with the GPG key %s") gpgkey;
let cmd = sprintf "%s --armor --output %s --export %s"
- (quote (cmdline.gpg // "index.gpg"))
- (quote tmprepo) (quote gpgkey) in
+ (quote cmdline.gpg)
+ (quote (tmprepo // "index.gpg")) (quote gpgkey) in
if shell_command cmd <> 0 then
error (f_"failed to export the GPG key %s") gpgkey;
let cmd = sprintf "%s --armor --default-key %s --clearsign %s"
(quote cmdline.gpg) (quote gpgkey)
- (quote (tmprepo // "index" )) in
+ (quote (tmprepo // "index")) in
if shell_command cmd <> 0 then
error (f_"failed to sign index");
);
let entries = List.flatten (List.map scan_product_list downloads) in
if verbose () then (
printf "simplestreams tree (%s) after parsing:\n" uri;
- List.iter (Index.print_entry Pervasives.stdout) entries
+ List.iter (Index.print_entry Stdlib.stdout) entries
);
entries
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
--- /dev/null
+[debian-12]
+name=Debian 12 (bookworm)
+osinfo=debian12
+arch=x86_64
+file=debian-12.xz
+checksum[sha512]=f1c58b53b7d25691ccbd2c3eb97f692985e8a035247dee3ed8e024bbae64574620ace75dbb57207064739f5e4b317c6ad6d6d518d777c719441b06b1634fe07e
+format=raw
+size=6442450944
+compressed_size=275642276
+expand=/dev/sda1
+notes=Debian 12 (bookworm)
+
+ This is a minimal Debian install.
+
+ This image is so very minimal that it only includes an ssh server
+ This image does not contain SSH host keys. To regenerate them use:
+
+ --firstboot-command "dpkg-reconfigure openssh-server"
+
+ This template was generated by a script in the libguestfs source tree:
+ builder/templates/make-template.ml
+ Associated files used to prepare this template can be found in the
+ same directory.
+
--- /dev/null
+# This is the virt-install command which was used to create
+# the virt-builder template 'debian-12'
+# NB: This file is generated for documentation purposes ONLY!
+# This script was never run, and is not intended to be run.
+
+'virt-install' \
+ '--transient' \
+ '--name=tmp-3x44r0p1' \
+ '--ram=4096' \
+ '--arch=x86_64' \
+ '--cpu=host' \
+ '--vcpus=4' \
+ '--os-variant=debian8' \
+ '--initrd-inject=/tmp/csgljpjq.tmp/preseed.cfg' \
+ '--extra-args=auto mirror/http/proxy= console=tty0 console=ttyS0,115200 rd_NO_PLYMOUTH' \
+ '--disk=/home/rjones/d/guestfs-tools/builder/templates/tmp-3x44r0p1.img,size=6,format=raw' \
+ '--location=http://deb.debian.org/debian/dists/bookworm/main/installer-amd64' \
+ '--serial=pty' \
+ '--nographics'
+
--- /dev/null
+[fedora-38]
+name=Fedora® 38 Server (aarch64)
+osinfo=fedora38
+arch=aarch64
+file=fedora-38-aarch64.xz
+checksum[sha512]=eeb4bf2f82625c1a5c14b17a016e325534049b070c2f03c164e81e64a0187aae79bced4ee9e25aab9f55389eb7cd5d4538b2610dc7461b317de2685fe8680fba
+format=raw
+size=6442450944
+compressed_size=680892008
+expand=/dev/sda3
+notes=Fedora® 38 Server (aarch64)
+
+ This Fedora image contains only unmodified @Core group packages.
+
+ Fedora and the Infinity design logo are trademarks of Red Hat, Inc.
+ Source and further information is available from http://fedoraproject.org/
+
+ You will need to use the associated UEFI NVRAM variables file:
+ http://libguestfs.org/download/builder/fedora-38-aarch64-nvram.xz
+
+ This template was generated by a script in the libguestfs source tree:
+ builder/templates/make-template.ml
+ Associated files used to prepare this template can be found in the
+ same directory.
+
--- /dev/null
+# Kickstart file for fedora-38-aarch64
+# Generated by libguestfs.git/builder/templates/make-template.ml
+
+text
+reboot
+lang en_US.UTF-8
+keyboard us
+network --bootproto dhcp
+rootpw builder
+firewall --enabled --ssh
+timezone --utc America/New_York
+selinux --enforcing
+
+bootloader --location=mbr --append="console=ttyAMA0 earlyprintk=pl011,0x9000000 ignore_loglevel no_timer_check printk.time=1 rd_NO_PLYMOUTH"
+
+
+zerombr
+clearpart --all --initlabel --disklabel=gpt
+autopart --type=plain
+
+# Halt the system once configuration has finished.
+poweroff
+
+%packages
+@core
+%end
+
+%post
+# Ensure the installation is up-to-date.
+dnf -y --best upgrade
+# This required otherwise the kernel will not be bootable, see
+# https://bugzilla.redhat.com/show_bug.cgi?id=1911177
+# https://bugzilla.redhat.com/show_bug.cgi?id=1945835#c24
+grub2-mkconfig -o '/etc/grub2-efi.cfg'
+%end
+
+# EOF
--- /dev/null
+# This is the virt-install command which was used to create
+# the virt-builder template 'fedora-38-aarch64'
+# NB: This file is generated for documentation purposes ONLY!
+# This script was never run, and is not intended to be run.
+
+'virt-install' \
+ '--transient' \
+ '--name=tmp-nlo8d7hr' \
+ '--ram=4096' \
+ '--arch=aarch64' \
+ '--vcpus=1' \
+ '--os-variant=fedora34' \
+ '--boot' 'loader=/usr/share/edk2/aarch64/QEMU_EFI-pflash.raw,loader_ro=yes,loader_type=pflash,nvram=/home/rjones/d/guestfs-tools/builder/templates/tmp-nlo8d7hr.vars' \
+ '--initrd-inject=fedora-38-aarch64.ks' \
+ '--extra-args=inst.ks=file:/fedora-38-aarch64.ks console=ttyAMA0 earlyprintk=pl011,0x9000000 ignore_loglevel no_timer_check printk.time=1 rd_NO_PLYMOUTH' \
+ '--disk=/home/rjones/d/guestfs-tools/builder/templates/tmp-nlo8d7hr.img,size=6,format=raw' \
+ '--location=https://lon.mirror.rackspace.com/fedora/releases/38/Server/aarch64/os/' \
+ '--serial=pty' \
+ '--nographics'
+
--- /dev/null
+[fedora-38]
+name=Fedora® 38 Server
+osinfo=fedora38
+arch=x86_64
+file=fedora-38.xz
+checksum[sha512]=e9746d591730b5aa3996d3f6c960c086ed238f433c5a65f6ade4d40cd674d9aef390804a37fd70f2e933bcb0ac4a99fa646cb13db9e9608877807a02fe101776
+format=raw
+size=6442450944
+compressed_size=687953248
+expand=/dev/sda3
+notes=Fedora® 38 Server
+
+ This Fedora image contains only unmodified @Core group packages.
+
+ Fedora and the Infinity design logo are trademarks of Red Hat, Inc.
+ Source and further information is available from http://fedoraproject.org/
+
+ This template was generated by a script in the libguestfs source tree:
+ builder/templates/make-template.ml
+ Associated files used to prepare this template can be found in the
+ same directory.
+
--- /dev/null
+# Kickstart file for fedora-38
+# Generated by libguestfs.git/builder/templates/make-template.ml
+
+text
+reboot
+lang en_US.UTF-8
+keyboard us
+network --bootproto dhcp
+rootpw builder
+firewall --enabled --ssh
+timezone --utc America/New_York
+selinux --enforcing
+
+bootloader --location=mbr --append="console=tty0 console=ttyS0,115200 rd_NO_PLYMOUTH"
+
+
+zerombr
+clearpart --all --initlabel --disklabel=gpt
+autopart --type=plain
+
+# Halt the system once configuration has finished.
+poweroff
+
+%packages
+@core
+%end
+
+%post
+# Ensure the installation is up-to-date.
+dnf -y --best upgrade
+# This required otherwise the kernel will not be bootable, see
+# https://bugzilla.redhat.com/show_bug.cgi?id=1911177
+# https://bugzilla.redhat.com/show_bug.cgi?id=1945835#c24
+grub2-mkconfig -o '/etc/grub2.cfg'
+# Enable Xen domU support.
+pushd /etc/dracut.conf.d
+echo 'add_drivers+=" xen:vbd xen:vif "' > virt-builder-xen-drivers.conf
+popd
+# To make dracut config changes permanent, we need to rerun dracut.
+# Rerun dracut for the installed kernel (not the running kernel).
+# See commit 0fa52e4e45d80874bc5ea5f112f74be1d3f3472f and
+# https://www.redhat.com/archives/libguestfs/2014-June/thread.html#00045
+KERNEL_VERSION="$(rpm -q kernel --qf '%{version}-%{release}.%{arch}\n' |
+ sort -V | tail -1)"
+dracut -f /boot/initramfs-$KERNEL_VERSION.img $KERNEL_VERSION
+%end
+
+# EOF
--- /dev/null
+# This is the virt-install command which was used to create
+# the virt-builder template 'fedora-38'
+# NB: This file is generated for documentation purposes ONLY!
+# This script was never run, and is not intended to be run.
+
+'virt-install' \
+ '--transient' \
+ '--name=tmp-612x9sxk' \
+ '--ram=4096' \
+ '--arch=x86_64' \
+ '--cpu=host' \
+ '--vcpus=4' \
+ '--os-variant=fedora34' \
+ '--initrd-inject=fedora-38.ks' \
+ '--extra-args=inst.ks=file:/fedora-38.ks console=tty0 console=ttyS0,115200 rd_NO_PLYMOUTH' \
+ '--disk=/home/rjones/d/guestfs-tools/builder/templates/tmp-612x9sxk.img,size=6,format=raw' \
+ '--location=https://lon.mirror.rackspace.com/fedora/releases/38/Server/x86_64/os/' \
+ '--serial=pty' \
+ '--nographics'
+
--- /dev/null
+[fedora-39]
+name=Fedora® 39 Server
+osinfo=fedora39
+arch=x86_64
+file=fedora-39.xz
+checksum[sha512]=8ff9abba5b3e040e6182f929f76cbee8285baebb1af5c1797fbe1b4115b8c32a62266313bbba7e26cf01ca1f866eb5db6455cb6760013800099c60ee6f77c74a
+format=raw
+size=6442450944
+compressed_size=654173196
+expand=/dev/sda3
+notes=Fedora® 39 Server
+
+ This Fedora image contains only unmodified @Core group packages.
+
+ Fedora and the Infinity design logo are trademarks of Red Hat, Inc.
+ Source and further information is available from http://fedoraproject.org/
+
+ This template was generated by a script in the libguestfs source tree:
+ builder/templates/make-template.ml
+ Associated files used to prepare this template can be found in the
+ same directory.
+
--- /dev/null
+# Kickstart file for fedora-39
+# Generated by libguestfs.git/builder/templates/make-template.ml
+
+text
+reboot
+lang en_US.UTF-8
+keyboard us
+network --bootproto dhcp
+rootpw builder
+firewall --enabled --ssh
+timezone --utc America/New_York
+selinux --enforcing
+
+bootloader --location=mbr --append="console=tty0 console=ttyS0,115200 rd_NO_PLYMOUTH"
+
+
+zerombr
+clearpart --all --initlabel --disklabel=gpt
+autopart --type=plain
+
+# Halt the system once configuration has finished.
+poweroff
+
+%packages
+@core
+%end
+
+%post
+# Ensure the installation is up-to-date.
+dnf -y --best upgrade
+# This required otherwise the kernel will not be bootable, see
+# https://bugzilla.redhat.com/show_bug.cgi?id=1911177
+# https://bugzilla.redhat.com/show_bug.cgi?id=1945835#c24
+grub2-mkconfig -o '/etc/grub2.cfg'
+# Enable Xen domU support.
+pushd /etc/dracut.conf.d
+echo 'add_drivers+=" xen:vbd xen:vif "' > virt-builder-xen-drivers.conf
+popd
+# To make dracut config changes permanent, we need to rerun dracut.
+# Rerun dracut for the installed kernel (not the running kernel).
+# See commit 0fa52e4e45d80874bc5ea5f112f74be1d3f3472f and
+# https://www.redhat.com/archives/libguestfs/2014-June/thread.html#00045
+KERNEL_VERSION="$(rpm -q kernel --qf '%{version}-%{release}.%{arch}\n' |
+ sort -V | tail -1)"
+dracut -f /boot/initramfs-$KERNEL_VERSION.img $KERNEL_VERSION
+%end
+
+# EOF
--- /dev/null
+# This is the virt-install command which was used to create
+# the virt-builder template 'fedora-39'
+# NB: This file is generated for documentation purposes ONLY!
+# This script was never run, and is not intended to be run.
+
+'virt-install' \
+ '--transient' \
+ '--name=tmp-lu5hmagp' \
+ '--ram=4096' \
+ '--arch=x86_64' \
+ '--cpu=host' \
+ '--vcpus=4' \
+ '--os-variant=fedora34' \
+ '--initrd-inject=fedora-39.ks' \
+ '--extra-args=inst.ks=file:/fedora-39.ks console=tty0 console=ttyS0,115200 rd_NO_PLYMOUTH' \
+ '--disk=/home/rjones/d/guestfs-tools/builder/templates/tmp-lu5hmagp.img,size=6,format=raw' \
+ '--location=https://lon.mirror.rackspace.com/fedora/releases/39/Server/x86_64/os/' \
+ '--serial=pty' \
+ '--nographics'
+
| "debian", "9" -> Debian (9, "stretch")
| "debian", "10" -> Debian (10, "buster")
| "debian", "11" -> Debian (11, "bullseye")
+ | "debian", "12" -> Debian (12, "bookworm")
| "ubuntu", "10.04" -> Ubuntu (ver, "lucid")
| "ubuntu", "12.04" -> Ubuntu (ver, "precise")
| "ubuntu", "14.04" -> Ubuntu (ver, "trusty")
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
module G = Guestfs
-(* Simple reimplementation of Array.mem, available only with OCaml >= 4.03. *)
-let array_find a l =
- List.mem a (Array.to_list l)
-
let rec relabel (g : G.guestfs) =
(* Is the guest using SELinux? (Otherwise this is a no-op). *)
if is_selinux_guest g then (
g#aug_load ();
debug_augeas_errors g;
+ let config_path = "/files/etc/selinux/config" in
+ let config_keys = g#aug_ls config_path in
+ (* SELinux may be disabled via a setting in config file *)
+ let selinux_disabled =
+ let selinuxmode_path = config_path ^ "/SELINUX" in
+ if Array.mem selinuxmode_path config_keys then
+ g#aug_get selinuxmode_path = "disabled"
+ else
+ false in
+ if selinux_disabled then
+ failwith "selinux disabled";
+
(* Get the SELinux policy name, eg. "targeted", "minimum".
* Use "targeted" if not specified, just like libselinux does.
*)
let policy =
- let config_path = "/files/etc/selinux/config" in
let selinuxtype_path = config_path ^ "/SELINUXTYPE" in
- let keys = g#aug_ls config_path in
- if array_find selinuxtype_path keys then
+ if Array.mem selinuxtype_path config_keys then
g#aug_get selinuxtype_path
else
"targeted" in
I<Note>: C<PERMISSIONS> by default would be decimal, unless you prefix
it with C<0> to get octal, ie. use C<0700> not C<700>.
+=item B<--chown> UID:GID:PATH
+
+Change the owner user and group ID of a file or directory in the guest.
+Note:
+
+=over 4
+
+=item *
+
+Only numeric UIDs and GIDs will work, and these may not be the same
+inside the guest as on the host.
+
+=item *
+
+This will not work with Windows guests.
+
+=back
+
+For example:
+
+ virt-customize --chown '0:0:/var/log/audit.log'
+
+See also: I<--upload>.
+
=item B<--commands-from-file> FILENAME
Read the customize commands from a file, one (and its arguments)
You can have multiple I<--ssh-inject> options, for different users
and also for more keys for each user.
+=item B<--tar-in> TARFILE:REMOTEDIR
+
+Copy local files or directories from a local tar file
+called C<TARFILE> into the disk image, placing them in the
+directory C<REMOTEDIR> (which must exist). Note that
+the tar file must be uncompressed (F<.tar.gz> files will not work
+here)
+
=item B<--timezone> TIMEZONE
Set the default timezone of the guest to C<TIMEZONE>. Use a location
[--append-line FILE:LINE] [--chmod PERMISSIONS:FILE]
- [--commands-from-file FILENAME] [--copy SOURCE:DEST]
- [--copy-in LOCALPATH:REMOTEDIR] [--delete PATH] [--edit FILE:EXPR]
- [--firstboot SCRIPT] [--firstboot-command 'CMD+ARGS']
- [--firstboot-install PKG,PKG..] [--hostname HOSTNAME]
- [--inject-qemu-ga METHOD] [--inject-virtio-win METHOD]
- [--install PKG,PKG..] [--link TARGET:LINK[:LINK..]] [--mkdir DIR]
- [--move SOURCE:DEST] [--password USER:SELECTOR]
- [--root-password SELECTOR] [--run SCRIPT]
- [--run-command 'CMD+ARGS'] [--scrub FILE] [--sm-attach SELECTOR]
- [--sm-register] [--sm-remove] [--sm-unregister]
- [--ssh-inject USER[:SELECTOR]] [--truncate FILE]
- [--truncate-recursive PATH] [--timezone TIMEZONE] [--touch FILE]
+ [--chown UID:GID:PATH] [--commands-from-file FILENAME]
+ [--copy SOURCE:DEST] [--copy-in LOCALPATH:REMOTEDIR]
+ [--delete PATH] [--edit FILE:EXPR] [--firstboot SCRIPT]
+ [--firstboot-command 'CMD+ARGS'] [--firstboot-install PKG,PKG..]
+ [--hostname HOSTNAME] [--inject-qemu-ga METHOD]
+ [--inject-virtio-win METHOD] [--install PKG,PKG..]
+ [--link TARGET:LINK[:LINK..]] [--mkdir DIR] [--move SOURCE:DEST]
+ [--password USER:SELECTOR] [--root-password SELECTOR]
+ [--run SCRIPT] [--run-command 'CMD+ARGS'] [--scrub FILE]
+ [--sm-attach SELECTOR] [--sm-register] [--sm-remove]
+ [--sm-unregister] [--ssh-inject USER[:SELECTOR]]
+ [--tar-in TARFILE:REMOTEDIR] [--timezone TIMEZONE] [--touch FILE]
+ [--truncate FILE] [--truncate-recursive PATH]
[--uninstall PKG,PKG..] [--update] [--upload FILE:DEST]
[--write FILE:CONTENT] [--no-logfile]
[--password-crypto md5|sha256|sha512] [--no-selinux-relabel]
(* --append-line FILE:LINE *)
| `Chmod of string * string
(* --chmod PERMISSIONS:FILE *)
+ | `Chown of string * string * string
+ (* --chown UID:GID:PATH *)
| `CommandsFromFile of string
(* --commands-from-file FILENAME *)
| `Copy of string * string
(* --sm-unregister *)
| `SSHInject of string * Ssh_key.ssh_key_selector
(* --ssh-inject USER[:SELECTOR] *)
- | `Truncate of string
- (* --truncate FILE *)
- | `TruncateRecursive of string
- (* --truncate-recursive PATH *)
+ | `TarIn of string * string
+ (* --tar-in TARFILE:REMOTEDIR *)
| `Timezone of string
(* --timezone TIMEZONE *)
| `Touch of string
(* --touch FILE *)
+ | `Truncate of string
+ (* --truncate FILE *)
+ | `TruncateRecursive of string
+ (* --truncate-recursive PATH *)
| `UninstallPackages of string list
(* --uninstall PKG,PKG.. *)
| `Update
option_name in
let len = String.length arg in
String.sub arg 0 i, String.sub arg (i+1) (len-(i+1))
- in
- let split_string_list arg =
+ and split_string_triplet option_name arg =
+ match String.nsplit ~max:3 "," arg with
+ | [a; b; c] -> a, b, c
+ | _ ->
+ error (f_"invalid format for '--%s' parameter, see the man page")
+ option_name
+ and split_string_list arg =
String.nsplit "," arg
in
let split_links_list option_name arg =
s_"Change the permissions of a file"
),
Some "PERMISSIONS:FILE", "Change the permissions of C<FILE> to C<PERMISSIONS>.\n\nI<Note>: C<PERMISSIONS> by default would be decimal, unless you prefix\nit with C<0> to get octal, ie. use C<0700> not C<700>.";
+ (
+ [ L"chown" ],
+ Getopt.String (
+ s_"UID:GID:PATH",
+ fun s ->
+ let p = split_string_triplet "chown" s in
+ List.push_front (`Chown p) ops
+ ),
+ s_"Change the owner user and group ID of a file or directory"
+ ),
+ Some "UID:GID:PATH", "Change the owner user and group ID of a file or directory in the guest.\nNote:\n\n=over 4\n\n=item *\n\nOnly numeric UIDs and GIDs will work, and these may not be the same\ninside the guest as on the host.\n\n=item *\n\nThis will not work with Windows guests.\n\n=back\n\nFor example:\n\n virt-customize --chown '0:0:/var/log/audit.log'\n\nSee also: I<--upload>.";
(
[ L"commands-from-file" ],
Getopt.String (
),
Some "USER[:SELECTOR]", "Inject an ssh key so the given C<USER> will be able to log in over\nssh without supplying a password. The C<USER> must exist already\nin the guest.\n\nSee L<virt-builder(1)/SSH KEYS> for the format of\nthe C<SELECTOR> field.\n\nYou can have multiple I<--ssh-inject> options, for different users\nand also for more keys for each user.";
(
- [ L"truncate" ],
- Getopt.String (s_"FILE", fun s -> List.push_front (`Truncate s) ops),
- s_"Truncate a file to zero size"
- ),
- Some "FILE", "This command truncates C<FILE> to a zero-length file. The file must exist\nalready.";
- (
- [ L"truncate-recursive" ],
- Getopt.String (s_"PATH", fun s -> List.push_front (`TruncateRecursive s) ops),
- s_"Recursively truncate all files in directory"
+ [ L"tar-in" ],
+ Getopt.String (
+ s_"TARFILE:REMOTEDIR",
+ fun s ->
+ let p = split_string_pair "tar-in" s in
+ List.push_front (`TarIn p) ops
+ ),
+ s_"Copy local files or directories from a tarball into image"
),
- Some "PATH", "This command recursively truncates all files under C<PATH> to zero-length.";
+ Some "TARFILE:REMOTEDIR", "Copy local files or directories from a local tar file\ncalled C<TARFILE> into the disk image, placing them in the\ndirectory C<REMOTEDIR> (which must exist). Note that\nthe tar file must be uncompressed (F<.tar.gz> files will not work\nhere)";
(
[ L"timezone" ],
Getopt.String (s_"TIMEZONE", fun s -> List.push_front (`Timezone s) ops),
s_"Run touch on a file"
),
Some "FILE", "This command performs a L<touch(1)>-like operation on C<FILE>.";
+ (
+ [ L"truncate" ],
+ Getopt.String (s_"FILE", fun s -> List.push_front (`Truncate s) ops),
+ s_"Truncate a file to zero size"
+ ),
+ Some "FILE", "This command truncates C<FILE> to a zero-length file. The file must exist\nalready.";
+ (
+ [ L"truncate-recursive" ],
+ Getopt.String (s_"PATH", fun s -> List.push_front (`TruncateRecursive s) ops),
+ s_"Recursively truncate all files in directory"
+ ),
+ Some "PATH", "This command recursively truncates all files under C<PATH> to zero-length.";
(
[ L"uninstall" ],
Getopt.String (
(* --append-line FILE:LINE *)
| `Chmod of string * string
(* --chmod PERMISSIONS:FILE *)
+ | `Chown of string * string * string
+ (* --chown UID:GID:PATH *)
| `CommandsFromFile of string
(* --commands-from-file FILENAME *)
| `Copy of string * string
(* --sm-unregister *)
| `SSHInject of string * Ssh_key.ssh_key_selector
(* --ssh-inject USER[:SELECTOR] *)
- | `Truncate of string
- (* --truncate FILE *)
- | `TruncateRecursive of string
- (* --truncate-recursive PATH *)
+ | `TarIn of string * string
+ (* --tar-in TARFILE:REMOTEDIR *)
| `Timezone of string
(* --timezone TIMEZONE *)
| `Touch of string
(* --touch FILE *)
+ | `Truncate of string
+ (* --truncate FILE *)
+ | `TruncateRecursive of string
+ (* --truncate-recursive PATH *)
| `UninstallPackages of string list
(* --uninstall PKG,PKG.. *)
| `Update
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
with G.Error msg ->
error (f_"could not find bootloader mount point (%s): %s") mp msg in
+ (*
+ * Workaround for older UEFI-based Debian which may not have
+ * /boot/efi/EFI/debian/grub.cfg.
+ *)
+ let paths =
+ if g#exists "/boot/grub/grub.cfg" then
+ match i_firmware with
+ | Firmware.I_BIOS -> paths
+ | I_UEFI _ -> paths @ ["/boot/grub/grub.cfg"]
+ else paths
+ in
+
(* We can determine if the bootloader config file is grub 1 or
* grub 2 just by looking at the filename.
*)
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
| x::xs, y::ys, z::zs -> (x, y, z) :: combine3 xs ys zs
| _ -> invalid_arg "combine3"
- let rec assoc_lbl ?(cmp = Pervasives.compare) ~default x = function
+ let rec assoc_lbl ?(cmp = Stdlib.compare) ~default x = function
| [] -> default
| (y, y') :: _ when cmp x y = 0 -> y'
| _ :: ys -> assoc_lbl ~cmp ~default x ys
- let uniq ?(cmp = Pervasives.compare) xs =
+ let uniq ?(cmp = Stdlib.compare) xs =
let rec loop acc = function
| [] -> acc
| [x] -> x :: acc
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
open Std_utils
open Tools_utils
+open Common_gettext.Gettext
type t = {
curl : string;
args : args;
tmpdir : string option;
+ url : string;
}
and args = (string * string option) list
| SystemProxy -> []
| ForcedProxy url -> [ "proxy", Some url; "noproxy", Some "" ]
-let create ?(curl = "curl") ?(proxy = SystemProxy) ?tmpdir args =
+let create ?(curl = "curl") ?(proxy = SystemProxy) ?tmpdir args url =
+ (* The ["url"] key must not appear in [args]. This was how the
+ * previous version of this module worked, so lets check there
+ * are no callers still doing this.
+ *)
+ List.iter (function "url", _ -> assert false | _ -> ()) args;
+
let args = safe_args @ args_of_proxy proxy @ args in
- { curl = curl; args = args; tmpdir = tmpdir }
+ { curl; args; tmpdir; url }
-let run { curl; args; tmpdir } =
+let run { curl; args; tmpdir; url } =
let config_file, chan = Filename.open_temp_file ?temp_dir:tmpdir
"guestfscurl" ".conf" in
List.iter (
| c -> output_char chan c
done;
fprintf chan "\"\n"
- ) args;
+ ) (("url", Some url) :: args);
close_out chan;
let cmd = sprintf "%s -q --config %s" (quote curl) (quote config_file) in
- let lines = external_command ~echo_cmd:false cmd in
+ let help = sprintf (f_"downloading %s") url in
+ let lines = external_command ~echo_cmd:false ~help cmd in
Unix.unlink config_file;
lines
-let to_string { curl; args } =
+let to_string { curl; args; url } =
let b = Buffer.create 128 in
bprintf b "%s -q" (quote curl);
List.iter (
| "user", Some _ -> bprintf b " --user <hidden>"
| name, Some value -> bprintf b " --%s %s" name (quote value)
) args;
- bprintf b "\n";
+ bprintf b " %s\n" (quote url);
Buffer.contents b
let print chan t = output_string chan (to_string t)
| SystemProxy (** Use the system settings. *)
| ForcedProxy of string (** The proxy is forced to the specified URL. *)
-val create : ?curl:string -> ?proxy:proxy -> ?tmpdir:string -> args -> t
+val create : ?curl:string -> ?proxy:proxy -> ?tmpdir:string -> args -> string
+ -> t
(** Create a curl command handle.
The curl arguments are a list of key, value pairs corresponding
to curl command line parameters, without leading dashes,
eg. [("user", Some "user:password")].
+ The string parameter is the URL (which is required).
+
The optional [?curl] parameter controls the name of the curl
binary (default ["curl"]).
driver = OSINFO_DEVICE_DRIVER(osinfo_list_get_nth (OSINFO_LIST(list), i));
- vi = caml_alloc (6, 0);
+ vi = caml_alloc (7, 0);
str = osinfo_device_driver_get_architecture (driver);
copyv = caml_copy_string (str);
Store_field (vi, 0, copyv);
let getopt = Getopt.create argspec ?anon_fun usage_msg in
{ getopt; ks; debug_gc }
+let external_command_failed help cmd reason =
+ let help_prefix = match help with None -> "" | Some str -> str ^ ": " in
+ error "%s%s ‘%s’: %s" help_prefix (s_"external command") cmd reason
+
(* Run an external command, slurp up the output as a list of lines. *)
-let external_command ?(echo_cmd = true) cmd =
+let external_command ?(echo_cmd = true) ?help cmd =
if echo_cmd then
debug "%s" cmd;
let chan = Unix.open_process_in cmd in
(match stat with
| Unix.WEXITED 0 -> ()
| Unix.WEXITED i ->
- error (f_"external command ‘%s’ exited with error %d") cmd i
+ let reason = sprintf (f_"exited with error %d") i in
+ external_command_failed help cmd reason
| Unix.WSIGNALED i ->
- error (f_"external command ‘%s’ killed by signal %d") cmd i
+ let reason = sprintf (f_"killed by signal %d") i in
+ external_command_failed help cmd reason
| Unix.WSTOPPED i ->
- error (f_"external command ‘%s’ stopped by signal %d") cmd i
+ let reason = sprintf (f_"stopped by signal %d") i in
+ external_command_failed help cmd reason
);
lines
-let rec run_commands ?(echo_cmd = true) cmds =
+let rec run_commands ?(echo_cmd = true) ?help cmds =
let res = Array.make (List.length cmds) 0 in
let pids =
List.mapi (
let matching_pair = List.hd matching_pair in
let idx, _, app, outfd, errfd = matching_pair in
pids := new_pids;
- res.(idx) <- do_teardown app outfd errfd stat
+ res.(idx) <- do_teardown help app outfd errfd stat
);
done;
Array.to_list res
-and run_command ?(echo_cmd = true) ?stdout_fd ?stderr_fd args =
+and run_command ?(echo_cmd = true) ?help ?stdout_fd ?stderr_fd args =
let run_res = do_run args ~echo_cmd ?stdout_fd ?stderr_fd in
match run_res with
| Either (pid, app, outfd, errfd) ->
let _, stat = Unix.waitpid [] pid in
- do_teardown app outfd errfd stat
+ do_teardown help app outfd errfd stat
| Or code ->
code
-and do_run ?(echo_cmd = true) ?stdout_fd ?stderr_fd args =
+and do_run ?(echo_cmd = true) ?help ?stdout_fd ?stderr_fd args =
let app = List.hd args in
let get_fd default = function
| None ->
debug "%s: %s: executable not found" app fn;
Or 127
-and do_teardown app outfd errfd exitstat =
+and do_teardown help app outfd errfd exitstat =
Option.iter Unix.close outfd;
Option.iter Unix.close errfd;
match exitstat with
| Unix.WEXITED i ->
- i
+ i
| Unix.WSIGNALED i ->
- error (f_"external command ‘%s’ killed by signal %d") app i
+ let reason = sprintf (f_"killed by signal %d") i in
+ external_command_failed help app reason
| Unix.WSTOPPED i ->
- error (f_"external command ‘%s’ stopped by signal %d") app i
+ let reason = sprintf (f_"stopped by signal %d") i in
+ external_command_failed help app reason
let shell_command ?(echo_cmd = true) cmd =
if echo_cmd then
Returns a new {!cmdline_options} structure. *)
-val external_command : ?echo_cmd:bool -> string -> string list
+val external_command : ?echo_cmd:bool -> ?help:string -> string -> string list
(** Run an external command, slurp up the output as a list of lines.
[echo_cmd] specifies whether to output the full command on verbose
- mode, and it's on by default. *)
+ mode, and it's on by default.
+
+ [help] is an optional string which is printed as a prefix in
+ case the external command fails, eg as a hint to the user about
+ what we were trying to do. *)
-val run_commands : ?echo_cmd:bool -> (string list * Unix.file_descr option * Unix.file_descr option) list -> int list
+val run_commands : ?echo_cmd:bool -> ?help:string -> (string list * Unix.file_descr option * Unix.file_descr option) list -> int list
(** Run external commands in parallel without using a shell,
and return a list with their exit codes.
end of the execution of the command for which it was specified.
[echo_cmd] specifies whether output the full command on verbose
- mode, and it's on by default. *)
+ mode, and it's on by default.
-val run_command : ?echo_cmd:bool -> ?stdout_fd:Unix.file_descr -> ?stderr_fd:Unix.file_descr -> string list -> int
+ [help] is an optional string which is printed as a prefix in
+ case the external command fails, eg as a hint to the user about
+ what we were trying to do. *)
+
+val run_command : ?echo_cmd:bool -> ?help:string -> ?stdout_fd:Unix.file_descr -> ?stderr_fd:Unix.file_descr -> string list -> int
(** Run an external command without using a shell, and return its exit code.
If [stdout_fd] or [stderr_fd] is specified, the file descriptor
is automatically closed after executing the command.
[echo_cmd] specifies whether output the full command on verbose
- mode, and it's on by default. *)
+ mode, and it's on by default.
+
+ [help] is an optional string which is printed as a prefix in
+ case the external command fails, eg as a hint to the user about
+ what we were trying to do. *)
val shell_command : ?echo_cmd:bool -> string -> int
(** Run an external shell command, and return its exit code.
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
#include <caml/memory.h>
#include <caml/mlvalues.h>
+#include <libxml/parser.h>
#include <libxml/xpath.h>
#include <libxml/xpathInternals.h>
#include <libxml/uri.h>
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
=item B<--key> SELECTOR
Specify a key for LUKS, to automatically open a LUKS device when using
-the inspection. C<ID> can be either the libguestfs device name, or
-the UUID of the LUKS device.
+the inspection.
=over 4
-=item B<--key> C<ID>:key:KEY_STRING
+=item B<--key> NAMEB<:key:>KEY_STRING
+
+=item B<--key> UUIDB<:key:>KEY_STRING
+
+=item B<--key> B<all:key:>KEY_STRING
+
+C<NAME> is the libguestfs device name (eg. C</dev/sda1>). C<UUID> is
+the device UUID. C<all> means try the key against any encrypted
+device.
Use the specified C<KEY_STRING> as passphrase.
-=item B<--key> C<ID>:file:FILENAME
+=item B<--key> NAMEB<:file:>FILENAME
+
+=item B<--key> UUIDB<:file:>FILENAME
+
+=item B<--key> B<all:file:>FILENAME
Read the passphrase from F<FILENAME>.
-=item B<--key> C<ID>:clevis
+=item B<--key> NAMEB<:clevis>
+
+=item B<--key> UUIDB<:clevis>
+
+=item B<--key> B<all:clevis>
-Attempt passphrase-less unlocking for C<ID> with Clevis, over the
+Attempt passphrase-less unlocking for the device with Clevis, over the
network. Please refer to L<guestfs(3)/ENCRYPTED DISKS> for more
information on network-bound disk encryption (NBDE).
#include <stdio.h>
#include <stdlib.h>
+#include <stdbool.h>
#include <unistd.h>
#include <termios.h>
#include <string.h>
if (ks) {
for (i = 0; i < ks->nr_keys; ++i) {
struct key_store_key *key = &ks->keys[i];
+ bool key_id_matches_this_device;
- if (STRNEQ (key->id, device) && (!uuid || STRNEQ (key->id, uuid)))
- continue;
+ key_id_matches_this_device =
+ STREQ (key->id, "all") || /* special string "all" matches any device */
+ STREQ (key->id, device) ||
+ (uuid && STREQ (key->id, uuid));
+ if (!key_id_matches_this_device) continue;
switch (key->type) {
case key_string:
return key_store_import_key (ks, &key);
}
+/* Turn /dev/mapper/VG-LV into /dev/VG/LV, in-place. */
+static void
+unescape_device_mapper_lvm (char *id)
+{
+ static const char dev[] = "/dev/", dev_mapper[] = "/dev/mapper/";
+ const char *input_start;
+ char *output;
+ enum { M_SCAN, M_FILL, M_DONE } mode;
+
+ if (!STRPREFIX (id, dev_mapper))
+ return;
+
+ /* Start parsing "VG-LV" from "id" after "/dev/mapper/". */
+ input_start = id + (sizeof dev_mapper - 1);
+
+ /* Start writing the unescaped "VG/LV" output after "/dev/". */
+ output = id + (sizeof dev - 1);
+
+ for (mode = M_SCAN; mode < M_DONE; ++mode) {
+ char c;
+ const char *input = input_start;
+ const char *hyphen_buffered = NULL;
+ bool single_hyphen_seen = false;
+
+ do {
+ c = *input;
+
+ switch (c) {
+ case '-':
+ if (hyphen_buffered == NULL)
+ /* This hyphen may start an escaped hyphen, or it could be the
+ * separator in VG-LV.
+ */
+ hyphen_buffered = input;
+ else {
+ /* This hyphen completes an escaped hyphen; unescape it. */
+ if (mode == M_FILL)
+ *output++ = '-';
+ hyphen_buffered = NULL;
+ }
+ break;
+
+ case '/':
+ /* Slash characters are forbidden in VG-LV anywhere. If there's any,
+ * we'll find it in the first (i.e., scanning) phase, before we output
+ * anything back to "id".
+ */
+ assert (mode == M_SCAN);
+ return;
+
+ default:
+ /* Encountered a non-slash, non-hyphen character -- which also may be
+ * the terminating NUL.
+ */
+ if (hyphen_buffered != NULL) {
+ /* The non-hyphen character comes after a buffered hyphen, so the
+ * buffered hyphen is supposed to be the single hyphen that separates
+ * VG from LV in VG-LV. There are three requirements for this
+ * separator: (a) it must be unique (we must not have seen another
+ * such separator earlier), (b) it must not be at the start of VG-LV
+ * (because VG would be empty that way), (c) it must not be at the end
+ * of VG-LV (because LV would be empty that way). Should any of these
+ * be violated, we'll catch that during the first (i.e., scanning)
+ * phase, before modifying "id".
+ */
+ if (single_hyphen_seen || hyphen_buffered == input_start ||
+ c == '\0') {
+ assert (mode == M_SCAN);
+ return;
+ }
+
+ /* Translate the separator hyphen to a slash character. */
+ if (mode == M_FILL)
+ *output++ = '/';
+ hyphen_buffered = NULL;
+ single_hyphen_seen = true;
+ }
+
+ /* Output the non-hyphen character (including the terminating NUL)
+ * regardless of whether there was a buffered hyphen separator (which,
+ * by now, we'll have attempted to translate and flush).
+ */
+ if (mode == M_FILL)
+ *output++ = c;
+ }
+
+ ++input;
+ } while (c != '\0');
+
+ /* We must have seen the VG-LV separator. If that's not the case, we'll
+ * catch it before modifying "id".
+ */
+ if (!single_hyphen_seen) {
+ assert (mode == M_SCAN);
+ return;
+ }
+ }
+}
+
struct key_store *
-key_store_import_key (struct key_store *ks, const struct key_store_key *key)
+key_store_import_key (struct key_store *ks, struct key_store_key *key)
{
struct key_store_key *new_keys;
error (EXIT_FAILURE, errno, "realloc");
ks->keys = new_keys;
+ unescape_device_mapper_lvm (key->id);
ks->keys[ks->nr_keys] = *key;
++ks->nr_keys;
* device name, or the UUID.
*
* There may be multiple matching devices in the list.
+ *
+ * This may be the special string "all" which matches any device.
*/
char *id;
const char *uuid, size_t *nr_matches);
extern void free_keys (struct matching_key *keys, size_t nr_matches);
extern struct key_store *key_store_add_from_selector (struct key_store *ks, const char *selector);
-extern struct key_store *key_store_import_key (struct key_store *ks, const struct key_store_key *key);
+extern struct key_store *key_store_import_key (struct key_store *ks,
+ struct key_store_key *key);
extern bool key_store_requires_network (const struct key_store *ks);
extern void free_key_store (struct key_store *ks);
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.71 for guestfs-tools 1.50.1.
+# Generated by GNU Autoconf 2.71 for guestfs-tools 1.52.0.
#
#
# Copyright (C) 1992-1996, 1998-2017, 2020-2021 Free Software Foundation,
# Identity of this package.
PACKAGE_NAME='guestfs-tools'
PACKAGE_TARNAME='guestfs-tools'
-PACKAGE_VERSION='1.50.1'
-PACKAGE_STRING='guestfs-tools 1.50.1'
+PACKAGE_VERSION='1.52.0'
+PACKAGE_STRING='guestfs-tools 1.52.0'
PACKAGE_BUGREPORT=''
PACKAGE_URL=''
OCAMLLIB
OCAMLVERSION
OCAMLC
+HWDATA_PKGDATADIR
LIBOSINFO_LIBS
LIBOSINFO_CFLAGS
JANSSON_LIBS
PCRE2_CONFIG
PCRE2_LIBS
PCRE2_CFLAGS
+localedir_c_make
+localedir_c
POSUB
LTLIBINTL
LIBINTL
JANSSON_LIBS
LIBOSINFO_CFLAGS
LIBOSINFO_LIBS
+HWDATA_PKGDATADIR
LIBCRYPT_CFLAGS
LIBCRYPT_LIBS
LIBLZMA_CFLAGS
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures guestfs-tools 1.50.1 to adapt to many kinds of systems.
+\`configure' configures guestfs-tools 1.52.0 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of guestfs-tools 1.50.1:";;
+ short | recursive ) echo "Configuration of guestfs-tools 1.52.0:";;
esac
cat <<\_ACEOF
C compiler flags for LIBOSINFO, overriding pkg-config
LIBOSINFO_LIBS
linker flags for LIBOSINFO, overriding pkg-config
+ HWDATA_PKGDATADIR
+ value of pkgdatadir for hwdata, overriding pkg-config
LIBCRYPT_CFLAGS
C compiler flags for LIBCRYPT, overriding pkg-config
LIBCRYPT_LIBS
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-guestfs-tools configure 1.50.1
+guestfs-tools configure 1.52.0
generated by GNU Autoconf 2.71
Copyright (C) 2021 Free Software Foundation, Inc.
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by guestfs-tools $as_me 1.50.1, which was
+It was created by guestfs-tools $as_me 1.52.0, which was
generated by GNU Autoconf 2.71. Invocation command line was
$ $0$ac_configure_args_raw
# Define the identity of the package.
PACKAGE='guestfs-tools'
- VERSION='1.50.1'
+ VERSION='1.52.0'
printf "%s\n" "#define PACKAGE \"$PACKAGE\"" >>confdefs.h
fi
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBGUESTFS" >&5
-printf %s "checking for LIBGUESTFS... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libguestfs >= 1.49.8" >&5
+printf %s "checking for libguestfs >= 1.49.8... " >&6; }
if test -n "$LIBGUESTFS_CFLAGS"; then
pkg_cv_LIBGUESTFS_CFLAGS="$LIBGUESTFS_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBGUESTFS_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libguestfs >= 1.49.8" 2>&1`
+ LIBGUESTFS_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libguestfs >= 1.49.8" 2>&1`
else
- LIBGUESTFS_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libguestfs >= 1.49.8" 2>&1`
+ LIBGUESTFS_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libguestfs >= 1.49.8" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBGUESTFS_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBGUESTFS_PKG_ERRORS" >&5
- as_fn_error $? "Package requirements (libguestfs >= 1.49.8) were not met:
+ as_fn_error $? "Package requirements (libguestfs >= 1.49.8) were not met:
$LIBGUESTFS_PKG_ERRORS
and LIBGUESTFS_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details." "$LINENO" 5
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
- { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+ { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
as_fn_error $? "The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
To get pkg-config, see <http://pkg-config.freedesktop.org/>.
See \`config.log' for more details" "$LINENO" 5; }
else
- LIBGUESTFS_CFLAGS=$pkg_cv_LIBGUESTFS_CFLAGS
- LIBGUESTFS_LIBS=$pkg_cv_LIBGUESTFS_LIBS
+ LIBGUESTFS_CFLAGS=$pkg_cv_LIBGUESTFS_CFLAGS
+ LIBGUESTFS_LIBS=$pkg_cv_LIBGUESTFS_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBTINFO" >&5
-printf %s "checking for LIBTINFO... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for tinfo" >&5
+printf %s "checking for tinfo... " >&6; }
if test -n "$LIBTINFO_CFLAGS"; then
pkg_cv_LIBTINFO_CFLAGS="$LIBTINFO_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "tinfo" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "tinfo" 2>&1`
else
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "tinfo" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "tinfo" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBTINFO_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBTINFO_PKG_ERRORS" >&5
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBTINFO" >&5
-printf %s "checking for LIBTINFO... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ncurses" >&5
+printf %s "checking for ncurses... " >&6; }
if test -n "$LIBTINFO_CFLAGS"; then
pkg_cv_LIBTINFO_CFLAGS="$LIBTINFO_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "ncurses" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "ncurses" 2>&1`
else
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "ncurses" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "ncurses" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBTINFO_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBTINFO_PKG_ERRORS" >&5
for ac_prog in ncurses6-config ncurses5-config
LIBTINFO_LIBS=`$NCURSES_CONFIG --libs`
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
for ac_prog in ncurses6-config ncurses5-config
LIBTINFO_LIBS=`$NCURSES_CONFIG --libs`
else
- LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
- LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
+ LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
+ LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
fi
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBTINFO" >&5
-printf %s "checking for LIBTINFO... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ncurses" >&5
+printf %s "checking for ncurses... " >&6; }
if test -n "$LIBTINFO_CFLAGS"; then
pkg_cv_LIBTINFO_CFLAGS="$LIBTINFO_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "ncurses" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "ncurses" 2>&1`
else
- LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "ncurses" 2>&1`
+ LIBTINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "ncurses" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBTINFO_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBTINFO_PKG_ERRORS" >&5
for ac_prog in ncurses6-config ncurses5-config
LIBTINFO_LIBS=`$NCURSES_CONFIG --libs`
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
for ac_prog in ncurses6-config ncurses5-config
LIBTINFO_LIBS=`$NCURSES_CONFIG --libs`
else
- LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
- LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
+ LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
+ LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
fi
else
- LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
- LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
+ LIBTINFO_CFLAGS=$pkg_cv_LIBTINFO_CFLAGS
+ LIBTINFO_LIBS=$pkg_cv_LIBTINFO_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
+ gl_sed_double_backslashes='s/\\/\\\\/g'
+ gl_sed_escape_doublequotes='s/"/\\"/g'
+ gl_sed_escape_for_make_1="s,\\([ \"&'();<>\\\\\`|]\\),\\\\\\1,g"
+ gl_sed_escape_for_make_2='s,\$,\\$$,g'
+
if { eval "gt_val=\$$gt_func_gnugettext_libc"; test "$gt_val" = "yes"; } \
|| { { eval "gt_val=\$$gt_func_gnugettext_libintl"; test "$gt_val" = "yes"; } \
&& test "$PACKAGE" != gettext-runtime \
- && test "$PACKAGE" != gettext-tools; }; then
+ && test "$PACKAGE" != gettext-tools \
+ && test "$PACKAGE" != libintl; }; then
gt_use_preinstalled_gnugettext=yes
else
LIBINTL=
- INTLLIBS="$LIBINTL"
+
+ INTLLIBS="$LIBINTL"
+
+
+ gt_save_prefix="${prefix}"
+ gt_save_datarootdir="${datarootdir}"
+ gt_save_localedir="${localedir}"
+ if test "X$prefix" = "XNONE"; then
+ prefix="$ac_default_prefix"
+ fi
+ eval datarootdir="$datarootdir"
+ eval localedir="$localedir"
+
+
+
+
+
+ gl_final_localedir="$localedir"
+ case "$build_os" in
+ cygwin*)
+ case "$host_os" in
+ mingw*)
+ gl_final_localedir=`cygpath -w "$gl_final_localedir"` ;;
+ esac
+ ;;
+ esac
+ localedir_c=`echo "$gl_final_localedir" | sed -e "$gl_sed_double_backslashes" -e "$gl_sed_escape_doublequotes"`
+ localedir_c='"'"$localedir_c"'"'
+
+
+ localedir_c_make=`echo "$localedir_c" | sed -e "$gl_sed_escape_for_make_1" -e "$gl_sed_escape_for_make_2"`
+ if test "$localedir_c_make" = '\"'"${gl_final_localedir}"'\"'; then
+ localedir_c_make='\"$(localedir)\"'
+ fi
+
+
+ localedir="${gt_save_localedir}"
+ datarootdir="${gt_save_datarootdir}"
+ prefix="${gt_save_prefix}"
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for PCRE2" >&5
-printf %s "checking for PCRE2... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libpcre2-8" >&5
+printf %s "checking for libpcre2-8... " >&6; }
if test -n "$PCRE2_CFLAGS"; then
pkg_cv_PCRE2_CFLAGS="$PCRE2_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- PCRE2_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libpcre2-8" 2>&1`
+ PCRE2_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libpcre2-8" 2>&1`
else
- PCRE2_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libpcre2-8" 2>&1`
+ PCRE2_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libpcre2-8" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$PCRE2_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$PCRE2_PKG_ERRORS" >&5
for ac_prog in pcre2-config
PCRE_LIBS=`$PCRE2_CONFIG --libs8`
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
for ac_prog in pcre2-config
PCRE_LIBS=`$PCRE2_CONFIG --libs8`
else
- PCRE2_CFLAGS=$pkg_cv_PCRE2_CFLAGS
- PCRE2_LIBS=$pkg_cv_PCRE2_LIBS
+ PCRE2_CFLAGS=$pkg_cv_PCRE2_CFLAGS
+ PCRE2_LIBS=$pkg_cv_PCRE2_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBVIRT" >&5
-printf %s "checking for LIBVIRT... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libvirt >= 0.10.2" >&5
+printf %s "checking for libvirt >= 0.10.2... " >&6; }
if test -n "$LIBVIRT_CFLAGS"; then
pkg_cv_LIBVIRT_CFLAGS="$LIBVIRT_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBVIRT_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libvirt >= 0.10.2" 2>&1`
+ LIBVIRT_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libvirt >= 0.10.2" 2>&1`
else
- LIBVIRT_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libvirt >= 0.10.2" 2>&1`
+ LIBVIRT_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libvirt >= 0.10.2" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBVIRT_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBVIRT_PKG_ERRORS" >&5
if test "$DEFAULT_BACKEND" = "libvirt"; then
fi
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if test "$DEFAULT_BACKEND" = "libvirt"; then
fi
else
- LIBVIRT_CFLAGS=$pkg_cv_LIBVIRT_CFLAGS
- LIBVIRT_LIBS=$pkg_cv_LIBVIRT_LIBS
+ LIBVIRT_CFLAGS=$pkg_cv_LIBVIRT_CFLAGS
+ LIBVIRT_LIBS=$pkg_cv_LIBVIRT_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBXML2" >&5
-printf %s "checking for LIBXML2... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libxml-2.0" >&5
+printf %s "checking for libxml-2.0... " >&6; }
if test -n "$LIBXML2_CFLAGS"; then
pkg_cv_LIBXML2_CFLAGS="$LIBXML2_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBXML2_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libxml-2.0" 2>&1`
+ LIBXML2_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libxml-2.0" 2>&1`
else
- LIBXML2_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libxml-2.0" 2>&1`
+ LIBXML2_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libxml-2.0" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBXML2_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBXML2_PKG_ERRORS" >&5
- as_fn_error $? "Package requirements (libxml-2.0) were not met:
+ as_fn_error $? "Package requirements (libxml-2.0) were not met:
$LIBXML2_PKG_ERRORS
and LIBXML2_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details." "$LINENO" 5
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
- { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+ { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
as_fn_error $? "The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
To get pkg-config, see <http://pkg-config.freedesktop.org/>.
See \`config.log' for more details" "$LINENO" 5; }
else
- LIBXML2_CFLAGS=$pkg_cv_LIBXML2_CFLAGS
- LIBXML2_LIBS=$pkg_cv_LIBXML2_LIBS
+ LIBXML2_CFLAGS=$pkg_cv_LIBXML2_CFLAGS
+ LIBXML2_LIBS=$pkg_cv_LIBXML2_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for JANSSON" >&5
-printf %s "checking for JANSSON... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for jansson >= 2.7" >&5
+printf %s "checking for jansson >= 2.7... " >&6; }
if test -n "$JANSSON_CFLAGS"; then
pkg_cv_JANSSON_CFLAGS="$JANSSON_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- JANSSON_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "jansson >= 2.7" 2>&1`
+ JANSSON_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "jansson >= 2.7" 2>&1`
else
- JANSSON_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "jansson >= 2.7" 2>&1`
+ JANSSON_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "jansson >= 2.7" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$JANSSON_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$JANSSON_PKG_ERRORS" >&5
- as_fn_error $? "Package requirements (jansson >= 2.7) were not met:
+ as_fn_error $? "Package requirements (jansson >= 2.7) were not met:
$JANSSON_PKG_ERRORS
and JANSSON_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details." "$LINENO" 5
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
- { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+ { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
as_fn_error $? "The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
To get pkg-config, see <http://pkg-config.freedesktop.org/>.
See \`config.log' for more details" "$LINENO" 5; }
else
- JANSSON_CFLAGS=$pkg_cv_JANSSON_CFLAGS
- JANSSON_LIBS=$pkg_cv_JANSSON_LIBS
+ JANSSON_CFLAGS=$pkg_cv_JANSSON_CFLAGS
+ JANSSON_LIBS=$pkg_cv_JANSSON_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBOSINFO" >&5
-printf %s "checking for LIBOSINFO... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libosinfo-1.0" >&5
+printf %s "checking for libosinfo-1.0... " >&6; }
if test -n "$LIBOSINFO_CFLAGS"; then
pkg_cv_LIBOSINFO_CFLAGS="$LIBOSINFO_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBOSINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libosinfo-1.0" 2>&1`
+ LIBOSINFO_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libosinfo-1.0" 2>&1`
else
- LIBOSINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libosinfo-1.0" 2>&1`
+ LIBOSINFO_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libosinfo-1.0" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBOSINFO_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBOSINFO_PKG_ERRORS" >&5
- as_fn_error $? "Package requirements (libosinfo-1.0) were not met:
+ as_fn_error $? "Package requirements (libosinfo-1.0) were not met:
$LIBOSINFO_PKG_ERRORS
and LIBOSINFO_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details." "$LINENO" 5
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
- { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+ { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
as_fn_error $? "The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
To get pkg-config, see <http://pkg-config.freedesktop.org/>.
See \`config.log' for more details" "$LINENO" 5; }
else
- LIBOSINFO_CFLAGS=$pkg_cv_LIBOSINFO_CFLAGS
- LIBOSINFO_LIBS=$pkg_cv_LIBOSINFO_LIBS
+ LIBOSINFO_CFLAGS=$pkg_cv_LIBOSINFO_CFLAGS
+ LIBOSINFO_LIBS=$pkg_cv_LIBOSINFO_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
fi
+if test -n "$HWDATA_PKGDATADIR"; then
+ pkg_cv_HWDATA_PKGDATADIR="$HWDATA_PKGDATADIR"
+ elif test -n "$PKG_CONFIG"; then
+ if test -n "$PKG_CONFIG" && \
+ { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"hwdata\""; } >&5
+ ($PKG_CONFIG --exists --print-errors "hwdata") 2>&5
+ ac_status=$?
+ printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+ test $ac_status = 0; }; then
+ pkg_cv_HWDATA_PKGDATADIR=`$PKG_CONFIG --variable="pkgdatadir" "hwdata" 2>/dev/null`
+ test "x$?" != "x0" && pkg_failed=yes
+else
+ pkg_failed=yes
+fi
+ else
+ pkg_failed=untried
+fi
+HWDATA_PKGDATADIR=$pkg_cv_HWDATA_PKGDATADIR
+
+if test "x$HWDATA_PKGDATADIR" = x""
+then :
+
+fi
+
+
printf "%s\n"
printf "%s\n" "--- Checking for OCaml compiler and libguestfs bindings ---"
# libguestfs
fi
-ocaml_ver_str=4.04
+ocaml_ver_str=4.07
ocaml_min_major=4
-ocaml_min_minor=4
+ocaml_min_minor=7
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking if OCaml version >= $ocaml_ver_str" >&5
printf %s "checking if OCaml version >= $ocaml_ver_str... " >&6; }
ocaml_major="`echo $OCAMLVERSION | $AWK -F. '{print $1}'`"
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBCRYPT" >&5
-printf %s "checking for LIBCRYPT... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for libxcrypt" >&5
+printf %s "checking for libxcrypt... " >&6; }
if test -n "$LIBCRYPT_CFLAGS"; then
pkg_cv_LIBCRYPT_CFLAGS="$LIBCRYPT_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBCRYPT_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libxcrypt" 2>&1`
+ LIBCRYPT_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "libxcrypt" 2>&1`
else
- LIBCRYPT_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libxcrypt" 2>&1`
+ LIBCRYPT_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "libxcrypt" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBCRYPT_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBCRYPT_PKG_ERRORS" >&5
old_LIBS="$LIBS"
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
old_LIBS="$LIBS"
else
- LIBCRYPT_CFLAGS=$pkg_cv_LIBCRYPT_CFLAGS
- LIBCRYPT_LIBS=$pkg_cv_LIBCRYPT_LIBS
+ LIBCRYPT_CFLAGS=$pkg_cv_LIBCRYPT_CFLAGS
+ LIBCRYPT_LIBS=$pkg_cv_LIBCRYPT_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for LIBLZMA" >&5
-printf %s "checking for LIBLZMA... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for liblzma" >&5
+printf %s "checking for liblzma... " >&6; }
if test -n "$LIBLZMA_CFLAGS"; then
pkg_cv_LIBLZMA_CFLAGS="$LIBLZMA_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- LIBLZMA_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "liblzma" 2>&1`
+ LIBLZMA_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "liblzma" 2>&1`
else
- LIBLZMA_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "liblzma" 2>&1`
+ LIBLZMA_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "liblzma" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$LIBLZMA_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$LIBLZMA_PKG_ERRORS" >&5
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: liblzma not found, virt-builder will be slower" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: liblzma not found, virt-builder will be slower" >&5
printf "%s\n" "$as_me: WARNING: liblzma not found, virt-builder will be slower" >&2;}
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: liblzma not found, virt-builder will be slower" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: liblzma not found, virt-builder will be slower" >&5
printf "%s\n" "$as_me: WARNING: liblzma not found, virt-builder will be slower" >&2;}
else
- LIBLZMA_CFLAGS=$pkg_cv_LIBLZMA_CFLAGS
- LIBLZMA_LIBS=$pkg_cv_LIBLZMA_LIBS
+ LIBLZMA_CFLAGS=$pkg_cv_LIBLZMA_CFLAGS
+ LIBLZMA_LIBS=$pkg_cv_LIBLZMA_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
pkg_failed=no
-{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for BASH_COMPLETION" >&5
-printf %s "checking for BASH_COMPLETION... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for bash-completion >= 2.0" >&5
+printf %s "checking for bash-completion >= 2.0... " >&6; }
if test -n "$BASH_COMPLETION_CFLAGS"; then
pkg_cv_BASH_COMPLETION_CFLAGS="$BASH_COMPLETION_CFLAGS"
if test $pkg_failed = yes; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
_pkg_short_errors_supported=no
fi
if test $_pkg_short_errors_supported = yes; then
- BASH_COMPLETION_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "bash-completion >= 2.0" 2>&1`
+ BASH_COMPLETION_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "bash-completion >= 2.0" 2>&1`
else
- BASH_COMPLETION_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "bash-completion >= 2.0" 2>&1`
+ BASH_COMPLETION_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "bash-completion >= 2.0" 2>&1`
fi
- # Put the nasty error message in config.log where it belongs
- echo "$BASH_COMPLETION_PKG_ERRORS" >&5
+ # Put the nasty error message in config.log where it belongs
+ echo "$BASH_COMPLETION_PKG_ERRORS" >&5
bash_completion=no
printf "%s\n" "$as_me: WARNING: bash-completion not installed" >&2;}
elif test $pkg_failed = untried; then
- { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
printf "%s\n" "no" >&6; }
bash_completion=no
printf "%s\n" "$as_me: WARNING: bash-completion not installed" >&2;}
else
- BASH_COMPLETION_CFLAGS=$pkg_cv_BASH_COMPLETION_CFLAGS
- BASH_COMPLETION_LIBS=$pkg_cv_BASH_COMPLETION_LIBS
+ BASH_COMPLETION_CFLAGS=$pkg_cv_BASH_COMPLETION_CFLAGS
+ BASH_COMPLETION_LIBS=$pkg_cv_BASH_COMPLETION_LIBS
{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
printf "%s\n" "yes" >&6; }
ac_config_files="$ac_config_files win-reg/virt-win-reg"
-ac_config_files="$ac_config_files Makefile align/Makefile bash/Makefile builder/Makefile builder/libguestfs.conf builder/opensuse.conf builder/templates/Makefile builder/test-config/virt-builder/repos.d/test-index.conf builder/test-simplestreams/virt-builder/repos.d/cirros.conf builder/test-website/virt-builder/repos.d/libguestfs.conf cat/Makefile common/edit/Makefile common/mlcustomize/Makefile common/mldrivers/Makefile common/mlgettext/Makefile common/mlpcre/Makefile common/mlprogress/Makefile common/mlstdutils/Makefile common/mlstdutils/guestfs_config.ml common/mltools/Makefile common/mlutils/Makefile common/mlvisit/Makefile common/mlxml/Makefile common/options/Makefile common/parallel/Makefile common/progress/Makefile common/structs/Makefile common/utils/Makefile common/visit/Makefile common/windows/Makefile config.sh customize/Makefile docs/Makefile df/Makefile dib/Makefile diff/Makefile drivers/Makefile edit/Makefile format/Makefile get-kernel/Makefile gnulib/lib/Makefile inspector/Makefile make-fs/Makefile po-docs/Makefile po-docs/ja/Makefile po-docs/uk/Makefile po/Makefile resize/Makefile sparsify/Makefile sysprep/Makefile test-data/Makefile test-data/binaries/Makefile test-data/blank-disks/Makefile test-data/files/Makefile test-data/phony-guests/Makefile test-data/phony-guests/guests.xml win-reg/Makefile"
+ac_config_files="$ac_config_files Makefile align/Makefile bash/Makefile builder/Makefile builder/libguestfs.conf builder/opensuse.conf builder/templates/Makefile builder/test-config/virt-builder/repos.d/test-index.conf builder/test-simplestreams/virt-builder/repos.d/cirros.conf builder/test-website/virt-builder/repos.d/libguestfs.conf cat/Makefile common/edit/Makefile common/mlcustomize/Makefile common/mldrivers/Makefile common/mlgettext/Makefile common/mlpcre/Makefile common/mlprogress/Makefile common/mlstdutils/Makefile common/mlstdutils/guestfs_config.ml common/mltools/Makefile common/mlutils/Makefile common/mlvisit/Makefile common/mlxml/Makefile common/options/Makefile common/parallel/Makefile common/progress/Makefile common/structs/Makefile common/utils/Makefile common/visit/Makefile common/windows/Makefile config.sh customize/Makefile docs/Makefile df/Makefile diff/Makefile drivers/Makefile drivers/hwdata_config.ml edit/Makefile format/Makefile get-kernel/Makefile gnulib/lib/Makefile inspector/Makefile make-fs/Makefile po-docs/Makefile po-docs/ja/Makefile po-docs/uk/Makefile po/Makefile resize/Makefile sparsify/Makefile sysprep/Makefile test-data/Makefile test-data/binaries/Makefile test-data/blank-disks/Makefile test-data/files/Makefile test-data/phony-guests/Makefile test-data/phony-guests/guests.xml win-reg/Makefile"
cat >confcache <<\_ACEOF
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by guestfs-tools $as_me 1.50.1, which was
+This file was extended by guestfs-tools $as_me 1.52.0, which was
generated by GNU Autoconf 2.71. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config='$ac_cs_config_escaped'
ac_cs_version="\\
-guestfs-tools config.status 1.50.1
+guestfs-tools config.status 1.52.0
configured by $0, generated by GNU Autoconf 2.71,
with options \\"\$ac_cs_config\\"
"customize/Makefile") CONFIG_FILES="$CONFIG_FILES customize/Makefile" ;;
"docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;;
"df/Makefile") CONFIG_FILES="$CONFIG_FILES df/Makefile" ;;
- "dib/Makefile") CONFIG_FILES="$CONFIG_FILES dib/Makefile" ;;
"diff/Makefile") CONFIG_FILES="$CONFIG_FILES diff/Makefile" ;;
"drivers/Makefile") CONFIG_FILES="$CONFIG_FILES drivers/Makefile" ;;
+ "drivers/hwdata_config.ml") CONFIG_FILES="$CONFIG_FILES drivers/hwdata_config.ml" ;;
"edit/Makefile") CONFIG_FILES="$CONFIG_FILES edit/Makefile" ;;
"format/Makefile") CONFIG_FILES="$CONFIG_FILES format/Makefile" ;;
"get-kernel/Makefile") CONFIG_FILES="$CONFIG_FILES get-kernel/Makefile" ;;
echo "then you should check the preceding messages."
echo
echo "Please report bugs back to the mailing list:"
-echo "http://www.redhat.com/mailman/listinfo/libguestfs"
+echo "https://lists.libguestfs.org"
echo
echo "Next you should type 'make' to build the package,"
echo "then 'make check' to run the tests."
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-AC_INIT([guestfs-tools], [1.50.1])
+AC_INIT([guestfs-tools], [1.52.0])
dnl The common/ subdirectory assumes this. In libguestfs it contains
dnl the --with-extra parameter. Here we just define it to the version.
customize/Makefile
docs/Makefile
df/Makefile
- dib/Makefile
diff/Makefile
drivers/Makefile
+ drivers/hwdata_config.ml
edit/Makefile
format/Makefile
get-kernel/Makefile
echo "then you should check the preceding messages."
echo
echo "Please report bugs back to the mailing list:"
-echo "http://www.redhat.com/mailman/listinfo/libguestfs"
+echo "https://lists.libguestfs.org"
echo
echo "Next you should type 'make' to build the package,"
echo "then 'make check' to run the tests."
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
(* --append-line FILE:LINE *)
| `Chmod of string * string
(* --chmod PERMISSIONS:FILE *)
+ | `Chown of string * string * string
+ (* --chown UID:GID:PATH *)
| `CommandsFromFile of string
(* --commands-from-file FILENAME *)
| `Copy of string * string
(* --sm-unregister *)
| `SSHInject of string * Ssh_key.ssh_key_selector
(* --ssh-inject USER[:SELECTOR] *)
- | `Truncate of string
- (* --truncate FILE *)
- | `TruncateRecursive of string
- (* --truncate-recursive PATH *)
+ | `TarIn of string * string
+ (* --tar-in TARFILE:REMOTEDIR *)
| `Timezone of string
(* --timezone TIMEZONE *)
| `Touch of string
(* --touch FILE *)
+ | `Truncate of string
+ (* --truncate FILE *)
+ | `TruncateRecursive of string
+ (* --truncate-recursive PATH *)
| `UninstallPackages of string list
(* --uninstall PKG,PKG.. *)
| `Update
option_name in
let len = String.length arg in
String.sub arg 0 i, String.sub arg (i+1) (len-(i+1))
- in
- let split_string_list arg =
+ and split_string_triplet option_name arg =
+ match String.nsplit ~max:3 "," arg with
+ | [a; b; c] -> a, b, c
+ | _ ->
+ error (f_"invalid format for '--%s' parameter, see the man page")
+ option_name
+ and split_string_list arg =
String.nsplit "," arg
in
let split_links_list option_name arg =
s_"Change the permissions of a file"
),
Some "PERMISSIONS:FILE", "Change the permissions of C<FILE> to C<PERMISSIONS>.\n\nI<Note>: C<PERMISSIONS> by default would be decimal, unless you prefix\nit with C<0> to get octal, ie. use C<0700> not C<700>.";
+ (
+ [ L"chown" ],
+ Getopt.String (
+ s_"UID:GID:PATH",
+ fun s ->
+ let p = split_string_triplet "chown" s in
+ List.push_front (`Chown p) ops
+ ),
+ s_"Change the owner user and group ID of a file or directory"
+ ),
+ Some "UID:GID:PATH", "Change the owner user and group ID of a file or directory in the guest.\nNote:\n\n=over 4\n\n=item *\n\nOnly numeric UIDs and GIDs will work, and these may not be the same\ninside the guest as on the host.\n\n=item *\n\nThis will not work with Windows guests.\n\n=back\n\nFor example:\n\n virt-customize --chown '0:0:/var/log/audit.log'\n\nSee also: I<--upload>.";
(
[ L"commands-from-file" ],
Getopt.String (
),
Some "USER[:SELECTOR]", "Inject an ssh key so the given C<USER> will be able to log in over\nssh without supplying a password. The C<USER> must exist already\nin the guest.\n\nSee L<virt-builder(1)/SSH KEYS> for the format of\nthe C<SELECTOR> field.\n\nYou can have multiple I<--ssh-inject> options, for different users\nand also for more keys for each user.";
(
- [ L"truncate" ],
- Getopt.String (s_"FILE", fun s -> List.push_front (`Truncate s) ops),
- s_"Truncate a file to zero size"
- ),
- Some "FILE", "This command truncates C<FILE> to a zero-length file. The file must exist\nalready.";
- (
- [ L"truncate-recursive" ],
- Getopt.String (s_"PATH", fun s -> List.push_front (`TruncateRecursive s) ops),
- s_"Recursively truncate all files in directory"
+ [ L"tar-in" ],
+ Getopt.String (
+ s_"TARFILE:REMOTEDIR",
+ fun s ->
+ let p = split_string_pair "tar-in" s in
+ List.push_front (`TarIn p) ops
+ ),
+ s_"Copy local files or directories from a tarball into image"
),
- Some "PATH", "This command recursively truncates all files under C<PATH> to zero-length.";
+ Some "TARFILE:REMOTEDIR", "Copy local files or directories from a local tar file\ncalled C<TARFILE> into the disk image, placing them in the\ndirectory C<REMOTEDIR> (which must exist). Note that\nthe tar file must be uncompressed (F<.tar.gz> files will not work\nhere)";
(
[ L"timezone" ],
Getopt.String (s_"TIMEZONE", fun s -> List.push_front (`Timezone s) ops),
s_"Run touch on a file"
),
Some "FILE", "This command performs a L<touch(1)>-like operation on C<FILE>.";
+ (
+ [ L"truncate" ],
+ Getopt.String (s_"FILE", fun s -> List.push_front (`Truncate s) ops),
+ s_"Truncate a file to zero size"
+ ),
+ Some "FILE", "This command truncates C<FILE> to a zero-length file. The file must exist\nalready.";
+ (
+ [ L"truncate-recursive" ],
+ Getopt.String (s_"PATH", fun s -> List.push_front (`TruncateRecursive s) ops),
+ s_"Recursively truncate all files in directory"
+ ),
+ Some "PATH", "This command recursively truncates all files under C<PATH> to zero-length.";
(
[ L"uninstall" ],
Getopt.String (
(* --append-line FILE:LINE *)
| `Chmod of string * string
(* --chmod PERMISSIONS:FILE *)
+ | `Chown of string * string * string
+ (* --chown UID:GID:PATH *)
| `CommandsFromFile of string
(* --commands-from-file FILENAME *)
| `Copy of string * string
(* --sm-unregister *)
| `SSHInject of string * Ssh_key.ssh_key_selector
(* --ssh-inject USER[:SELECTOR] *)
- | `Truncate of string
- (* --truncate FILE *)
- | `TruncateRecursive of string
- (* --truncate-recursive PATH *)
+ | `TarIn of string * string
+ (* --tar-in TARFILE:REMOTEDIR *)
| `Timezone of string
(* --timezone TIMEZONE *)
| `Touch of string
(* --touch FILE *)
+ | `Truncate of string
+ (* --truncate FILE *)
+ | `TruncateRecursive of string
+ (* --truncate-recursive PATH *)
| `UninstallPackages of string list
(* --uninstall PKG,PKG.. *)
| `Update
let mode = if String.is_prefix mode "0" then "0o" ^ mode else mode in
g#chmod (int_of_string mode) path
+ | `Chown (uid, gid, path) ->
+ let uid, gid =
+ try int_of_string uid, int_of_string gid
+ with Failure _ ->
+ error (f_"--chown: could not parse numeric UID:GID from \
+ %s:%s") uid gid in
+
+ message (f_"Changing owner of %s to %d:%d") path uid gid;
+ g#chown uid gid path
+
| `Command cmd ->
message (f_"Running: %s") cmd;
do_run ~display:cmd cmd
) else
warning (f_"SSH key could not be injected for this type of guest")
+ | `TarIn (tarfile, remotedir) ->
+ message (f_"Unpack tar file: %s to %s") tarfile remotedir;
+ g#tar_in tarfile remotedir
+
| `Truncate path ->
message (f_"Truncating: %s") path;
g#truncate path
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
+++ /dev/null
-# libguestfs virt-dib tool
-# Copyright (C) 2015 Red Hat Inc.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-include $(top_srcdir)/subdir-rules.mk
-
-EXTRA_DIST = \
- $(SOURCES_MLI) $(SOURCES_ML) $(SOURCES_C) \
- test-virt-dib-docs.sh \
- virt-dib.pod
-
-SOURCES_MLI = \
- cmdline.mli \
- dib.mli \
- elements.mli \
- output_format.mli \
- $(patsubst %,output_format_%.mli,$(formats)) \
- utils.mli
-
-# Filenames output_format_<name>.ml in alphabetical order.
-formats = \
- docker \
- qcow2 \
- raw \
- squashfs \
- tar \
- tgz \
- vhd
-
-SOURCES_ML = \
- utils.ml \
- output_format.ml \
- cmdline.ml \
- elements.ml \
- $(patsubst %,output_format_%.ml,$(formats)) \
- dib.ml
-
-SOURCES_C = \
- dummy.c
-
-bin_PROGRAMS =
-
-if HAVE_OCAML
-
-bin_PROGRAMS += virt-dib
-
-virt_dib_SOURCES = $(SOURCES_C)
-virt_dib_CPPFLAGS = \
- -I. \
- -I$(top_builddir) \
- -I$(top_srcdir)/gnulib/lib -I$(top_builddir)/gnulib/lib \
- -I$(shell $(OCAMLC) -where) \
- -I$(top_srcdir)/gnulib/lib \
- -I$(top_srcdir)/common/utils \
- -I$(top_srcdir)/lib
-virt_dib_CFLAGS = \
- -pthread \
- $(WARN_CFLAGS) $(WERROR_CFLAGS)
-
-BOBJECTS = \
- $(SOURCES_ML:.ml=.cmo)
-XOBJECTS = $(BOBJECTS:.cmo=.cmx)
-
-OCAMLPACKAGES = \
- -package str,unix,guestfs \
- -I $(top_builddir)/common/utils/.libs \
- -I $(top_builddir)/gnulib/lib/.libs \
- -I $(top_builddir)/ocaml \
- -I $(top_builddir)/common/mlstdutils \
- -I $(top_builddir)/common/mlutils \
- -I $(top_builddir)/common/mlgettext \
- -I $(top_builddir)/common/mlpcre \
- -I $(top_builddir)/common/mltools
-if HAVE_OCAML_PKG_GETTEXT
-OCAMLPACKAGES += -package gettext-stub
-endif
-
-OCAMLCLIBS = \
- -pthread -lpthread \
- -lutils \
- $(LIBXML2_LIBS) \
- $(LIBGUESTFS_LIBS) \
- $(LIBINTL) \
- -lgnu
-
-OCAMLFLAGS = $(OCAML_FLAGS) $(OCAML_WARN_ERROR) -ccopt '$(CFLAGS)'
-
-if !HAVE_OCAMLOPT
-OBJECTS = $(BOBJECTS)
-else
-OBJECTS = $(XOBJECTS)
-endif
-
-OCAMLLINKFLAGS = \
- mlstdutils.$(MLARCHIVE) \
- mlguestfs.$(MLARCHIVE) \
- mlcutils.$(MLARCHIVE) \
- mlgettext.$(MLARCHIVE) \
- mlpcre.$(MLARCHIVE) \
- mltools.$(MLARCHIVE) \
- $(LINK_CUSTOM_OCAMLC_ONLY)
-
-virt_dib_DEPENDENCIES = \
- $(OBJECTS) \
- ../common/mlstdutils/mlstdutils.$(MLARCHIVE) \
- ../common/mlutils/mlcutils.$(MLARCHIVE) \
- ../common/mlgettext/mlgettext.$(MLARCHIVE) \
- ../common/mlpcre/mlpcre.$(MLARCHIVE) \
- ../common/mltools/mltools.$(MLARCHIVE) \
- $(top_builddir)/ocaml-link.sh
-virt_dib_LINK = \
- $(top_builddir)/ocaml-link.sh -cclib '$(OCAMLCLIBS)' -- \
- $(OCAMLFIND) $(BEST) $(OCAMLFLAGS) $(OCAMLPACKAGES) $(OCAMLLINKFLAGS) \
- $(OBJECTS) -o $@
-
-# The output_format_*.mli files are all empty and autogenerated.
-CLEANFILES += \
- $(patsubst %,output_format_%.mli,$(formats))
-
-output_format_%.mli:
- rm -f $@ $@-t
- echo '(* This file is generated by Makefile.am. *)' >> $@-t
- echo '(* Nothing is exported from output format modules. *)' >> $@-t
- mv $@-t $@
-
-# Tests.
-
-TESTS_ENVIRONMENT = $(top_builddir)/run --test
-
-TESTS = test-virt-dib-docs.sh
-
-# Manual pages and HTML files for the website.
-
-man_MANS = virt-dib.1
-
-noinst_DATA = $(top_builddir)/website/virt-dib.1.html
-
-virt-dib.1 $(top_builddir)/website/virt-dib.1.html: stamp-virt-dib.pod
-
-stamp-virt-dib.pod: virt-dib.pod
- $(PODWRAPPER) \
- --man virt-dib.1 \
- --html $(top_builddir)/website/virt-dib.1.html \
- --license GPLv2+ \
- --warning safe \
- $<
- touch $@
-
-# OCaml dependencies.
-.depend: $(SOURCES_MLI) $(SOURCES_ML)
- $(top_builddir)/ocaml-dep.sh $^
--include .depend
-
-endif
-
-.PHONY: docs
+++ /dev/null
-# Makefile.in generated by automake 1.16.5 from Makefile.am.
-# @configure_input@
-
-# Copyright (C) 1994-2021 Free Software Foundation, Inc.
-
-# This Makefile.in is free software; the Free Software Foundation
-# gives unlimited permission to copy and/or distribute it,
-# with or without modifications, as long as this notice is preserved.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
-# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
-# PARTICULAR PURPOSE.
-
-@SET_MAKE@
-
-# libguestfs virt-dib tool
-# Copyright (C) 2015 Red Hat Inc.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-# libguestfs
-# Copyright (C) 2009-2023 Red Hat Inc.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-# subdir-rules.mk should be included in every *subdirectory* Makefile.am.
-
-# libguestfs
-# Copyright (C) 2013 Red Hat Inc.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-# 'common-rules.mk' should be included in every Makefile.am.
-# cf. 'subdir-rules.mk'
-
-
-VPATH = @srcdir@
-am__is_gnu_make = { \
- if test -z '$(MAKELEVEL)'; then \
- false; \
- elif test -n '$(MAKE_HOST)'; then \
- true; \
- elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
- true; \
- else \
- false; \
- fi; \
-}
-am__make_running_with_option = \
- case $${target_option-} in \
- ?) ;; \
- *) echo "am__make_running_with_option: internal error: invalid" \
- "target option '$${target_option-}' specified" >&2; \
- exit 1;; \
- esac; \
- has_opt=no; \
- sane_makeflags=$$MAKEFLAGS; \
- if $(am__is_gnu_make); then \
- sane_makeflags=$$MFLAGS; \
- else \
- case $$MAKEFLAGS in \
- *\\[\ \ ]*) \
- bs=\\; \
- sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
- | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \
- esac; \
- fi; \
- skip_next=no; \
- strip_trailopt () \
- { \
- flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
- }; \
- for flg in $$sane_makeflags; do \
- test $$skip_next = yes && { skip_next=no; continue; }; \
- case $$flg in \
- *=*|--*) continue;; \
- -*I) strip_trailopt 'I'; skip_next=yes;; \
- -*I?*) strip_trailopt 'I';; \
- -*O) strip_trailopt 'O'; skip_next=yes;; \
- -*O?*) strip_trailopt 'O';; \
- -*l) strip_trailopt 'l'; skip_next=yes;; \
- -*l?*) strip_trailopt 'l';; \
- -[dEDm]) skip_next=yes;; \
- -[JT]) skip_next=yes;; \
- esac; \
- case $$flg in \
- *$$target_option*) has_opt=yes; break;; \
- esac; \
- done; \
- test $$has_opt = yes
-am__make_dryrun = (target_option=n; $(am__make_running_with_option))
-am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
-pkgdatadir = $(datadir)/@PACKAGE@
-pkgincludedir = $(includedir)/@PACKAGE@
-pkglibdir = $(libdir)/@PACKAGE@
-pkglibexecdir = $(libexecdir)/@PACKAGE@
-am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
-INSTALL_HEADER = $(INSTALL_DATA)
-transform = $(program_transform_name)
-NORMAL_INSTALL = :
-PRE_INSTALL = :
-POST_INSTALL = :
-NORMAL_UNINSTALL = :
-PRE_UNINSTALL = :
-POST_UNINSTALL = :
-build_triplet = @build@
-host_triplet = @host@
-bin_PROGRAMS = $(am__EXEEXT_1)
-@HAVE_OCAML_TRUE@am__append_1 = virt-dib
-@HAVE_OCAML_PKG_GETTEXT_TRUE@@HAVE_OCAML_TRUE@am__append_2 = -package gettext-stub
-
-# The output_format_*.mli files are all empty and autogenerated.
-@HAVE_OCAML_TRUE@am__append_3 = \
-@HAVE_OCAML_TRUE@ $(patsubst %,output_format_%.mli,$(formats))
-
-subdir = dib
-ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
-am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \
- $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \
- $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
- $(top_srcdir)/m4/ocaml.m4 $(top_srcdir)/m4/guestfs-progs.m4 \
- $(top_srcdir)/m4/guestfs-c.m4 \
- $(top_srcdir)/m4/guestfs-libraries.m4 \
- $(top_srcdir)/m4/guestfs-ocaml-gettext.m4 \
- $(top_srcdir)/m4/guestfs-ocaml.m4 \
- $(top_srcdir)/m4/guestfs-perl.m4 \
- $(top_srcdir)/m4/guestfs-misc-libraries.m4 \
- $(top_srcdir)/m4/guestfs-bash-completion.m4 \
- $(top_srcdir)/configure.ac
-am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
- $(ACLOCAL_M4)
-DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
-mkinstalldirs = $(install_sh) -d
-CONFIG_HEADER = $(top_builddir)/config.h
-CONFIG_CLEAN_FILES =
-CONFIG_CLEAN_VPATH_FILES =
-@HAVE_OCAML_TRUE@am__EXEEXT_1 = virt-dib$(EXEEXT)
-am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)"
-PROGRAMS = $(bin_PROGRAMS)
-am__virt_dib_SOURCES_DIST = dummy.c
-am__objects_1 = virt_dib-dummy.$(OBJEXT)
-@HAVE_OCAML_TRUE@am_virt_dib_OBJECTS = $(am__objects_1)
-virt_dib_OBJECTS = $(am_virt_dib_OBJECTS)
-virt_dib_LDADD = $(LDADD)
-AM_V_P = $(am__v_P_@AM_V@)
-am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
-am__v_P_0 = false
-am__v_P_1 = :
-AM_V_GEN = $(am__v_GEN_@AM_V@)
-am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
-am__v_GEN_0 = @echo " GEN " $@;
-am__v_GEN_1 =
-AM_V_at = $(am__v_at_@AM_V@)
-am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
-am__v_at_0 = @
-am__v_at_1 =
-DEFAULT_INCLUDES = -I.@am__isrc@ -I$(top_builddir)
-depcomp = $(SHELL) $(top_srcdir)/build-aux/depcomp
-am__maybe_remake_depfiles = depfiles
-am__depfiles_remade = ./$(DEPDIR)/virt_dib-dummy.Po
-am__mv = mv -f
-AM_V_lt = $(am__v_lt_@AM_V@)
-am__v_lt_ = $(am__v_lt_@AM_DEFAULT_V@)
-am__v_lt_0 = --silent
-am__v_lt_1 =
-COMPILE = $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) \
- $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)
-LTCOMPILE = $(LIBTOOL) $(AM_V_lt) --tag=CC $(AM_LIBTOOLFLAGS) \
- $(LIBTOOLFLAGS) --mode=compile $(CC) $(DEFS) \
- $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) \
- $(AM_CFLAGS) $(CFLAGS)
-AM_V_CC = $(am__v_CC_@AM_V@)
-am__v_CC_ = $(am__v_CC_@AM_DEFAULT_V@)
-am__v_CC_0 = @echo " CC " $@;
-am__v_CC_1 =
-CCLD = $(CC)
-LINK = $(LIBTOOL) $(AM_V_lt) --tag=CC $(AM_LIBTOOLFLAGS) \
- $(LIBTOOLFLAGS) --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) \
- $(AM_LDFLAGS) $(LDFLAGS) -o $@
-AM_V_CCLD = $(am__v_CCLD_@AM_V@)
-am__v_CCLD_ = $(am__v_CCLD_@AM_DEFAULT_V@)
-am__v_CCLD_0 = @echo " CCLD " $@;
-am__v_CCLD_1 =
-SOURCES = $(virt_dib_SOURCES)
-DIST_SOURCES = $(am__virt_dib_SOURCES_DIST)
-am__can_run_installinfo = \
- case $$AM_UPDATE_INFO_DIR in \
- n|no|NO) false;; \
- *) (install-info --version) >/dev/null 2>&1;; \
- esac
-am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
-am__vpath_adj = case $$p in \
- $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
- *) f=$$p;; \
- esac;
-am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
-am__install_max = 40
-am__nobase_strip_setup = \
- srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
-am__nobase_strip = \
- for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
-am__nobase_list = $(am__nobase_strip_setup); \
- for p in $$list; do echo "$$p $$p"; done | \
- sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
- $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
- if (++n[$$2] == $(am__install_max)) \
- { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
- END { for (dir in files) print dir, files[dir] }'
-am__base_list = \
- sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
- sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
-am__uninstall_files_from_dir = { \
- test -z "$$files" \
- || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
- || { echo " ( cd '$$dir' && rm -f" $$files ")"; \
- $(am__cd) "$$dir" && rm -f $$files; }; \
- }
-man1dir = $(mandir)/man1
-NROFF = nroff
-MANS = $(man_MANS)
-DATA = $(noinst_DATA)
-am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
-# Read a list of newline-separated strings from the standard input,
-# and print each of them once, without duplicates. Input order is
-# *not* preserved.
-am__uniquify_input = $(AWK) '\
- BEGIN { nonempty = 0; } \
- { items[$$0] = 1; nonempty = 1; } \
- END { if (nonempty) { for (i in items) print i; }; } \
-'
-# Make sure the list of sources is unique. This is necessary because,
-# e.g., the same source file might be shared among _SOURCES variables
-# for different programs/libraries.
-am__define_uniq_tagged_files = \
- list='$(am__tagged_files)'; \
- unique=`for i in $$list; do \
- if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
- done | $(am__uniquify_input)`
-am__tty_colors_dummy = \
- mgn= red= grn= lgn= blu= brg= std=; \
- am__color_tests=no
-am__tty_colors = { \
- $(am__tty_colors_dummy); \
- if test "X$(AM_COLOR_TESTS)" = Xno; then \
- am__color_tests=no; \
- elif test "X$(AM_COLOR_TESTS)" = Xalways; then \
- am__color_tests=yes; \
- elif test "X$$TERM" != Xdumb && { test -t 1; } 2>/dev/null; then \
- am__color_tests=yes; \
- fi; \
- if test $$am__color_tests = yes; then \
- red='\e[0;31m'; \
- grn='\e[0;32m'; \
- lgn='\e[1;32m'; \
- blu='\e[1;34m'; \
- mgn='\e[0;35m'; \
- brg='\e[1m'; \
- std='\e[m'; \
- fi; \
-}
-am__recheck_rx = ^[ ]*:recheck:[ ]*
-am__global_test_result_rx = ^[ ]*:global-test-result:[ ]*
-am__copy_in_global_log_rx = ^[ ]*:copy-in-global-log:[ ]*
-# A command that, given a newline-separated list of test names on the
-# standard input, print the name of the tests that are to be re-run
-# upon "make recheck".
-am__list_recheck_tests = $(AWK) '{ \
- recheck = 1; \
- while ((rc = (getline line < ($$0 ".trs"))) != 0) \
- { \
- if (rc < 0) \
- { \
- if ((getline line2 < ($$0 ".log")) < 0) \
- recheck = 0; \
- break; \
- } \
- else if (line ~ /$(am__recheck_rx)[nN][Oo]/) \
- { \
- recheck = 0; \
- break; \
- } \
- else if (line ~ /$(am__recheck_rx)[yY][eE][sS]/) \
- { \
- break; \
- } \
- }; \
- if (recheck) \
- print $$0; \
- close ($$0 ".trs"); \
- close ($$0 ".log"); \
-}'
-# A command that, given a newline-separated list of test names on the
-# standard input, create the global log from their .trs and .log files.
-am__create_global_log = $(AWK) ' \
-function fatal(msg) \
-{ \
- print "fatal: making $@: " msg | "cat >&2"; \
- exit 1; \
-} \
-function rst_section(header) \
-{ \
- print header; \
- len = length(header); \
- for (i = 1; i <= len; i = i + 1) \
- printf "="; \
- printf "\n\n"; \
-} \
-{ \
- copy_in_global_log = 1; \
- global_test_result = "RUN"; \
- while ((rc = (getline line < ($$0 ".trs"))) != 0) \
- { \
- if (rc < 0) \
- fatal("failed to read from " $$0 ".trs"); \
- if (line ~ /$(am__global_test_result_rx)/) \
- { \
- sub("$(am__global_test_result_rx)", "", line); \
- sub("[ ]*$$", "", line); \
- global_test_result = line; \
- } \
- else if (line ~ /$(am__copy_in_global_log_rx)[nN][oO]/) \
- copy_in_global_log = 0; \
- }; \
- if (copy_in_global_log) \
- { \
- rst_section(global_test_result ": " $$0); \
- while ((rc = (getline line < ($$0 ".log"))) != 0) \
- { \
- if (rc < 0) \
- fatal("failed to read from " $$0 ".log"); \
- print line; \
- }; \
- printf "\n"; \
- }; \
- close ($$0 ".trs"); \
- close ($$0 ".log"); \
-}'
-# Restructured Text title.
-am__rst_title = { sed 's/.*/ & /;h;s/./=/g;p;x;s/ *$$//;p;g' && echo; }
-# Solaris 10 'make', and several other traditional 'make' implementations,
-# pass "-e" to $(SHELL), and POSIX 2008 even requires this. Work around it
-# by disabling -e (using the XSI extension "set +e") if it's set.
-am__sh_e_setup = case $$- in *e*) set +e;; esac
-# Default flags passed to test drivers.
-am__common_driver_flags = \
- --color-tests "$$am__color_tests" \
- --enable-hard-errors "$$am__enable_hard_errors" \
- --expect-failure "$$am__expect_failure"
-# To be inserted before the command running the test. Creates the
-# directory for the log if needed. Stores in $dir the directory
-# containing $f, in $tst the test, in $log the log. Executes the
-# developer- defined test setup AM_TESTS_ENVIRONMENT (if any), and
-# passes TESTS_ENVIRONMENT. Set up options for the wrapper that
-# will run the test scripts (or their associated LOG_COMPILER, if
-# thy have one).
-am__check_pre = \
-$(am__sh_e_setup); \
-$(am__vpath_adj_setup) $(am__vpath_adj) \
-$(am__tty_colors); \
-srcdir=$(srcdir); export srcdir; \
-case "$@" in \
- */*) am__odir=`echo "./$@" | sed 's|/[^/]*$$||'`;; \
- *) am__odir=.;; \
-esac; \
-test "x$$am__odir" = x"." || test -d "$$am__odir" \
- || $(MKDIR_P) "$$am__odir" || exit $$?; \
-if test -f "./$$f"; then dir=./; \
-elif test -f "$$f"; then dir=; \
-else dir="$(srcdir)/"; fi; \
-tst=$$dir$$f; log='$@'; \
-if test -n '$(DISABLE_HARD_ERRORS)'; then \
- am__enable_hard_errors=no; \
-else \
- am__enable_hard_errors=yes; \
-fi; \
-case " $(XFAIL_TESTS) " in \
- *[\ \ ]$$f[\ \ ]* | *[\ \ ]$$dir$$f[\ \ ]*) \
- am__expect_failure=yes;; \
- *) \
- am__expect_failure=no;; \
-esac; \
-$(AM_TESTS_ENVIRONMENT) $(TESTS_ENVIRONMENT)
-# A shell command to get the names of the tests scripts with any registered
-# extension removed (i.e., equivalently, the names of the test logs, with
-# the '.log' extension removed). The result is saved in the shell variable
-# '$bases'. This honors runtime overriding of TESTS and TEST_LOGS. Sadly,
-# we cannot use something simpler, involving e.g., "$(TEST_LOGS:.log=)",
-# since that might cause problem with VPATH rewrites for suffix-less tests.
-# See also 'test-harness-vpath-rewrite.sh' and 'test-trs-basic.sh'.
-am__set_TESTS_bases = \
- bases='$(TEST_LOGS)'; \
- bases=`for i in $$bases; do echo $$i; done | sed 's/\.log$$//'`; \
- bases=`echo $$bases`
-AM_TESTSUITE_SUMMARY_HEADER = ' for $(PACKAGE_STRING)'
-RECHECK_LOGS = $(TEST_LOGS)
-AM_RECURSIVE_TARGETS = check recheck
-TEST_SUITE_LOG = test-suite.log
-TEST_EXTENSIONS = @EXEEXT@ .test
-LOG_COMPILE = $(LOG_COMPILER) $(AM_LOG_FLAGS) $(LOG_FLAGS)
-am__set_b = \
- case '$@' in \
- */*) \
- case '$*' in \
- */*) b='$*';; \
- *) b=`echo '$@' | sed 's/\.log$$//'`; \
- esac;; \
- *) \
- b='$*';; \
- esac
-am__test_logs1 = $(TESTS:=.log)
-am__test_logs2 = $(am__test_logs1:@EXEEXT@.log=.log)
-TEST_LOGS = $(am__test_logs2:.test.log=.log)
-TEST_LOG_DRIVER = $(SHELL) $(top_srcdir)/build-aux/test-driver
-TEST_LOG_COMPILE = $(TEST_LOG_COMPILER) $(AM_TEST_LOG_FLAGS) \
- $(TEST_LOG_FLAGS)
-am__DIST_COMMON = $(srcdir)/Makefile.in \
- $(top_srcdir)/build-aux/depcomp \
- $(top_srcdir)/build-aux/test-driver \
- $(top_srcdir)/common-rules.mk $(top_srcdir)/subdir-rules.mk
-DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
-ACLOCAL = @ACLOCAL@
-AMTAR = @AMTAR@
-AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
-AR = @AR@
-AUTOCONF = @AUTOCONF@
-AUTOHEADER = @AUTOHEADER@
-AUTOMAKE = @AUTOMAKE@
-AWK = @AWK@
-BASH_COMPLETIONS_DIR = @BASH_COMPLETIONS_DIR@
-BASH_COMPLETION_CFLAGS = @BASH_COMPLETION_CFLAGS@
-BASH_COMPLETION_LIBS = @BASH_COMPLETION_LIBS@
-CC = @CC@
-CCDEPMODE = @CCDEPMODE@
-CFLAGS = @CFLAGS@
-CPP = @CPP@
-CPPFLAGS = @CPPFLAGS@
-CSCOPE = @CSCOPE@
-CTAGS = @CTAGS@
-CYGPATH_W = @CYGPATH_W@
-DEFS = @DEFS@
-DEPDIR = @DEPDIR@
-DLLTOOL = @DLLTOOL@
-DSYMUTIL = @DSYMUTIL@
-DUMPBIN = @DUMPBIN@
-ECHO_C = @ECHO_C@
-ECHO_N = @ECHO_N@
-ECHO_T = @ECHO_T@
-EGREP = @EGREP@
-ETAGS = @ETAGS@
-EXEEXT = @EXEEXT@
-FGREP = @FGREP@
-GCC_VISIBILITY_HIDDEN = @GCC_VISIBILITY_HIDDEN@
-GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@
-GMSGFMT = @GMSGFMT@
-GMSGFMT_015 = @GMSGFMT_015@
-GREP = @GREP@
-INSTALL = @INSTALL@
-INSTALL_DATA = @INSTALL_DATA@
-INSTALL_PROGRAM = @INSTALL_PROGRAM@
-INSTALL_SCRIPT = @INSTALL_SCRIPT@
-INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
-INTLLIBS = @INTLLIBS@
-INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@
-JANSSON_CFLAGS = @JANSSON_CFLAGS@
-JANSSON_LIBS = @JANSSON_LIBS@
-LD = @LD@
-LDFLAGS = @LDFLAGS@
-LEX = @LEX@
-LEXLIB = @LEXLIB@
-LEX_OUTPUT_ROOT = @LEX_OUTPUT_ROOT@
-LIBCRYPT_CFLAGS = @LIBCRYPT_CFLAGS@
-LIBCRYPT_LIBS = @LIBCRYPT_LIBS@
-LIBGUESTFS_CFLAGS = @LIBGUESTFS_CFLAGS@
-LIBGUESTFS_LIBS = @LIBGUESTFS_LIBS@
-LIBICONV = @LIBICONV@
-LIBINTL = @LIBINTL@
-LIBLZMA_CFLAGS = @LIBLZMA_CFLAGS@
-LIBLZMA_LIBS = @LIBLZMA_LIBS@
-LIBOBJS = @LIBOBJS@
-LIBOSINFO_CFLAGS = @LIBOSINFO_CFLAGS@
-LIBOSINFO_LIBS = @LIBOSINFO_LIBS@
-LIBS = @LIBS@
-LIBTINFO_CFLAGS = @LIBTINFO_CFLAGS@
-LIBTINFO_LIBS = @LIBTINFO_LIBS@
-LIBTOOL = @LIBTOOL@
-LIBVIRT_CFLAGS = @LIBVIRT_CFLAGS@
-LIBVIRT_LIBS = @LIBVIRT_LIBS@
-LIBXML2_CFLAGS = @LIBXML2_CFLAGS@
-LIBXML2_LIBS = @LIBXML2_LIBS@
-LIPO = @LIPO@
-LN_S = @LN_S@
-LTLIBICONV = @LTLIBICONV@
-LTLIBINTL = @LTLIBINTL@
-LTLIBOBJS = @LTLIBOBJS@
-LT_SYS_LIBRARY_PATH = @LT_SYS_LIBRARY_PATH@
-MAKEINFO = @MAKEINFO@
-MANIFEST_TOOL = @MANIFEST_TOOL@
-MKDIR_P = @MKDIR_P@
-MKISOFS = @MKISOFS@
-MSGCAT = @MSGCAT@
-MSGFMT = @MSGFMT@
-MSGMERGE = @MSGMERGE@
-MSGMERGE_FOR_MSGFMT_OPTION = @MSGMERGE_FOR_MSGFMT_OPTION@
-NCURSES_CONFIG = @NCURSES_CONFIG@
-NM = @NM@
-NMEDIT = @NMEDIT@
-OBJDUMP = @OBJDUMP@
-OBJEXT = @OBJEXT@
-OCAMLBEST = @OCAMLBEST@
-OCAMLBUILD = @OCAMLBUILD@
-OCAMLC = @OCAMLC@
-OCAMLCDOTOPT = @OCAMLCDOTOPT@
-OCAMLDEP = @OCAMLDEP@
-OCAMLDOC = @OCAMLDOC@
-OCAMLFIND = @OCAMLFIND@
-OCAMLLIB = @OCAMLLIB@
-OCAMLMKLIB = @OCAMLMKLIB@
-OCAMLMKTOP = @OCAMLMKTOP@
-OCAMLOPT = @OCAMLOPT@
-OCAMLOPTDOTOPT = @OCAMLOPTDOTOPT@
-OCAMLVERSION = @OCAMLVERSION@
-OCAML_FLAGS = @OCAML_FLAGS@
-OCAML_GETTEXT = @OCAML_GETTEXT@
-OCAML_PKG_gettext = @OCAML_PKG_gettext@
-OCAML_PKG_guestfs = @OCAML_PKG_guestfs@
-OCAML_PKG_ounit2 = @OCAML_PKG_ounit2@
-OCAML_RUNTIME_VARIANT_PIC_OPTION = @OCAML_RUNTIME_VARIANT_PIC_OPTION@
-OCAML_WARN_ERROR = @OCAML_WARN_ERROR@
-OTOOL = @OTOOL@
-OTOOL64 = @OTOOL64@
-PACKAGE = @PACKAGE@
-PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
-PACKAGE_NAME = @PACKAGE_NAME@
-PACKAGE_STRING = @PACKAGE_STRING@
-PACKAGE_TARNAME = @PACKAGE_TARNAME@
-PACKAGE_URL = @PACKAGE_URL@
-PACKAGE_VERSION = @PACKAGE_VERSION@
-PACKAGE_VERSION_FULL = @PACKAGE_VERSION_FULL@
-PATH_SEPARATOR = @PATH_SEPARATOR@
-PCRE2_CFLAGS = @PCRE2_CFLAGS@
-PCRE2_CONFIG = @PCRE2_CONFIG@
-PCRE2_LIBS = @PCRE2_LIBS@
-PERL = @PERL@
-PKG_CONFIG = @PKG_CONFIG@
-PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
-PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
-PO4A_GETTEXTIZE = @PO4A_GETTEXTIZE@
-PO4A_TRANSLATE = @PO4A_TRANSLATE@
-PODWRAPPER = @PODWRAPPER@
-POSUB = @POSUB@
-RANLIB = @RANLIB@
-REALPATH = @REALPATH@
-SED = @SED@
-SET_MAKE = @SET_MAKE@
-SHELL = @SHELL@
-SQLITE3 = @SQLITE3@
-STRIP = @STRIP@
-SYSCONFDIR = @SYSCONFDIR@
-USE_NLS = @USE_NLS@
-VALGRIND = @VALGRIND@
-VERSION = @VERSION@
-VERSION_SCRIPT_FLAGS = @VERSION_SCRIPT_FLAGS@
-XGETTEXT = @XGETTEXT@
-XGETTEXT_015 = @XGETTEXT_015@
-XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@
-XMLLINT = @XMLLINT@
-XZCAT = @XZCAT@
-YACC = @YACC@
-YFLAGS = @YFLAGS@
-abs_builddir = @abs_builddir@
-abs_srcdir = @abs_srcdir@
-abs_top_builddir = @abs_top_builddir@
-abs_top_srcdir = @abs_top_srcdir@
-ac_ct_AR = @ac_ct_AR@
-ac_ct_CC = @ac_ct_CC@
-ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
-am__include = @am__include@
-am__leading_dot = @am__leading_dot@
-am__quote = @am__quote@
-am__tar = @am__tar@
-am__untar = @am__untar@
-bindir = @bindir@
-build = @build@
-build_alias = @build_alias@
-build_cpu = @build_cpu@
-build_os = @build_os@
-build_vendor = @build_vendor@
-builddir = @builddir@
-datadir = @datadir@
-datarootdir = @datarootdir@
-docdir = @docdir@
-dvidir = @dvidir@
-exec_prefix = @exec_prefix@
-host = @host@
-host_alias = @host_alias@
-host_cpu = @host_cpu@
-host_os = @host_os@
-host_vendor = @host_vendor@
-htmldir = @htmldir@
-includedir = @includedir@
-infodir = @infodir@
-install_sh = @install_sh@
-libdir = @libdir@
-libexecdir = @libexecdir@
-libvirt_ro_uri = @libvirt_ro_uri@
-localedir = @localedir@
-localstatedir = @localstatedir@
-mandir = @mandir@
-mkdir_p = @mkdir_p@
-oldincludedir = @oldincludedir@
-ounit_is_v2 = @ounit_is_v2@
-pdfdir = @pdfdir@
-prefix = @prefix@
-program_transform_name = @program_transform_name@
-psdir = @psdir@
-runstatedir = @runstatedir@
-sbindir = @sbindir@
-sharedstatedir = @sharedstatedir@
-srcdir = @srcdir@
-sysconfdir = @sysconfdir@
-target_alias = @target_alias@
-top_build_prefix = @top_build_prefix@
-top_builddir = @top_builddir@
-top_srcdir = @top_srcdir@
-
-# Files that should universally be removed by 'make clean'. Note if
-# there is any case in any subdirectory where a file should not be
-# removed by 'make clean', it should not be listed here!
-
-# Editor backup files
-
-# Patch original and reject files.
-
-# OCaml intermediate and generated files.
-
-# OCaml -annot files (used for displaying types in some IDEs).
-
-# OCaml oUnit generated files.
-
-# Manual pages - these are all generated from *.pod, so the
-# pages themselves should all be removed by 'make clean'.
-
-# Stamp files used when generating man pages.
-
-# Bindtests temporary files used in many language bindings.
-CLEANFILES = *~ *.bak *.orig *.rej *.cmi *.cmo *.cma *.cmx *.cmxa \
- dll*.so *.a *.annot oUnit-*.cache oUnit-*.log *.1 *.3 *.5 *.8 \
- stamp-*.pod bindtests.tmp $(am__append_3)
-
-# Files that should be universally removed by 'make distclean'.
-DISTCLEANFILES = .depend stamp-*
-
-# Special suffixes used by OCaml.
-
-# Special suffixes used by PO files.
-SUFFIXES = .cmo .cmi .cmx .ml .mli .mll .mly .po .gmo
-LOG_DRIVER = env $(SHELL) $(top_srcdir)/build-aux/guestfs-test-driver
-
-# Rules for building OCaml objects.
-# See also:
-# guestfs-hacking(1) section "HOW OCAML PROGRAMS ARE COMPILED AND LINKED"
-@HAVE_OCAMLOPT_FALSE@MLARCHIVE = cma
-@HAVE_OCAMLOPT_TRUE@MLARCHIVE = cmxa
-@HAVE_OCAMLOPT_FALSE@LINK_CUSTOM_OCAMLC_ONLY = -custom
-@HAVE_OCAMLOPT_FALSE@BEST = c
-@HAVE_OCAMLOPT_TRUE@BEST = opt
-
-# custom silent rules
-guestfs_am_v_ocamlc = $(guestfs_am_v_ocamlc_@AM_V@)
-guestfs_am_v_ocamlc_ = $(guestfs_am_v_ocamlc_@AM_DEFAULT_V@)
-guestfs_am_v_ocamlc_0 = @echo " OCAMLC " $@;
-guestfs_am_v_ocamlcmi = $(guestfs_am_v_ocamlcmi_@AM_V@)
-guestfs_am_v_ocamlcmi_ = $(guestfs_am_v_ocamlcmi_@AM_DEFAULT_V@)
-guestfs_am_v_ocamlcmi_0 = @echo " OCAMLCMI" $@;
-guestfs_am_v_ocamlopt = $(guestfs_am_v_ocamlopt_@AM_V@)
-guestfs_am_v_ocamlopt_ = $(guestfs_am_v_ocamlopt_@AM_DEFAULT_V@)
-guestfs_am_v_ocamlopt_0 = @echo " OCAMLOPT" $@;
-guestfs_am_v_javac = $(guestfs_am_v_javac_@AM_V@)
-guestfs_am_v_javac_ = $(guestfs_am_v_javac_@AM_DEFAULT_V@)
-guestfs_am_v_javac_0 = @echo " JAVAC " $@;
-guestfs_am_v_erlc = $(guestfs_am_v_erlc_@AM_V@)
-guestfs_am_v_erlc_ = $(guestfs_am_v_erlc_@AM_DEFAULT_V@)
-guestfs_am_v_erlc_0 = @echo " ERLC " $@;
-guestfs_am_v_podwrapper = $(guestfs_am_v_podwrapper_@AM_V@)
-guestfs_am_v_podwrapper_ = $(guestfs_am_v_podwrapper_@AM_DEFAULT_V@)
-guestfs_am_v_podwrapper_0 = @echo " POD " $@;
-guestfs_am_v_jar = $(guestfs_am_v_jar_@AM_V@)
-guestfs_am_v_jar_ = $(guestfs_am_v_jar_@AM_DEFAULT_V@)
-guestfs_am_v_jar_0 = @echo " JAR " $@;
-guestfs_am_v_po4a_translate = $(guestfs_am_v_po4a_translate_@AM_V@)
-guestfs_am_v_po4a_translate_ = $(guestfs_am_v_po4a_translate_@AM_DEFAULT_V@)
-guestfs_am_v_po4a_translate_0 = @echo " PO4A-T " $@;
-EXTRA_DIST = \
- $(SOURCES_MLI) $(SOURCES_ML) $(SOURCES_C) \
- test-virt-dib-docs.sh \
- virt-dib.pod
-
-SOURCES_MLI = \
- cmdline.mli \
- dib.mli \
- elements.mli \
- output_format.mli \
- $(patsubst %,output_format_%.mli,$(formats)) \
- utils.mli
-
-
-# Filenames output_format_<name>.ml in alphabetical order.
-formats = \
- docker \
- qcow2 \
- raw \
- squashfs \
- tar \
- tgz \
- vhd
-
-SOURCES_ML = \
- utils.ml \
- output_format.ml \
- cmdline.ml \
- elements.ml \
- $(patsubst %,output_format_%.ml,$(formats)) \
- dib.ml
-
-SOURCES_C = \
- dummy.c
-
-@HAVE_OCAML_TRUE@virt_dib_SOURCES = $(SOURCES_C)
-@HAVE_OCAML_TRUE@virt_dib_CPPFLAGS = \
-@HAVE_OCAML_TRUE@ -I. \
-@HAVE_OCAML_TRUE@ -I$(top_builddir) \
-@HAVE_OCAML_TRUE@ -I$(top_srcdir)/gnulib/lib -I$(top_builddir)/gnulib/lib \
-@HAVE_OCAML_TRUE@ -I$(shell $(OCAMLC) -where) \
-@HAVE_OCAML_TRUE@ -I$(top_srcdir)/gnulib/lib \
-@HAVE_OCAML_TRUE@ -I$(top_srcdir)/common/utils \
-@HAVE_OCAML_TRUE@ -I$(top_srcdir)/lib
-
-@HAVE_OCAML_TRUE@virt_dib_CFLAGS = \
-@HAVE_OCAML_TRUE@ -pthread \
-@HAVE_OCAML_TRUE@ $(WARN_CFLAGS) $(WERROR_CFLAGS)
-
-@HAVE_OCAML_TRUE@BOBJECTS = \
-@HAVE_OCAML_TRUE@ $(SOURCES_ML:.ml=.cmo)
-
-@HAVE_OCAML_TRUE@XOBJECTS = $(BOBJECTS:.cmo=.cmx)
-@HAVE_OCAML_TRUE@OCAMLPACKAGES = -package str,unix,guestfs -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/utils/.libs -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/gnulib/lib/.libs -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/ocaml -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/mlstdutils -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/mlutils -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/mlgettext -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/mlpcre -I \
-@HAVE_OCAML_TRUE@ $(top_builddir)/common/mltools \
-@HAVE_OCAML_TRUE@ $(am__append_2)
-@HAVE_OCAML_TRUE@OCAMLCLIBS = \
-@HAVE_OCAML_TRUE@ -pthread -lpthread \
-@HAVE_OCAML_TRUE@ -lutils \
-@HAVE_OCAML_TRUE@ $(LIBXML2_LIBS) \
-@HAVE_OCAML_TRUE@ $(LIBGUESTFS_LIBS) \
-@HAVE_OCAML_TRUE@ $(LIBINTL) \
-@HAVE_OCAML_TRUE@ -lgnu
-
-@HAVE_OCAML_TRUE@OCAMLFLAGS = $(OCAML_FLAGS) $(OCAML_WARN_ERROR) -ccopt '$(CFLAGS)'
-@HAVE_OCAMLOPT_FALSE@@HAVE_OCAML_TRUE@OBJECTS = $(BOBJECTS)
-@HAVE_OCAMLOPT_TRUE@@HAVE_OCAML_TRUE@OBJECTS = $(XOBJECTS)
-@HAVE_OCAML_TRUE@OCAMLLINKFLAGS = \
-@HAVE_OCAML_TRUE@ mlstdutils.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ mlguestfs.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ mlcutils.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ mlgettext.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ mlpcre.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ mltools.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ $(LINK_CUSTOM_OCAMLC_ONLY)
-
-@HAVE_OCAML_TRUE@virt_dib_DEPENDENCIES = \
-@HAVE_OCAML_TRUE@ $(OBJECTS) \
-@HAVE_OCAML_TRUE@ ../common/mlstdutils/mlstdutils.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ ../common/mlutils/mlcutils.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ ../common/mlgettext/mlgettext.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ ../common/mlpcre/mlpcre.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ ../common/mltools/mltools.$(MLARCHIVE) \
-@HAVE_OCAML_TRUE@ $(top_builddir)/ocaml-link.sh
-
-@HAVE_OCAML_TRUE@virt_dib_LINK = \
-@HAVE_OCAML_TRUE@ $(top_builddir)/ocaml-link.sh -cclib '$(OCAMLCLIBS)' -- \
-@HAVE_OCAML_TRUE@ $(OCAMLFIND) $(BEST) $(OCAMLFLAGS) $(OCAMLPACKAGES) $(OCAMLLINKFLAGS) \
-@HAVE_OCAML_TRUE@ $(OBJECTS) -o $@
-
-
-# Tests.
-@HAVE_OCAML_TRUE@TESTS_ENVIRONMENT = $(top_builddir)/run --test
-@HAVE_OCAML_TRUE@TESTS = test-virt-dib-docs.sh
-
-# Manual pages and HTML files for the website.
-@HAVE_OCAML_TRUE@man_MANS = virt-dib.1
-@HAVE_OCAML_TRUE@noinst_DATA = $(top_builddir)/website/virt-dib.1.html
-all: all-am
-
-.SUFFIXES:
-.SUFFIXES: .cmo .cmi .cmx .ml .mli .mll .mly .po .gmo .c .lo .log .o .obj .test .test$(EXEEXT) .trs
-$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(top_srcdir)/subdir-rules.mk $(top_srcdir)/common-rules.mk $(am__configure_deps)
- @for dep in $?; do \
- case '$(am__configure_deps)' in \
- *$$dep*) \
- ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
- && { if test -f $@; then exit 0; else break; fi; }; \
- exit 1;; \
- esac; \
- done; \
- echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign dib/Makefile'; \
- $(am__cd) $(top_srcdir) && \
- $(AUTOMAKE) --foreign dib/Makefile
-Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
- @case '$?' in \
- *config.status*) \
- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
- *) \
- echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles)'; \
- cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles);; \
- esac;
-$(top_srcdir)/subdir-rules.mk $(top_srcdir)/common-rules.mk $(am__empty):
-
-$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
-
-$(top_srcdir)/configure: $(am__configure_deps)
- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
-$(ACLOCAL_M4): $(am__aclocal_m4_deps)
- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
-$(am__aclocal_m4_deps):
-install-binPROGRAMS: $(bin_PROGRAMS)
- @$(NORMAL_INSTALL)
- @list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
- if test -n "$$list"; then \
- echo " $(MKDIR_P) '$(DESTDIR)$(bindir)'"; \
- $(MKDIR_P) "$(DESTDIR)$(bindir)" || exit 1; \
- fi; \
- for p in $$list; do echo "$$p $$p"; done | \
- sed 's/$(EXEEXT)$$//' | \
- while read p p1; do if test -f $$p \
- || test -f $$p1 \
- ; then echo "$$p"; echo "$$p"; else :; fi; \
- done | \
- sed -e 'p;s,.*/,,;n;h' \
- -e 's|.*|.|' \
- -e 'p;x;s,.*/,,;s/$(EXEEXT)$$//;$(transform);s/$$/$(EXEEXT)/' | \
- sed 'N;N;N;s,\n, ,g' | \
- $(AWK) 'BEGIN { files["."] = ""; dirs["."] = 1 } \
- { d=$$3; if (dirs[d] != 1) { print "d", d; dirs[d] = 1 } \
- if ($$2 == $$4) files[d] = files[d] " " $$1; \
- else { print "f", $$3 "/" $$4, $$1; } } \
- END { for (d in files) print "f", d, files[d] }' | \
- while read type dir files; do \
- if test "$$dir" = .; then dir=; else dir=/$$dir; fi; \
- test -z "$$files" || { \
- echo " $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files '$(DESTDIR)$(bindir)$$dir'"; \
- $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files "$(DESTDIR)$(bindir)$$dir" || exit $$?; \
- } \
- ; done
-
-uninstall-binPROGRAMS:
- @$(NORMAL_UNINSTALL)
- @list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
- files=`for p in $$list; do echo "$$p"; done | \
- sed -e 'h;s,^.*/,,;s/$(EXEEXT)$$//;$(transform)' \
- -e 's/$$/$(EXEEXT)/' \
- `; \
- test -n "$$list" || exit 0; \
- echo " ( cd '$(DESTDIR)$(bindir)' && rm -f" $$files ")"; \
- cd "$(DESTDIR)$(bindir)" && rm -f $$files
-
-clean-binPROGRAMS:
- @list='$(bin_PROGRAMS)'; test -n "$$list" || exit 0; \
- echo " rm -f" $$list; \
- rm -f $$list || exit $$?; \
- test -n "$(EXEEXT)" || exit 0; \
- list=`for p in $$list; do echo "$$p"; done | sed 's/$(EXEEXT)$$//'`; \
- echo " rm -f" $$list; \
- rm -f $$list
-
-virt-dib$(EXEEXT): $(virt_dib_OBJECTS) $(virt_dib_DEPENDENCIES) $(EXTRA_virt_dib_DEPENDENCIES)
- @rm -f virt-dib$(EXEEXT)
- $(AM_V_GEN)$(virt_dib_LINK) $(virt_dib_OBJECTS) $(virt_dib_LDADD) $(LIBS)
-
-mostlyclean-compile:
- -rm -f *.$(OBJEXT)
-
-distclean-compile:
- -rm -f *.tab.c
-
-@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/virt_dib-dummy.Po@am__quote@ # am--include-marker
-
-$(am__depfiles_remade):
- @$(MKDIR_P) $(@D)
- @echo '# dummy' >$@-t && $(am__mv) $@-t $@
-
-am--depfiles: $(am__depfiles_remade)
-
-.c.o:
-@am__fastdepCC_TRUE@ $(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.o$$||'`;\
-@am__fastdepCC_TRUE@ $(COMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ $< &&\
-@am__fastdepCC_TRUE@ $(am__mv) $$depbase.Tpo $$depbase.Po
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $<
-
-.c.obj:
-@am__fastdepCC_TRUE@ $(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.obj$$||'`;\
-@am__fastdepCC_TRUE@ $(COMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ `$(CYGPATH_W) '$<'` &&\
-@am__fastdepCC_TRUE@ $(am__mv) $$depbase.Tpo $$depbase.Po
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'`
-
-.c.lo:
-@am__fastdepCC_TRUE@ $(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.lo$$||'`;\
-@am__fastdepCC_TRUE@ $(LTCOMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ $< &&\
-@am__fastdepCC_TRUE@ $(am__mv) $$depbase.Tpo $$depbase.Plo
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='$<' object='$@' libtool=yes @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(LTCOMPILE) -c -o $@ $<
-
-virt_dib-dummy.o: dummy.c
-@am__fastdepCC_TRUE@ $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(virt_dib_CPPFLAGS) $(CPPFLAGS) $(virt_dib_CFLAGS) $(CFLAGS) -MT virt_dib-dummy.o -MD -MP -MF $(DEPDIR)/virt_dib-dummy.Tpo -c -o virt_dib-dummy.o `test -f 'dummy.c' || echo '$(srcdir)/'`dummy.c
-@am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/virt_dib-dummy.Tpo $(DEPDIR)/virt_dib-dummy.Po
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='dummy.c' object='virt_dib-dummy.o' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(virt_dib_CPPFLAGS) $(CPPFLAGS) $(virt_dib_CFLAGS) $(CFLAGS) -c -o virt_dib-dummy.o `test -f 'dummy.c' || echo '$(srcdir)/'`dummy.c
-
-virt_dib-dummy.obj: dummy.c
-@am__fastdepCC_TRUE@ $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(virt_dib_CPPFLAGS) $(CPPFLAGS) $(virt_dib_CFLAGS) $(CFLAGS) -MT virt_dib-dummy.obj -MD -MP -MF $(DEPDIR)/virt_dib-dummy.Tpo -c -o virt_dib-dummy.obj `if test -f 'dummy.c'; then $(CYGPATH_W) 'dummy.c'; else $(CYGPATH_W) '$(srcdir)/dummy.c'; fi`
-@am__fastdepCC_TRUE@ $(AM_V_at)$(am__mv) $(DEPDIR)/virt_dib-dummy.Tpo $(DEPDIR)/virt_dib-dummy.Po
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ $(AM_V_CC)source='dummy.c' object='virt_dib-dummy.obj' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCC_FALSE@ $(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(virt_dib_CPPFLAGS) $(CPPFLAGS) $(virt_dib_CFLAGS) $(CFLAGS) -c -o virt_dib-dummy.obj `if test -f 'dummy.c'; then $(CYGPATH_W) 'dummy.c'; else $(CYGPATH_W) '$(srcdir)/dummy.c'; fi`
-
-mostlyclean-libtool:
- -rm -f *.lo
-
-clean-libtool:
- -rm -rf .libs _libs
-install-man1: $(man_MANS)
- @$(NORMAL_INSTALL)
- @list1=''; \
- list2='$(man_MANS)'; \
- test -n "$(man1dir)" \
- && test -n "`echo $$list1$$list2`" \
- || exit 0; \
- echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \
- $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \
- { for i in $$list1; do echo "$$i"; done; \
- if test -n "$$list2"; then \
- for i in $$list2; do echo "$$i"; done \
- | sed -n '/\.1[a-z]*$$/p'; \
- fi; \
- } | while read p; do \
- if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
- echo "$$d$$p"; echo "$$p"; \
- done | \
- sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
- -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
- sed 'N;N;s,\n, ,g' | { \
- list=; while read file base inst; do \
- if test "$$base" = "$$inst"; then list="$$list $$file"; else \
- echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \
- $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \
- fi; \
- done; \
- for i in $$list; do echo "$$i"; done | $(am__base_list) | \
- while read files; do \
- test -z "$$files" || { \
- echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \
- $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \
- done; }
-
-uninstall-man1:
- @$(NORMAL_UNINSTALL)
- @list=''; test -n "$(man1dir)" || exit 0; \
- files=`{ for i in $$list; do echo "$$i"; done; \
- l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
- sed -n '/\.1[a-z]*$$/p'; \
- } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
- -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
- dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir)
-
-ID: $(am__tagged_files)
- $(am__define_uniq_tagged_files); mkid -fID $$unique
-tags: tags-am
-TAGS: tags
-
-tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
- set x; \
- here=`pwd`; \
- $(am__define_uniq_tagged_files); \
- shift; \
- if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \
- test -n "$$unique" || unique=$$empty_fix; \
- if test $$# -gt 0; then \
- $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
- "$$@" $$unique; \
- else \
- $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
- $$unique; \
- fi; \
- fi
-ctags: ctags-am
-
-CTAGS: ctags
-ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
- $(am__define_uniq_tagged_files); \
- test -z "$(CTAGS_ARGS)$$unique" \
- || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
- $$unique
-
-GTAGS:
- here=`$(am__cd) $(top_builddir) && pwd` \
- && $(am__cd) $(top_srcdir) \
- && gtags -i $(GTAGS_ARGS) "$$here"
-cscopelist: cscopelist-am
-
-cscopelist-am: $(am__tagged_files)
- list='$(am__tagged_files)'; \
- case "$(srcdir)" in \
- [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \
- *) sdir=$(subdir)/$(srcdir) ;; \
- esac; \
- for i in $$list; do \
- if test -f "$$i"; then \
- echo "$(subdir)/$$i"; \
- else \
- echo "$$sdir/$$i"; \
- fi; \
- done >> $(top_builddir)/cscope.files
-
-distclean-tags:
- -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
-
-# Recover from deleted '.trs' file; this should ensure that
-# "rm -f foo.log; make foo.trs" re-run 'foo.test', and re-create
-# both 'foo.log' and 'foo.trs'. Break the recipe in two subshells
-# to avoid problems with "make -n".
-.log.trs:
- rm -f $< $@
- $(MAKE) $(AM_MAKEFLAGS) $<
-
-# Leading 'am--fnord' is there to ensure the list of targets does not
-# expand to empty, as could happen e.g. with make check TESTS=''.
-am--fnord $(TEST_LOGS) $(TEST_LOGS:.log=.trs): $(am__force_recheck)
-am--force-recheck:
- @:
-
-$(TEST_SUITE_LOG): $(TEST_LOGS)
- @$(am__set_TESTS_bases); \
- am__f_ok () { test -f "$$1" && test -r "$$1"; }; \
- redo_bases=`for i in $$bases; do \
- am__f_ok $$i.trs && am__f_ok $$i.log || echo $$i; \
- done`; \
- if test -n "$$redo_bases"; then \
- redo_logs=`for i in $$redo_bases; do echo $$i.log; done`; \
- redo_results=`for i in $$redo_bases; do echo $$i.trs; done`; \
- if $(am__make_dryrun); then :; else \
- rm -f $$redo_logs && rm -f $$redo_results || exit 1; \
- fi; \
- fi; \
- if test -n "$$am__remaking_logs"; then \
- echo "fatal: making $(TEST_SUITE_LOG): possible infinite" \
- "recursion detected" >&2; \
- elif test -n "$$redo_logs"; then \
- am__remaking_logs=yes $(MAKE) $(AM_MAKEFLAGS) $$redo_logs; \
- fi; \
- if $(am__make_dryrun); then :; else \
- st=0; \
- errmsg="fatal: making $(TEST_SUITE_LOG): failed to create"; \
- for i in $$redo_bases; do \
- test -f $$i.trs && test -r $$i.trs \
- || { echo "$$errmsg $$i.trs" >&2; st=1; }; \
- test -f $$i.log && test -r $$i.log \
- || { echo "$$errmsg $$i.log" >&2; st=1; }; \
- done; \
- test $$st -eq 0 || exit 1; \
- fi
- @$(am__sh_e_setup); $(am__tty_colors); $(am__set_TESTS_bases); \
- ws='[ ]'; \
- results=`for b in $$bases; do echo $$b.trs; done`; \
- test -n "$$results" || results=/dev/null; \
- all=` grep "^$$ws*:test-result:" $$results | wc -l`; \
- pass=` grep "^$$ws*:test-result:$$ws*PASS" $$results | wc -l`; \
- fail=` grep "^$$ws*:test-result:$$ws*FAIL" $$results | wc -l`; \
- skip=` grep "^$$ws*:test-result:$$ws*SKIP" $$results | wc -l`; \
- xfail=`grep "^$$ws*:test-result:$$ws*XFAIL" $$results | wc -l`; \
- xpass=`grep "^$$ws*:test-result:$$ws*XPASS" $$results | wc -l`; \
- error=`grep "^$$ws*:test-result:$$ws*ERROR" $$results | wc -l`; \
- if test `expr $$fail + $$xpass + $$error` -eq 0; then \
- success=true; \
- else \
- success=false; \
- fi; \
- br='==================='; br=$$br$$br$$br$$br; \
- result_count () \
- { \
- if test x"$$1" = x"--maybe-color"; then \
- maybe_colorize=yes; \
- elif test x"$$1" = x"--no-color"; then \
- maybe_colorize=no; \
- else \
- echo "$@: invalid 'result_count' usage" >&2; exit 4; \
- fi; \
- shift; \
- desc=$$1 count=$$2; \
- if test $$maybe_colorize = yes && test $$count -gt 0; then \
- color_start=$$3 color_end=$$std; \
- else \
- color_start= color_end=; \
- fi; \
- echo "$${color_start}# $$desc $$count$${color_end}"; \
- }; \
- create_testsuite_report () \
- { \
- result_count $$1 "TOTAL:" $$all "$$brg"; \
- result_count $$1 "PASS: " $$pass "$$grn"; \
- result_count $$1 "SKIP: " $$skip "$$blu"; \
- result_count $$1 "XFAIL:" $$xfail "$$lgn"; \
- result_count $$1 "FAIL: " $$fail "$$red"; \
- result_count $$1 "XPASS:" $$xpass "$$red"; \
- result_count $$1 "ERROR:" $$error "$$mgn"; \
- }; \
- { \
- echo "$(PACKAGE_STRING): $(subdir)/$(TEST_SUITE_LOG)" | \
- $(am__rst_title); \
- create_testsuite_report --no-color; \
- echo; \
- echo ".. contents:: :depth: 2"; \
- echo; \
- for b in $$bases; do echo $$b; done \
- | $(am__create_global_log); \
- } >$(TEST_SUITE_LOG).tmp || exit 1; \
- mv $(TEST_SUITE_LOG).tmp $(TEST_SUITE_LOG); \
- if $$success; then \
- col="$$grn"; \
- else \
- col="$$red"; \
- test x"$$VERBOSE" = x || cat $(TEST_SUITE_LOG); \
- fi; \
- echo "$${col}$$br$${std}"; \
- echo "$${col}Testsuite summary"$(AM_TESTSUITE_SUMMARY_HEADER)"$${std}"; \
- echo "$${col}$$br$${std}"; \
- create_testsuite_report --maybe-color; \
- echo "$$col$$br$$std"; \
- if $$success; then :; else \
- echo "$${col}See $(subdir)/$(TEST_SUITE_LOG)$${std}"; \
- if test -n "$(PACKAGE_BUGREPORT)"; then \
- echo "$${col}Please report to $(PACKAGE_BUGREPORT)$${std}"; \
- fi; \
- echo "$$col$$br$$std"; \
- fi; \
- $$success || exit 1
-
-check-TESTS:
- @list='$(RECHECK_LOGS)'; test -z "$$list" || rm -f $$list
- @list='$(RECHECK_LOGS:.log=.trs)'; test -z "$$list" || rm -f $$list
- @test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
- @set +e; $(am__set_TESTS_bases); \
- log_list=`for i in $$bases; do echo $$i.log; done`; \
- trs_list=`for i in $$bases; do echo $$i.trs; done`; \
- log_list=`echo $$log_list`; trs_list=`echo $$trs_list`; \
- $(MAKE) $(AM_MAKEFLAGS) $(TEST_SUITE_LOG) TEST_LOGS="$$log_list"; \
- exit $$?;
-recheck: all
- @test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
- @set +e; $(am__set_TESTS_bases); \
- bases=`for i in $$bases; do echo $$i; done \
- | $(am__list_recheck_tests)` || exit 1; \
- log_list=`for i in $$bases; do echo $$i.log; done`; \
- log_list=`echo $$log_list`; \
- $(MAKE) $(AM_MAKEFLAGS) $(TEST_SUITE_LOG) \
- am__force_recheck=am--force-recheck \
- TEST_LOGS="$$log_list"; \
- exit $$?
-test-virt-dib-docs.sh.log: test-virt-dib-docs.sh
- @p='test-virt-dib-docs.sh'; \
- b='test-virt-dib-docs.sh'; \
- $(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
- --log-file $$b.log --trs-file $$b.trs \
- $(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
- "$$tst" $(AM_TESTS_FD_REDIRECT)
-.test.log:
- @p='$<'; \
- $(am__set_b); \
- $(am__check_pre) $(TEST_LOG_DRIVER) --test-name "$$f" \
- --log-file $$b.log --trs-file $$b.trs \
- $(am__common_driver_flags) $(AM_TEST_LOG_DRIVER_FLAGS) $(TEST_LOG_DRIVER_FLAGS) -- $(TEST_LOG_COMPILE) \
- "$$tst" $(AM_TESTS_FD_REDIRECT)
-@am__EXEEXT_TRUE@.test$(EXEEXT).log:
-@am__EXEEXT_TRUE@ @p='$<'; \
-@am__EXEEXT_TRUE@ $(am__set_b); \
-@am__EXEEXT_TRUE@ $(am__check_pre) $(TEST_LOG_DRIVER) --test-name "$$f" \
-@am__EXEEXT_TRUE@ --log-file $$b.log --trs-file $$b.trs \
-@am__EXEEXT_TRUE@ $(am__common_driver_flags) $(AM_TEST_LOG_DRIVER_FLAGS) $(TEST_LOG_DRIVER_FLAGS) -- $(TEST_LOG_COMPILE) \
-@am__EXEEXT_TRUE@ "$$tst" $(AM_TESTS_FD_REDIRECT)
-distdir: $(BUILT_SOURCES)
- $(MAKE) $(AM_MAKEFLAGS) distdir-am
-
-distdir-am: $(DISTFILES)
- @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
- topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
- list='$(DISTFILES)'; \
- dist_files=`for file in $$list; do echo $$file; done | \
- sed -e "s|^$$srcdirstrip/||;t" \
- -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
- case $$dist_files in \
- */*) $(MKDIR_P) `echo "$$dist_files" | \
- sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
- sort -u` ;; \
- esac; \
- for file in $$dist_files; do \
- if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
- if test -d $$d/$$file; then \
- dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
- if test -d "$(distdir)/$$file"; then \
- find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
- fi; \
- if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
- cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
- find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
- fi; \
- cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
- else \
- test -f "$(distdir)/$$file" \
- || cp -p $$d/$$file "$(distdir)/$$file" \
- || exit 1; \
- fi; \
- done
-check-am: all-am
- $(MAKE) $(AM_MAKEFLAGS) check-TESTS
-check: check-am
-all-am: Makefile $(PROGRAMS) $(MANS) $(DATA)
-installdirs:
- for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)"; do \
- test -z "$$dir" || $(MKDIR_P) "$$dir"; \
- done
-install: install-am
-install-exec: install-exec-am
-install-data: install-data-am
-uninstall: uninstall-am
-
-install-am: all-am
- @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
-
-installcheck: installcheck-am
-install-strip:
- if test -z '$(STRIP)'; then \
- $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
- install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
- install; \
- else \
- $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
- install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
- "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
- fi
-mostlyclean-generic:
- -test -z "$(TEST_LOGS)" || rm -f $(TEST_LOGS)
- -test -z "$(TEST_LOGS:.log=.trs)" || rm -f $(TEST_LOGS:.log=.trs)
- -test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
-
-clean-generic:
- -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)
-
-distclean-generic:
- -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
- -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
- -test -z "$(DISTCLEANFILES)" || rm -f $(DISTCLEANFILES)
-
-maintainer-clean-generic:
- @echo "This command is intended for maintainers to use"
- @echo "it deletes files that may require special tools to rebuild."
-clean: clean-am
-
-clean-am: clean-binPROGRAMS clean-generic clean-libtool mostlyclean-am
-
-distclean: distclean-am
- -rm -f ./$(DEPDIR)/virt_dib-dummy.Po
- -rm -f Makefile
-distclean-am: clean-am distclean-compile distclean-generic \
- distclean-tags
-
-dvi: dvi-am
-
-dvi-am:
-
-html: html-am
-
-html-am:
-
-info: info-am
-
-info-am:
-
-install-data-am: install-man
-
-install-dvi: install-dvi-am
-
-install-dvi-am:
-
-install-exec-am: install-binPROGRAMS
-
-install-html: install-html-am
-
-install-html-am:
-
-install-info: install-info-am
-
-install-info-am:
-
-install-man: install-man1
-
-install-pdf: install-pdf-am
-
-install-pdf-am:
-
-install-ps: install-ps-am
-
-install-ps-am:
-
-installcheck-am:
-
-maintainer-clean: maintainer-clean-am
- -rm -f ./$(DEPDIR)/virt_dib-dummy.Po
- -rm -f Makefile
-maintainer-clean-am: distclean-am maintainer-clean-generic
-
-mostlyclean: mostlyclean-am
-
-mostlyclean-am: mostlyclean-compile mostlyclean-generic \
- mostlyclean-libtool
-
-pdf: pdf-am
-
-pdf-am:
-
-ps: ps-am
-
-ps-am:
-
-uninstall-am: uninstall-binPROGRAMS uninstall-man
-
-uninstall-man: uninstall-man1
-
-.MAKE: check-am install-am install-strip
-
-.PHONY: CTAGS GTAGS TAGS all all-am am--depfiles check check-TESTS \
- check-am clean clean-binPROGRAMS clean-generic clean-libtool \
- cscopelist-am ctags ctags-am distclean distclean-compile \
- distclean-generic distclean-libtool distclean-tags distdir dvi \
- dvi-am html html-am info info-am install install-am \
- install-binPROGRAMS install-data install-data-am install-dvi \
- install-dvi-am install-exec install-exec-am install-html \
- install-html-am install-info install-info-am install-man \
- install-man1 install-pdf install-pdf-am install-ps \
- install-ps-am install-strip installcheck installcheck-am \
- installdirs maintainer-clean maintainer-clean-generic \
- mostlyclean mostlyclean-compile mostlyclean-generic \
- mostlyclean-libtool pdf pdf-am ps ps-am recheck tags tags-am \
- uninstall uninstall-am uninstall-binPROGRAMS uninstall-man \
- uninstall-man1
-
-.PRECIOUS: Makefile
-
-
--include $(top_builddir)/localenv
-
-# Individual Makefile.am's should define generator_built if that
-# subdirectory contains any files which are built by the generator.
-# Set generator_built to the list of those files.
-
-$(generator_built): $(top_builddir)/generator/stamp-generator
-
-$(top_builddir)/generator/stamp-generator: $(top_builddir)/generator/generator
- @if test -f $(top_builddir)/generator/Makefile; then \
- $(MAKE) -C $(top_builddir)/generator stamp-generator; \
- else \
- echo "warning: Run 'make' at the top level to build $(generator_built)"; \
- fi
-
-# If this file doesn't exist, just print a warning and continue.
-# During 'make distclean' we can end up deleting this file.
-$(top_builddir)/generator/generator:
- @if test -f $(top_builddir)/generator/Makefile; then \
- $(MAKE) -C $(top_builddir)/generator generator; \
- else \
- echo "warning: Run 'make' at the top level to build $@"; \
- fi
-
-%.cmi: %.mli
- $(guestfs_am_v_ocamlcmi)$(OCAMLFIND) ocamlc $(OCAMLFLAGS) $(OCAMLPACKAGES) -c $< -o $@
-%.cmo: %.ml
- $(guestfs_am_v_ocamlc)$(OCAMLFIND) ocamlc $(OCAMLFLAGS) $(OCAMLPACKAGES) -c $< -o $@
-@HAVE_OCAMLOPT_TRUE@%.cmx: %.ml
-@HAVE_OCAMLOPT_TRUE@ $(guestfs_am_v_ocamlopt)$(OCAMLFIND) ocamlopt $(OCAMLFLAGS) $(OCAMLPACKAGES) -c $< -o $@
-
-# Test shell scripts should use '$TEST_FUNCTIONS' to get a predefined
-# set of helper functions for running tests (see test-functions.sh).
-#
-# Notes:
-#
-# (1) This is in fact a single command all on one line. The variables
-# are evaluated in test-functions.sh.
-#
-# (2) We use absolute paths here and in test-functions.sh so that the
-# test can change directory freely. But we also include the
-# non-absolute values so they can be used by the test script itself.
-export TEST_FUNCTIONS := \
- source $(abs_top_srcdir)/test-functions.sh \
- abs_srcdir="$(abs_srcdir)" \
- abs_builddir="$(abs_builddir)" \
- top_srcdir="$(top_srcdir)" \
- top_builddir="$(top_builddir)" \
- abs_top_srcdir="$(abs_top_srcdir)" \
- abs_top_builddir="$(abs_top_builddir)"
-
-@HAVE_OCAML_TRUE@output_format_%.mli:
-@HAVE_OCAML_TRUE@ rm -f $@ $@-t
-@HAVE_OCAML_TRUE@ echo '(* This file is generated by Makefile.am. *)' >> $@-t
-@HAVE_OCAML_TRUE@ echo '(* Nothing is exported from output format modules. *)' >> $@-t
-@HAVE_OCAML_TRUE@ mv $@-t $@
-
-@HAVE_OCAML_TRUE@virt-dib.1 $(top_builddir)/website/virt-dib.1.html: stamp-virt-dib.pod
-
-@HAVE_OCAML_TRUE@stamp-virt-dib.pod: virt-dib.pod
-@HAVE_OCAML_TRUE@ $(PODWRAPPER) \
-@HAVE_OCAML_TRUE@ --man virt-dib.1 \
-@HAVE_OCAML_TRUE@ --html $(top_builddir)/website/virt-dib.1.html \
-@HAVE_OCAML_TRUE@ --license GPLv2+ \
-@HAVE_OCAML_TRUE@ --warning safe \
-@HAVE_OCAML_TRUE@ $<
-@HAVE_OCAML_TRUE@ touch $@
-
-# OCaml dependencies.
-@HAVE_OCAML_TRUE@.depend: $(SOURCES_MLI) $(SOURCES_ML)
-@HAVE_OCAML_TRUE@ $(top_builddir)/ocaml-dep.sh $^
-@HAVE_OCAML_TRUE@-include .depend
-
-.PHONY: docs
-
-# Tell versions [3.59,3.63) of GNU make to not export all variables.
-# Otherwise a system limit (for SysV at least) may be exceeded.
-.NOEXPORT:
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(* Command line argument parsing. *)
-
-open Std_utils
-open Tools_utils
-open Common_gettext.Gettext
-open Getopt.OptionName
-
-open Utils
-
-open Printf
-
-type cmdline = {
- debug : int;
- basepath : string;
- elements : string list;
- excluded_elements : string list;
- element_paths : string list;
- excluded_scripts : string list;
- use_base : bool;
- drive : string option;
- drive_format : string option;
- image_name : string;
- fs_type : string;
- size : int64;
- root_label : string option;
- install_type : string;
- image_cache : string option;
- mkfs_options : string option;
- is_ramdisk : bool;
- ramdisk_element : string;
- extra_packages : string list;
- memsize : int option;
- network : bool;
- smp : int option;
- delete_on_failure : bool;
- formats : Output_format.set;
- arch : string;
- envvars : string list;
- checksum : bool;
- python : string option;
-}
-
-let parse_cmdline () =
- let usage_msg =
- sprintf (f_"\
-%s: run diskimage-builder elements to generate images
-
- virt-dib -B DIB-LIB -p ELEMENTS-PATH elements...
-
-A short summary of the options is given below. For detailed help please
-read the man page virt-dib(1).
-")
- prog in
-
- let elements = ref [] in
- let append_element element = List.push_front element elements in
-
- let excluded_elements = ref [] in
- let append_excluded_element element = List.push_front element excluded_elements in
-
- let element_paths = ref [] in
- let append_element_path arg = List.push_front arg element_paths in
-
- let excluded_scripts = ref [] in
- let append_excluded_script arg = List.push_front arg excluded_scripts in
-
- let debug = ref 0 in
- let set_debug arg =
- if arg < 0 then
- error (f_"--debug parameter must be >= 0");
- debug := arg in
-
- let basepath = ref "" in
-
- let image_name = ref "image" in
-
- let fs_type = ref "ext4" in
-
- let size = ref (unit_GB 5) in
- let set_size arg = size := parse_size arg in
-
- let memsize = ref None in
- let set_memsize arg = memsize := Some arg in
-
- let network = ref true in
-
- let smp = ref None in
- let set_smp arg = smp := Some arg in
-
- let formats = ref None in
- let set_format arg =
- let fmts = List.remove_duplicates (String.nsplit "," arg) in
- let fmtset =
- List.fold_left (
- fun fmtset fmt ->
- try Output_format.add_to_set fmt fmtset
- with Not_found ->
- error (f_"invalid format ‘%s’ in --formats") fmt
- ) Output_format.empty_set fmts in
- formats := Some fmtset in
-
- let envvars = ref [] in
- let append_envvar arg = List.push_front arg envvars in
-
- let use_base = ref true in
-
- let arch = ref "" in
-
- let drive = ref None in
- let set_drive arg = drive := Some arg in
- let drive_format = ref None in
- let set_drive_format arg = drive_format := Some arg in
-
- let root_label = ref None in
- let set_root_label arg = root_label := Some arg in
-
- let install_type = ref "source" in
-
- let image_cache = ref None in
- let set_image_cache arg = image_cache := Some arg in
-
- let delete_on_failure = ref true in
-
- let is_ramdisk = ref false in
- let ramdisk_element = ref "ramdisk" in
-
- let mkfs_options = ref None in
- let set_mkfs_options arg = mkfs_options := Some arg in
-
- let extra_packages = ref [] in
- let append_extra_packages arg =
- List.push_front_list (List.rev (String.nsplit "," arg)) extra_packages in
-
- let checksum = ref false in
-
- let python = ref None in
- let set_python arg = python := Some arg in
-
- let argspec = [
- [ S 'p'; L"element-path" ], Getopt.String ("path", append_element_path), s_"Add new a elements location";
- [ L"exclude-element" ], Getopt.String ("element", append_excluded_element),
- s_"Exclude the specified element";
- [ L"exclude-script" ], Getopt.String ("script", append_excluded_script),
- s_"Exclude the specified script";
- [ L"envvar" ], Getopt.String ("envvar[=value]", append_envvar), s_"Carry/set this environment variable";
- [ L"skip-base" ], Getopt.Clear use_base, s_"Skip the inclusion of the ‘base’ element";
- [ L"root-label" ], Getopt.String ("label", set_root_label), s_"Label for the root fs";
- [ L"install-type" ], Getopt.Set_string ("type", install_type), s_"Installation type";
- [ L"image-cache" ], Getopt.String ("directory", set_image_cache), s_"Location for cached images";
- [ L"mkfs-options" ], Getopt.String ("option", set_mkfs_options),
- s_"Add mkfs options";
- [ L"extra-packages" ], Getopt.String ("pkg,...", append_extra_packages),
- s_"Add extra packages to install";
- [ L"checksum" ], Getopt.Set checksum, s_"Generate MD5 and SHA256 checksum files";
- [ L"python" ], Getopt.String ("python", set_python), s_"Set Python interpreter";
-
- [ L"ramdisk" ], Getopt.Set is_ramdisk, "Switch to a ramdisk build";
- [ L"ramdisk-element" ], Getopt.Set_string ("name", ramdisk_element), s_"Main element for building ramdisks";
-
- [ L"name" ], Getopt.Set_string ("name", image_name), s_"Name of the image";
- [ L"fs-type" ], Getopt.Set_string ("fs", fs_type), s_"Filesystem for the image";
- [ L"size" ], Getopt.String ("size", set_size), s_"Set output disk size";
- [ L"formats" ], Getopt.String ("qcow2,tgz,...", set_format), s_"Output formats";
- [ L"arch" ], Getopt.Set_string ("arch", arch), s_"Output architecture";
- [ L"drive" ], Getopt.String ("path", set_drive), s_"Optional drive for caches";
- [ L"drive-format" ], Getopt.String (s_"format", set_drive_format), s_"Format of optional drive";
-
- [ S 'm'; L"memsize" ], Getopt.Int ("mb", set_memsize), s_"Set memory size";
- [ L"network" ], Getopt.Set network, s_"Enable appliance network (default)";
- [ L"no-network" ], Getopt.Clear network, s_"Disable appliance network";
- [ L"smp" ], Getopt.Int ("vcpus", set_smp), s_"Set number of vCPUs";
- [ L"no-delete-on-failure" ], Getopt.Clear delete_on_failure,
- s_"Don’t delete output file on failure";
-
- [ L"debug" ], Getopt.Int ("level", set_debug), s_"Set debug level";
- [ S 'B' ], Getopt.Set_string ("path", basepath), s_"Base path of diskimage-builder library";
- ] in
- let argspec = argspec @ Output_format.extra_args () in
-
- let opthandle = create_standard_options argspec ~anon_fun:append_element ~machine_readable:true usage_msg in
- Getopt.parse opthandle.getopt;
-
- let debug = !debug in
- let basepath = !basepath in
- let elements = List.rev !elements in
- let excluded_elements = List.rev !excluded_elements in
- let element_paths = List.rev !element_paths in
- let excluded_scripts = List.rev !excluded_scripts in
- let image_name = !image_name in
- let fs_type = !fs_type in
- let size = !size in
- let memsize = !memsize in
- let network = !network in
- let smp = !smp in
- let formats = !formats in
- let envvars = !envvars in
- let use_base = !use_base in
- let arch = !arch in
- let drive = !drive in
- let drive_format = !drive_format in
- let root_label = !root_label in
- let install_type = !install_type in
- let image_cache = !image_cache in
- let delete_on_failure = !delete_on_failure in
- let is_ramdisk = !is_ramdisk in
- let ramdisk_element = !ramdisk_element in
- let mkfs_options = !mkfs_options in
- let extra_packages = List.rev !extra_packages in
- let checksum = !checksum in
- let python = !python in
-
- (* No elements and machine-readable mode? Print some facts. *)
- (match elements, machine_readable () with
- | [], Some { pr } ->
- pr "virt-dib\n";
- let formats_list = Output_format.list_formats () in
- List.iter (pr "output:%s\n") formats_list;
- exit 0
- | _, _ -> ()
- );
-
- if basepath = "" then
- error (f_"-B must be specified");
-
- let formats =
- match formats with
- | None -> Output_format.add_to_set "qcow2" Output_format.empty_set
- | Some fmtset ->
- if Output_format.set_cardinal fmtset = 0 then
- error (f_"the list of output formats cannot be empty");
- fmtset in
-
- if elements = [] then
- error (f_"at least one distribution root element must be specified");
-
- let python = Option.map get_required_tool python in
-
- { debug = debug; basepath = basepath; elements = elements;
- excluded_elements = excluded_elements; element_paths = element_paths;
- excluded_scripts = excluded_scripts; use_base = use_base; drive = drive;
- drive_format = drive_format; image_name = image_name; fs_type = fs_type;
- size = size; root_label = root_label; install_type = install_type;
- image_cache = image_cache; mkfs_options = mkfs_options;
- is_ramdisk = is_ramdisk; ramdisk_element = ramdisk_element;
- extra_packages = extra_packages; memsize = memsize; network = network;
- smp = smp; delete_on_failure = delete_on_failure;
- formats = formats; arch = arch; envvars = envvars;
- checksum = checksum; python = python;
- }
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(** Command line argument parsing. *)
-
-type cmdline = {
- debug : int;
- basepath : string;
- elements : string list;
- excluded_elements : string list;
- element_paths : string list;
- excluded_scripts : string list;
- use_base : bool;
- drive : string option;
- drive_format : string option;
- image_name : string;
- fs_type : string;
- size : int64;
- root_label : string option;
- install_type : string;
- image_cache : string option;
- mkfs_options : string option;
- is_ramdisk : bool;
- ramdisk_element : string;
- extra_packages : string list;
- memsize : int option;
- network : bool;
- smp : int option;
- delete_on_failure : bool;
- formats : Output_format.set;
- arch : string;
- envvars : string list;
- checksum : bool;
- python : string option;
-}
-
-val parse_cmdline : unit -> cmdline
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Std_utils
-open Tools_utils
-open Unix_utils
-open Common_gettext.Gettext
-
-open Cmdline
-open Utils
-open Elements
-
-open Printf
-
-module G = Guestfs
-
-let checksums = [ "md5"; "sha256" ]
-and tool_of_checksum csum =
- csum ^ "sum"
-
-let exclude_elements elements = function
- | [] ->
- (* No elements to filter out, so just don't bother iterating through
- * the elements. *)
- elements
- | excl -> StringSet.filter (not_in_list excl) elements
-
-let read_envvars envvars =
- List.filter_map (
- fun var ->
- let i = String.find var "=" in
- if i = -1 then (
- try Some (var, Sys.getenv var)
- with Not_found -> None
- ) else (
- let len = String.length var in
- Some (String.sub var 0 i, String.sub var (i + 1) (len - i - 1))
- )
- ) envvars
-
-let read_dib_envvars () =
- let vars = Array.to_list (Unix.environment ()) in
- let vars = List.filter (fun x -> String.is_prefix x "DIB_") vars in
- let vars = List.map (fun x -> x ^ "\n") vars in
- String.concat "" vars
-
-let write_script fn text =
- with_open_out fn (
- fun oc ->
- output_string oc text;
- flush oc
- );
- Unix.chmod fn 0o755
-
-let envvars_string l =
- let l = List.map (
- fun (var, value) ->
- sprintf "export %s=%s" var (quote value)
- ) l in
- String.concat "\n" l
-
-let prepare_external ~envvars ~dib_args ~dib_vars ~out_name ~root_label
- ~rootfs_uuid ~image_cache ~arch ~network ~debug ~fs_type ~checksum
- ~python
- destdir libdir fakebindir loaded_elements all_elements element_paths =
- let network_string = if network then "" else "1" in
- let checksum_string = if checksum then "1" else "" in
- let elements_paths_yaml =
- List.map (
- fun e ->
- sprintf "%s: %s" e (quote (Hashtbl.find loaded_elements e).directory)
- ) (StringSet.elements all_elements) in
- let elements_paths_yaml = String.concat ", " elements_paths_yaml in
- let elements_paths_array =
- List.map (
- fun e ->
- sprintf "[%s]=%s" e (quote (Hashtbl.find loaded_elements e).directory)
- ) (StringSet.elements all_elements) in
- let elements_paths_array = String.concat " " elements_paths_array in
-
- let run_extra = sprintf "\
-#!/bin/bash
-set -e
-%s
-mount_dir=$1
-shift
-hooks_dir=$1
-shift
-target_dir=$1
-shift
-script=$1
-shift
-
-VIRT_DIB_OURPATH=$(dirname $(realpath $0))
-
-# user variables
-%s
-
-export PATH=%s:$PATH
-
-# d-i-b variables
-export TMP_MOUNT_PATH=\"$mount_dir\"
-export DIB_OFFLINE=%s
-export IMAGE_NAME=\"%s\"
-export DIB_ROOT_LABEL=\"%s\"
-export DIB_IMAGE_ROOT_FS_UUID=%s
-export DIB_IMAGE_CACHE=\"%s\"
-export _LIB=%s
-export ARCH=%s
-export TMP_HOOKS_PATH=\"$hooks_dir\"
-export DIB_ARGS=\"%s\"
-export IMAGE_ELEMENT=\"%s\"
-export ELEMENTS_PATH=\"%s\"
-export DIB_ENV=%s
-export TMPDIR=\"${TMP_MOUNT_PATH}/tmp\"
-export TMP_DIR=\"${TMPDIR}\"
-export DIB_DEBUG_TRACE=%d
-export FS_TYPE=%s
-export DIB_CHECKSUM=%s
-export DIB_PYTHON_EXEC=%s
-
-elinfo_out=$(<${VIRT_DIB_OURPATH}/elinfo_out)
-eval \"$elinfo_out\"
-
-ENVIRONMENT_D_DIR=$target_dir/../environment.d
-
-if [ -d $ENVIRONMENT_D_DIR ] ; then
- env_files=$(find $ENVIRONMENT_D_DIR -maxdepth 1 -xtype f | \
- grep -E \"/[0-9A-Za-z_\\.-]+$\" | \
- LANG=C sort -n)
- for env_file in $env_files ; do
- source $env_file
- done
-fi
-
-source $_LIB/die
-
-$target_dir/$script
-"
- (if debug >= 1 then "set -x\n" else "")
- (envvars_string envvars)
- fakebindir
- network_string
- out_name
- root_label
- rootfs_uuid
- image_cache
- (quote libdir)
- arch
- dib_args
- (String.concat " " (StringSet.elements all_elements))
- (String.concat ":" element_paths)
- (quote dib_vars)
- debug
- fs_type
- checksum_string
- python in
- write_script (destdir // "run-part-extra.sh") run_extra;
- let elinfo_out = sprintf "\
-export IMAGE_ELEMENT_YAML=\"{%s}\"
-function get_image_element_array {
- echo \"%s\"
-};
-export -f get_image_element_array;
-"
- elements_paths_yaml
- elements_paths_array in
- write_script (destdir // "elinfo_out") elinfo_out
-
-let prepare_aux ~envvars ~dib_args ~dib_vars ~log_file ~out_name ~rootfs_uuid
- ~arch ~network ~root_label ~install_type ~debug ~extra_packages ~fs_type
- ~checksum destdir all_elements =
- let network_string = if network then "" else "1" in
- let checksum_string = if checksum then "1" else "" in
-
- let script_run_part = sprintf "\
-#!/bin/bash
-set -e
-%s
-sysroot=$1
-shift
-mysysroot=$1
-shift
-blockdev=$1
-shift
-target_dir=$1
-shift
-new_wd=$1
-shift
-script=$1
-shift
-
-# user variables
-%s
-
-# system variables
-export HOME=$mysysroot/tmp/in_target.aux/perm/home
-export PATH=$mysysroot/tmp/in_target.aux/hooks/bin:$PATH
-export TMP=$mysysroot/tmp
-export TMPDIR=$TMP
-export TMP_DIR=$TMP
-
-# d-i-b variables
-export TMP_MOUNT_PATH=$sysroot
-export TARGET_ROOT=$sysroot
-export DIB_OFFLINE=%s
-export IMAGE_NAME=\"%s\"
-export DIB_IMAGE_ROOT_FS_UUID=%s
-export DIB_IMAGE_CACHE=$HOME/.cache/image-create
-export DIB_ROOT_LABEL=\"%s\"
-export _LIB=$mysysroot/tmp/in_target.aux/lib
-export _PREFIX=$mysysroot/tmp/in_target.aux/elements
-export ARCH=%s
-export TMP_HOOKS_PATH=$mysysroot/tmp/in_target.aux/hooks
-export DIB_ARGS=\"%s\"
-export DIB_MANIFEST_SAVE_DIR=\"$mysysroot/tmp/in_target.aux/out/${IMAGE_NAME}.d\"
-export IMAGE_BLOCK_DEVICE=$blockdev
-export IMAGE_BLOCK_DEVICE_WITHOUT_PART=$(echo ${IMAGE_BLOCK_DEVICE} | sed -e \"s|^\\(.*loop[0-9]*\\)p[0-9]*$|\\1|g\")
-export IMAGE_ELEMENT=\"%s\"
-export DIB_ENV=%s
-export DIB_DEBUG_TRACE=%d
-export DIB_NO_TMPFS=1
-export FS_TYPE=%s
-export DIB_CHECKSUM=%s
-
-export TMP_BUILD_DIR=$mysysroot/tmp/in_target.aux
-export TMP_IMAGE_DIR=$mysysroot/tmp/in_target.aux
-
-if [ -n \"$mysysroot\" ]; then
- export PATH=$mysysroot/tmp/in_target.aux/fake-bin:$PATH
- source $_LIB/die
-else
- export PATH=\"$PATH:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\"
-fi
-
-ENVIRONMENT_D_DIR=$target_dir/../environment.d
-
-if [ -d $ENVIRONMENT_D_DIR ] ; then
- env_files=$(find $ENVIRONMENT_D_DIR -maxdepth 1 -xtype f | \
- grep -E \"/[0-9A-Za-z_\\.-]+$\" | \
- LANG=C sort -n)
- for env_file in $env_files ; do
- source $env_file
- done
-fi
-
-if [ -n \"$new_wd\" ]; then
- cd \"$mysysroot/$new_wd\"
-fi
-
-$target_dir/$script
-"
- (if debug >= 1 then "set -x\n" else "")
- (envvars_string envvars)
- network_string
- out_name
- rootfs_uuid
- root_label
- arch
- dib_args
- (String.concat " " (StringSet.elements all_elements))
- (quote dib_vars)
- debug
- fs_type
- checksum_string in
- write_script (destdir // "run-part.sh") script_run_part;
- let script_run_and_log = "\
-#!/bin/bash
-logfile=$1
-shift
-exec 3>&1
-exit `( ( ( $(dirname $0)/run-part.sh \"$@\" ) 2>&1 3>&-; echo $? >&4) | tee -a $logfile >&3 >&2) 4>&1`
-" in
- write_script (destdir // "run-and-log.sh") script_run_and_log;
-
- (* Create the fake sudo support. *)
- do_mkdir (destdir // "fake-bin");
- let fake_sudo = "\
-#!/bin/bash
-set -e
-
-SCRIPTNAME=fake-sudo
-
-ARGS_SHORT=\"EHiu:\"
-ARGS_LONG=\"\"
-TEMP=`POSIXLY_CORRECT=1 getopt ${ARGS_SHORT:+-o $ARGS_SHORT} ${ARGS_LONG:+--long $ARGS_LONG} \
- -n \"$SCRIPTNAME\" -- \"$@\"`
-if [ $? != 0 ]; then echo \"$SCRIPTNAME: terminating...\" >&2 ; exit 1 ; fi
-eval set -- \"$TEMP\"
-
-preserve_env=
-set_home=
-login_shell=
-user=
-
-while true; do
- case \"$1\" in
- -E) preserve_env=1; shift;;
- -H) set_home=1; shift;;
- -i) login_shell=1; shift;;
- -u) user=$2; shift 2;;
- --) shift; break;;
- *) echo \"$SCRIPTNAME: internal arguments error\"; exit 1;;
- esac
-done
-
-if [ -n \"$user\" ]; then
- if [ $user != root -a $user != `whoami` ]; then
- echo \"$SCRIPTNAME: cannot use the sudo user $user, only root and $(whoami) handled\" >&2
- exit 1
- fi
-fi
-
-if [ -z \"$preserve_env\" ]; then
- for envvar in `awk 'BEGIN{for (i in ENVIRON) {print i}}'`; do
- case \"$envvar\" in
- PATH | USER | USERNAME | HOSTNAME | TERM | LANG | HOME | SHELL | LOGNAME ) ;;
- BASH_FUNC_* ) unset -f $envvar ;;
- *) unset $envvar ;;
- esac
- done
-fi
-# TMPDIR needs to be unset, regardless of -E
-unset TMPDIR
-# ... and do that also to the other \"TMPDIR\"-like variables
-unset TMP
-unset TMP_DIR
-
-cmd=$1
-shift
-$cmd \"$@\"
-" in
- write_script (destdir // "fake-bin" // "sudo") fake_sudo;
- (* Pick dib-run-parts from the host, if available, otherwise put
- * a fake executable which will error out if used.
- *)
- (try
- let loc = which "dib-run-parts" in
- do_cp loc (destdir // "fake-bin")
- with Executable_not_found _ ->
- let fake_dib_run_parts = "\
-#!/bin/sh
-echo \"Please install dib-run-parts on the host\"
-exit 1
-" in
- write_script (destdir // "fake-bin" // "dib-run-parts") fake_dib_run_parts;
- );
-
- (* Write the custom hooks. *)
- let script_install_type_env = sprintf "\
-export DIB_DEFAULT_INSTALLTYPE=${DIB_DEFAULT_INSTALLTYPE:-\"%s\"}
-"
- install_type in
- write_script (destdir // "hooks" // "environment.d" // "11-dib-install-type.bash") script_install_type_env;
-
- (* Write install-packages.sh if needed. *)
- if extra_packages <> [] then (
- let script_install_packages = sprintf "\
-#!/bin/bash
-install-packages %s
-"
- (String.concat " " extra_packages) in
- write_script (destdir // "install-packages.sh") script_install_packages;
- );
-
- do_mkdir (destdir // "perm")
-
-let timing_output ~target_name entries timings =
- let buf = Buffer.create 4096 in
- Buffer.add_string buf "----------------------- PROFILING -----------------------\n";
- Buffer.add_char buf '\n';
- bprintf buf "Target: %s\n" target_name;
- Buffer.add_char buf '\n';
- bprintf buf "%-40s %9s\n" "Script" "Seconds";
- bprintf buf "%-40s %9s\n" "---------------------------------------" "----------";
- Buffer.add_char buf '\n';
- List.iter (
- fun x ->
- bprintf buf "%-40s %10.3f\n" x (Hashtbl.find timings x);
- ) entries;
- Buffer.add_char buf '\n';
- Buffer.add_string buf "--------------------- END PROFILING ---------------------\n";
- Buffer.contents buf
-
-type sysroot_type =
- | In
- | Out
- | Subroot
-
-let timed_run fn =
- let time_before = Unix.gettimeofday () in
- fn ();
- let time_after = Unix.gettimeofday () in
- time_after -. time_before
-
-let run_parts ~debug ~sysroot ~blockdev ~log_file ?(new_wd = "")
- (g : Guestfs.guestfs) hook_name scripts =
- let hook_dir = "/tmp/in_target.aux/hooks/" ^ hook_name in
- let scripts = List.sort digit_prefix_compare scripts in
- let outbuf = Buffer.create 16384 in
- let timings = Hashtbl.create 13 in
- let new_wd =
- match sysroot, new_wd with
- | (Out|Subroot), "" -> "''"
- | (In|Out|Subroot), dir -> dir in
- List.iter (
- fun x ->
- message (f_"Running: %s/%s") hook_name x;
- g#write_append log_file (sprintf "Running %s/%s...\n" hook_name x);
- let out = ref "" in
- let run () =
- let outstr =
- match sysroot with
- | In ->
- g#sh (sprintf "/tmp/in_target.aux/run-and-log.sh '%s' '' '' '%s' '%s' '%s' '%s'" log_file blockdev hook_dir new_wd x)
- | Out ->
- g#debug "sh" [| "/sysroot/tmp/in_target.aux/run-and-log.sh"; "/sysroot" ^ log_file; "/sysroot"; "/sysroot"; blockdev; "/sysroot" ^ hook_dir; new_wd; x |]
- | Subroot ->
- g#debug "sh" [| "/sysroot/tmp/in_target.aux/run-and-log.sh"; "/sysroot" ^ log_file; "/sysroot/subroot"; "/sysroot"; blockdev; "/sysroot" ^ hook_dir; new_wd; x |] in
- out := outstr;
- Buffer.add_string outbuf outstr in
- let delta_t = timed_run run in
- Buffer.add_char outbuf '\n';
- out := ensure_trailing_newline !out;
- printf "%s%!" !out;
- if debug >= 1 then (
- printf "%s completed after %.3f s\n" x delta_t
- );
- Hashtbl.add timings x delta_t;
- ) scripts;
- g#write_append log_file (timing_output ~target_name:hook_name scripts timings);
- flush_all ();
- Buffer.contents outbuf
-
-let run_parts_host ~debug (g : Guestfs.guestfs) hook_name base_mount_dir scripts run_script =
- let scripts = List.sort digit_prefix_compare scripts in
- let mount_dir = base_mount_dir // hook_name in
- (* Point to the in-guest hooks, so that changes there can affect
- * other phases.
- *)
- let hooks_dir = mount_dir // "tmp" // "in_target.aux" // "hooks" in
- let hook_dir = hooks_dir // hook_name in
- do_mkdir mount_dir;
-
- let rec fork_and_run () =
- let pid = Unix.fork () in
- if pid = 0 then ( (* child *)
- let retcode = run_scripts () in
- flush_all ();
- let cmd = [ "guestunmount"; mount_dir ] in
- ignore (run_command cmd);
- Exit._exit retcode
- );
- pid
- and run_scripts () =
- let timings = Hashtbl.create 13 in
- let rec loop = function
- | x :: xs ->
- message (f_"Running: %s/%s") hook_name x;
- let cmd = [ run_script; mount_dir; hooks_dir; hook_dir; x ] in
- let retcode = ref 0 in
- let run () =
- retcode := run_command cmd in
- let delta_t = timed_run run in
- if debug >= 1 then (
- printf "\n";
- printf "%s completed after %.3f s\n" x delta_t
- );
- Hashtbl.add timings x delta_t;
- let retcode = !retcode in
- if retcode <> 0 then retcode
- else loop xs
- | [] -> 0
- in
- let retcode = loop scripts in
- if debug >= 1 then (
- print_string (timing_output ~target_name:hook_name scripts timings)
- );
- retcode
- in
-
- g#mount_local mount_dir;
- let pid = fork_and_run () in
- g#mount_local_run ();
-
- (match snd (Unix.waitpid [] pid) with
- | Unix.WEXITED 0 -> ()
- | Unix.WEXITED i -> exit i
- | Unix.WSIGNALED i
- | Unix.WSTOPPED i ->
- error (f_"sub-process killed by signal (%d)") i
- );
-
- flush_all ()
-
-let run_install_packages ~debug ~blockdev ~log_file
- (g : Guestfs.guestfs) packages =
- let pkgs_string = String.concat " " packages in
- message (f_"Installing: %s") pkgs_string;
- g#write_append log_file (sprintf "Installing %s...\n" pkgs_string);
- let out = g#sh (sprintf "/tmp/in_target.aux/run-and-log.sh '%s' '' '' '%s' '/tmp/in_target.aux' '' 'install-packages.sh'" log_file blockdev) in
- let out = ensure_trailing_newline out in
- if debug >= 1 then (
- printf "%s%!" out;
- printf "package installation completed\n";
- );
- flush_all ();
- out
-
-(* Finalize the list of output formats. *)
-let () = Output_format.bake ()
-
-let main () =
- let cmdline = parse_cmdline () in
- let debug = cmdline.debug in
-
- (* Check that the specified base directory of diskimage-builder
- * has the "die" script in it, so we know the directory is the
- * right one (hopefully so, at least).
- *)
- if not (Sys.file_exists (cmdline.basepath // "die")) then
- error (f_"the specified base path is not the diskimage-builder library");
-
- (* Check for required tools. *)
- let python =
- match cmdline.python with
- | None -> get_required_tool "python"
- | Some exe -> exe in
- require_tool "uuidgen";
- Output_format.check_formats_prerequisites cmdline.formats;
- if cmdline.checksum then
- List.iter (fun x -> require_tool (tool_of_checksum x)) checksums;
-
- let image_basename = Filename.basename cmdline.image_name in
- let image_basename_d = image_basename ^ ".d" in
-
- let tmpdir = Mkdtemp.temp_dir "dib." in
- On_exit.rm_rf tmpdir;
- let auxtmpdir = tmpdir // "in_target.aux" in
- do_mkdir auxtmpdir;
- let hookstmpdir = auxtmpdir // "hooks" in
- do_mkdir (hookstmpdir // "environment.d"); (* Just like d-i-b does. *)
- do_mkdir (auxtmpdir // "out" // image_basename_d);
- let elements =
- if cmdline.use_base then ["base"] @ cmdline.elements
- else cmdline.elements in
- let elements =
- if cmdline.is_ramdisk then [cmdline.ramdisk_element] @ elements
- else elements in
- info (f_"Elements: %s") (String.concat " " elements);
- if debug >= 1 then (
- printf "tmpdir: %s\n" tmpdir;
- printf "element paths: %s\n" (String.concat ":" cmdline.element_paths);
- );
-
- let loaded_elements = load_elements ~debug cmdline.element_paths in
- if debug >= 1 then (
- printf "loaded elements:\n";
- Hashtbl.iter (
- fun k v ->
- printf " %s => %s\n" k v.directory;
- Hashtbl.iter (
- fun k v ->
- printf "\t%-20s %s\n" k (String.concat " " (List.sort compare v))
- ) v.hooks;
- ) loaded_elements;
- printf "\n";
- );
- let all_elements = load_dependencies elements loaded_elements in
- let all_elements = exclude_elements all_elements
- (cmdline.excluded_elements @ builtin_elements_blacklist) in
-
- info (f_"Expanded elements: %s")
- (String.concat " " (StringSet.elements all_elements));
-
- let envvars = read_envvars cmdline.envvars in
- info (f_"Carried environment variables: %s")
- (String.concat " " (List.map fst envvars));
- if debug >= 1 then (
- printf "carried over envvars:\n";
- if envvars <> [] then
- List.iter (
- fun (var, value) ->
- printf " %s=%s\n" var value
- ) envvars
- else
- printf " (none)\n";
- printf "\n";
- );
- let dib_args = stringify_args (Array.to_list Sys.argv) in
- let dib_vars = read_dib_envvars () in
- if debug >= 1 then (
- printf "DIB args:\n%s\n" dib_args;
- printf "DIB envvars:\n%s\n" dib_vars
- );
-
- message (f_"Preparing auxiliary data");
-
- copy_elements all_elements loaded_elements
- (cmdline.excluded_scripts @ builtin_scripts_blacklist) hookstmpdir;
-
- (* Re-read the hook scripts from the hooks dir, as d-i-b (and we too)
- * has basically copied over anything found in elements.
- *)
- let final_hooks = load_hooks ~debug hookstmpdir in
-
- let log_file = "/tmp/in_target.aux/perm/" ^ (log_filename ()) in
-
- let arch =
- match cmdline.arch with
- | "" -> current_arch ()
- | arch -> arch in
-
- let root_label =
- match cmdline.root_label with
- | None ->
- (* XFS has a limit of 12 characters for filesystem labels.
- * Not changing the default for other filesystems to maintain
- * backwards compatibility.
- *)
- (match cmdline.fs_type with
- | "xfs" -> "img-rootfs"
- | _ -> "cloudimg-rootfs")
- | Some label -> label in
-
- let image_cache =
- match cmdline.image_cache with
- | None -> Sys.getenv "HOME" // ".cache" // "image-create"
- | Some dir -> dir in
- do_mkdir image_cache;
-
- let rootfs_uuid = uuidgen () in
-
- prepare_aux ~envvars ~dib_args ~dib_vars ~log_file ~out_name:image_basename
- ~rootfs_uuid ~arch ~network:cmdline.network ~root_label
- ~install_type:cmdline.install_type ~debug
- ~extra_packages:cmdline.extra_packages
- ~fs_type:cmdline.fs_type
- ~checksum:cmdline.checksum
- auxtmpdir all_elements;
-
- let delete_output_file = ref cmdline.delete_on_failure in
- let delete_file () =
- if !delete_output_file then (
- let filenames = Output_format.get_filenames cmdline.formats cmdline.image_name in
- List.iter (
- fun fn ->
- try Unix.unlink fn with _ -> ()
- ) filenames
- )
- in
- at_exit delete_file;
-
- prepare_external ~envvars ~dib_args ~dib_vars ~out_name:image_basename
- ~root_label ~rootfs_uuid ~image_cache ~arch
- ~network:cmdline.network ~debug
- ~fs_type:cmdline.fs_type
- ~checksum:cmdline.checksum
- ~python
- tmpdir cmdline.basepath
- (auxtmpdir // "fake-bin")
- loaded_elements all_elements cmdline.element_paths;
-
- let run_hook ~blockdev ~sysroot ?(new_wd = "") (g : Guestfs.guestfs) hook =
- try
- let scripts =
- (* Sadly, scripts (especially in root.d and extra-data.d)
- * can add (by copying or symlinking) new scripts for other
- * phases, which would be ignored if we were using the lists
- * collected after composing the tree of hooks.
- * As result, when running in-chroot hooks, re-read the list
- * of scripts actually available for each hook.
- *)
- match hook with
- | "pre-install.d" | "install.d" | "post-install.d" | "finalise.d" ->
- let scripts_path = "/tmp/in_target.aux/hooks/" ^ hook in
- (* Cleanly handle cases when the phase directory does not exist. *)
- if g#is_dir ~followsymlinks:true scripts_path then
- load_scripts g scripts_path
- else
- raise Not_found
- | _ ->
- Hashtbl.find final_hooks hook in
- if debug >= 1 then (
- printf "Running hooks for %s...\n%!" hook;
- );
- run_parts ~debug ~sysroot ~blockdev ~log_file ~new_wd g hook scripts
- with Not_found -> "" in
-
- let copy_in (g : Guestfs.guestfs) srcdir destdir =
- let desttar = Filename.temp_file ~temp_dir:tmpdir "virt-dib." ".tar.gz" in
- let cmd = [ "tar"; "czf"; desttar; "-C"; srcdir; "--owner=root";
- "--group=root"; "." ] in
- if run_command cmd <> 0 then exit 1;
- g#mkdir_p destdir;
- g#tar_in ~compress:"gzip" desttar destdir;
- Sys.remove desttar in
-
- if debug >= 1 then
- ignore (run_command [ "tree"; "-ps"; tmpdir ]);
-
- message (f_"Opening the disks");
-
- let is_ramdisk_build =
- cmdline.is_ramdisk || StringSet.mem "ironic-agent" all_elements in
-
- let g, tmpdisk, tmpdiskfmt, drive_partition =
- let g = open_guestfs () in
- Option.iter g#set_memsize cmdline.memsize;
- Option.iter g#set_smp cmdline.smp;
- g#set_network cmdline.network;
-
- (* Main disk with the built image. *)
- let fmt = "raw" in
- let fn =
- (* If "raw" is among the selected outputs, use it as main backing
- * disk, otherwise create a temporary disk.
- *)
- if not is_ramdisk_build && Output_format.set_mem "raw" cmdline.formats then
- cmdline.image_name
- else
- Filename.temp_file ~temp_dir:tmpdir "image." "" in
- let fn = output_filename fn fmt in
- (* Produce the output image. *)
- g#disk_create fn fmt cmdline.size;
- g#add_drive ~readonly:false ~format:fmt fn;
-
- (* Helper drive for elements and binaries. *)
- g#add_drive_scratch (unit_GB 5);
-
- (match cmdline.drive with
- | None ->
- g#add_drive_scratch (unit_GB 5)
- | Some drive ->
- g#add_drive ?format:cmdline.drive_format drive;
- );
-
- g#launch ();
-
- Output_format.check_formats_appliance_prerequisites cmdline.formats g;
-
- (* Prepare the /in_target.aux partition. *)
- g#mkfs "ext2" "/dev/sdb";
- g#mount "/dev/sdb" "/";
-
- copy_in g auxtmpdir "/";
- copy_in g cmdline.basepath "/lib";
- g#umount "/";
-
- (* Prepare the /in_target.aux/perm partition. *)
- let drive_partition =
- match cmdline.drive with
- | None ->
- g#mkfs "ext2" "/dev/sdc";
- "/dev/sdc"
- | Some _ ->
- let partitions = Array.to_list (g#list_partitions ()) in
- (match partitions with
- | [] -> "/dev/sdc"
- | p ->
- let p = List.filter (fun x -> String.is_prefix x "/dev/sdc") p in
- if p = [] then
- error (f_"no partitions found in the helper drive");
- List.hd p
- ) in
- g#mount drive_partition "/";
- g#mkdir_p "/home/.cache/image-create";
- g#umount "/";
-
- g, fn, fmt, drive_partition in
-
- let mount_aux () =
- g#mkmountpoint "/tmp/in_target.aux";
- g#mount "/dev/sdb" "/tmp/in_target.aux";
- g#mount drive_partition "/tmp/in_target.aux/perm" in
-
- (* Small kludge: try to umount all first: if that fails, use lsof and fuser
- * to find out what might have caused the failure, run udevadm to try
- * to settle things down (udev, you never know), and try umount all again.
- *)
- let checked_umount_all () =
- try g#umount_all ()
- with G.Error _ ->
- if debug >= 1 then (
- (try printf "lsof:\n%s\nEND\n" (g#debug "sh" [| "lsof"; "/sysroot"; |]) with _ -> ());
- (try printf "fuser:\n%s\nEND\n" (g#debug "sh" [| "fuser"; "-v"; "-m"; "/sysroot"; |]) with _ -> ());
- (try printf "losetup:\n%s\nEND\n" (g#debug "sh" [| "losetup"; "--list"; "--all" |]) with _ -> ());
- );
- ignore (g#debug "sh" [| "udevadm"; "--debug"; "settle" |]);
- g#umount_all () in
-
- g#mkmountpoint "/tmp";
- mount_aux ();
-
- let blockdev =
- (* Setup a loopback device, just like d-i-b would tie an image in the host
- * environment.
- *)
- let run_losetup device =
- let lines = g#debug "sh" [| "losetup"; "--show"; "-f"; device |] in
- let lines = String.nsplit "\n" lines in
- let lines = List.filter ((<>) "") lines in
- (match lines with
- | [] -> device
- | x :: _ -> x
- ) in
- let blockdev = run_losetup "/dev/sda" in
-
- let run_hook_out_eval hook envvar =
- let lines = run_hook ~sysroot:Out ~blockdev g hook in
- let lines = String.nsplit "\n" lines in
- let lines = List.filter ((<>) "") lines in
- if lines = [] then None
- else (try Some (var_from_lines envvar lines) with _ -> None) in
-
- (match run_hook_out_eval "block-device.d" "IMAGE_BLOCK_DEVICE" with
- | None -> blockdev
- | Some x -> x
- ) in
-
- let rec run_hook_out ?(new_wd = "") hook =
- do_run_hooks_noout ~sysroot:Out ~new_wd hook
- and run_hook_in hook =
- do_run_hooks_noout ~sysroot:In hook
- and run_hook_subroot hook =
- do_run_hooks_noout ~sysroot:Subroot hook
- and do_run_hooks_noout ~sysroot ?(new_wd = "") hook =
- ignore (run_hook ~sysroot ~blockdev ~new_wd g hook)
- and run_hook_host hook =
- try
- let scripts = Hashtbl.find final_hooks hook in
- if debug >= 1 then (
- printf "Running hooks for %s...\n%!" hook;
- );
- run_parts_host ~debug g hook tmpdir scripts
- (tmpdir // "run-part-extra.sh")
- with Not_found -> () in
-
- g#sync ();
- checked_umount_all ();
- flush_all ();
-
- message (f_"Setting up the destination root");
-
- (* Create and mount the target filesystem. *)
- let mkfs_options =
- match cmdline.mkfs_options with
- | None -> []
- | Some o -> [ o ] in
- let mkfs_options =
- [ "-t"; cmdline.fs_type ] @
- (match cmdline.fs_type with
- | "ext4" ->
- (* Very conservative to handle images being resized a lot
- * Without -J option specified, default journal size will be set to 32M
- * and online resize will be failed with error of needs too many credits.
- *)
- [ "-i"; "4096"; "-J"; "size=64" ]
- | _ -> []
- ) @ mkfs_options @ [ blockdev ] in
- ignore (g#debug "sh" (Array.of_list ([ "mkfs" ] @ mkfs_options)));
- g#set_label blockdev root_label;
- if String.is_prefix cmdline.fs_type "ext" then
- g#set_uuid blockdev rootfs_uuid;
- g#mount blockdev "/";
- g#mkmountpoint "/tmp";
- mount_aux ();
- g#mkdir "/subroot";
-
- run_hook_subroot "root.d";
-
- g#sync ();
- g#umount "/tmp/in_target.aux/perm";
- g#umount "/tmp/in_target.aux";
- g#rm_rf "/tmp";
- let subroot_items =
- let l = Array.to_list (g#ls "/subroot") in
- let l_lost_plus_found, l = List.partition ((=) "lost+found") l in
- if l_lost_plus_found <> [] then (
- g#rm_rf "/subroot/lost+found";
- );
- l in
- List.iter (fun x -> g#mv ("/subroot/" ^ x) ("/" ^ x)) subroot_items;
- g#rmdir "/subroot";
- (* Check /tmp exists already. *)
- ignore (g#is_dir "/tmp");
- mount_aux ();
- g#ln_s "in_target.aux/hooks" "/tmp/in_target.d";
-
- run_hook_host "extra-data.d";
-
- run_hook_in "pre-install.d";
-
- if cmdline.extra_packages <> [] then
- ignore (run_install_packages ~debug ~blockdev ~log_file g
- cmdline.extra_packages);
-
- run_hook_in "install.d";
-
- run_hook_in "post-install.d";
-
- (* Unmount and remount the image, as d-i-b does at this point too. *)
- g#sync ();
- checked_umount_all ();
- flush_all ();
- g#mount blockdev "/";
- (* Check /tmp/in_target.aux still exists. *)
- ignore (g#is_dir "/tmp/in_target.aux");
- g#mount "/dev/sdb" "/tmp/in_target.aux";
- g#mount drive_partition "/tmp/in_target.aux/perm";
-
- run_hook_in "finalise.d";
-
- let out_dir = "/tmp/in_target.aux/out/" ^ image_basename_d in
-
- run_hook_out ~new_wd:out_dir "cleanup.d";
-
- g#sync ();
-
- if g#ls out_dir <> [||] then (
- message (f_"Extracting data out of the image");
- do_mkdir (cmdline.image_name ^ ".d");
- g#copy_out out_dir (Filename.dirname cmdline.image_name);
- );
-
- (* Unmount everything, and remount only the root to cleanup
- * its /tmp; this way we should be pretty sure that there is
- * nothing left mounted over /tmp, so it is safe to empty it.
- *)
- checked_umount_all ();
- flush_all ();
- g#mount blockdev "/";
- Array.iter (fun x -> g#rm_rf ("/tmp/" ^ x)) (g#ls "/tmp");
- (* Truncate /var/log files in preparation for first boot. *)
- truncate_recursive g "/var/log";
- let non_log fn =
- not (String.is_suffix fn ".log")
- in
- (* Remove root logs. *)
- rm_rf_only_files g ~filter:non_log "/root";
-
- flush_all ();
-
- Output_format.run_formats_on_filesystem cmdline.formats g cmdline.image_name tmpdir;
-
- message (f_"Umounting the disks");
-
- (* Now that we've finished the build, don't delete the output file on
- * exit.
- *)
- delete_output_file := false;
-
- g#sync ();
- checked_umount_all ();
- g#shutdown ();
- g#close ();
-
- flush_all ();
-
- (* Don't produce images as output when doing a ramdisk build. *)
- if not is_ramdisk_build then
- Output_format.run_formats_on_file cmdline.formats cmdline.image_name (tmpdisk, tmpdiskfmt) tmpdir;
-
- if not is_ramdisk_build && cmdline.checksum then (
- let file_flags = [ Unix.O_WRONLY; Unix.O_CREAT; Unix.O_TRUNC; ] in
- let filenames = Output_format.get_filenames cmdline.formats cmdline.image_name in
- List.iter (
- fun fn ->
- message (f_"Generating checksums for %s") fn;
- let cmds =
- List.map (
- fun csum ->
- let csum_fn = fn ^ "." ^ csum in
- let csum_tool = tool_of_checksum csum in
- let outfd = Unix.openfile csum_fn file_flags 0o640 in
- [ csum_tool; fn ], Some outfd, None
- ) checksums in
- let res = run_commands cmds in
- List.iteri (
- fun i code ->
- if code <> 0 then (
- let args, _, _ = List.nth cmds i in
- error (f_"external command ‘%s’ exited with error %d")
- (List.hd args) code
- )
- ) res;
- ) filenames;
- );
-
- message (f_"Done")
-
-let () = run_main_and_handle_errors main
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(* Nothing is exported. *)
+++ /dev/null
-/* Dummy source, to be used for OCaml-based tools with no C sources. */
-enum { foo = 1 };
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(* Parsing and handling of elements. *)
-
-open Std_utils
-open Tools_utils
-open Common_gettext.Gettext
-
-open Utils
-
-open Printf
-
-type element = {
- directory : string;
- hooks : hooks_map;
-}
-and hooks_map = (string, string list) Hashtbl.t (* hook name, scripts *)
-
-exception Duplicate_script of string * string (* hook, script *)
-
-let builtin_elements_blacklist = [
-]
-
-let builtin_scripts_blacklist = [
- "01-sahara-version"; (* Gets the Git commit ID of the d-i-b and
- * sahara-image-elements repositories. *)
-]
-
-let valid_script_name n =
- let is_char_valid = function
- | 'A'..'Z' | 'a'..'z' | '0'..'9' | '_' | '-' -> true
- | _ -> false in
- try ignore (string_index_fn (fun c -> not (is_char_valid c)) n); false
- with Not_found -> true
-
-let stringset_of_list l =
- List.fold_left (fun acc x -> StringSet.add x acc) StringSet.empty l
-
-let load_hooks ~debug path =
- let hooks = Hashtbl.create 13 in
- let entries = Array.to_list (Sys.readdir path) in
- let entries = List.filter (fun x -> Filename.check_suffix x ".d") entries in
- let entries = List.map (fun x -> (x, path // x)) entries in
- let entries = List.filter (fun (_, x) -> is_directory x) entries in
- List.iter (
- fun (hook, p) ->
- let listing = Array.to_list (Sys.readdir p) in
- let scripts = List.filter valid_script_name listing in
- let scripts = List.filter (
- fun x ->
- try
- let s = Unix.stat (p // x) in
- s.Unix.st_kind = Unix.S_REG && s.Unix.st_perm land 0o111 > 0
- with Unix.Unix_error _ -> false
- ) scripts in
- if scripts <> [] then
- Hashtbl.add hooks hook scripts
- ) entries;
- hooks
-
-let load_scripts (g : Guestfs.guestfs) path =
- let listing = Array.to_list (g#readdir path) in
- let scripts = List.filter (
- function
- | { Guestfs.ftyp = ('r'|'l'|'u'|'?') } -> true
- | _ -> false
- ) listing in
- let scripts = List.filter (fun x -> valid_script_name x.Guestfs.name) scripts in
- List.filter_map (
- fun x ->
- let { Guestfs.st_mode = mode } = g#statns (path ^ "/" ^ x.Guestfs.name) in
- if mode &^ 0o111_L > 0_L then Some x.Guestfs.name
- else None
- ) scripts
-
-let load_elements ~debug paths =
- let loaded_elements = Hashtbl.create 13 in
- let paths = List.filter is_directory paths in
- List.iter (
- fun path ->
- let listing = Array.to_list (Sys.readdir path) in
- let listing = List.map (fun x -> (x, path // x)) listing in
- let listing = List.filter (fun (_, x) -> is_directory x) listing in
- List.iter (
- fun (p, dir) ->
- if not (Hashtbl.mem loaded_elements p) then (
- let elem = { directory = dir; hooks = load_hooks ~debug dir } in
- Hashtbl.add loaded_elements p elem
- ) else if debug >= 1 then (
- printf "element %s (in %s) already present" p path;
- )
- ) listing
- ) paths;
- loaded_elements
-
-let load_dependencies elements loaded_elements =
- let get filename element =
- try
- let path = (Hashtbl.find loaded_elements element).directory in
- let path = path // filename in
- if Sys.file_exists path then (
- let lines = read_whole_file path in
- let lines = String.nsplit "\n" lines in
- let lines = List.filter ((<>) "") lines in
- stringset_of_list lines
- ) else
- StringSet.empty
- with Not_found ->
- error (f_"element %s not found") element in
- let get_deps = get "element-deps" in
- let get_provides = get "element-provides" in
-
- let queue = Queue.create () in
- let final = ref StringSet.empty in
- let provided = ref StringSet.empty in
- let provided_by = Hashtbl.create 13 in
- List.iter (fun x -> Queue.push x queue) elements;
- final := stringset_of_list elements;
- while not (Queue.is_empty queue) do
- let elem = Queue.pop queue in
- if StringSet.mem elem !provided <> true then (
- let element_deps = get_deps elem in
- let element_provides = get_provides elem in
- (* Save which elements provide another element for potential
- * error message.
- *)
- StringSet.iter (fun x -> Hashtbl.add provided_by x elem) element_provides;
- provided := StringSet.union !provided element_provides;
- StringSet.iter (fun x -> Queue.push x queue)
- (StringSet.diff element_deps (StringSet.union !final !provided));
- final := StringSet.union !final element_deps
- )
- done;
- let conflicts = StringSet.inter (stringset_of_list elements) !provided in
- if not (StringSet.is_empty conflicts) then (
- let buf = Buffer.create 100 in
- StringSet.iter (
- fun elem ->
- let s = sprintf (f_" %s: already provided by %s")
- elem (Hashtbl.find provided_by elem) in
- Buffer.add_string buf s
- ) conflicts;
- error (f_"following elements are already provided by another element:\n%s")
- (Buffer.contents buf)
- );
- if not (StringSet.mem "operating-system" !provided) then
- error (f_"please include an operating system element");
- StringSet.diff !final !provided
-
-let copy_element element destdir blacklist =
- let entries = Array.to_list (Sys.readdir element.directory) in
- let entries = List.filter ((<>) "tests") entries in
- let entries = List.filter ((<>) "test-elements") entries in
- let dirs, nondirs = List.partition is_directory entries in
- let dirs = List.map (fun x -> (x, element.directory // x, destdir // x)) dirs in
- let nondirs = List.map (fun x -> element.directory // x) nondirs in
- List.iter (
- fun (e, path, destpath) ->
- do_mkdir destpath;
- let subentries = Array.to_list (Sys.readdir path) in
- let subentries = List.filter (not_in_list blacklist) subentries in
- List.iter (
- fun sube ->
- if is_regular_file (destpath // sube) then (
- raise (Duplicate_script (e, sube))
- ) else
- do_cp (path // sube) destpath
- ) subentries;
- ) dirs;
- List.iter (
- fun path ->
- do_cp path destdir
- ) nondirs
-
-let copy_elements elements loaded_elements blacklist destdir =
- do_mkdir destdir;
- StringSet.iter (
- fun element ->
- try
- copy_element (Hashtbl.find loaded_elements element) destdir blacklist
- with
- | Duplicate_script (hook, script) ->
- let element_has_script e =
- try
- let s = Hashtbl.find (Hashtbl.find loaded_elements e).hooks hook in
- List.exists ((=) script) s
- with Not_found -> false in
- let dups = StringSet.filter element_has_script elements in
- error (f_"There is a duplicated script in your elements:\n%s/%s in: %s")
- hook script (String.concat " " (StringSet.elements dups))
- ) elements
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(** Parsing and handling of elements. *)
-
-type element = {
- directory : string; (** directory of the element *)
- hooks : hooks_map; (** available hooks, and scripts for each hook*)
-}
-and hooks_map = (string, string list) Hashtbl.t (** hook name, scripts *)
-
-val builtin_elements_blacklist : string list
-(** These are the elements which we don't ever try to use. *)
-
-val builtin_scripts_blacklist : string list
-(** These are the scripts which we don't ever try to run.
-
- Usual reason could be that they are not compatible the way
- virt-dib works, e.g. they expect the tree of elements outside
- the chroot, which is not available in the appliance. *)
-
-val load_elements : debug:int -> string list -> (string, element) Hashtbl.t
-(** [load_elements ~debug paths] loads elements from the specified
- [paths]; returns a [Hashtbl.t] of {!element} structs indexed by
- the element name. *)
-
-val load_dependencies : StringSet.elt list -> (string, element) Hashtbl.t -> StringSet.t
-(** [load_dependencies element_set elements] returns the whole set of
- elements needed to use [element_set], including [element_list]
- themselves. In other words, this recursively resolves the
- dependencies of [element_set]. *)
-
-val copy_elements : StringSet.t -> (string, element) Hashtbl.t -> string list -> string -> unit
-(** [copy_elements element_set elements blacklisted_scripts destdir]
- copies the elements in [element_set] (with the element definitions
- provided as [elements]) into the [destdir] directory.
-
- [blacklisted_scripts] contains names of scripts to never copy. *)
-
-val load_hooks : debug:int -> string -> hooks_map
-(** [load_hooks ~debug path] loads the hooks from the specified
- [path] (which usually represents an element). *)
-
-val load_scripts : Guestfs.guestfs -> string -> string list
-(** [load_scripts g path] loads the scripts from the specified [path]
- (which usually represents a directory of an hook). *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2012-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Std_utils
-open Tools_utils
-open Common_gettext.Gettext
-open Getopt.OptionName
-
-open Utils
-
-type format = {
- name : string;
- extra_args : extra_arg list;
- output_to_file : bool;
- check_prerequisites : (unit -> unit) option;
- check_appliance_prerequisites : (Guestfs.guestfs -> unit) option;
- run_on_filesystem : (Guestfs.guestfs -> string -> string -> unit) option;
- run_on_file : (string -> (string * string) -> string -> unit) option;
-}
-and extra_arg = {
- extra_argspec : Getopt.keys * Getopt.spec * Getopt.doc;
-}
-
-let defaults = {
- name = "";
- extra_args = [];
- output_to_file = true;
- check_prerequisites = None;
- check_appliance_prerequisites = None;
- run_on_filesystem = None;
- run_on_file = None;
-}
-
-let all_formats = ref []
-
-module FormatSet = Set.Make (
- struct
- type t = format
- let compare a b = compare a.name b.name
- end
-)
-type set = FormatSet.t
-
-let empty_set = FormatSet.empty
-
-let add_to_set name set =
- let op = List.find (fun { name = n } -> name = n) !all_formats in
- FormatSet.add op set
-
-let set_mem x set =
- FormatSet.exists (fun { name = n } -> n = x) set
-
-let set_cardinal set =
- FormatSet.cardinal set
-
-let register_format op =
- List.push_front op all_formats
-
-let baked = ref false
-let rec bake () =
- (* Note we actually want all_formats to be sorted by name,
- * ignoring the order field.
- *)
- let ops =
- List.sort (fun { name = a } { name = b } -> compare a b) !all_formats in
- check_no_dupes ops;
- List.iter check ops;
- all_formats := ops;
- baked := true
-and check_no_dupes ops =
- ignore (
- List.fold_left (
- fun opset op ->
- if FormatSet.mem op opset then
- error (f_"duplicate format name (%s)") op.name;
- add_to_set op.name opset
- ) empty_set ops
- )
-and check op =
- let n = String.length op.name in
- if n = 0 then
- error (f_"format name is an empty string");
- for i = 0 to n-1 do
- match String.unsafe_get op.name i with
- | 'a'..'z' | 'A'..'Z' | '0'..'9' | '-' -> ()
- | c ->
- error (f_"disallowed character (%c) in format name") c
- done
-
-let extra_args () =
- assert !baked;
-
- List.flatten (
- List.map (fun { extra_args } ->
- List.map (fun { extra_argspec = argspec } -> argspec) extra_args
- ) !all_formats
- )
-
-let list_formats () =
- assert !baked;
-
- List.map (fun { name = n } -> n) !all_formats
-
-let compare_formats { name = n1 } { name = n2 } =
- compare n1 n2
-
-let check_formats_prerequisites ~formats =
- assert !baked;
-
- (* Run the formats in alphabetical, rather than random order. *)
- let formats = List.sort compare_formats (FormatSet.elements formats) in
-
- List.iter (
- function
- | { check_prerequisites = Some fn } ->
- fn ()
- | { check_prerequisites = None } -> ()
- ) formats
-
-let check_formats_appliance_prerequisites ~formats g =
- assert !baked;
-
- (* Run the formats in alphabetical, rather than random order. *)
- let formats = List.sort compare_formats (FormatSet.elements formats) in
-
- List.iter (
- function
- | { check_appliance_prerequisites = Some fn } ->
- fn g
- | { check_appliance_prerequisites = None } -> ()
- ) formats
-
-let run_formats_on_filesystem ~formats g image_name tmpdir =
- assert !baked;
-
- (* Run the formats in alphabetical, rather than random order. *)
- let formats = List.sort compare_formats (FormatSet.elements formats) in
-
- List.iter (
- function
- | { run_on_filesystem = Some fn; name; output_to_file } ->
- let filename =
- if output_to_file then output_filename image_name name
- else "" in
- fn g filename tmpdir
- | { run_on_filesystem = None } -> ()
- ) formats
-
-let run_formats_on_file ~formats image_name tmpdisk tmpdir =
- assert !baked;
-
- (* Run the formats in alphabetical, rather than random order. *)
- let formats = List.sort compare_formats (FormatSet.elements formats) in
-
- List.iter (
- function
- | { run_on_file = Some fn; name; output_to_file } ->
- let filename =
- if output_to_file then output_filename image_name name
- else "" in
- fn filename tmpdisk tmpdir
- | { run_on_file = None } -> ()
- ) formats
-
-let get_filenames ~formats image_name =
- assert !baked;
-
- (* Run the formats in alphabetical, rather than random order. *)
- let formats = List.sort compare_formats (FormatSet.elements formats) in
-
- List.filter_map (
- function
- | { output_to_file = true; name } ->
- Some (output_filename image_name name)
- | { output_to_file = false } ->
- None
- ) formats
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2012-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-(** Handling of output formats. *)
-
-(** Structure used to describe output formats. *)
-type format = {
- name : string;
- (** The name of the format, which is exposed via the [--formats]
- command line parameter. Must contain only alphanumeric and
- '-' (dash) character. *)
-
- extra_args : extra_arg list;
- (** Extra command-line arguments, if any. eg. The [docker]
- format has an extra [--docker-target] parameter.
-
- For a description of each list element, see {!extra_arg} below.
-
- You can decide the types of the arguments, whether they are
- mandatory etc. *)
-
- output_to_file : bool;
- (** Whether the format writes to a file. Most of the formats
- produce a file as result, although some (e.g. docker) do
- not. *)
-
- check_prerequisites : (unit -> unit) option;
- (** The function which is called after the command line processing
- to check whether the requirements for this format (available
- tools, values for command line arguments, etc) are fulfilled. *)
-
- check_appliance_prerequisites : (Guestfs.guestfs -> unit) option;
- (** The function which is called after the appliance start to check
- whether the requirements in the appliance for this format
- (available features, filesystems, etc) are fulfilled. *)
-
- run_on_filesystem : (Guestfs.guestfs -> string -> string -> unit) option;
- (** The function which is called to perform the export while the
- guest is mounted.
-
- The parameters are:
- - [g]: the libguestfs handle
- - [filename]: the output filename for the format, or an empty
- string if {!output_to_file} is [false]
- - [tmpdir]: the temporary directory currently in use *)
-
- run_on_file : (string -> (string * string) -> string -> unit) option;
- (** The function which is called to perform the export using the
- temporary disk as reference.
-
- The parameters are:
- - [filename]: the output filename for the format, or an empty
- string if {!output_to_file} is [false]
- - [tmpdisk]: a tuple representing the temporary disk, as
- [(filename, format)]
- - [tmpdir]: the temporary directory currently in use *)
-}
-
-and extra_arg = {
- extra_argspec : Getopt.keys * Getopt.spec * Getopt.doc;
- (** The argspec. See [Getopt] module in [common/mltools]. *)
-}
-
-val defaults : format
-(** This is so formats can write [let op = { defaults with ... }]. *)
-
-val register_format : format -> unit
-(** Register a format. *)
-
-val bake : unit -> unit
-(** 'Bake' is called after all modules have been registered. We
- finalize the list of formats, sort it, and run some checks. *)
-
-val extra_args : unit -> Getopt.speclist
-(** Get the list of extra arguments for the command line. *)
-
-val list_formats : unit -> string list
-(** List supported formats. *)
-
-type set
-(** A (sub-)set of formats. *)
-
-val empty_set : set
-(** Empty set of formats. *)
-
-val add_to_set : string -> set -> set
-(** [add_to_set name set] adds the format named [name] to [set].
-
- Note that this will raise [Not_found] if [name] is not
- a valid format name. *)
-
-val set_mem : string -> set -> bool
-(** Check whether the specified format is in the set. *)
-
-val set_cardinal : set -> int
-(** Return the size of the formats set. *)
-
-val check_formats_prerequisites : formats:set -> unit
-(** Check the prerequisites in all the formats listed in the [formats] set. *)
-
-val check_formats_appliance_prerequisites : formats:set -> Guestfs.guestfs -> unit
-(** Check the appliance prerequisites in all the formats listed in the
- [formats] set. *)
-
-val run_formats_on_filesystem : formats:set -> Guestfs.guestfs -> string -> string -> unit
-(** Run the filesystem-based export for all the formats listed in the
- [formats] set. *)
-
-val run_formats_on_file : formats:set -> string -> (string * string) -> string -> unit
-(** Run the disk-based export for all the formats listed in the
- [formats] set. *)
-
-val get_filenames : formats:set -> string -> string list
-(** Return the list of all the output filenames for formats in the
- [formats] set. Only formats with {!output_to_file} as [true]
- will be taken into account. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2016-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Tools_utils
-open Common_gettext.Gettext
-open Getopt.OptionName
-
-open Utils
-open Output_format
-
-let docker_target = ref None
-let set_docker_target arg = docker_target := Some arg
-
-let docker_check () =
- require_tool "docker";
- if !docker_target = None then
- error (f_"docker: a target was not specified, use ‘--docker-target’")
-
-let docker_run_fs (g : Guestfs.guestfs) _ temp_dir =
- let docker_target =
- match !docker_target with
- | None -> assert false (* checked earlier *)
- | Some t -> t in
- message (f_"Importing the image to docker as ‘%s’") docker_target;
- let dockertmp = Filename.temp_file ~temp_dir "docker." ".tar" in
- g#tar_out ~excludes:[| "./sys/*"; "./proc/*" |] ~xattrs:true ~selinux:true
- "/" dockertmp;
- let cmd = [ "sudo"; "docker"; "import"; dockertmp; docker_target ] in
- if run_command cmd <> 0 then exit 1
-
-let fmt = {
- defaults with
- name = "docker";
- output_to_file = false;
- extra_args = [
- { extra_argspec = [ L"docker-target" ], Getopt.String ("target", set_docker_target), s_"Repo and tag for docker"; };
- ];
- check_prerequisites = Some docker_check;
- run_on_filesystem = Some docker_run_fs;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Std_utils
-open Tools_utils
-open Common_gettext.Gettext
-open Getopt.OptionName
-
-open Utils
-open Output_format
-
-let compressed = ref true
-let qemu_img_options = ref None
-let set_qemu_img_options arg = qemu_img_options := Some arg
-
-let qcow2_check () =
- require_tool "qemu-img"
-
-let qcow2_run_file filename (tmpdisk, tmpdiskfmt) _ =
- message (f_"Converting to qcow2");
- let cmd = [ "qemu-img"; "convert" ] @
- (if !compressed then [ "-c" ] else []) @
- [ "-f"; tmpdiskfmt; tmpdisk; "-O"; "qcow2" ] @
- (match !qemu_img_options with
- | None -> []
- | Some opt -> [ "-o"; opt ]) @
- [ qemu_input_filename filename ] in
- if run_command cmd <> 0 then exit 1
-
-let fmt = {
- defaults with
- name = "qcow2";
- extra_args = [
- { extra_argspec = [ S 'u' ], Getopt.Clear compressed, s_"Do not compress the qcow2 image"; };
- { extra_argspec = [ L"qemu-img-options" ], Getopt.String ("option", set_qemu_img_options), s_"Add qemu-img options"; };
- ];
- check_prerequisites = Some qcow2_check;
- run_on_file = Some qcow2_run_file;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Output_format
-
-(* The raw format is currently handled on its own in virt-dib,
- * so this is merely to add the output format to the available
- * ones. This might change in the future, though.
- *)
-
-let fmt = {
- defaults with
- name = "raw";
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2017 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Tools_utils
-open Common_gettext.Gettext
-
-open Output_format
-
-let squashfs_check (g : Guestfs.guestfs) =
- g#available [| "squashfs" |]
-
-let squashfs_run_fs (g : Guestfs.guestfs) filename _ =
- message (f_"Compressing the image as squashfs");
- g#mksquashfs ~excludes:[| "sys/*"; "proc/*"; "dev/*" |] ~compress:"xz"
- "/" filename
-
-let fmt = {
- defaults with
- name = "squashfs";
- check_appliance_prerequisites = Some squashfs_check;
- run_on_filesystem = Some squashfs_run_fs;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Tools_utils
-open Common_gettext.Gettext
-
-open Output_format
-
-let tar_run_fs (g : Guestfs.guestfs) filename _ =
- message (f_"Compressing the image as tar");
- g#tar_out ~excludes:[| "./sys/*"; "./proc/*" |] ~xattrs:true ~selinux:true
- "/" filename
-
-let fmt = {
- defaults with
- name = "tar";
- run_on_filesystem = Some tar_run_fs;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2017 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Tools_utils
-open Common_gettext.Gettext
-
-open Output_format
-
-let tgz_run_fs (g : Guestfs.guestfs) filename _ =
- message (f_"Compressing the image as tar.gz");
- g#tar_out ~excludes:[| "./sys/*"; "./proc/*" |] ~xattrs:true ~selinux:true
- ~compress:"gzip" "/" filename
-
-let fmt = {
- defaults with
- name = "tgz";
- run_on_filesystem = Some tgz_run_fs;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015-2023 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Tools_utils
-open Common_gettext.Gettext
-
-open Utils
-open Output_format
-
-let vhd_check () =
- require_tool "vhd-util"
-
-let vhd_run_file filename (tmpdisk, _) temp_dir =
- message (f_"Converting to VHD");
- let fn_intermediate = Filename.temp_file ~temp_dir "vhd-intermediate." "" in
- let cmd = [ "vhd-util"; "convert"; "-s"; "0"; "-t"; "1";
- "-i"; tmpdisk; "-o"; fn_intermediate ] in
- if run_command cmd <> 0 then exit 1;
- let cmd = [ "vhd-util"; "convert"; "-s"; "1"; "-t"; "2";
- "-i"; fn_intermediate; "-o"; filename ] in
- if run_command cmd <> 0 then exit 1;
- if not (Sys.file_exists filename) then
- error (f_"VHD output not produced, most probably vhd-util is old or not patched for ‘convert’")
-
-let fmt = {
- defaults with
- name = "vhd";
- check_prerequisites = Some vhd_check;
- run_on_file = Some vhd_run_file;
-}
-
-let () = register_format fmt
+++ /dev/null
-(* This file is generated by Makefile.am. *)
-(* Nothing is exported from output format modules. *)
+++ /dev/null
-#!/bin/bash -
-# libguestfs
-# Copyright (C) 2016 Red Hat Inc.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-set -e
-
-$TEST_FUNCTIONS
-
-$top_srcdir/podcheck.pl "$srcdir/virt-dib.pod" virt-dib
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-open Std_utils
-open Tools_utils
-open Common_gettext.Gettext
-
-open Printf
-
-let unit_GB howmany =
- (Int64.of_int howmany) *^ 1024_L *^ 1024_L *^ 1024_L
-
-let current_arch () =
- (* Turn a CPU into the dpkg architecture naming. *)
- match Guestfs_config.host_cpu with
- | "amd64" | "x86_64" -> "amd64"
- | "i386" | "i486" | "i586" | "i686" -> "i386"
- | arch when String.is_prefix arch "armv" -> "armhf"
- | arch -> arch
-
-let output_filename image_name = function
- | "squashfs" -> image_name ^ ".squash"
- | fmt -> image_name ^ "." ^ fmt
-
-let log_filename () =
- let tm = Unix.gmtime (Unix.time ()) in
- sprintf "%s-%d%02d%02d-%02d%02d%02d.log"
- prog (tm.Unix.tm_year + 1900) (tm.Unix.tm_mon + 1) tm.Unix.tm_mday
- tm.Unix.tm_hour tm.Unix.tm_min tm.Unix.tm_sec
-
-let var_from_lines var lines =
- let var_with_equal = var ^ "=" in
- let var_lines = List.filter (fun x -> String.is_prefix x var_with_equal) lines in
- match var_lines with
- | [] ->
- error (f_"variable ‘%s’ not found in lines:\n%s")
- var (String.concat "\n" lines)
- | [x] -> snd (String.split "=" x)
- | _ ->
- error (f_"variable ‘%s’ has more than one occurrency in lines:\n%s")
- var (String.concat "\n" lines)
-
-let string_index_fn fn str =
- let len = String.length str in
- let rec loop i =
- if i = len then raise Not_found
- else if fn str.[i] then i
- else loop (i + 1) in
- loop 0
-
-let digit_prefix_compare a b =
- let myint str =
- try int_of_string str
- with _ -> 0 in
- let mylength str =
- match String.length str with
- | 0 -> max_int
- | x -> x in
- let split_prefix str =
- let len = String.length str in
- let digits =
- try string_index_fn (fun x -> not (Char.isdigit x)) str
- with Not_found -> len in
- match digits with
- | 0 -> "", str
- | x when x = len -> str, ""
- | _ -> String.sub str 0 digits, String.sub str digits (len - digits) in
-
- let pref_a, rest_a = split_prefix a in
- let pref_b, rest_b = split_prefix b in
- match mylength pref_a, mylength pref_b, compare (myint pref_a) (myint pref_b) with
- | x, y, 0 when x = y -> compare rest_a rest_b
- | x, y, 0 -> x - y
- | _, _, x -> x
-
-let do_mkdir dir =
- mkdir_p dir 0o755
-
-let get_required_tool tool =
- try which tool
- with Executable_not_found tool ->
- error (f_"%s needed but not found") tool
-
-let require_tool tool =
- ignore (get_required_tool tool)
-
-let do_cp src destdir =
- let cmd = [ "cp"; "-t"; destdir; "-a"; src ] in
- if run_command cmd <> 0 then exit 1
-
-let ensure_trailing_newline str =
- if String.length str > 0 && str.[String.length str - 1] <> '\n' then str ^ "\n"
- else str
-
-let not_in_list l e =
- not (List.mem e l)
+++ /dev/null
-(* virt-dib
- * Copyright (C) 2015 Red Hat Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
- *)
-
-val unit_GB : int -> int64
-(** [unit_GB n] returns n * 2^30 *)
-
-val current_arch : unit -> string
-(** Turn the host_cpu into the dpkg architecture naming. *)
-
-val output_filename : string -> string -> string
-(** [output_filename image_name format] generates a suitable output
- filename based on the image filename and output format. *)
-
-val log_filename : unit -> string
-(** Generate a name for the log file containing the program name and
- current date/time. *)
-
-val var_from_lines : string -> string list -> string
-(** Find variable definition in a set of lines of the form [var=value]. *)
-
-val string_index_fn : (char -> bool) -> string -> int
-(** Apply function to each character in the string. If the function
- returns true, return the index of the character.
-
- In other words, like {!String.index} but using a function
- instead of a single character.
-
- @raise Not_found if no match *)
-
-val digit_prefix_compare : string -> string -> int
-
-val do_mkdir : string -> unit
-(** Wrapper around [mkdir -p -m 0755] *)
-
-val get_required_tool : string -> string
-(** Ensure external program is installed. Return the full path of the
- program or fail with an error message. *)
-
-val require_tool : string -> unit
-(** Same as {!get_required_tool} but only checks the external program
- is installed and does not return the path. *)
-
-val do_cp : string -> string -> unit
-(** Wrapper around [cp -a src destdir]. *)
-
-val ensure_trailing_newline : string -> string
-(** If the input string is not [""], ensure there is a trailing ['\n'],
- adding one if necessary. *)
-
-val not_in_list : 'a list -> 'a -> bool
-(** Opposite of {!List.mem}. *)
+++ /dev/null
-=head1 NAME
-
-virt-dib - Run diskimage-builder elements
-
-=head1 SYNOPSIS
-
- virt-dib -B DIB-LIB [options] elements...
-
-=head1 DESCRIPTION
-
-Virt-dib is a tool for using the elements of C<diskimage-builder>
-to build a new disk image, generate new ramdisks, etc.
-
-Virt-dib is intended as safe replacement for C<diskimage-builder>
-and its C<ramdisk-image-create> mode, see
-L</COMPARISON WITH DISKIMAGE-BUILDER> for a quick comparison with
-usage of C<diskimage-builder>.
-
-C<diskimage-builder> is part of the TripleO OpenStack project:
-L<https://wiki.openstack.org/wiki/TripleO>.
-
-=head1 EXAMPLES
-
-=head2 Build simple images of distributions
-
- virt-dib \
- -B /path/to/diskimage-builder/lib \
- -p /path/to/diskimage-builder/elements \
- --envvar DIB_RELEASE=jessie \
- --name debian-jessie \
- debian vm
-
-This builds a Debian Jessie (8.x) disk image, suitable for running
-as virtual machine, saved as F<debian-jessie.qcow2>.
-
-=head2 Build ramdisks
-
- virt-dib \
- -B /path/to/diskimage-builder/lib \
- -p /path/to/diskimage-builder/elements \
- --ramdisk \
- --name ramdisk \
- ubuntu deploy-ironic
-
-This builds a ramdisk for the Ironic OpenStack component based
-on the Ubuntu distribution.
-
-=head1 OPTIONS
-
-=over 4
-
-=item B<--help>
-
-Display help.
-
-=item B<-B> PATH
-
-Set the path to the library directory of C<diskimage-builder>. This is
-usually the F<lib> subdirectory in the sources and when installed,
-and F</usr/share/diskimage-builder/lib> when installed in F</usr>.
-
-This parameter is B<mandatory>, as virt-dib needs to provide it for
-the elements (as some of them might use scripts in it).
-Virt-dib itself does not make use of the library directory.
-
-=item B<--arch> ARCHITECTURE
-
-Use the specified architecture for the output image. The default
-value is the same as the host running virt-dib.
-
-Right now this option does nothing more than setting the C<ARCH>
-environment variable for the elements, and it’s up to them to
-produce an image for the requested architecture.
-
-=item B<--checksum>
-
-Generate checksum files for the generated image. The supported
-checksums are MD5, and SHA256.
-
-=item B<--colors>
-
-=item B<--colours>
-
-Use ANSI colour sequences to colourize messages. This is the default
-when the output is a tty. If the output of the program is redirected
-to a file, ANSI colour sequences are disabled unless you use this
-option.
-
-=item B<--debug> LEVEL
-
-Set the debug level to C<LEVEL>, which is a non-negative integer
-number. The default is C<0>.
-
-This debug level is different than what I<-x> and I<-v> set,
-and it increases the debugging information printed out.
-Specifically, this sets the C<DIB_DEBUG_TRACE>, and any value
-E<gt> C<0> enables tracing in the scripts executed.
-
-=item B<--docker-target> TARGET
-
-Set the repository and tag for docker.
-
-This is used only when the formats include C<docker>, and it is
-required in that case.
-
-=item B<--drive> DISK
-
-Add the specified disk to be used as helper drive where to cache
-files of the elements, like disk images, distribution packages, etc.
-
-See L</HELPER DRIVE>.
-
-=item B<--drive-format> raw
-
-=item B<--drive-format> qcow2
-
-Specify the format of the helper drive. If this flag is not given
-then it is auto-detected from the drive itself.
-
-If working with untrusted raw-format guest disk images, you should
-ensure the format is always specified.
-
-This option is used only if I<--drive> is specified.
-
-See L</HELPER DRIVE>.
-
-=item B<-p> PATH
-
-=item B<--element-path> PATH
-
-Add a new path with elements. Paths are used in the same order as the
-I<-p> parameters appear, so a path specified first is looked first,
-and so on.
-
-Obviously, it is recommended to add the path to the own elements of
-C<diskimage-builder>, as most of the other elements will rely on them.
-
-=item B<--extra-packages> PACKAGE,...
-
-Install additional packages in the image being built.
-
-This relies on the C<install-packages> binary provided by the
-package management elements.
-
-This option can be specified multiple times, each time with multiple
-packages separated by comma.
-
-=item B<--envvar> VARIABLE
-
-=item B<--envvar> VARIABLE=VALUE
-
-Carry or set an environment variable for the elements.
-
-See L</ENVIRONMENT VARIABLES> below for more information on the
-interaction and usage of environment variables.
-
-This option can be used in two ways:
-
-=over 4
-
-=item B<--envvar> VARIABLE
-
-Carry the environment variable C<VARIABLE>. If it is not set, nothing
-is exported to the elements.
-
-=item B<--envvar> VARIABLE=VALUE
-
-Set the environment variable C<VARIABLE> with value C<VALUE> for the
-elements, regardless whether an environment variable with the same
-name exists.
-
-This can be useful to pass environment variable without exporting
-them in the environment where virt-dib runs.
-
-=back
-
-=item B<--exclude-element> ELEMENT
-
-Ignore the specified element.
-
-=item B<--exclude-script> SCRIPT
-
-Ignore any element script named C<SCRIPT>, whichever element it is in.
-
-This can be useful in case some script does not run well with
-virt-dib, for example when they really need C<diskimage-builder>'s
-environment.
-
-=item B<--formats> FORMAT,...
-
-Set the list of output formats, separating them with comma.
-
-Supported formats are:
-
-=over 4
-
-=item C<docker>
-
-Import the image to docker, running B<docker import>. The target for
-the image B<must> be specified using I<--docker-target>.
-
-Please note this operation usually requires the docker service to be
-enabled, otherwise it will fail. Furthermore, B<docker> is run using
-L<sudo(8)>, so make sure the user has the permissions to run at least
-B<docker>.
-
-=item C<qcow2> (enabled by default)
-
-QEMU’s qcow2. This output format requires the C<qemu-img> tool.
-
-=item C<raw>
-
-Raw disk format.
-
-=item C<squashfs>
-
-An squashfs filesystem, compressed with XZ. This output format
-requires the C<squashfs> feature; see also
-L<guestfs(3)/AVAILABILITY>.
-
-=item C<tar>
-
-An uncompressed tarball.
-
-=item C<tgz>
-
-A tarball compressed with gzip.
-
-=item C<vhd>
-
-C<Virtual Hard Disk> disk image. This output format requires
-the C<vhd-util> tool.
-
-Please note that the version of C<vhd-util> tool needs to be patched
-to support the C<convert> subcommand, and to be bootable.
-The patch is available here:
-L<https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix>.
-
-=back
-
-=item B<--fs-type> FILESYSTEM
-
-Set the filesystem type to use for the root filesystem. The default
-is C<ext4>.
-
-See also L<guestfs(3)/guestfs_filesystem_available>.
-
-=item B<--image-cache> DIRECTORY
-
-Set the path in the host where cache the resources used by the
-elements of the C<extra-data.d> phase. The default is
-F<~/.cache/image-create>.
-
-Please note that most of the resources fetched in phases other than
-C<extra-data.d> will be cached in the helper drive specified with
-I<--drive>; see also L</HELPER DRIVE>.
-
-=item B<--install-type> TYPE
-
-Specify the default installation type. Defaults to C<source>.
-
-Set to C<package> to use package based installations by default.
-
-=item B<--machine-readable>
-
-=item B<--machine-readable>=format
-
-This option is used to make the output more machine friendly
-when being parsed by other programs. See
-L</MACHINE READABLE OUTPUT> below.
-
-=item B<-m> MB
-
-=item B<--memsize> MB
-
-Change the amount of memory allocated to the appliance. Increase
-this if you find that the virt-dib execution runs out of memory.
-
-The default can be found with this command:
-
- guestfish get-memsize
-
-=item B<--mkfs-options> C<OPTION STRING>
-
-Add the specified options to L<mkfs(1)>, to be able to fine-tune
-the root filesystem creation; the options are passed to the driver
-of L<mfks(1)>, and not to L<mfks(1)> itself. Note that
-I<--fs-type> is used to change the filesystem type.
-
-You should use I<--mkfs-options> at most once. To pass multiple
-options, separate them with space, eg:
-
- virt-dib ... --mkfs-options '-O someopt -I foo'
-
-=item B<--network>
-
-=item B<--no-network>
-
-Enable or disable network access from the guest during the
-installation.
-
-Enabled is the default. Use I<--no-network> to disable access.
-
-The network only allows outgoing connections and has other minor
-limitations. See L<virt-rescue(1)/NETWORK>.
-
-This does not affect whether the guest can access the network once it
-has been booted, because that is controlled by your hypervisor or
-cloud environment and has nothing to do with virt-dib.
-
-If you use I<--no-network>, then the environment variable
-C<DIB_OFFLINE> is set to C<1>, signaling the elements that they
-should use only cached resources when available. Note also that,
-unlike with C<diskimage-builder> where elements may still be able
-to access to the network even with C<DIB_OFFLINE=>, under virt-dib
-network will not be accessible at all.
-
-=item B<--name> NAME
-
-Set the name of the output image file. The default is C<image>.
-
-According to the chosen name, there will be the following in the
-current directory:
-
-=over 4
-
-=item F<$NAME.ext>
-
-For each output format, a file named after the output image
-with the extension depending on the format; for example:
-F<$NAME.qcow2>, F<$NAME.raw>, etc.
-
-Not applicable in ramdisk mode, see L</RAMDISK BUILDING>.
-
-=item F<$NAME.d>
-
-A directory containing any files created by the elements, for example
-F<dib-manifests> directory (created by the C<manifests> element),
-ramdisks and kernels in ramdisk mode, and so on.
-
-=item F<$NAME.ext.checksum>
-
-When I<--checksum> is specified, there will be files for each
-supported checksum type; for example: F<$NAME.ext.md5>,
-F<$NAME.ext.sha256>, etc.
-
-Not applicable in ramdisk mode, see L</RAMDISK BUILDING>.
-
-=back
-
-=item B<--no-delete-on-failure>
-
-Don’t delete the output files on failure to build. You can use this
-to debug failures to run scripts.
-
-The default is to delete the output files if virt-dib fails (or,
-for example, some script that it runs fails).
-
-=item B<--python> PYTHON
-
-Specify a different Python interpreter to use. Parts of
-C<diskimage-builder> are implemented in Python, and thus an
-interpreter is needed.
-
-C<PYTHON> can either be an executable filename (e.g. F<python2>,
-which is then searched in C<$PATH>), or a full path (e.g.
-F</usr/bin/python2>). If not specified, the default value is
-F<python>.
-
-=item B<-q>
-
-=item B<--quiet>
-
-Don’t print ordinary progress messages.
-
-=item B<--qemu-img-options> option[,option,...]
-
-Pass I<--qemu-img-options> option(s) to the L<qemu-img(1)> command
-to fine-tune the output format. Options available depend on
-the output format (see I<--formats>) and the installed version
-of the qemu-img program.
-
-You should use I<--qemu-img-options> at most once. To pass multiple
-options, separate them with commas, eg:
-
- virt-dib ... --qemu-img-options cluster_size=512,preallocation=metadata ...
-
-=item B<--ramdisk>
-
-Set the ramdisk building mode.
-
-See L</RAMDISK BUILDING>.
-
-=item B<--ramdisk-element> NAME
-
-Set the name for the additional element added in ramdisk building
-mode. The default is C<ramdisk>.
-
-See L</RAMDISK BUILDING>.
-
-=item B<--root-label> LABEL
-
-Set the label for the root filesystem in the created image.
-
-Please note that some filesystems have different restrictions on
-the length of their labels; for example, on C<ext2/3/4> filesystems
-labels cannot be longer than 16 characters, while on C<xfs> they have
-at most 12 characters.
-
-The default depends on the actual filesystem for the root partition
-(see I<--fs-type>): on C<xfs> is C<img-rootfs>, while
-C<cloudimg-rootfs> on any other filesystem.
-
-=item B<--size> SIZE
-
-Select the size of the output disk, where the size can be specified
-using common names such as C<32G> (32 gigabytes) etc.
-The default size is C<5G>.
-
-To specify size in bytes, the number must be followed by the lowercase
-letter I<b>, eg: S<C<--size 10737418240b>>.
-
-See also L<virt-resize(1)> for resizing partitions of an existing
-disk image.
-
-=item B<--skip-base>
-
-Skip the inclusion of the C<base> element.
-
-=item B<--smp> N
-
-Enable N E<ge> 2 virtual CPUs for scripts to use.
-
-=item B<-u>
-
-Do not compress resulting qcow2 images. The default is to compress
-them.
-
-=item B<-v>
-
-=item B<--verbose>
-
-Enable debugging messages.
-
-=item B<-V>
-
-=item B<--version>
-
-Display version number and exit.
-
-=item B<--wrap>
-
-Wrap error, warning, and informative messages. This is the default
-when the output is a tty. If the output of the program is redirected
-to a file, wrapping is disabled unless you use this option.
-
-=item B<-x>
-
-Enable tracing of libguestfs API calls.
-
-=back
-
-=head1 ENVIRONMENT VARIABLES
-
-Unlike with C<diskimage-builder>, the environment of the host is
-B<not> inherited in the appliance when running most of the elements
-(i.e. all except the ones in the C<extra-data.d> phase).
-
-To set environment for the elements being run, it is necessary to tell
-virt-dib to use them, with the option I<--envvar>. Such option
-allows to selectively export environment variables when running the
-elements, and it is the preferred way to pass environment variables
-to the elements.
-
-To recap: if you want the environment variable C<MYVAR>
-(and its content) to be available to the elements, you can do either
-
- export MYVAR # whichever is its value
- virt-dib ... --envvar MYVAR ...
-
-or
-
- virt-dib ... --envvar MYVAR=value_of_it ...
-
-=head1 HELPER DRIVE
-
-Virt-dib runs most of the element in its own appliance, and thus not
-on the host. Because of this, there is no possibility for elements
-to cache resources directly on the host.
-
-To solve this issue, virt-dib allows the usage of an helper drive
-where to store cached resources, like disk images,
-distribution packages, etc. While this means that there is a smaller
-space available for caching, at least it allows to limit the space
-on the host for caches, without assuming that elements will do that
-by themselves.
-
-Currently this disk is either required to have a single partition
-on it, or the first partition on it will be used. A disk with
-the latter configuration can be easily created with L<guestfish(1)>
-like the following:
-
- guestfish -N filename.img=fs:ext4:10G exit
-
-The above will create a disk image called F<filename.img>, 10G big,
-with a single partition of type ext4;
-see L<guestfish(1)/PREPARED DISK IMAGES>.
-
-It is recommended for it to be E<ge> 10G or even more, as elements
-will cache disk images, distribution packages, etc. As with any disk
-image, the helper disk can be easily resized using L<virt-resize(1)>
-if more space in it is needed.
-
-The drive can be accessed like any other disk image, for example using
-other tools of libguestfs such as L<guestfish(1)>:
-
- guestfish -a filename.img -m /dev/sda1
-
-If no helper drive is specified with I<--drive>, all the resources
-cached during a virt-dib run will be discarded.
-
-=head2 RESOURCES INSIDE THE DRIVE
-
-Inside the helper drive, it is possible to find the following
-resources:
-
-=over 4
-
-=item F</home>
-
-This directory is set as C<HOME> environment variable during the
-build. It contains mostly the image cache (saved as
-F</home/.cache/image-create>), and whichever other resource is
-cached in the home directory of the user running the various tools.
-
-=item F</virt-dib-*.log>
-
-These are the logs of the elements being run within the libguestfs
-appliance, which means all the phases except C<extra-data.d>.
-
-=back
-
-=head1 RAMDISK BUILDING
-
-Virt-dib can emulate also C<ramdisk-image-create>, which is a
-secondary operation mode of C<diskimage-builder>. Instead of being
-a different tool name, virt-dib provides easy access to this mode
-using the I<--ramdisk> switch.
-
-In this mode:
-
-=over 4
-
-=item
-
-there is an additional ramdisk element added (see
-I<--ramdisk-element>)
-
-=item
-
-no image is produced (so I<--formats> is ignored)
-
-=item
-
-F<$NAME.d> (see I<--name>) will contain initrd, kernel, etc
-
-=back
-
-=head1 TEMPORARY DIRECTORY
-
-Virt-dib uses the standard temporary directory used by libguestfs,
-see L<guestfs(3)/ENVIRONMENT VARIABLES>.
-
-By default this location is F</tmp> (default value for C<TMPDIR>),
-which on some systems may be on a tmpfs filesystem, and thus
-defaulting to a maximum size of I<half> of physical RAM.
-If virt-dib exceeds this, it may hang or exit early with an error.
-The solution is to point C<TMPDIR> to a permanent location used
-as temporary location, for example:
-
- mkdir local-tmp
- env TMPDIR=$PWD/local-tmp virt-dib ...
- rm -rf local-tmp
-
-=head1 EXTRA DEPENDENCIES
-
-Because of virt-dib runs most of the elements in its own appliance,
-all the tools and libraries used by elements running outside the
-guest (typically C<root.d>, C<block-device.d>, and C<cleanup.d>)
-need to be present in the appliance as well. In case they
-are not, scripts will fail typically with a C<command not found>
-error.
-
-For tools and libraries packaged by the distribution, the easy
-solution is to tell libguestfs to include additional packages in the
-appliance. This is doable by e.g. creating a new file with the
-additional packages:
-
- # echo wget > /usr/lib64/guestfs/supermin.d/dib-my-extra
-
-The actual path to the F<supermin.d> directory depends on the
-distribution; additional files can list more packages, each in
-its own line. For more details, see L<supermin(1)>.
-
-=head1 COMPARISON WITH DISKIMAGE-BUILDER
-
-Virt-dib is intended as safe replacement for C<diskimage-builder>
-and its C<ramdisk-image-create> mode; the user-notable differences
-consist in:
-
-=over 4
-
-=item
-
-the command line arguments; some of the arguments are the same as
-available in C<diskimage-builder>, while some have different names:
-
- disk-image-create virt-dib
- ----------------- --------
- -a ARCH --arch ARCH
- --image-size SIZE --size SIZE
- --max-online-resize SIZE doable using --mkfs-options
- -n --skip-base
- -o IMAGENAME --name IMAGENAME
- -p PACKAGE(S) --extra-packages PACKAGE(S)
- -t FORMAT(S) --formats FORMAT(S)
- -x --debug 1
- -x -x --debug 2
- -x -x [-x ...] --debug 3/4/etc
-
-=item
-
-the location of non-image output files (like ramdisks and kernels)
-
-=item
-
-the way some of the cached resources are saved: using an helper drive,
-not directly on the disk where virt-dib is run
-
-=item
-
-the need to specify a target size for the output disk, as opposed
-to C<diskimage-builder> calculating an optimal one
-
-=item
-
-the handling of environment variables, see L</ENVIRONMENT VARIABLES>.
-
-Furthermore, other than the libguestfs own environment variables
-(see L<guestfs(3)/ENVIRONMENT VARIABLES>), virt-dib does not read
-any other environment variable: this means that all the options
-and behaviour changes are specified solely using command line
-arguments
-
-=item
-
-extra tools needed on some out-of-chroot phases need to be available
-in the appliance, see L</EXTRA DEPENDENCIES>.
-
-=back
-
-Elements themselves should notice no difference in they way
-they are run; behaviour differences may due to wrong assumptions in
-elements, or not correct virt-dib emulation.
-
-Known issues at the moment:
-
-=over 4
-
-=item
-
-(none)
-
-=back
-
-=head1 MACHINE READABLE OUTPUT
-
-The I<--machine-readable> option can be used to make the output more
-machine friendly, which is useful when calling virt-dib from other
-programs, GUIs etc.
-
-Use the option on its own to query the capabilities of the
-virt-dib binary. Typical output looks like this:
-
- $ virt-dib --machine-readable
- virt-dib
- output:qcow2
- output:tar
- output:raw
- output:vhd
-
-A list of features is printed, one per line, and the program exits
-with status 0.
-
-The C<output:> features refer to the output formats (I<--formats>
-command line option) supported by this binary.
-
-It is possible to specify a format string for controlling the output;
-see L<guestfs(3)/ADVANCED MACHINE READABLE OUTPUT>.
-
-=head1 TESTING
-
-Virt-dib has been tested with C<diskimage-builder> (and its elements)
-E<ge> 0.1.43; from time to time also with C<tripleo-image-elements>
-and C<sahara-image-elements>.
-
-Previous versions may work, but it is not guaranteed.
-
-=head1 EXIT STATUS
-
-This program returns 0 if successful, or non-zero if there was an
-error.
-
-=head1 SEE ALSO
-
-L<guestfs(3)>,
-L<guestfish(1)>,
-L<virt-resize(1)>,
-L<http://libguestfs.org/>.
-
-=head1 AUTHOR
-
-Pino Toscano (C<ptoscano at redhat dot com>)
-
-=head1 COPYRIGHT
-
-Copyright (C) 2015 Red Hat Inc.
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
output_string ("changed:");
#define COMPARE_STAT(n) \
if (file1->stat->n != file2->stat->n) output_string (#n)
- COMPARE_STAT (st_dev);
- COMPARE_STAT (st_ino);
+ /* Comparing st_dev and st_ino is disabled for now, see the longer
+ * discussion here:
+ * https://listman.redhat.com/archives/libguestfs/2023-July/032061.html
+ * Even if we fixed the libguestfs API to do translation of this
+ * field correctly, it seems unlikely that there would ever be a
+ * meaningful difference in the st_dev or st_ino fields. We
+ * already know the fields refer to the same filename. Is it
+ * interesting that the file might have moved to a different disk?
+ * Everything else is comparing the content or direct metadata of
+ * the file, but st_dev and st_ino represent the metadata of the
+ * filesystem which is (arguably) different.
+ */
+// COMPARE_STAT (st_dev);
+// COMPARE_STAT (st_ino);
COMPARE_STAT (st_mode);
COMPARE_STAT (st_nlink);
COMPARE_STAT (st_uid);
EXTRA_DIST = \
guestfs-tools-release-notes-1.48.pod \
- guestfs-tools-release-notes-1.50.pod
+ guestfs-tools-release-notes-1.50.pod \
+ guestfs-tools-release-notes-1.52.pod
man_MANS = \
guestfs-tools-release-notes-1.48.1 \
- guestfs-tools-release-notes-1.50.1
+ guestfs-tools-release-notes-1.50.1 \
+ guestfs-tools-release-notes-1.52.1
noinst_DATA = \
$(top_builddir)/website/guestfs-tools-release-notes-1.48.1.html \
- $(top_builddir)/website/guestfs-tools-release-notes-1.50.1.html
+ $(top_builddir)/website/guestfs-tools-release-notes-1.50.1.html \
+ $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html
guestfs-tools-release-notes-1.48.1 guestfs-tools-release-notes-1.48.txt $(top_builddir)/website/guestfs-tools-release-notes-1.48.1.html: stamp-guestfs-tools-release-notes-1.48.pod
--license GPLv2+ \
$<
touch $@
+
+guestfs-tools-release-notes-1.52.1 guestfs-tools-release-notes-1.52.txt $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html: stamp-guestfs-tools-release-notes-1.52.pod
+
+stamp-guestfs-tools-release-notes-1.52.pod: guestfs-tools-release-notes-1.52.pod
+ $(PODWRAPPER) \
+ --section 1 \
+ --man guestfs-tools-release-notes-1.52.1 \
+ --html $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html \
+ --license GPLv2+ \
+ $<
+ touch $@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
guestfs_am_v_po4a_translate_0 = @echo " PO4A-T " $@;
EXTRA_DIST = \
guestfs-tools-release-notes-1.48.pod \
- guestfs-tools-release-notes-1.50.pod
+ guestfs-tools-release-notes-1.50.pod \
+ guestfs-tools-release-notes-1.52.pod
man_MANS = \
guestfs-tools-release-notes-1.48.1 \
- guestfs-tools-release-notes-1.50.1
+ guestfs-tools-release-notes-1.50.1 \
+ guestfs-tools-release-notes-1.52.1
noinst_DATA = \
$(top_builddir)/website/guestfs-tools-release-notes-1.48.1.html \
- $(top_builddir)/website/guestfs-tools-release-notes-1.50.1.html
+ $(top_builddir)/website/guestfs-tools-release-notes-1.50.1.html \
+ $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html
all: all-am
$<
touch $@
+guestfs-tools-release-notes-1.52.1 guestfs-tools-release-notes-1.52.txt $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html: stamp-guestfs-tools-release-notes-1.52.pod
+
+stamp-guestfs-tools-release-notes-1.52.pod: guestfs-tools-release-notes-1.52.pod
+ $(PODWRAPPER) \
+ --section 1 \
+ --man guestfs-tools-release-notes-1.52.1 \
+ --html $(top_builddir)/website/guestfs-tools-release-notes-1.52.1.html \
+ --license GPLv2+ \
+ $<
+ touch $@
+
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
--- /dev/null
+=head1 NAME
+
+guestfs-tools-release-notes - guestfs tools release Notes
+
+=head1 RELEASE NOTES FOR GUESTFS TOOLS 1.52
+
+These are the release notes for guestfs tools stable release 1.52.
+This describes the major changes since 1.50.
+
+Guestfs tools 1.52.0 was released on B<5 January 2024>.
+
+=begin comment
+
+=head2 Security
+
+=end comment
+
+=head2 virt-dib was removed
+
+virt-dib, a tool that built disk images using diskimage-builder
+descriptions has been removed. It only supported an older version of
+the diskimage-builder metadata. See also:
+L<https://bugzilla.redhat.com/1910039>
+
+=head2 virt-builder
+
+L<virt-builder(1)> now prints better error messages when a specific
+URL cannot be downloaded.
+
+=head2 virt-builder-repository
+
+Fix GPG repository signing (thanks Allard Berends).
+
+=head2 virt-customize
+
+New L<virt-customize(1)> I<--chown> and I<--tar-in> options. (Also
+available in virt-builder and virt-sysprep.)
+
+=head2 virt-diff
+
+L<virt-diff(1)> no longer considers C<st_dev> and C<st_ino> fields,
+which means that guests where a file has moved across a mountpoint but
+is otherwise identical (size, path, etc) will not show up as a
+difference.
+
+=head2 virt-drivers
+
+L<virt-drivers(1)> a tool which looks at the device drivers needed by
+a guest, can now look up vendor and device names using the PCI and USB
+IDs databases.
+
+=head2 Common changes
+
+The common I<--key> option now recognizes LVM names like
+F</dev/mapper/rhel_bootp--73--75--123-root> (Laszlo Ersek).
+
+The I<--key> option also supports a new S<I<--key all:...>> selector
+to try the same key on all devices.
+
+=head2 Build changes
+
+Support for OCaml 5, and OCaml E<ge> 4.07 is now the minimum (thanks
+Guillaume Munch-Maccagnoni, Jerry James, Josh Berdine, Jürgen Hötzel,
+Vincent Laviron).
+
+Fix compatibility issues with libxml2 2.12.
+
+=head2 Internals
+
+Fix an off-by-one error which caused very rare crashes in some of the
+virt tools.
+
+=head2 Bugs fixed
+
+=begin comment
+
+https_proxy= ./bugs-in-changelog.sh v1.50.0..
+
+=end comment
+
+=over 4
+
+=item L<https://bugzilla.redhat.com/2175703>
+
+virt-v2v failed to inspect RHEL9.2 guest due to kernel-core /
+kernel-modules-core subpackage split
+
+=item L<https://bugzilla.redhat.com/2168506>
+
+RFE: Virt-v2v should recognize partition names like '/dev/mapper/rhel
+boot--73--75--123-root' in related keys option
+
+=item L<https://bugzilla.redhat.com/1910039>
+
+virt-dib doesn't work with newer diskimage-builder version on RHEL8
+
+=back
+
+=head1 SEE ALSO
+
+L<http://libguestfs.org/>
+
+=head1 AUTHORS
+
+=begin comment
+
+git shortlog -s v1.50.0..
+
+=end comment
+
+=over 4
+
+=item Jürgen Hötzel
+
+=item Laszlo Ersek
+
+=item Richard W.M. Jones
+
+=back
+
+=head1 COPYRIGHT
+
+Copyright (C) 2009-2024 Red Hat Inc.
virt-drivers.pod
SOURCES_MLI = \
- drivers.mli
+ drivers.mli \
+ hwdata_config.mli \
+ hwdata.mli
SOURCES_ML = \
+ hwdata_config.ml \
+ hwdata.ml \
drivers.ml
SOURCES_C = \
DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
mkinstalldirs = $(install_sh) -d
CONFIG_HEADER = $(top_builddir)/config.h
-CONFIG_CLEAN_FILES =
+CONFIG_CLEAN_FILES = hwdata_config.ml
CONFIG_CLEAN_VPATH_FILES =
@HAVE_OCAML_TRUE@am__EXEEXT_1 = virt-drivers$(EXEEXT)
am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)"
TEST_LOG_DRIVER = $(SHELL) $(top_srcdir)/build-aux/test-driver
TEST_LOG_COMPILE = $(TEST_LOG_COMPILER) $(AM_TEST_LOG_FLAGS) \
$(TEST_LOG_FLAGS)
-am__DIST_COMMON = $(srcdir)/Makefile.in \
+am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/hwdata_config.ml.in \
$(top_srcdir)/build-aux/depcomp \
$(top_srcdir)/build-aux/test-driver \
$(top_srcdir)/common-rules.mk $(top_srcdir)/subdir-rules.mk
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
virt-drivers.pod
SOURCES_MLI = \
- drivers.mli
+ drivers.mli \
+ hwdata_config.mli \
+ hwdata.mli
SOURCES_ML = \
+ hwdata_config.ml \
+ hwdata.ml \
drivers.ml
SOURCES_C = \
$(ACLOCAL_M4): $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
$(am__aclocal_m4_deps):
+hwdata_config.ml: $(top_builddir)/config.status $(srcdir)/hwdata_config.ml.in
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
install-binPROGRAMS: $(bin_PROGRAMS)
@$(NORMAL_INSTALL)
@list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
(Option.map (fun v -> ("class", sprintf "%06LX" v)) pci_class);
List.may_push_back attrs
(Option.map (fun v -> ("vendor", sprintf "%04LX" v)) pci_vendor);
+ let vendorname = get_pci_vendor pci_vendor in
+ List.may_push_back attrs
+ (Option.map (fun v -> "vendorname", v) vendorname);
List.may_push_back attrs
(Option.map (fun v -> ("device", sprintf "%04LX" v)) pci_device);
+ let devicename = get_pci_device pci_vendor pci_device in
+ List.may_push_back attrs
+ (Option.map (fun v -> "devicename", v) devicename);
List.may_push_back attrs
(Option.map (fun v -> ("subsystem", sprintf "%08LX" v)) pci_subsys);
List.may_push_back attrs
let attrs = ref [] in
List.may_push_back attrs
(Option.map (fun v -> ("vendor", sprintf "%04LX" v)) usb_vendor);
+ let vendorname = get_usb_vendor usb_vendor in
+ List.may_push_back attrs
+ (Option.map (fun v -> "vendorname", v) vendorname);
List.may_push_back attrs
(Option.map (fun v -> ("product", sprintf "%04LX" v)) usb_product);
+ let productname = get_usb_device usb_vendor usb_product in
+ List.may_push_back attrs
+ (Option.map (fun v -> "productname", v) productname);
List.may_push_back attrs
(Option.map (fun v -> ("revision", sprintf "%02LX" v)) usb_rev);
List.may_push_back attrs
| Other path ->
Comment (sprintf "unknown DeviceId: %s" (String.concat "\\" path))
+and get_pci_vendor v = get_hwdata'1 Hwdata.pci_vendor v
+and get_pci_device v d = get_hwdata'2 Hwdata.pci_device v d
+and get_usb_vendor v = get_hwdata'1 Hwdata.usb_vendor v
+and get_usb_device v d = get_hwdata'2 Hwdata.usb_device v d
+
+and get_hwdata'1 f = function
+ | Some i64 when i64 >= 0_L && i64 <= 0xffff_L ->
+ let i32 = Int64.to_int32 i64 in
+ f i32
+ | _ -> None
+
+and get_hwdata'2 f v d =
+ match v, d with
+ | Some v64, Some d64 when v64 >= 0_L && v64 <= 0xffff_L &&
+ d64 >= 0_L && d64 <= 0xffff_L ->
+ let v32 = Int64.to_int32 v64 and d32 = Int64.to_int32 d64 in
+ f v32 d32
+ | _ -> None
+
(* Main program. *)
let main () =
let add, ks = parse_cmdline () in
--- /dev/null
+(* virt-drivers
+ * Copyright (C) 2009-2023 Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *)
+
+open Std_utils
+open Tools_utils
+open Common_gettext.Gettext
+
+open Printf
+open Scanf
+
+module DBKey = struct
+ type t =
+ | Vendor of int32
+ | Device of int32 * int32
+ let compare = compare
+end
+module DB = Map.Make (DBKey)
+
+let is_4_digit_hex id =
+ String.length id = 4 &&
+ Char.isxdigit id.[0] &&
+ Char.isxdigit id.[1] &&
+ Char.isxdigit id.[2] &&
+ Char.isxdigit id.[3]
+let hex_to_int32 id = sscanf id "%lx" identity
+
+(* Loads one of the [*.ids] files, returning the entries as a
+ * 3 level map. Returns [None] if the file could not be opened
+ * or parsed.
+ *)
+let load filename =
+ try
+ let lines = read_whole_file filename in
+ let lines = String.lines_split lines in
+
+ (* This loop drops blank lines and comments, splits the fields of
+ * the database, and returns [(lineno, indent, key, label) list].
+ *)
+ let rec loop lineno acc = function
+ | [] -> List.rev acc
+ (* Blank lines. *)
+ | "" :: lines ->
+ loop (lineno+1) acc lines
+ (* Note that # only starts a comment at the beginning of the line. *)
+ | comment :: lines when String.is_prefix comment "#" ->
+ loop (lineno+1) acc lines
+ (* Otherwise its some data. *)
+ | line :: lines ->
+ let len = String.length line in
+ let indent =
+ let rec counttabs i =
+ if i < len && line.[i] = '\t' then 1 + counttabs (i+1) else 0
+ in
+ counttabs 0 in
+ let line = String.sub line indent (len - indent) in
+
+ let n = String.cspan line " \t" in
+ let key, label = String.break n line in
+ let n = String.span label " \t" in
+ let _, label = String.break n label in
+
+ let acc =
+ if key = "" && label = "" then acc
+ else (lineno, indent, key, label) :: acc in
+
+ loop (lineno+1) acc lines
+ in
+ let lines = loop 1 [] lines in
+
+ (* Since the format is essentially a space-saving one where
+ * vendor name
+ * \t device name
+ * is short for:
+ * vendor name
+ * vendor device name
+ * pull the fields from previous lines down, resulting in
+ * a flat list.
+ *)
+ let rec loop keys acc = function
+ | [] -> List.rev acc
+ | (lineno, indent, key, label) :: lines ->
+ let prefix = List.take indent keys in
+ let keys = prefix @ [ key ] in
+ let acc = (lineno, keys, label) :: acc in
+ loop keys acc lines
+ in
+ let lines = loop [] [] lines in
+
+ (*
+ List.iter (
+ fun (lineno, keys, label) ->
+ eprintf "[%s] -> %s # line %d\n"
+ (String.concat ";" keys) label lineno
+ ) lines;
+ *)
+
+ (* Now we can finally process the database.
+ *
+ * We currently ignore the [C] (class) and other records
+ * that appear at the end of the file. We might want to
+ * try parsing these in future. It will require changes to
+ * the code above because the label isn't parsed right.
+ *)
+ let db =
+ List.fold_left (
+ fun db (lineno, keys, label) ->
+ let loc = filename, lineno in
+ match keys with
+ | [vendor] when is_4_digit_hex vendor ->
+ let vendor = hex_to_int32 vendor in
+ DB.add (Vendor vendor) (label, loc) db
+ | [vendor; device] when is_4_digit_hex vendor &&
+ is_4_digit_hex device ->
+ let vendor = hex_to_int32 vendor in
+ let device = hex_to_int32 device in
+ DB.add (Device (vendor, device)) (label, loc) db
+ | _ ->
+ db
+ ) DB.empty lines in
+
+ Some db
+ with exn ->
+ warning (f_"hwdata: %s: %s") filename (Printexc.to_string exn);
+ None
+
+(* Lazily load the PCI database, if present. *)
+let pci_db =
+ let filename = Hwdata_config.pci_ids in
+ lazy (match filename with None -> None | Some filename -> load filename)
+
+(* Look up PCI vendor and device ID. *)
+let pci_vendor vendor =
+ let db = Lazy.force pci_db in
+ match db with
+ | None -> None
+ | Some db ->
+ match DB.find_opt (Vendor vendor) db with
+ | None -> None
+ | Some (label, _) -> Some label
+
+let pci_device vendor device =
+ let db = Lazy.force pci_db in
+ match db with
+ | None -> None
+ | Some db ->
+ match DB.find_opt (Device (vendor, device)) db with
+ | None -> None
+ | Some (label, _) -> Some label
+
+(* Lazily load the USB database, if present. *)
+let usb_db =
+ let filename = Hwdata_config.usb_ids in
+ lazy (match filename with None -> None | Some filename -> load filename)
+
+(* Look up USB vendor and device ID. *)
+let usb_vendor vendor =
+ let db = Lazy.force usb_db in
+ match db with
+ | None -> None
+ | Some db ->
+ match DB.find_opt (Vendor vendor) db with
+ | None -> None
+ | Some (label, _) -> Some label
+
+let usb_device vendor device =
+ let db = Lazy.force usb_db in
+ match db with
+ | None -> None
+ | Some db ->
+ match DB.find_opt (Device (vendor, device)) db with
+ | None -> None
+ | Some (label, _) -> Some label
--- /dev/null
+(* virt-drivers
+ * Copyright (C) 2013-2023 Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *)
+
+(** Look up PCI and USB vendor and device IDs. *)
+
+val pci_vendor : int32 -> string option
+(** Look up the PCI vendor ID. If found, return the name. *)
+
+val pci_device : int32 -> int32 -> string option
+(** Look up the PCI vendor & device ID. If found, return the name. *)
+
+val usb_vendor : int32 -> string option
+(** Look up the USB vendor ID. If found, return the name. *)
+
+val usb_device : int32 -> int32 -> string option
+(** Look up the USB vendor & device ID. If found, return the name. *)
--- /dev/null
+(* virt-drivers
+ * drivers/hwdata_config.ml. Generated from hwdata_config.ml.in by configure.
+ * Copyright (C) 2009-2023 Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *)
+
+open Std_utils
+
+let dir = ""
+let dir = if dir = "" then None else Some dir
+
+let pci_ids = Option.map (fun d -> d // "pci.ids") dir
+let usb_ids = Option.map (fun d -> d // "usb.ids") dir
--- /dev/null
+(* virt-drivers
+ * @configure_input@
+ * Copyright (C) 2009-2023 Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *)
+
+open Std_utils
+
+let dir = "@HWDATA_PKGDATADIR@"
+let dir = if dir = "" then None else Some dir
+
+let pci_ids = Option.map (fun d -> d // "pci.ids") dir
+let usb_ids = Option.map (fun d -> d // "usb.ids") dir
--- /dev/null
+(* virt-drivers
+ * Copyright (C) 2013-2023 Red Hat Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *)
+
+val dir : string option
+(** [pkgdatadir] variable defined by hwdata.pc
+
+ This is the name of the directory containing [pci.ids] and
+ related files which contain the PCI IDs. *)
+
+val pci_ids : string option
+(** Path to the [pci.ids] file.
+
+ Note at runtime this is an optional dependency, so it may
+ not at exist even if not [None]. *)
+
+val usb_ids : string option
+(** Path to the [usb.ids] file.
+
+ Note at runtime this is an optional dependency, so it may
+ not at exist even if not [None]. *)
skip_if_skipped
skip_unless_phony_guest windows.img
-rm -f actual-windows.xml
+rm -f actual-windows.xml actual-windows.xml.bak
$VG virt-drivers --format=raw -a ../test-data/phony-guests/windows.img > actual-windows.xml
+
+# We can't predict if hwdata is available, so we don't know if
+# vendorname and devicename fields will be present. If present,
+# remove them before comparison.
+mv actual-windows.xml actual-windows.xml.bak
+sed -e "s/ vendorname='\([^']*\)'//g" \
+ -e "s/ devicename='\([^']*\)'//g" \
+ < actual-windows.xml.bak > actual-windows.xml
+
diff -ur -I "generated by" expected-windows.xml actual-windows.xml
-rm actual-windows.xml
+rm actual-windows.xml actual-windows.xml.bak
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
fi
f=../test-data/phony-guests/fedora-luks-on-lvm.img
-keys=(--key /dev/VG/Root:key:FEDORA-Root
- --key /dev/VG/LV1:key:FEDORA-LV1
- --key /dev/VG/LV2:key:FEDORA-LV2
- --key /dev/VG/LV3:key:FEDORA-LV3)
+
+keys=(--key /dev/Volume-Group/Root:key:FEDORA-Root
+ --key /dev/Volume-Group/Logical-Volume-1:key:FEDORA-LV1
+ --key /dev/Volume-Group/Logical-Volume-2:key:FEDORA-LV2
+ --key /dev/Volume-Group/Logical-Volume-3:key:FEDORA-LV3)
+
+keys_mapper=(--key /dev/mapper/Volume--Group-Root:key:FEDORA-Root
+ --key /dev/mapper/Volume--Group-Logical--Volume--1:key:FEDORA-LV1
+ --key /dev/mapper/Volume--Group-Logical--Volume--2:key:FEDORA-LV2
+ --key /dev/mapper/Volume--Group-Logical--Volume--3:key:FEDORA-LV3)
+
+keys_all=(--key all:key:FEDORA-Root
+ --key all:key:FEDORA-LV1
+ --key all:key:FEDORA-LV2
+ --key all:key:FEDORA-LV3)
# Ignore zero-sized file.
if [ -s "$f" ]; then
- uuid_root=$(guestfish --ro -i -a "$f" "${keys[@]}" luks-uuid /dev/VG/Root)
+ uuid_root=$(guestfish --ro -i -a "$f" "${keys[@]}" \
+ luks-uuid /dev/Volume-Group/Root)
b=$(basename "$f")
$VG virt-inspector "${keys[@]}" --format=raw -a "$f" > "actual-$b.xml"
# Check the generated output validate the schema.
# are any differences.
sed -e "s/ROOTUUID/$uuid_root/" < "$srcdir/expected-$b.xml" \
| diff -u - "actual-$b.xml"
+
+ # Re-run virt-inspector with keys using the /dev/mapper/VG-LV format; verify
+ # only that the XML output matches the output from the previous
+ # virt-inspector invocation (which used the /dev/VG/LV format).
+ $VG virt-inspector "${keys_mapper[@]}" --format=raw -a "$f" \
+ | diff -u "actual-$b.xml" -
+
+ # Re-run using all:SELECTOR syntax.
+ $VG virt-inspector "${keys_all[@]}" --format=raw -a "$f" \
+ | diff -u "actual-$b.xml" -
fi
dnl Check for libosinfo (mandatory)
PKG_CHECK_MODULES([LIBOSINFO], [libosinfo-1.0])
+
+dnl Check for hwdata directory (containing pci.ids) (optional, for virt-drivers)
+PKG_CHECK_VAR([HWDATA_PKGDATADIR], [hwdata], [pkgdatadir])
[],
[enable_ocaml=yes])
-dnl OCaml >= 4.04 is required.
-ocaml_ver_str=4.04
+dnl OCaml >= 4.07 is required.
+ocaml_ver_str=4.07
ocaml_min_major=4
-ocaml_min_minor=4
+ocaml_min_minor=7
AC_MSG_CHECKING([if OCaml version >= $ocaml_ver_str])
ocaml_major="`echo $OCAMLVERSION | $AWK -F. '{print $1}'`"
ocaml_minor="`echo $OCAMLVERSION | $AWK -F. '{print $2}' | sed 's/^0//'`"
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
-M utf-8 -L utf-8 \
--package-name $(PACKAGE_NAME) \
--package-version $(PACKAGE_VERSION) \
- --msgid-bugs-address libguestfs@redhat.com \
+ --msgid-bugs-address guestfs@lists.libguestfs.org \
--copyright-holder "Red Hat Inc." \
-p $(abs_srcdir)/$@ \
$(patsubst %,-m %,$(shell cat $(srcdir)/podfiles))
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
-M utf-8 -L utf-8 \
--package-name $(PACKAGE_NAME) \
--package-version $(PACKAGE_VERSION) \
- --msgid-bugs-address libguestfs@redhat.com \
+ --msgid-bugs-address guestfs@lists.libguestfs.org \
--copyright-holder "Red Hat Inc." \
-p $(abs_srcdir)/$@ \
$(patsubst %,-m %,$(shell cat $(srcdir)/podfiles))
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2017-09-11 04:54+0000\n"
"Last-Translator: Zdenek <chmelarz@gmail.com>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 09:57+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 10:15+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
-msgstr "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
+msgstr "L<https://lists.libguestfs.org>"
#. type: =head1
#: ../docs/guestfs-testing.pod:26
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2018-03-12 09:56+0000\n"
"Last-Translator: Javier Blanco <javi.deb@gmail.com>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 10:17+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 10:19+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: guestfs-tools 1.45.1\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2021-03-11 11:43+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2017-02-24 07:33+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
-msgstr "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
+msgstr "L<https://lists.libguestfs.org>"
#. type: =head1
#: ../docs/guestfs-testing.pod:26
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
I<Note>: C<PERMISSIONS> by default would be decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not C<700>.
+=item B<--chown> UID:GID:PATH
+
+Change the owner user and group ID of a file or directory in the guest. Note:
+
+=over 4
+
+=item *
+
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+
+=item *
+
+This will not work with Windows guests.
+
+=back
+
+例:
+
+ virt-customize --chown '0:0:/var/log/audit.log'
+
+See also: I<--upload>.
+
=item B<--commands-from-file> FILENAME
Read the customize commands from a file, one (and its arguments) each line.
You can have multiple I<--ssh-inject> options, for different users and also for more keys for each user.
+=item B<--tar-in> TARFILE:REMOTEDIR
+
+Copy local files or directories from a local tar file called C<TARFILE> into the disk image, placing them in the directory C<REMOTEDIR> (which must exist). Note that the tar file must be uncompressed (F<.tar.gz> files will not work here)
+
=item B<--timezone> TIMEZONE
Set the default timezone of the guest to C<TIMEZONE>. Use a location string like C<Europe/London>
--- /dev/null
+
+=head1 名前
+
+guestfs-tools-release-notes - guestfs tools release Notes
+
+=head1 RELEASE NOTES FOR GUESTFS TOOLS 1.52
+
+These are the release notes for guestfs tools stable release 1.52. This describes the major changes since 1.50.
+
+Guestfs tools 1.52.0 was released on B<5 January 2024>.
+
+=begin コメント
+
+=head2 Security
+
+=end コメント
+
+=head2 virt-dib was removed
+
+virt-dib, a tool that built disk images using diskimage-builder descriptions has been removed. It only supported an older version of the diskimage-builder metadata. See also: L<https://bugzilla.redhat.com/1910039>
+
+=head2 virt-builder
+
+L<virt-builder(1)> now prints better error messages when a specific URL cannot be downloaded.
+
+=head2 virt-builder-repository
+
+Fix GPG repository signing (thanks Allard Berends).
+
+=head2 virt-customize
+
+New L<virt-customize(1)> I<--chown> and I<--tar-in> options. (Also available in virt-builder and virt-sysprep.)
+
+=head2 virt-diff
+
+L<virt-diff(1)> no longer considers C<st_dev> and C<st_ino> fields, which means that guests where a file has moved across a mountpoint but is otherwise identical (size, path, etc) will not show up as a difference.
+
+=head2 virt-drivers
+
+L<virt-drivers(1)> a tool which looks at the device drivers needed by a guest, can now look up vendor and device names using the PCI and USB IDs databases.
+
+=head2 Common changes
+
+The common I<--key> option now recognizes LVM names like F</dev/mapper/rhel_bootp--73--75--123-root> (Laszlo Ersek).
+
+The I<--key> option also supports a new S<I<--key all:...>> selector to try the same key on all devices.
+
+=head2 Build changes
+
+Support for OCaml 5, and OCaml E<ge> 4.07 is now the minimum (thanks Guillaume Munch-Maccagnoni, Jerry James, Josh Berdine, Jürgen Hötzel, Vincent Laviron).
+
+Fix compatibility issues with libxml2 2.12.
+
+=head2 内部
+
+Fix an off-by-one error which caused very rare crashes in some of the virt tools.
+
+=head2 バグ修正
+
+=begin コメント
+
+https_proxy= ./bugs-in-changelog.sh v1.50.0..
+
+=end コメント
+
+=over 4
+
+=item L<https://bugzilla.redhat.com/2175703>
+
+virt-v2v failed to inspect RHEL9.2 guest due to kernel-core / kernel-modules-core subpackage split
+
+=item L<https://bugzilla.redhat.com/2168506>
+
+RFE: Virt-v2v should recognize partition names like '/dev/mapper/rhel boot--73--75--123-root' in related keys option
+
+=item L<https://bugzilla.redhat.com/1910039>
+
+virt-dib doesn't work with newer diskimage-builder version on RHEL8
+
+=back
+
+=head1 関連項目
+
+L<http://libguestfs.org/>
+
+=head1 著者
+
+=begin コメント
+
+git shortlog -s v1.50.0..
+
+=end コメント
+
+=over 4
+
+=item Jürgen Hötzel
+
+=item Laszlo Ersek
+
+=item Richard W.M. Jones
+
+=back
+
+=head1 COPYRIGHT
+
+Copyright (C) 2009-2024 Red Hat Inc.
+
=item B<--key> SELECTOR
-Specify a key for LUKS, to automatically open a LUKS device when using the inspection. C<ID> can be either the libguestfs device name, or the UUID of the LUKS device.
+Specify a key for LUKS, to automatically open a LUKS device when using the inspection.
=over 4
-=item B<--key> C<ID>:key:KEY_STRING
+=item B<--key> NAMEB<:key:>KEY_STRING
+
+=item B<--key> UUIDB<:key:>KEY_STRING
+
+=item B<--key> B<all:key:>KEY_STRING
+
+C<NAME> is the libguestfs device name (eg. C</dev/sda1>). C<UUID> is the device UUID. C<all> means try the key against any encrypted device.
Use the specified C<KEY_STRING> as passphrase.
-=item B<--key> C<ID>:file:FILENAME
+=item B<--key> NAMEB<:file:>FILENAME
+
+=item B<--key> UUIDB<:file:>FILENAME
+
+=item B<--key> B<all:file:>FILENAME
Read the passphrase from F<FILENAME>.
-=item B<--key> C<ID>:clevis
+=item B<--key> NAMEB<:clevis>
+
+=item B<--key> UUIDB<:clevis>
+
+=item B<--key> B<all:clevis>
-Attempt passphrase-less unlocking for C<ID> with Clevis, over the network. Please refer to L<guestfs(3)/ENCRYPTED DISKS> for more information on network-bound disk encryption (NBDE).
+Attempt passphrase-less unlocking for the device with Clevis, over the network. Please refer to L<guestfs(3)/ENCRYPTED DISKS> for more information on network-bound disk encryption (NBDE).
Note that if any such option is present on the command line, QEMU user networking will be automatically enabled for the libguestfs appliance.
I<Note>: C<PERMISSIONS> by default would be decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not C<700>.
+=item B<--chown> UID:GID:PATH (see C<customize> below)
+
+Change the owner user and group ID of a file or directory in the guest. Note:
+
+=over 4
+
+=item *
+
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+
+=item *
+
+This will not work with Windows guests.
+
+=back
+
+例:
+
+ virt-customize --chown '0:0:/var/log/audit.log'
+
+See also: I<--upload>.
+
=item B<--commands-from-file> FILENAME (see C<customize> below)
Read the customize commands from a file, one (and its arguments) each line.
You can have multiple I<--ssh-inject> options, for different users and also for more keys for each user.
+=item B<--tar-in> TARFILE:REMOTEDIR (see C<customize> below)
+
+Copy local files or directories from a local tar file called C<TARFILE> into the disk image, placing them in the directory C<REMOTEDIR> (which must exist). Note that the tar file must be uncompressed (F<.tar.gz> files will not work here)
+
=item B<--timezone> TIMEZONE (see C<customize> below)
Set the default timezone of the guest to C<TIMEZONE>. Use a location string like C<Europe/London>
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-alignment-scan 1"
-.TH virt-alignment-scan 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-alignment-scan 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-alignment-scan \- 仮想マシンのパーティションにおけるアライメントの確認
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-alignment\-scan [\-\-options] \-d domname
\&
\& virt\-alignment\-scan [\-\-options]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
古いオペレーティングシステムが自身をインストールするとき、パーティションツールが基礎となるストレージと一致しないセクターにパーティションを配置します (一般的に最初のパーティションはセクター \f(CW63\fR から始まります)。一致しないパーティションにより、必要以上に I/O を発生させるというオペレーティングシステムの問題を引き起こします。
.PP
virt-alignment-scan ツールは、仮想マシンおよびディスクイメージにあるパーティションの配置を確認します。配置に問題があれば警告します。
.PP
現在、配置の問題を修正するための仮想化ツールはありません。ゲストオペレーティングシステムを再インストールすることだけができます。以下の NetApp のドキュメントが、問題と取り得る解決策をまとめています: http://media.netapp.com/documents/tr\-3747.pdf
-.SH "出力"
+.SH 出力
.IX Header "出力"
このツールをディスクイメージにおいて直接実行するには、\fI\-a\fR オプションを使用します:
.PP
.IX Item "1 列目"
The device and partition name (eg. \fI/dev/sda1\fR meaning the first partition on the first block device).
.Sp
-すべての libvirt 仮想マシンを一覧表示するとき (\fI\-a\fR や \fI\-d\fR オプションなし)、この列は libvirt 名または \s-1UUID\s0 が先頭につきます (\fI\-\-uuid\fR が指定されていると)。例: \f(CW\*(C`WinXP:/dev/sda1\*(C'\fR
+すべての libvirt 仮想マシンを一覧表示するとき (\fI\-a\fR や \fI\-d\fR オプションなし)、この列は libvirt 名または UUID が先頭につきます (\fI\-\-uuid\fR が指定されていると)。例: \f(CW\*(C`WinXP:/dev/sda1\*(C'\fR
.IP "2 列目" 4
.IX Item "2 列目"
パーティションの開始位置（バイト単位）
.IX Item "5 列目以降"
オプションの自由なテキスト説明。
.PP
-プログラムからの終了コードは、不適切に配置されたパーティションが見つかったかどうかに依存して変わります。以下の \*(L"終了ステータス\*(R" を参照してください。
+プログラムからの終了コードは、不適切に配置されたパーティションが見つかったかどうかに依存して変わります。以下の "終了ステータス" を参照してください。
.PP
出力なしで終了コードを欲しいならば、\fI\-q\fR オプションを使用してください。
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
仮想マシンからディスクイメージの \fIfile\fR を追加します。
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a \s-1URI\s0\fR" 4
+.IP "\fB\-a URI\fR" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add \s-1URI\s0\fR" 4
+.IP "\fB\-\-add URI\fR" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
.IP "\fB\-P\fR nr_threads" 4
.IX Item "-P nr_threads"
Since libguestfs 1.22, virt-alignment-scan is multithreaded and examines guests in parallel. By default the number of threads to use is chosen based on the amount of free memory available at the time that virt-alignment-scan is started. You can force virt-alignment-scan to use at most \f(CW\*(C`nr_threads\*(C'\fR by using the \fI\-P\fR option.
.Sp
Note that \fI\-P 0\fR means to autodetect, and \fI\-P 1\fR means to use a single thread.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
-Don’t produce any output. Just set the exit code (see \*(L"\s-1EXIT STATUS\*(R"\s0 below).
-.IP "\fB\-\-uuid\fR" 4
+Don’t produce any output. Just set the exit code (see "EXIT STATUS" below).
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
-名前の代わりに \s-1UUID\s0 を表示します。仮想マシンがマイグレーションまたは名前変更されたとき、または偶然 2 つの仮想マシンが同じ名前を持つとき、仮想マシンに使用させるために有用です。
+名前の代わりに UUID を表示します。仮想マシンがマイグレーションまたは名前変更されたとき、または偶然 2 つの仮想マシンが同じ名前を持つとき、仮想マシンに使用させるために有用です。
.Sp
すべての libvirt 仮想マシンを一覧表示するとき (\fI\-a\fR や \fI\-d\fR オプションが指定されていないとき)、 このオプションのみが適用されます。
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "推奨されるアライメント"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 推奨されるアライメント
.IX Header "推奨されるアライメント"
-Windows 2008 および ca.2010 以前のLinux よりも古いオペレーティングシステムは、512 バイトのセクター容量でセクター 63 に、第 1 パーティションの第1セクターを配置しなければいけません。これは古くからの障害によるものです。ドライブは \s-1BIOS\s0 にシリンダー/ヘッド/セクター (\s-1CHS\s0) の配置を通知する必要があります。配置は最近のドライブにおいては意味がありませんが、必ずトラックあたり 63 セクターを持つことをときどき通知します。そのため、オペレーティングシステムはセクター 63 にある、第 2 \*(L"トラック\*(R" の先頭にある第 1 パーティションに置かれます。
+Windows 2008 および ca.2010 以前のLinux よりも古いオペレーティングシステムは、512 バイトのセクター容量でセクター 63 に、第 1 パーティションの第1セクターを配置しなければいけません。これは古くからの障害によるものです。ドライブは BIOS にシリンダー/ヘッド/セクター (CHS) の配置を通知する必要があります。配置は最近のドライブにおいては意味がありませんが、必ずトラックあたり 63 セクターを持つことをときどき通知します。そのため、オペレーティングシステムはセクター 63 にある、第 2 "トラック" の先頭にある第 1 パーティションに置かれます。
.PP
-ゲスト \s-1OS\s0 が仮想化されているとき、ホストオペレーティングシステムおよびハイパーバイザーは以下のどれかにアライメントされていることが好ましいでしょう。
-.IP "\(bu" 4
+ゲスト OS が仮想化されているとき、ホストオペレーティングシステムおよびハイパーバイザーは以下のどれかにアライメントされていることが好ましいでしょう。
+.IP \(bu 4
512 バイト
.Sp
-ホスト \s-1OS\s0 がハードディスクのパーティションに直接ローカルストレージを使用して、ハードディスクが 512 バイトの物理セクターを持っている場合。
-.IP "\(bu" 4
+ホスト OS がハードディスクのパーティションに直接ローカルストレージを使用して、ハードディスクが 512 バイトの物理セクターを持っている場合。
+.IP \(bu 4
4 K バイト
.Sp
4K バイトの物理セクターを持つ新規ハードディスクにおけるローカルストレージ向け。 4K バイトのブロック容量を持つファイルシステムにおけるファイル形式のストレージ向け。もしくは、何種類かのネットワークストレージ（NAS）向け。
-.IP "\(bu" 4
+.IP \(bu 4
64 K バイト
.Sp
-ハイエンドの \s-1NAS\s0 向け。いくつかの NetApp ハードウェアに最適なブロックサイズです。
-.IP "\(bu" 4
+ハイエンドの NAS 向け。いくつかの NetApp ハードウェアに最適なブロックサイズです。
+.IP \(bu 4
1 M バイト
.Sp
-以下の \*(L"1 \s-1MB\s0 パーティションアライメント\*(R" 参照。
+以下の "1 MB パーティションアライメント" 参照。
.PP
基礎となるストレージに正しくアライメントされていないパーティションは余計な I/O を引き起こします。たとえば:
.PP
\& 0
.Ve
.PP
-NetApp \s-1LUN\s0 向け:
+NetApp LUN 向け:
.PP
.Vb 8
\& $ cat /sys/block/sdc/queue/logical_block_size
これらの数字の意味に関する詳細は http://docs.redhat.com/docs/en\-US/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/newstorage\-iolimits.html を参照してください。
.PP
[4K ドライブデータを提供してくれた Matt Booth に感謝します。NetApp のデータと追加情報を提供してくれた Mike Snitzer に感謝します。]
-.SS "1 \s-1MB\s0 パーティションアライメント"
+.SS "1 MB パーティションアライメント"
.IX Subsection "1 MB パーティションアライメント"
-Microsoft は Windows Server 2008 以降、すべてのパーティションに対してデフォルトのアライメントとして 1 \s-1MB\s0 を選択しました。 Linux はこれに従ってきました。
+Microsoft は Windows Server 2008 以降、すべてのパーティションに対してデフォルトのアライメントとして 1 MB を選択しました。 Linux はこれに従ってきました。
.PP
仮想マシンにおいて 512 バイトのセクターと仮定すると、セクター 2048 に開始されている最初のパーティションを参照してください。また、（もしあれば）後続のパーティションは 2048 セクターの倍数から始まります。
.PP
-1 \s-1MB\s0 アライメントはすべての現行アライメント要求 (4K, 64K) と互換性があります。また、物理ブロック容量における将来的な拡張の余地を残します。
-.SS "アライメントの設定法"
+1 MB アライメントはすべての現行アライメント要求 (4K, 64K) と互換性があります。また、物理ブロック容量における将来的な拡張の余地を残します。
+.SS アライメントの設定法
.IX Subsection "アライメントの設定法"
-\&\fBvirt\-resize\fR\|(1) can change the alignment of the partitions of some guests. Currently it can fully align all the partitions of all Windows guests, and it will fix the bootloader where necessary. For Linux guests, it can align the second and subsequent partitions, so the majority of \s-1OS\s0 accesses except at boot will be aligned.
+\&\fBvirt\-resize\fR\|(1) can change the alignment of the partitions of some guests. Currently it can fully align all the partitions of all Windows guests, and it will fix the bootloader where necessary. For Linux guests, it can align the second and subsequent partitions, so the majority of OS accesses except at boot will be aligned.
.PP
Another way to correct partition alignment problems is to reinstall your guest operating systems. If you install operating systems from templates, ensure these have correct partition alignment too.
.PP
古いバージョンの Windows は、次の NetApp ドキュメントに有用な情報があります: http://media.netapp.com/documents/tr\-3747.pdf
.PP
For Red Hat Enterprise Linux ≤ 5, use a Kickstart script that contains an explicit \f(CW%pre\fR section that creates aligned partitions using \fBparted\fR\|(8). Do not use the Kickstart \f(CW\*(C`part\*(C'\fR command. The NetApp document above contains an example.
-.SH "終了ステータス"
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは以下を返します:
-.IP "\(bu" 4
+.IP \(bu 4
0
.Sp
正常終了、すべてのパーティションが最高のパフォーマンスのために ≥ 64K に配置されています
-.IP "\(bu" 4
+.IP \(bu 4
1
.Sp
ディスクイメージまたは仮想マシンのスキャン中にエラーが発生しました
-.IP "\(bu" 4
+.IP \(bu 4
2
.Sp
正常終了、いくつかのパーティションがハイエンドのネットワークストレージにおいてパフォーマンスの悪い < 64K のアライメントを持ちます
-.IP "\(bu" 4
+.IP \(bu 4
3
.Sp
正常終了、いくつかのパーティションが多くのハイパーバイザーにおいてパフォーマンスの悪い < 4K のアライメントを持ちます
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2011 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-builder 1"
-.TH virt-builder 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-builder 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-builder \- Build virtual machine images quickly
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 3
\& virt\-builder os\-version
\& virt\-builder \-\-get\-kernel DISKIMAGE
\& [\-\-format raw|qcow2] [\-\-output OUTPUTDIR]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
Virt-builder is a tool for quickly building new virtual machines. You can build a variety of VMs for local or cloud use, usually within a few minutes or less. Virt-builder also has many ways to customize these VMs. Everything is run from the command line and nothing requires root privileges, so automation and scripting is simple.
.PP
-Note that virt-builder does not install guests from scratch. It takes cleanly prepared, digitally signed \s-1OS\s0 templates and customizes them. This approach is used because it is much faster, but if you need to do fresh installs you may want to look at \fBvirt\-install\fR\|(1) and \fBoz\-install\fR\|(1).
+Note that virt-builder does not install guests from scratch. It takes cleanly prepared, digitally signed OS templates and customizes them. This approach is used because it is much faster, but if you need to do fresh installs you may want to look at \fBvirt\-install\fR\|(1) and \fBoz\-install\fR\|(1).
.PP
The easiest way to get started is by looking at the examples in the next section.
-.SH "例"
+.SH 例
.IX Header "例"
.SS "List the virtual machines available"
.IX Subsection "List the virtual machines available"
.PP
You \fIdo not\fR need to run this command as root.
.PP
-The first time this runs it has to download the template over the network, but this gets cached (see \*(L"\s-1CACHING\*(R"\s0).
+The first time this runs it has to download the template over the network, but this gets cached (see "CACHING").
.PP
The name of the output file is derived from the template name, so above it will be \fIfedora\-27.img\fR. You can change the output filename using the \fI\-o\fR option:
.PP
\& virt\-builder fedora\-27 \-\-size 20G
.Ve
.PP
-As above, but the output size will be 20 \s-1GB.\s0 The guest \s-1OS\s0 is resized as it is copied to the output (automatically, using \fBvirt\-resize\fR\|(1)).
+As above, but the output size will be 20 GB. The guest OS is resized as it is copied to the output (automatically, using \fBvirt\-resize\fR\|(1)).
.PP
.Vb 1
\& virt\-builder fedora\-27 \-\-arch i686
.PP
Note if you \fIdon’t\fR set \fI\-\-root\-password\fR then the guest is given a \fIrandom\fR root password which is printed on stdout.
.PP
-You can also create user accounts. See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 below.
+You can also create user accounts. See "USERS AND PASSWORDS" below.
.SS "Set the hostname"
.IX Subsection "Set the hostname"
.Vb 1
which edits \fI/etc/dnf/dnf.conf\fR inside the disk image (during disk image creation, long before boot).
.PP
You can combine these options, and have multiple options of all types.
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
ヘルプを表示します。
-.IP "\fB\-\-arch\fR \s-1ARCHITECTURE\s0" 4
+.IP "\fB\-\-arch\fR ARCHITECTURE" 4
.IX Item "--arch ARCHITECTURE"
Use the specified architecture for the output image. This means there must be sources providing the requested template for the requested architecture.
.Sp
-See also \*(L"\s-1ARCHITECTURE\*(R"\s0.
-.IP "\fB\-\-attach\fR \s-1ISOFILE\s0" 4
+See also "ARCHITECTURE".
+.IP "\fB\-\-attach\fR ISOFILE" 4
.IX Item "--attach ISOFILE"
During the customization phase, the given disk is attached to the libguestfs appliance. This is used to provide extra software repositories or other data for customization.
.Sp
-You probably want to ensure the volume(s) or filesystems in the attached disks are labelled (or use an \s-1ISO\s0 volume name) so that you can mount them by label in your run-scripts:
+You probably want to ensure the volume(s) or filesystems in the attached disks are labelled (or use an ISO volume name) so that you can mount them by label in your run-scripts:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
-You can have multiple \fI\-\-attach\fR options, and the format can be any disk format (not just an \s-1ISO\s0).
+You can have multiple \fI\-\-attach\fR options, and the format can be any disk format (not just an ISO).
.Sp
-See also: \fI\-\-run\fR, \*(L"Installing packages at build time from a side repository\*(R", \fBgenisoimage\fR\|(1), \fBvirt\-make\-fs\fR\|(1).
-.IP "\fB\-\-attach\-format\fR \s-1FORMAT\s0" 4
+See also: \fI\-\-run\fR, "Installing packages at build time from a side repository", \fBgenisoimage\fR\|(1), \fBvirt\-make\-fs\fR\|(1).
+.IP "\fB\-\-attach\-format\fR FORMAT" 4
.IX Item "--attach-format FORMAT"
Specify the disk format for the next \fI\-\-attach\fR option. The \f(CW\*(C`FORMAT\*(C'\fR is usually \f(CW\*(C`raw\*(C'\fR or \f(CW\*(C`qcow2\*(C'\fR. Use \f(CW\*(C`raw\*(C'\fR for ISOs.
-.IP "\fB\-\-cache\fR \s-1DIR\s0" 4
+.IP "\fB\-\-cache\fR DIR" 4
.IX Item "--cache DIR"
.PD 0
-.IP "\fB\-\-no\-cache\fR" 4
+.IP \fB\-\-no\-cache\fR 4
.IX Item "--no-cache"
.PD
-\&\fI\-\-cache\fR \s-1DIR\s0 sets the directory to use/check for cached template files. If not set, defaults to either \fI\f(CI$XDG_CACHE_HOME\fI/virt\-builder/\fR or \fI\f(CI$HOME\fI/.cache/virt\-builder/\fR.
+\&\fI\-\-cache\fR DIR sets the directory to use/check for cached template files. If not set, defaults to either \fR\f(CI$XDG_CACHE_HOME\fR\fI/virt\-builder/\fR or \fI\fR\f(CI$HOME\fR\fI/.cache/virt\-builder/\fR.
.Sp
\&\fI\-\-no\-cache\fR disables template caching.
-.IP "\fB\-\-cache\-all\-templates\fR" 4
+.IP \fB\-\-cache\-all\-templates\fR 4
.IX Item "--cache-all-templates"
-Download all templates to the cache and then exit. See \*(L"\s-1CACHING\*(R"\s0.
+Download all templates to the cache and then exit. See "CACHING".
.Sp
Note this doesn't cache everything. More templates might be uploaded. Also this doesn't cache packages (the \fI\-\-install\fR, \fI\-\-update\fR options).
-.IP "\fB\-\-check\-signature\fR" 4
+.IP \fB\-\-check\-signature\fR 4
.IX Item "--check-signature"
.PD 0
-.IP "\fB\-\-no\-check\-signature\fR" 4
+.IP \fB\-\-no\-check\-signature\fR 4
.IX Item "--no-check-signature"
.PD
-Check/don’t check the digital signature of the \s-1OS\s0 template. The default is to check the signature and exit if it is not correct. Using \fI\-\-no\-check\-signature\fR bypasses this check.
+Check/don’t check the digital signature of the OS template. The default is to check the signature and exit if it is not correct. Using \fI\-\-no\-check\-signature\fR bypasses this check.
.Sp
See also \fI\-\-fingerprint\fR.
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-\-curl\fR \s-1CURL\s0" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP "\fB\-\-curl\fR CURL" 4
.IX Item "--curl CURL"
Specify an alternate \fBcurl\fR\|(1) binary. You can also use this to add curl parameters, for example to disable https certificate checks:
.Sp
.Vb 1
\& virt\-builder \-\-curl "curl \-\-insecure" [...]
.Ve
-.IP "\fB\-\-delete\-cache\fR" 4
+.IP \fB\-\-delete\-cache\fR 4
.IX Item "--delete-cache"
-Delete the template cache. See \*(L"\s-1CACHING\*(R"\s0.
-.IP "\fB\-\-no\-delete\-on\-failure\fR" 4
+Delete the template cache. See "CACHING".
+.IP \fB\-\-no\-delete\-on\-failure\fR 4
.IX Item "--no-delete-on-failure"
-Don’t delete the output file on failure to build. You can use this to debug failures to run scripts. See \*(L"\s-1DEBUGGING BUILDS\*(R"\s0 for ways to debug images.
+Don’t delete the output file on failure to build. You can use this to debug failures to run scripts. See "DEBUGGING BUILDS" for ways to debug images.
.Sp
The default is to delete the output file if virt-builder fails (or, for example, some script that it runs fails).
-.IP "\fB\-\-fingerprint\fR '\s-1AAAA BBBB ...\s0'" 4
+.IP "\fB\-\-fingerprint\fR 'AAAA BBBB ...'" 4
.IX Item "--fingerprint 'AAAA BBBB ...'"
Check that the index and templates are signed by the key with the given fingerprint. (The fingerprint is a long string, usually written as 10 groups of 4 hexadecimal digits).
.Sp
-You can give this option multiple times. If you have multiple source URLs, then you can have either no fingerprint, one fingerprint or multiple fingerprints. If you have multiple, then each must correspond 1\-1 with a source \s-1URL.\s0
+You can give this option multiple times. If you have multiple source URLs, then you can have either no fingerprint, one fingerprint or multiple fingerprints. If you have multiple, then each must correspond 1\-1 with a source URL.
.IP "\fB\-\-format\fR qcow2" 4
.IX Item "--format qcow2"
.PD 0
.Sp
With \fI\-\-get\-kernel\fR this specifies the input format.
.Sp
-To create an old-style qcow2 file (for compatibility with \s-1RHEL 6\s0 or very old qemu < 1.1), after running virt-builder, use this command:
+To create an old-style qcow2 file (for compatibility with RHEL 6 or very old qemu < 1.1), after running virt-builder, use this command:
.Sp
.Vb 1
\& qemu\-img amend \-f qcow2 \-o compat=0.10 output.qcow2
.Ve
-.IP "\fB\-\-get\-kernel\fR \s-1IMAGE\s0" 4
+.IP "\fB\-\-get\-kernel\fR IMAGE" 4
.IX Item "--get-kernel IMAGE"
-This option extracts the kernel and initramfs from a previously built disk image called \f(CW\*(C`IMAGE\*(C'\fR (in fact it works for any \s-1VM\s0 disk image, not just ones built using virt-builder).
+This option extracts the kernel and initramfs from a previously built disk image called \f(CW\*(C`IMAGE\*(C'\fR (in fact it works for any VM disk image, not just ones built using virt-builder).
.Sp
Note this method is \fBdeprecated\fR: there is a separate tool for this, \fBvirt\-get\-kernel\fR\|(1), which has more options for the file extraction.
.Sp
The format of the disk image is automatically detected unless you specify it by using the \fI\-\-format\fR option.
.Sp
In the case where the guest contains multiple kernels, the one with the highest version number is chosen. To extract arbitrary kernels from the disk image, see \fBguestfish\fR\|(1). To extract the entire \fI/boot\fR directory of a guest, see \fBvirt\-copy\-out\fR\|(1).
-.IP "\fB\-\-gpg\fR \s-1GPG\s0" 4
+.IP "\fB\-\-gpg\fR GPG" 4
.IX Item "--gpg GPG"
-Specify an alternate \fBgpg\fR\|(1) (\s-1GNU\s0 Privacy Guard) binary. By default virt-builder looks for either \f(CW\*(C`gpg2\*(C'\fR or \f(CW\*(C`gpg\*(C'\fR in the \f(CW$PATH\fR.
+Specify an alternate \fBgpg\fR\|(1) (GNU Privacy Guard) binary. By default virt-builder looks for either \f(CW\*(C`gpg2\*(C'\fR or \f(CW\*(C`gpg\*(C'\fR in the \f(CW$PATH\fR.
.Sp
You can also use this to add gpg parameters, for example to specify an alternate home directory:
.Sp
.Sp
It is possible to choose with \fI\-\-list\-format\fR the output format for the list templates:
.RS 4
-.IP "\fBshort\fR" 4
+.IP \fBshort\fR 4
.IX Item "short"
The default format, prints only the template identifier and, next to it, its short description.
-.IP "\fBlong\fR" 4
+.IP \fBlong\fR 4
.IX Item "long"
Prints a textual list with the details of the available sources, followed by the details of the available templates.
-.IP "\fBjson\fR" 4
+.IP \fBjson\fR 4
.IX Item "json"
-Prints a \s-1JSON\s0 object with the details of the available sources and the details of the available templates.
+Prints a JSON object with the details of the available sources and the details of the available templates.
.Sp
-The \f(CW\*(C`version\*(C'\fR key in the main object represents the \*(L"compatibility version\*(R", and it is bumped every time the resulting \s-1JSON\s0 output is incompatible with the previous versions (for example the structure has changed, or non-optional keys are no more present).
+The \f(CW\*(C`version\*(C'\fR key in the main object represents the "compatibility version", and it is bumped every time the resulting JSON output is incompatible with the previous versions (for example the structure has changed, or non-optional keys are no more present).
.RE
.RS 4
.Sp
\&\fI\-\-long\fR is a shorthand for the \f(CW\*(C`long\*(C'\fR format.
.Sp
-See also: \fI\-\-source\fR, \fI\-\-notes\fR, \*(L"\s-1SOURCES OF TEMPLATES\*(R"\s0.
+See also: \fI\-\-source\fR, \fI\-\-notes\fR, "SOURCES OF TEMPLATES".
.RE
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=format" 4
+.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の \*(L"マシン可読な出力\*(R" 参照。
-.IP "\fB\-m\fR \s-1MB\s0" 4
+このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の "マシン可読な出力" 参照。
+.IP "\fB\-m\fR MB" 4
.IX Item "-m MB"
.PD 0
-.IP "\fB\-\-memsize\fR \s-1MB\s0" 4
+.IP "\fB\-\-memsize\fR MB" 4
.IX Item "--memsize MB"
.PD
Change the amount of memory allocated to \fI\-\-run\fR scripts. Increase this if you find that \fI\-\-run\fR scripts or the \fI\-\-install\fR option are running out of memory.
.Vb 1
\& guestfish get\-memsize
.Ve
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Enable or disable network access from the guest during the installation.
.Sp
Enabled is the default. Use \fI\-\-no\-network\fR to disable access.
.Sp
-The network only allows outgoing connections and has other minor limitations. See \*(L"\s-1NETWORK\*(R"\s0 in \fBvirt\-rescue\fR\|(1).
+The network only allows outgoing connections and has other minor limitations. See "NETWORK" in \fBvirt\-rescue\fR\|(1).
.Sp
If you use \fI\-\-no\-network\fR then certain other options such as \fI\-\-install\fR will not work.
.Sp
.Sp
Generally speaking you should \fInot\fR use \fI\-\-no\-network\fR. But here are some reasons why you might want to:
.RS 4
-.IP "1." 4
-Because the libguestfs backend that you are using doesn't support the network. (See: \*(L"\s-1BACKEND\*(R"\s0 in \fBguestfs\fR\|(3)).
-.IP "2." 4
-Any software you need to install comes from an attached \s-1ISO,\s0 so you don't need the network.
-.IP "3." 4
-You don’t want untrusted guest code trying to access your host network when running virt-builder. This is particularly an issue when you don't trust the source of the operating system templates. (See \*(L"\s-1SECURITY\*(R"\s0 below).
-.IP "4." 4
+.IP 1. 4
+Because the libguestfs backend that you are using doesn't support the network. (See: "BACKEND" in \fBguestfs\fR\|(3)).
+.IP 2. 4
+Any software you need to install comes from an attached ISO, so you don't need the network.
+.IP 3. 4
+You don’t want untrusted guest code trying to access your host network when running virt-builder. This is particularly an issue when you don't trust the source of the operating system templates. (See "SECURITY" below).
+.IP 4. 4
You don’t have a host network (eg. in secure/restricted environments).
.RE
.RS 4
.RE
-.IP "\fB\-\-no\-sync\fR" 4
+.IP \fB\-\-no\-sync\fR 4
.IX Item "--no-sync"
Do not sync the output file on exit.
.Sp
Note that the output filename could be a device, partition or logical volume.
.Sp
When used with \fI\-\-get\-kernel\fR, this option specifies the output directory.
-.IP "\fB\-\-print\-cache\fR" 4
+.IP \fB\-\-print\-cache\fR 4
.IX Item "--print-cache"
-Print information about the template cache. See \*(L"\s-1CACHING\*(R"\s0.
-.IP "\fB\-q\fR" 4
+Print information about the template cache. See "CACHING".
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Don’t print ordinary progress messages.
-.IP "\fB\-\-size\fR \s-1SIZE\s0" 4
+.IP "\fB\-\-size\fR SIZE" 4
.IX Item "--size SIZE"
Select the size of the output disk, where the size can be specified using common names such as \f(CW\*(C`32G\*(C'\fR (32 gigabytes) etc.
.Sp
.Sp
If the size is not specified, then one of two things happens. If the output is a file, then the size is the same as the template. If the output is a device, partition, etc then the size of that device is used.
.Sp
-To specify size in bytes, the number must be followed by the lowercase letter \fIb\fR, eg: \f(CW\*(C`\-\-size 10737418240b\*(C'\fR.
+To specify size in bytes, the number must be followed by the lowercase letter \fIb\fR, eg: \f(CW\*(C`\-\-size\ 10737418240b\*(C'\fR.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
Enable N ≥ 2 virtual CPUs for \fI\-\-run\fR scripts to use.
-.IP "\fB\-\-source\fR \s-1URL\s0" 4
+.IP "\fB\-\-source\fR URL" 4
.IX Item "--source URL"
-Set the source \s-1URL\s0 to look for indexes.
+Set the source URL to look for indexes.
.Sp
You can give this option multiple times to specify multiple sources.
.Sp
-See also \*(L"\s-1SOURCES OF TEMPLATES\*(R"\s0 below.
+See also "SOURCES OF TEMPLATES" below.
.Sp
Note that you should not point \fI\-\-source\fR to sources that you don’t trust (unless the source is signed by someone you do trust). See also the \fI\-\-no\-network\fR option.
-.IP "\fB\-\-no\-warn\-if\-partition\fR" 4
+.IP \fB\-\-no\-warn\-if\-partition\fR 4
.IX Item "--no-warn-if-partition"
-Do not emit a warning if the output device is a partition. This warning avoids a common user error when writing to a \s-1USB\s0 key or external drive, when you should normally write to the whole device (\fI\-\-output /dev/sdX\fR), not to a partition on the device (\fI\-\-output /dev/sdX1\fR). Use this option to \fIsuppress\fR this warning.
-.IP "\fB\-v\fR" 4
+Do not emit a warning if the output device is a partition. This warning avoids a common user error when writing to a USB key or external drive, when you should normally write to the whole device (\fI\-\-output\ /dev/sdX\fR), not to a partition on the device (\fI\-\-output\ /dev/sdX1\fR). Use this option to \fIsuppress\fR this warning.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Enable debug messages and/or produce verbose output.
.Sp
When reporting bugs, use this option and attach the complete output to your bug report.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
+libguestfs API 呼び出しのトレースを有効にします。
.SS "Customization options"
.IX Subsection "Customization options"
-.IP "\fB\-\-append\-line\fR \s-1FILE:LINE\s0" 4
+.IP "\fB\-\-append\-line\fR FILE:LINE" 4
.IX Item "--append-line FILE:LINE"
Append a single line of text to the \f(CW\*(C`FILE\*(C'\fR. If the file does not already end with a newline, then one is added before the appended line. Also a newline is added to the end of the \f(CW\*(C`LINE\*(C'\fR string automatically.
.Sp
\& \-\-append\-line \*(Aq/etc/hosts:\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
-.IP "\fB\-\-chmod\fR \s-1PERMISSIONS:FILE\s0" 4
+.IP "\fB\-\-chmod\fR PERMISSIONS:FILE" 4
.IX Item "--chmod PERMISSIONS:FILE"
Change the permissions of \f(CW\*(C`FILE\*(C'\fR to \f(CW\*(C`PERMISSIONS\*(C'\fR.
.Sp
\&\fINote\fR: \f(CW\*(C`PERMISSIONS\*(C'\fR by default would be decimal, unless you prefix it with \f(CW0\fR to get octal, ie. use \f(CW0700\fR not \f(CW700\fR.
-.IP "\fB\-\-commands\-from\-file\fR \s-1FILENAME\s0" 4
+.IP "\fB\-\-chown\fR UID:GID:PATH" 4
+.IX Item "--chown UID:GID:PATH"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+例:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
+.IP "\fB\-\-commands\-from\-file\fR FILENAME" 4
.IX Item "--commands-from-file FILENAME"
Read the customize commands from a file, one (and its arguments) each line.
.Sp
.Ve
.Sp
The commands are handled in the same order as they are in the file, as if they were specified as \fI\-\-delete /some/file\fR on the command line.
-.IP "\fB\-\-copy\fR \s-1SOURCE:DEST\s0" 4
+.IP "\fB\-\-copy\fR SOURCE:DEST" 4
.IX Item "--copy SOURCE:DEST"
Copy files or directories recursively inside the guest.
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-copy\-in\fR \s-1LOCALPATH:REMOTEDIR\s0" 4
+.IP "\fB\-\-copy\-in\fR LOCALPATH:REMOTEDIR" 4
.IX Item "--copy-in LOCALPATH:REMOTEDIR"
Copy local files or directories recursively into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist).
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-delete\fR \s-1PATH\s0" 4
+.IP "\fB\-\-delete\fR PATH" 4
.IX Item "--delete PATH"
Delete a file from the guest. Or delete a directory (and all its contents, recursively).
.Sp
.Ve
.Sp
See also: \fI\-\-upload\fR, \fI\-\-scrub\fR.
-.IP "\fB\-\-edit\fR \s-1FILE:EXPR\s0" 4
+.IP "\fB\-\-edit\fR FILE:EXPR" 4
.IX Item "--edit FILE:EXPR"
Edit \f(CW\*(C`FILE\*(C'\fR using the Perl expression \f(CW\*(C`EXPR\*(C'\fR.
.Sp
.Sp
このオプションは Perl 5 がインストールされているときのみ利用可能であることに注意してください。
.Sp
-See \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
-.IP "\fB\-\-firstboot\fR \s-1SCRIPT\s0" 4
+See "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
+.IP "\fB\-\-firstboot\fR SCRIPT" 4
.IX Item "--firstboot SCRIPT"
Install \f(CW\*(C`SCRIPT\*(C'\fR inside the guest, so that when the guest first boots up, the script runs (as root, late in the boot process).
.Sp
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.IP "\fB\-\-firstboot\-command\fR '\s-1CMD+ARGS\s0'" 4
+.IP "\fB\-\-firstboot\-command\fR 'CMD+ARGS'" 4
.IX Item "--firstboot-command 'CMD+ARGS'"
Run command (and arguments) inside the guest when the guest first boots up (as root, late in the boot process).
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.IP "\fB\-\-firstboot\-install\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-firstboot\-install\fR PKG,PKG.." 4
.IX Item "--firstboot-install PKG,PKG.."
Install the named packages (a comma-separated list). These are installed when the guest first boots using the guest’s package manager (eg. apt, yum, etc.) and the guest’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0.
-.IP "\fB\-\-hostname\fR \s-1HOSTNAME\s0" 4
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES".
+.IP "\fB\-\-hostname\fR HOSTNAME" 4
.IX Item "--hostname HOSTNAME"
-Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (\s-1FQDN\s0) if you want.
-.IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0" 4
+Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (FQDN) if you want.
+.IP "\fB\-\-inject\-qemu\-ga\fR METHOD" 4
.IX Item "--inject-qemu-ga METHOD"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0" 4
+.IP "\fB\-\-inject\-virtio\-win\fR METHOD" 4
.IX Item "--inject-virtio-win METHOD"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
.RE
-.IP "\fB\-\-install\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-install\fR PKG,PKG.." 4
.IX Item "--install PKG,PKG.."
Install the named packages (a comma-separated list). These are installed during the image build using the guest’s package manager (eg. apt, yum, etc.) and the host’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0.
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES".
.Sp
See also \fI\-\-update\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR TARGET:LINK[:LINK..]" 4
.IX Item "--link TARGET:LINK[:LINK..]"
Create symbolic link(s) in the guest, starting at \f(CW\*(C`LINK\*(C'\fR and pointing at \f(CW\*(C`TARGET\*(C'\fR.
-.IP "\fB\-\-mkdir\fR \s-1DIR\s0" 4
+.IP "\fB\-\-mkdir\fR DIR" 4
.IX Item "--mkdir DIR"
Create a directory in the guest.
.Sp
-This uses \f(CW\*(C`mkdir \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
-.IP "\fB\-\-move\fR \s-1SOURCE:DEST\s0" 4
+This uses \f(CW\*(C`mkdir\ \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
+.IP "\fB\-\-move\fR SOURCE:DEST" 4
.IX Item "--move SOURCE:DEST"
Move files or directories inside the guest.
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-no\-logfile\fR" 4
+.IP \fB\-\-no\-logfile\fR 4
.IX Item "--no-logfile"
Scrub \f(CW\*(C`builder.log\*(C'\fR (log file from build commands) from the image after building is complete. If you don't want to reveal precisely how the image was built, use this option.
.Sp
-See also: \*(L"\s-1LOG FILE\*(R"\s0.
-.IP "\fB\-\-no\-selinux\-relabel\fR" 4
+See also: "LOG FILE".
+.IP \fB\-\-no\-selinux\-relabel\fR 4
.IX Item "--no-selinux-relabel"
Do not attempt to correct the SELinux labels of files in the guest.
.Sp
In such guests that support SELinux, customization automatically relabels files so that they have the correct SELinux label. (The relabeling is performed immediately, but if the operation fails, customization will instead touch \fI/.autorelabel\fR on the image to schedule a relabel operation for the next time the image boots.) This option disables the automatic relabeling.
.Sp
The option is a no-op for guests that do not support SELinux.
-.IP "\fB\-\-password\fR \s-1USER:SELECTOR\s0" 4
+.IP "\fB\-\-password\fR USER:SELECTOR" 4
.IX Item "--password USER:SELECTOR"
Set the password for \f(CW\*(C`USER\*(C'\fR. (Note this option does \fInot\fR create the user account).
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
When the virt tools change or set a password in the guest, this option sets the password encryption of that password to \f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`sha256\*(C'\fR or \f(CW\*(C`sha512\*(C'\fR.
.Sp
\&\f(CW\*(C`sha256\*(C'\fR and \f(CW\*(C`sha512\*(C'\fR require glibc ≥ 2.7 (check \fBcrypt\fR\|(3) inside the guest).
.Sp
-\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. \s-1RHEL 3\s0), but is not secure against modern attacks.
+\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. RHEL 3), but is not secure against modern attacks.
.Sp
-The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for \s-1SHA\-512,\s0 in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
+The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for SHA\-512, in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
.Sp
-Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
-.IP "\fB\-\-root\-password\fR \s-1SELECTOR\s0" 4
+Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+.IP "\fB\-\-root\-password\fR SELECTOR" 4
.IX Item "--root-password SELECTOR"
Set the root password.
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.Sp
Note: In virt-builder, if you \fIdon't\fR set \fI\-\-root\-password\fR then the guest is given a \fIrandom\fR root password.
-.IP "\fB\-\-run\fR \s-1SCRIPT\s0" 4
+.IP "\fB\-\-run\fR SCRIPT" 4
.IX Item "--run SCRIPT"
Run the shell script (or any program) called \f(CW\*(C`SCRIPT\*(C'\fR on the disk image. The script runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
The script is automatically chmod +x.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.IP "\fB\-\-run\-command\fR '\s-1CMD+ARGS\s0'" 4
+.IP "\fB\-\-run\-command\fR 'CMD+ARGS'" 4
.IX Item "--run-command 'CMD+ARGS'"
Run the command and arguments on the disk image. The command runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\-command\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.IP "\fB\-\-scrub\fR \s-1FILE\s0" 4
+.IP "\fB\-\-scrub\fR FILE" 4
.IX Item "--scrub FILE"
Scrub a file from the guest. This is like \fI\-\-delete\fR except that:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
It scrubs the data so a guest could not recover it.
-.IP "\(bu" 4
+.IP \(bu 4
It cannot delete directories, only regular files.
.RE
.RS 4
.RE
-.IP "\fB\-\-selinux\-relabel\fR" 4
+.IP \fB\-\-selinux\-relabel\fR 4
.IX Item "--selinux-relabel"
This is a compatibility option that does nothing.
-.IP "\fB\-\-sm\-attach\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-sm\-attach\fR SELECTOR" 4
.IX Item "--sm-attach SELECTOR"
Attach to a pool using \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
-.IP "\fB\-\-sm\-credentials\fR \s-1SELECTOR\s0" 4
+See "SUBSCRIPTION-MANAGER" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+.IP "\fB\-\-sm\-credentials\fR SELECTOR" 4
.IX Item "--sm-credentials SELECTOR"
Set the credentials for \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
-.IP "\fB\-\-sm\-register\fR" 4
+See "SUBSCRIPTION-MANAGER" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+.IP \fB\-\-sm\-register\fR 4
.IX Item "--sm-register"
Register the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
This requires credentials being set using \fI\-\-sm\-credentials\fR.
-.IP "\fB\-\-sm\-remove\fR" 4
+.IP \fB\-\-sm\-remove\fR 4
.IX Item "--sm-remove"
Remove all the subscriptions from the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
-.IP "\fB\-\-sm\-unregister\fR" 4
+.IP \fB\-\-sm\-unregister\fR 4
.IX Item "--sm-unregister"
Unregister the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-ssh\-inject\fR USER[:SELECTOR]" 4
.IX Item "--ssh-inject USER[:SELECTOR]"
Inject an ssh key so the given \f(CW\*(C`USER\*(C'\fR will be able to log in over ssh without supplying a password. The \f(CW\*(C`USER\*(C'\fR must exist already in the guest.
.Sp
-See \*(L"\s-1SSH KEYS\*(R"\s0 for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+See "SSH KEYS" for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
.Sp
You can have multiple \fI\-\-ssh\-inject\fR options, for different users and also for more keys for each user.
-.IP "\fB\-\-timezone\fR \s-1TIMEZONE\s0" 4
+.IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
+.IP "\fB\-\-timezone\fR TIMEZONE" 4
.IX Item "--timezone TIMEZONE"
Set the default timezone of the guest to \f(CW\*(C`TIMEZONE\*(C'\fR. Use a location string like \f(CW\*(C`Europe/London\*(C'\fR
-.IP "\fB\-\-touch\fR \s-1FILE\s0" 4
+.IP "\fB\-\-touch\fR FILE" 4
.IX Item "--touch FILE"
This command performs a \fBtouch\fR\|(1)\-like operation on \f(CW\*(C`FILE\*(C'\fR.
-.IP "\fB\-\-truncate\fR \s-1FILE\s0" 4
+.IP "\fB\-\-truncate\fR FILE" 4
.IX Item "--truncate FILE"
This command truncates \f(CW\*(C`FILE\*(C'\fR to a zero-length file. The file must exist already.
-.IP "\fB\-\-truncate\-recursive\fR \s-1PATH\s0" 4
+.IP "\fB\-\-truncate\-recursive\fR PATH" 4
.IX Item "--truncate-recursive PATH"
This command recursively truncates all files under \f(CW\*(C`PATH\*(C'\fR to zero-length.
-.IP "\fB\-\-uninstall\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-uninstall\fR PKG,PKG.." 4
.IX Item "--uninstall PKG,PKG.."
Uninstall the named packages (a comma-separated list). These are removed during the image build using the guest’s package manager (eg. apt, yum, etc.). Dependent packages may also need to be uninstalled to satisfy the request.
.Sp
See also \fI\-\-install\fR, \fI\-\-update\fR.
-.IP "\fB\-\-update\fR" 4
+.IP \fB\-\-update\fR 4
.IX Item "--update"
Do the equivalent of \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR, or whatever command is required to update the packages already installed in the template to their latest versions.
.Sp
See also \fI\-\-install\fR, \fI\-\-uninstall\fR.
-.IP "\fB\-\-upload\fR \s-1FILE:DEST\s0" 4
+.IP "\fB\-\-upload\fR FILE:DEST" 4
.IX Item "--upload FILE:DEST"
Upload local file \f(CW\*(C`FILE\*(C'\fR to destination \f(CW\*(C`DEST\*(C'\fR in the disk image. File owner and permissions from the original are preserved, so you should set them to what you want them to be in the disk image.
.Sp
If \f(CW\*(C`DEST\*(C'\fR is a directory name (which must already exist in the guest) then the file is uploaded into that directory, and it keeps the same name as on the local filesystem.
.Sp
See also: \fI\-\-mkdir\fR, \fI\-\-delete\fR, \fI\-\-scrub\fR.
-.IP "\fB\-\-write\fR \s-1FILE:CONTENT\s0" 4
+.IP "\fB\-\-write\fR FILE:CONTENT" 4
.IX Item "--write FILE:CONTENT"
Write \f(CW\*(C`CONTENT\*(C'\fR to \f(CW\*(C`FILE\*(C'\fR.
-.SH "REFERENCE"
+.SH REFERENCE
.IX Header "REFERENCE"
-.SS "\s-1INSTALLING PACKAGES\s0"
+.SS "INSTALLING PACKAGES"
.IX Subsection "INSTALLING PACKAGES"
There are several approaches to installing packages or applications in the guest which have different trade-offs.
.PP
\fIInstalling packages at build time\fR
.IX Subsection "Installing packages at build time"
.PP
-If the guest \s-1OS\s0 you are installing is similar to the host \s-1OS\s0 (eg. both are Linux), and if libguestfs supports network connections, then you can use \fI\-\-install\fR to install packages like this:
+If the guest OS you are installing is similar to the host OS (eg. both are Linux), and if libguestfs supports network connections, then you can use \fI\-\-install\fR to install packages like this:
.PP
.Vb 1
\& virt\-builder fedora\-27 \-\-install inkscape
\& virt\-builder fedora\-27 \-\-update
.Ve
.PP
-Most of the templates that ship with virt-builder come with a very minimal selection of packages (known as a \*(L"\s-1JEOS\*(R"\s0 or \*(L"Just Enough Operating System\*(R"), which are up to date at the time the template is created, but could be out of date by the time you come to install an \s-1OS\s0 from the template. This option updates those template packages.
+Most of the templates that ship with virt-builder come with a very minimal selection of packages (known as a "JEOS" or "Just Enough Operating System"), which are up to date at the time the template is created, but could be out of date by the time you come to install an OS from the template. This option updates those template packages.
.PP
\fIInstalling packages at first boot\fR
.IX Subsection "Installing packages at first boot"
\fIInstalling packages at build time from a side repository\fR
.IX Subsection "Installing packages at build time from a side repository"
.PP
-If the software you want to install is not available in the main package repository of the guest, then you can add a side repository. Usually this is presented as an \s-1ISO\s0 (\s-1CD\s0 disk image) file containing extra packages.
+If the software you want to install is not available in the main package repository of the guest, then you can add a side repository. Usually this is presented as an ISO (CD disk image) file containing extra packages.
.PP
You can create the disk image using either \fBgenisoimage\fR\|(1) or \fBvirt\-make\-fs\fR\|(1). For genisoimage, use a command like this:
.PP
\& genisoimage \-o extra\-packages.iso \-R \-J \-V EXTRA cdcontents/
.Ve
.PP
-Create a script that mounts the \s-1ISO\s0 and sets up the repository. For dnf, create /tmp/install.sh containing:
+Create a script that mounts the ISO and sets up the repository. For dnf, create /tmp/install.sh containing:
.PP
.Vb 2
\& mkdir /tmp/mount
\& apt\-get \-y install famousdatabase
.Ve
.PP
-Use the \fI\-\-attach\fR option to attach the \s-1CD /\s0 disk image and the \fI\-\-run\fR option to run the script:
+Use the \fI\-\-attach\fR option to attach the CD / disk image and the \fI\-\-run\fR option to run the script:
.PP
.Vb 3
\& virt\-builder fedora\-27 \e
\& \-\-attach extra\-packages.iso \e
\& \-\-run /tmp/install.sh
.Ve
-.SS "\s-1USERS AND PASSWORDS\s0"
+.SS "USERS AND PASSWORDS"
.IX Subsection "USERS AND PASSWORDS"
The \fI\-\-root\-password\fR option is used to change the root password (otherwise a random password is used). This option takes a password \f(CW\*(C`SELECTOR\*(C'\fR in one of the following formats:
.IP "\fB\-\-root\-password\fR file:FILENAME" 4
.Ve
.PP
The above command will create an \f(CW\*(C`rjones\*(C'\fR account with no password, and force the user to set a password when they first log in. There are other ways to manage passwords, see \fBuseradd\fR\|(8) for details.
-.SS "\s-1KEYBOARD LAYOUT\s0"
+.SS "KEYBOARD LAYOUT"
.IX Subsection "KEYBOARD LAYOUT"
Because there are so many different ways to set the keyboard layout in Linux distributions, virt-builder does not yet attempt to have a simple command line option. This section describes how to set the keyboard for some common Linux distributions.
.PP
.PP
See \fBlocalectl\fR\|(1) and https://www.happyassassin.net/2013/11/23/keyboard\-layouts\-in\-fedora\-20\-and\-previously/ for more details.
.PP
-\fIKeyboard layout using \fI/etc/sysconfig/keyboard\fI\fR
+\fIKeyboard layout using /etc/sysconfig/keyboard\fR
.IX Subsection "Keyboard layout using /etc/sysconfig/keyboard"
.PP
-For \s-1RHEL\s0 ≤ 6, Fedora ≤ 18 and similar, upload or modify the keyboard configuration file using the \fI\-\-upload\fR, \fI\-\-write\fR or \fI\-\-edit\fR options. For example:
+For RHEL ≤ 6, Fedora ≤ 18 and similar, upload or modify the keyboard configuration file using the \fI\-\-upload\fR, \fI\-\-write\fR or \fI\-\-edit\fR options. For example:
.PP
.Vb 2
\& virt\-builder centos\-6 \e
.Ve
.PP
See https://wiki.debian.org/Keyboard.
-.SS "\s-1LANGUAGE\s0"
+.SS LANGUAGE
.IX Subsection "LANGUAGE"
Most Linux distributions support multiple locale settings so that you can have guest messages printed in another language such as Russian.
.PP
\& \-\-write \*(Aq/etc/default/locale:LANG="ja_JP.UTF\-8"\*(Aq \e
\& \-\-run\-command "locale\-gen"
.Ve
-.SS "\s-1LOG FILE\s0"
+.SS "LOG FILE"
.IX Subsection "LOG FILE"
Scripts and package installation that runs at build time (\fI\-\-run\fR, \fI\-\-run\-command\fR, \fI\-\-install\fR, \fI\-\-update\fR, but \fInot\fR firstboot) is logged in one of the following locations:
-.IP "\fI/tmp/builder.log\fR" 4
+.IP \fI/tmp/builder.log\fR 4
.IX Item "/tmp/builder.log"
-On Linux, \s-1BSD,\s0 and other non-Windows guests.
-.IP "\fIC:\eTemp\ebuilder.log\fR" 4
+On Linux, BSD, and other non-Windows guests.
+.IP \fIC:\eTemp\ebuilder.log\fR 4
.IX Item "C:Tempbuilder.log"
-On Windows, \s-1DOS\s0 guests.
-.IP "\fI/builder.log\fR" 4
+On Windows, DOS guests.
+.IP \fI/builder.log\fR 4
.IX Item "/builder.log"
If \fI/tmp\fR or \fIC:\eTemp\fR is missing.
.PP
If you don’t want the log file to appear in the final image, then use the \fI\-\-no\-logfile\fR command line option.
-.SS "\s-1SSH KEYS\s0"
+.SS "SSH KEYS"
.IX Subsection "SSH KEYS"
The \fI\-\-ssh\-inject\fR option is used to inject ssh keys for users in the guest, so they can login without supplying a password.
.PP
-The \f(CW\*(C`SELECTOR\*(C'\fR part of the option value is optional; in this case, \fI\-\-ssh\-inject\fR \f(CW\*(C`USER\*(C'\fR means that we look in the \fIcurrent\fR user’s \fI~/.ssh\fR directory to find the default public \s-1ID\s0 file. That key is uploaded. \*(L"default public \s-1ID\*(R"\s0 is the \fIdefault_ID_file\fR file described in \fBssh\-copy\-id\fR\|(1).
+The \f(CW\*(C`SELECTOR\*(C'\fR part of the option value is optional; in this case, \fI\-\-ssh\-inject\fR \f(CW\*(C`USER\*(C'\fR means that we look in the \fIcurrent\fR user’s \fI~/.ssh\fR directory to find the default public ID file. That key is uploaded. "default public ID" is the \fIdefault_ID_file\fR file described in \fBssh\-copy\-id\fR\|(1).
.PP
If specified, the \f(CW\*(C`SELECTOR\*(C'\fR can be in one of the following formats:
.IP "\fB\-\-ssh\-inject\fR USER:file:FILENAME" 4
.IX Item "--ssh-inject USER:file:FILENAME"
-Read the ssh key from \fI\s-1FILENAME\s0\fR. \fI\s-1FILENAME\s0\fR is usually a \fI.pub\fR file.
+Read the ssh key from \fIFILENAME\fR. \fIFILENAME\fR is usually a \fI.pub\fR file.
.IP "\fB\-\-ssh\-inject\fR USER:string:KEY_STRING" 4
.IX Item "--ssh-inject USER:string:KEY_STRING"
-Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR. \f(CW\*(C`KEY_STRING\*(C'\fR is usually a public string like \fIssh-rsa \s-1AAAA....\s0 user@localhost\fR.
+Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR. \f(CW\*(C`KEY_STRING\*(C'\fR is usually a public string like \fIssh-rsa AAAA.... user@localhost\fR.
.PP
In any case, the \fI~USER/.ssh\fR directory and the \fI~USER/.ssh/authorized_keys\fR file will be created if not existing already.
-.SS "\s-1FIRST BOOT SCRIPTS\s0"
+.SS "FIRST BOOT SCRIPTS"
.IX Subsection "FIRST BOOT SCRIPTS"
The \fI\-\-firstboot\fR and \fI\-\-firstboot\-command\fR options allow you to execute commands at the first boot of the guest. To do so, an init script for the guest init system is installed, which takes care of running all the added scripts and commands.
.PP
Supported operating systems are:
-.IP "Linux" 4
+.IP Linux 4
.IX Item "Linux"
Init systems supported are: systemd, System-V init (known also as sysvinit), and Upstart (using the System-V scripts).
.Sp
Note that usually init scripts run as root, but with a more limited environment than what could be available from a normal shell: for example, \f(CW$HOME\fR may be unset or empty.
.Sp
The output of the first boot scripts is available in the guest as \fI~root/virt\-sysprep\-firstboot.log\fR.
-.IP "Windows" 4
+.IP Windows 4
.IX Item "Windows"
-\&\fIrhsrvany.exe\fR, available from sources at https://github.com/rwmjones/rhsrvany, or \fIpvvxsvc.exe\fR, available with \s-1SUSE VMDP\s0 is installed to run the first boot scripts. It is required, and the setup of first boot scripts will fail if it is not present.
+\&\fIrhsrvany.exe\fR, available from sources at https://github.com/rwmjones/rhsrvany, or \fIpvvxsvc.exe\fR, available with SUSE VMDP is installed to run the first boot scripts. It is required, and the setup of first boot scripts will fail if it is not present.
.Sp
\&\fIrhsrvany.exe\fR or \fIpvvxsvc.exe\fR is copied from the location pointed to by the \f(CW\*(C`VIRT_TOOLS_DATA_DIR\*(C'\fR environment variable; if not set, a compiled-in default will be used (something like \fI/usr/share/virt\-tools\fR).
.Sp
The output of the first boot scripts is available in the guest as \fIC:\eProgram Files\eGuestfs\eFirstboot\elog.txt\fR.
-.SS "SUBSCRIPTION-MANAGER"
+.SS SUBSCRIPTION-MANAGER
.IX Subsection "SUBSCRIPTION-MANAGER"
It is possible to automate the registration and attaching of the system using \f(CW\*(C`subscription\-manager\*(C'\fR. This is typical on Red Hat Enterprise Linux guests. There are few options which ease this process, avoid executing commands manually and exposing passwords on command line.
.PP
\&\fI\-\-sm\-register\fR starts the registration process, and requires \fI\-\-sm\-credentials\fR to be specified; the format of the \f(CW\*(C`SELECTOR\*(C'\fR of \fI\-\-sm\-credentials\fR is one of the following formats:
.IP "\fB\-\-sm\-credentials\fR USER:file:FILENAME" 4
.IX Item "--sm-credentials USER:file:FILENAME"
-Read the password for the specified \f(CW\*(C`USER\*(C'\fR from \fI\s-1FILENAME\s0\fR.
+Read the password for the specified \f(CW\*(C`USER\*(C'\fR from \fIFILENAME\fR.
.IP "\fB\-\-sm\-credentials\fR USER:password:PASSWORD" 4
.IX Item "--sm-credentials USER:password:PASSWORD"
Use the literal string \f(CW\*(C`PASSWORD\*(C'\fR for the specified \f(CW\*(C`USER\*(C'\fR.
\&\f(CW\*(C`subscription\-manager\*(C'\fR attaches to the best-fitting subscriptions for the system.
.IP "\fB\-\-sm\-attach\fR file:FILENAME" 4
.IX Item "--sm-attach file:FILENAME"
-Read the pool \s-1ID\s0 from \fI\s-1FILENAME\s0\fR.
+Read the pool ID from \fIFILENAME\fR.
.IP "\fB\-\-sm\-attach\fR pool:POOL" 4
.IX Item "--sm-attach pool:POOL"
-Use the literal string \f(CW\*(C`POOL\*(C'\fR as pool \s-1ID.\s0
+Use the literal string \f(CW\*(C`POOL\*(C'\fR as pool ID.
.PP
\&\fI\-\-sm\-remove\fR removes all the subscriptions from the guest, while \fI\-\-sm\-unregister\fR completely unregister the system.
-.SS "\s-1INSTALLATION PROCESS\s0"
+.SS "INSTALLATION PROCESS"
.IX Subsection "INSTALLATION PROCESS"
When you invoke virt-builder, installation proceeds as follows:
-.IP "\(bu" 4
+.IP \(bu 4
The template image is downloaded.
.Sp
-If the template image is present in the cache, the cached version is used instead. (See \*(L"\s-1CACHING\*(R"\s0).
-.IP "\(bu" 4
+If the template image is present in the cache, the cached version is used instead. (See "CACHING").
+.IP \(bu 4
The template signature is checked.
-.IP "\(bu" 4
+.IP \(bu 4
The template is uncompressed to a tmp file.
-.IP "\(bu" 4
+.IP \(bu 4
The template image is resized into the destination, using \fBvirt\-resize\fR\|(1).
-.IP "\(bu" 4
+.IP \(bu 4
Extra disks are attached (\fI\-\-attach\fR).
-.IP "\(bu" 4
+.IP \(bu 4
A new random seed is generated for the guest.
-.IP "\(bu" 4
+.IP \(bu 4
Guest customization is performed, in the order specified on the command line.
-.IP "\(bu" 4
+.IP \(bu 4
SELinux relabelling is done unless disabled with \fI\-\-no\-selinux\-relabel\fR.
-.SS "\s-1IMPORTING THE DISK IMAGE\s0"
+.SS "IMPORTING THE DISK IMAGE"
.IX Subsection "IMPORTING THE DISK IMAGE"
\fIImporting into libvirt\fR
.IX Subsection "Importing into libvirt"
.Ve
.PP
注:
-.IP "1." 4
+.IP 1. 4
You \fImust\fR specify the correct format. The format is \f(CW\*(C`raw\*(C'\fR unless you used virt\-builder’s \fI\-\-format\fR option.
-.IP "2." 4
+.IP 2. 4
\&\fI\-\-os\-variant\fR is highly recommended, because it will present optimum devices to enable the guest to run most efficiently. To get a list of all variants, do:
.Sp
.Vb 1
.Ve
.Sp
The above tool is provided by libosinfo package.
-.IP "3." 4
+.IP 3. 4
You can run virt-install as root or non-root. Each works slightly differently because libvirt manages a different set of virtual machines for each user. In particular virt-manager normally shows the root-owned VMs, whereas Boxes shows the user-owned VMs, and other tools probably work differently as well.
.PP
\fIImporting into OpenStack\fR
.PP
The \fI\-\-file\fR parameter is the virt-builder-generated disk image. It should match virt\-builder’s \fI\-\-output\fR option. The \fI\-\-disk\-format\fR parameter should match virt\-builder’s \fI\-\-format\fR option (or \f(CW\*(C`raw\*(C'\fR if you didn't use that option). The \fI\-\-container\-format\fR should always be \f(CW\*(C`bare\*(C'\fR since virt-builder doesn't put images into containers.
.PP
-You can use the \f(CW\*(C`glance image\-show \f(CIfedora\-27\-image\f(CW\*(C'\fR command to display the properties of the image.
+You can use the \f(CW\*(C`glance\ image\-show\ \fR\f(CIfedora\-27\-image\fR\f(CW\*(C'\fR command to display the properties of the image.
.PP
To boot up an instance of your image on a Nova compute node, do:
.PP
\& \-\-flavor m1.medium
.Ve
.PP
-Use \f(CW\*(C`nova flavor\-list\*(C'\fR to list possible machine flavors. Use \f(CW\*(C`nova list\*(C'\fR to list running instances.
+Use \f(CW\*(C`nova\ flavor\-list\*(C'\fR to list possible machine flavors. Use \f(CW\*(C`nova\ list\*(C'\fR to list running instances.
.PP
-\fIBooting directly using qemu or \s-1KVM\s0\fR
+\fIBooting directly using qemu or KVM\fR
.IX Subsection "Booting directly using qemu or KVM"
.PP
The qemu command line is not very stable or easy to use, hence libvirt should be used if possible. However a command line similar to the following could be used to boot the virtual machine:
.Ve
.PP
As with libvirt, it is very important that the correct format is chosen. It will be \f(CW\*(C`raw\*(C'\fR unless the \fI\-\-format\fR option was used.
-.SS "\s-1CONFIGURATION MANAGEMENT\s0"
+.SS "CONFIGURATION MANAGEMENT"
.IX Subsection "CONFIGURATION MANAGEMENT"
\fIPuppet\fR
.IX Subsection "Puppet"
.Ve
.PP
The precise instructions vary according to the Linux distro. For further information see: https://docs.puppet.com/puppet/latest/install_pre.html
-.SS "\s-1DEBUGGING BUILDS\s0"
+.SS "DEBUGGING BUILDS"
.IX Subsection "DEBUGGING BUILDS"
-If virt-builder itself fails, then enable debugging (\fI\-v\fR) and report a bug (see \*(L"\s-1BUGS\*(R"\s0 below).
+If virt-builder itself fails, then enable debugging (\fI\-v\fR) and report a bug (see "BUGS" below).
.PP
If virt-builder fails because some script or package it is installing fails, try using \fI\-\-no\-delete\-on\-failure\fR to preserve the output file, and continue reading this section.
.PP
Use guestfish commands like \f(CW\*(C`ll /directory\*(C'\fR and \f(CW\*(C`cat /file\*(C'\fR to examine directories and files.
.IP "Use guestmount" 4
.IX Item "Use guestmount"
-Mount the disk image safely on the host using \s-1FUSE\s0 and \fBguestmount\fR\|(1):
+Mount the disk image safely on the host using FUSE and \fBguestmount\fR\|(1):
.Sp
.Vb 3
\& mkdir /tmp/mp
.Vb 1
\& console=tty0 console=ttyS0,115200
.Ve
-.SS "\s-1SOURCES OF TEMPLATES\s0"
+.SS "SOURCES OF TEMPLATES"
.IX Subsection "SOURCES OF TEMPLATES"
virt-builder reads the available sources from configuration files, with the \fI.conf\fR extension and located in the following paths:
-.IP "\(bu" 4
-\&\f(CW$XDG_CONFIG_HOME\fR/virt\-builder/repos.d/ (\f(CW$XDG_CONFIG_HOME\fR is \fI\f(CI$HOME\fI/.config\fR if not set).
-.IP "\(bu" 4
+.IP \(bu 4
+\&\f(CW$XDG_CONFIG_HOME\fR/virt\-builder/repos.d/ (\f(CW$XDG_CONFIG_HOME\fR is \fR\f(CI$HOME\fR\fI/.config\fR if not set).
+.IP \(bu 4
\&\f(CW$VIRT_BUILDER_DIRS\fR/virt\-builder/repos.d/ (where \f(CW$VIRT_BUILDER_DIRS\fR means any of the directories in that environment variable, or just \fI/etc\fR if not set).
.PP
Each \fI.conf\fR file in those paths has a simple text format like the following:
.PP
The following fields can appear:
.ie n .IP """uri=URI""" 4
-.el .IP "\f(CWuri=URI\fR" 4
+.el .IP \f(CWuri=URI\fR 4
.IX Item "uri=URI"
-The \s-1URI\s0 of the index file which this repository refers to.
+The URI of the index file which this repository refers to.
.Sp
This field is required.
.ie n .IP """gpgkey=URI""" 4
-.el .IP "\f(CWgpgkey=URI\fR" 4
+.el .IP \f(CWgpgkey=URI\fR 4
.IX Item "gpgkey=URI"
-This optional field represents the \s-1URI\s0 (although only \fIfile://\fR URIs are accepted) of the key used to sign the index file. If not present, the index file referred by \fIuri=..\fR is not signed.
+This optional field represents the URI (although only \fIfile://\fR URIs are accepted) of the key used to sign the index file. If not present, the index file referred by \fIuri=..\fR is not signed.
.ie n .IP """proxy=MODE""" 4
-.el .IP "\f(CWproxy=MODE\fR" 4
+.el .IP \f(CWproxy=MODE\fR 4
.IX Item "proxy=MODE"
This optional field specifies the proxy mode, to be used when downloading the index file of this repository. The possible values are:
.RS 4
.IP "\fBno\fR, \fBoff\fR" 4
.IX Item "no, off"
No proxy is being used at all, even overriding the system configuration.
-.IP "\fBsystem\fR" 4
+.IP \fBsystem\fR 4
.IX Item "system"
The proxy used is the system one.
.IP "\fIanything else\fR" 4
If not present, the assumed value is to respect the proxy settings of the system (i.e. as if \fBsystem\fR would be specified).
.RE
.ie n .IP """format=FORMAT""" 4
-.el .IP "\f(CWformat=FORMAT\fR" 4
+.el .IP \f(CWformat=FORMAT\fR 4
.IX Item "format=FORMAT"
This optional field specifies the format of the repository. The possible values are:
.RS 4
-.IP "\fBnative\fR" 4
+.IP \fBnative\fR 4
.IX Item "native"
-The native format of the \f(CW\*(C`virt\-builder\*(C'\fR repository. See also \*(L"Creating and signing the index file\*(R" below.
-.IP "\fBsimplestreams\fR" 4
+The native format of the \f(CW\*(C`virt\-builder\*(C'\fR repository. See also "Creating and signing the index file" below.
+.IP \fBsimplestreams\fR 4
.IX Item "simplestreams"
-The \s-1URI\s0 represents the root of a Simple Streams v1.0 tree of metadata.
+The URI represents the root of a Simple Streams v1.0 tree of metadata.
.Sp
For more information about Simple Streams, see also https://launchpad.net/simplestreams.
.RE
.PP
You can set up your own site containing an index file and some templates, and then point virt-builder at the site by creating a \fI.conf\fR file pointing to it.
.PP
-Note that if your index is signed, you will need to properly fill \fIgpgkey=..\fR in your \fI.conf\fR file, making sure to deploy also the \s-1GPG\s0 key file.
+Note that if your index is signed, you will need to properly fill \fIgpgkey=..\fR in your \fI.conf\fR file, making sure to deploy also the GPG key file.
.PP
.Vb 3
\& virt\-builder \-\-source https://example.com/builder/index.asc \e
\& \-\-list
.Ve
.PP
-You can host this on any web or \s-1FTP\s0 server, or a local or network filesystem.
+You can host this on any web or FTP server, or a local or network filesystem.
.PP
-\fISetting up a \s-1GPG\s0 key\fR
+\fISetting up a GPG key\fR
.IX Subsection "Setting up a GPG key"
.PP
If you don’t have a GnuPG key, you will need to set one up. (Strictly speaking this is optional, but if your index and template files are not signed then virt-builder users will have to use the \fI\-\-no\-check\-signature\fR flag every time they use virt-builder.)
.PP
-To create a key, see the \s-1GPG\s0 manual http://www.gnupg.org/gph/en/manual.html.
+To create a key, see the GPG manual http://www.gnupg.org/gph/en/manual.html.
.PP
-Export your \s-1GPG\s0 public key:
+Export your GPG public key:
.PP
.Vb 1
\& gpg \-\-export \-a "you@example.com" > pubkey
.PP
There are many ways to create the templates. For example you could clone existing guests (see \fBvirt\-sysprep\fR\|(1)), or you could install a guest by hand (\fBvirt\-install\fR\|(1)). To see how the templates were created for virt-builder, look at the scripts in \f(CW\*(C`builder/templates\*(C'\fR
.PP
-Virt-builder supports any image format (e.g. raw, qcow2, etc) as template, both as-is, and compressed as \s-1XZ.\s0 This way, existing images (e.g. cleaned using \fBvirt\-sysprep\fR\|(1)) can be used as templates.
+Virt-builder supports any image format (e.g. raw, qcow2, etc) as template, both as-is, and compressed as XZ. This way, existing images (e.g. cleaned using \fBvirt\-sysprep\fR\|(1)) can be used as templates.
.PP
For best results when compressing the templates, use the following xz options (see \fBnbdkit\-xz\-plugin\fR\|(1) for further explanation):
.PP
\& expand=/dev/sda3
.Ve
.PP
-The part in square brackets is the \f(CW\*(C`os\-version\*(C'\fR, which is the same string that is used on the virt-builder command line to build that \s-1OS.\s0
+The part in square brackets is the \f(CW\*(C`os\-version\*(C'\fR, which is the same string that is used on the virt-builder command line to build that OS.
.PP
The index file creation and signature can be eased with the \fBvirt\-builder\-repository\fR\|(1) tool.
.PP
\& gpg \-\-clearsign \-\-armor index
.Ve
.PP
-This will create the final file called \fIindex.asc\fR which can be uploaded to the server (and is the \fIuri=..\fR \s-1URL\s0). As noted above, signing the index file is optional, but recommended.
+This will create the final file called \fIindex.asc\fR which can be uploaded to the server (and is the \fIuri=..\fR URL). As noted above, signing the index file is optional, but recommended.
.PP
The following fields can appear:
.ie n .IP """name=NAME""" 4
-.el .IP "\f(CWname=NAME\fR" 4
+.el .IP \f(CWname=NAME\fR 4
.IX Item "name=NAME"
The user-friendly name of this template. This is displayed in the \fI\-\-list\fR output but is otherwise not significant.
.ie n .IP """osinfo=ID""" 4
-.el .IP "\f(CWosinfo=ID\fR" 4
+.el .IP \f(CWosinfo=ID\fR 4
.IX Item "osinfo=ID"
-This optional field maps the operating system to the associated libosinfo \s-1ID.\s0 Virt-builder does not use it (yet).
+This optional field maps the operating system to the associated libosinfo ID. Virt-builder does not use it (yet).
.ie n .IP """arch=ARCH""" 4
-.el .IP "\f(CWarch=ARCH\fR" 4
+.el .IP \f(CWarch=ARCH\fR 4
.IX Item "arch=ARCH"
The architecture of the operating system installed within the template. This field is required.
.ie n .IP """file=PATH""" 4
-.el .IP "\f(CWfile=PATH\fR" 4
+.el .IP \f(CWfile=PATH\fR 4
.IX Item "file=PATH"
The path (relative to the index) of the xz-compressed template.
.Sp
-Note that absolute paths or URIs are \fBnot\fR permitted here. This is because virt-builder has a \*(L"same origin\*(R" policy for templates so they cannot come from other servers.
+Note that absolute paths or URIs are \fBnot\fR permitted here. This is because virt-builder has a "same origin" policy for templates so they cannot come from other servers.
.ie n .IP """sig=PATH""" 4
-.el .IP "\f(CWsig=PATH\fR" 4
+.el .IP \f(CWsig=PATH\fR 4
.IX Item "sig=PATH"
\&\fBThis option is deprecated\fR. Use the checksum field instead.
.Sp
-The path (relative to the index) of the \s-1GPG\s0 detached signature of the xz file.
+The path (relative to the index) of the GPG detached signature of the xz file.
.Sp
-Note that absolute paths or URIs are \fBnot\fR permitted here. This is because virt-builder has a \*(L"same origin\*(R" policy for templates so they cannot come from other servers.
+Note that absolute paths or URIs are \fBnot\fR permitted here. This is because virt-builder has a "same origin" policy for templates so they cannot come from other servers.
.Sp
The file can be created as follows:
.Sp
\& gpg \-\-detach\-sign \-\-armor \-o disk.xz.sig disk.xz
.Ve
.ie n .IP """checksum[sha512]=7b882fe9b82eb0fef...""" 4
-.el .IP "\f(CWchecksum[sha512]=7b882fe9b82eb0fef...\fR" 4
+.el .IP \f(CWchecksum[sha512]=7b882fe9b82eb0fef...\fR 4
.IX Item "checksum[sha512]=7b882fe9b82eb0fef..."
-The \s-1SHA\-512\s0 checksum of the file specified in \fIfile=..\fR is checked after it is downloaded. To work out the signature, do:
+The SHA\-512 checksum of the file specified in \fIfile=..\fR is checked after it is downloaded. To work out the signature, do:
.Sp
.Vb 1
\& sha512sum disk.xz
.Sp
Note if you use this, you don’t need to sign the file, ie. don’t use \f(CW\*(C`sig\*(C'\fR. This option overrides \f(CW\*(C`sig\*(C'\fR.
.ie n .IP """checksum=7b882fe9b82eb0fef...""" 4
-.el .IP "\f(CWchecksum=7b882fe9b82eb0fef...\fR" 4
+.el .IP \f(CWchecksum=7b882fe9b82eb0fef...\fR 4
.IX Item "checksum=7b882fe9b82eb0fef..."
\&\f(CW\*(C`checksum\*(C'\fR is an alias for \f(CW\*(C`checksum[sha512]\*(C'\fR.
.Sp
If you need to interoperate with virt-builder = 1.24.0 then you have to use \f(CW\*(C`checksum\*(C'\fR because that version would give a parse error with square brackets and numbers in the key of a field. This is fixed in virt-builder ≥ 1.24.1.
.ie n .IP """revision=N""" 4
-.el .IP "\f(CWrevision=N\fR" 4
+.el .IP \f(CWrevision=N\fR 4
.IX Item "revision=N"
The revision is an integer which is used to control the template cache. Increasing the revision number causes clients to download the template again even if they have a copy in the cache.
.Sp
The revision number is optional. If omitted it defaults to \f(CW1\fR.
.ie n .IP """format=raw""" 4
-.el .IP "\f(CWformat=raw\fR" 4
+.el .IP \f(CWformat=raw\fR 4
.IX Item "format=raw"
.PD 0
.ie n .IP """format=qcow2""" 4
-.el .IP "\f(CWformat=qcow2\fR" 4
+.el .IP \f(CWformat=qcow2\fR 4
.IX Item "format=qcow2"
.PD
Specify the format of the disk image; in case it is compressed, that is the format before the compression. If not given, the format is autodetected, but generally it is better to be explicit about the intended format.
.Sp
Note this is the source format, which is different from the \fI\-\-format\fR option (requested output format). Virt-builder does on-the-fly conversion from the source format to the requested output format.
.ie n .IP """size=NNN""" 4
-.el .IP "\f(CWsize=NNN\fR" 4
+.el .IP \f(CWsize=NNN\fR 4
.IX Item "size=NNN"
The virtual size of the image in bytes. This is the size of the image when uncompressed. If using a non-raw format such as qcow2 then it means the virtual disk size, not the size of the qcow2 file.
.Sp
.Sp
Virt-builder also uses this as the minimum size that users can request via the \fI\-\-size\fR option, or as the default size if there is no \fI\-\-size\fR option.
.ie n .IP """compressed_size=NNN""" 4
-.el .IP "\f(CWcompressed_size=NNN\fR" 4
+.el .IP \f(CWcompressed_size=NNN\fR 4
.IX Item "compressed_size=NNN"
The actual size of the disk image in bytes, i.e. what was specified in \fIfile=..\fR. This is just used for information (when using \f(CW\*(C`long\*(C'\fR, and \f(CW\*(C`json\*(C'\fR formats of \fI\-\-list\fR).
.ie n .IP """expand=/dev/sdaX""" 4
-.el .IP "\f(CWexpand=/dev/sdaX\fR" 4
+.el .IP \f(CWexpand=/dev/sdaX\fR 4
.IX Item "expand=/dev/sdaX"
When expanding the image to its final size, instruct \fBvirt\-resize\fR\|(1) to expand the named partition in the guest image to fill up all available space. This works like the virt-resize \fI\-\-expand\fR option.
.Sp
.Sp
It’s a good idea to use this, but not required. If the field is omitted then virt-resize will create an extra partition at the end of the disk to cover the free space, which is much less user-friendly.
.ie n .IP """lvexpand=/dev/VolGroup/LogVol""" 4
-.el .IP "\f(CWlvexpand=/dev/VolGroup/LogVol\fR" 4
+.el .IP \f(CWlvexpand=/dev/VolGroup/LogVol\fR 4
.IX Item "lvexpand=/dev/VolGroup/LogVol"
When expanding the image to its final size, instruct \fBvirt\-resize\fR\|(1) to expand the named logical volume in the guest image to fill up all available space. This works like the virt-resize \fI\-\-lv\-expand\fR option.
.Sp
-If the guest uses \s-1LVM2\s0 you should usually put the \s-1LV\s0 of the guest’s root filesystem here. If the guest does not use \s-1LVM2\s0 or its root filesystem is not on an \s-1LV,\s0 don't use this option.
+If the guest uses LVM2 you should usually put the LV of the guest’s root filesystem here. If the guest does not use LVM2 or its root filesystem is not on an LV, don't use this option.
.ie n .IP """notes=NOTES""" 4
-.el .IP "\f(CWnotes=NOTES\fR" 4
+.el .IP \f(CWnotes=NOTES\fR 4
.IX Item "notes=NOTES"
Any notes that go with this image, especially notes describing what packages are in the image, how the image was prepared, and licensing information.
.Sp
\& ...
.Ve
.ie n .IP """hidden=true""" 4
-.el .IP "\f(CWhidden=true\fR" 4
+.el .IP \f(CWhidden=true\fR 4
.IX Item "hidden=true"
Using the hidden flag prevents the template from being listed by the \fI\-\-list\fR option (but it is still installable). This is used for test images.
.ie n .IP """aliases=ALIAS1 ALIAS2 ...""" 4
.PP
Note that the parser and tool can work on either the signed or unsigned index file (ie. \fIindex\fR or \fIindex.asc\fR).
.PP
-The index is always encoded in \s-1UTF\-8.\s0
-.SS "\s-1CACHING\s0"
+The index is always encoded in UTF\-8.
+.SS CACHING
.IX Subsection "CACHING"
\fICaching templates\fR
.IX Subsection "Caching templates"
.PP
Since the templates are usually very large, downloaded templates are cached in the user’s home directory.
.PP
-The location of the cache is \fI\f(CI$XDG_CACHE_HOME\fI/virt\-builder/\fR or \fI\f(CI$HOME\fI/.cache/virt\-builder\fR.
+The location of the cache is \fR\f(CI$XDG_CACHE_HOME\fR\fI/virt\-builder/\fR or \fI\fR\f(CI$HOME\fR\fI/.cache/virt\-builder\fR.
.PP
You can print out information about the cache directory, including which guests are currently cached, by doing:
.PP
.PP
Virt-builder uses \fBcurl\fR\|(1) to download files and it also uses the current \f(CW\*(C`http_proxy\*(C'\fR (etc) settings when installing packages (\fI\-\-install\fR, \fI\-\-update\fR).
.PP
-You may therefore want to set those environment variables in order to maximize the amount of local caching that happens. See \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 and \fBcurl\fR\|(1).
+You may therefore want to set those environment variables in order to maximize the amount of local caching that happens. See "ENVIRONMENT VARIABLES" and \fBcurl\fR\|(1).
.PP
\fILocal mirrors\fR
.IX Subsection "Local mirrors"
\& \-\-run\-command \*(Aqapt\-get \-y update\*(Aq \e
\& \-\-install \*(Aqpkg1,pkg2,...\*(Aq
.Ve
-.SS "\s-1DIGITAL SIGNATURES\s0"
+.SS "DIGITAL SIGNATURES"
.IX Subsection "DIGITAL SIGNATURES"
-Virt-builder uses \s-1GNU\s0 Privacy Guard (GnuPG or gpg) to verify that the index and templates have not been tampered with.
+Virt-builder uses GNU Privacy Guard (GnuPG or gpg) to verify that the index and templates have not been tampered with.
.PP
The source points to an index file, which is optionally signed.
.PP
When a template is downloaded, its signature is checked in the same way.
.PP
Although the signatures are optional, if you don’t have them then virt-builder users will have to use \fI\-\-no\-check\-signature\fR on the command line. This prevents an attacker from replacing the signed index file with an unsigned index file and having virt-builder silently work without checking the signature. In any case it is highly recommended that you always create signed index and templates.
-.SS "アーキテクチャー"
+.SS アーキテクチャー
.IX Subsection "アーキテクチャー"
-Virt-builder can build a guest for any architecture no matter what the host architecture is. For example an x86\-64 guest on an \s-1ARM\s0 host.
+Virt-builder can build a guest for any architecture no matter what the host architecture is. For example an x86\-64 guest on an ARM host.
.PP
However certain options may not work, specifically options that require running commands in the guest during the build process: \fI\-\-install\fR, \fI\-\-update\fR, \fI\-\-run\fR, \fI\-\-run\-command\fR. You may need to replace these with their firstboot-equivalents.
.PP
An x86\-64 host building 32 bit i686 guests should work without any special steps.
-.SS "セキュリティ"
+.SS セキュリティ
.IX Subsection "セキュリティ"
Virt-builder does not need to run as root (in fact, should not be run as root), and doesn't use setuid, \f(CW\*(C`sudo\*(C'\fR or any similar mechanism.
.PP
.PP
Firstboot commands run in the context of the guest when it is booted, and so the security of your hypervisor / cloud should be considered.
.PP
-Virt-builder injects a random seed into every guest which it builds. This helps to ensure that \s-1TCP\s0 sequence numbers, UUIDs, ssh host keys etc are truly random when the guest boots.
+Virt-builder injects a random seed into every guest which it builds. This helps to ensure that TCP sequence numbers, UUIDs, ssh host keys etc are truly random when the guest boots.
.PP
You should check digital signatures and not ignore any signing errors.
-.SS "\s-1CLONES\s0"
+.SS CLONES
.IX Subsection "CLONES"
If you wish to create many new guests of the same type, it is tempting to run virt-builder once and then copy the output file. You should \fBnot\fR do this. You should run virt-builder once for each new guest you need.
.PP
The reason is that each clone needs to have (at least) a separate random seed, and possibly other unique features (such as filesystem UUIDs) in future versions of virt-builder.
.PP
-Another thing you should \fInot\fR do is to boot the guest, then clone the booted disk image. The reason is that some guests create unique machine IDs, \s-1SSH\s0 host keys and so on at first boot, and you would not want clones to have duplicate identities.
+Another thing you should \fInot\fR do is to boot the guest, then clone the booted disk image. The reason is that some guests create unique machine IDs, SSH host keys and so on at first boot, and you would not want clones to have duplicate identities.
.PP
See also: \fBvirt\-sysprep\fR\|(1).
-.SS "\s-1PERFORMANCE\s0"
+.SS PERFORMANCE
.IX Subsection "PERFORMANCE"
-The most important aspect of getting good performance is caching. Templates gets downloaded into the cache the first time they are used, or if you use the \fI\-\-cache\-all\-templates\fR option. See \*(L"\s-1CACHING\*(R"\s0 above for further information.
+The most important aspect of getting good performance is caching. Templates gets downloaded into the cache the first time they are used, or if you use the \fI\-\-cache\-all\-templates\fR option. See "CACHING" above for further information.
.PP
Packages required for the \fI\-\-install\fR and \fI\-\-update\fR options are downloaded using the host network connection. Setting the \f(CW\*(C`http_proxy\*(C'\fR, \f(CW\*(C`https_proxy\*(C'\fR and \f(CW\*(C`ftp_proxy\*(C'\fR environment variables to point to a local web cache may ensure they only need to be downloaded once. You can also try using a local package repository, although this can be complex to set up and varies according to which Linux distro you are trying to install.
.PP
-\fIUsing \fI\-\-no\-sync\fI\fR
+\fIUsing \-\-no\-sync\fR
.IX Subsection "Using --no-sync"
.PP
-Use \fI\-\-no\-sync\fR. However read the caveats in the \*(L"\s-1OPTIONS\*(R"\s0 section above, since this can cause disk corruption if not used correctly.
+Use \fI\-\-no\-sync\fR. However read the caveats in the "OPTIONS" section above, since this can cause disk corruption if not used correctly.
.PP
\fISkipping virt-resize\fR
.IX Subsection "Skipping virt-resize"
.PP
Virt-builder can skip the virt-resize step under certain conditions. This makes virt-builder much faster. The conditions are:
-.IP "\(bu" 4
+.IP \(bu 4
the output must be a regular file (not a block device), \fBand\fR
-.IP "\(bu" 4
+.IP \(bu 4
the user did \fBnot\fR use the \fI\-\-size\fR option, \fBand\fR
-.IP "\(bu" 4
+.IP \(bu 4
the output format is the same as the template format (usually raw).
.PP
\fIpxzcat\fR
.IX Subsection "pxzcat"
.PP
Virt-builder uses an internal implementation of pxzcat (parallel xzcat) if liblzma was found at build time. If liblzma was not found at build time, regular \f(CW\*(C`xzcat\*(C'\fR is used which is single-threaded.
-.SS "SELinux"
+.SS SELinux
.IX Subsection "SELinux"
Guests which use SELinux (such as Fedora and Red Hat Enterprise Linux) require that each file has a correct SELinux label.
.PP
Guest templates may already contain a file called \fI/.autorelabel\fR or you may touch it.
.Sp
For guests that use SELinux, this causes \fBrestorecon\fR\|(8) to run at first boot. Guests will reboot themselves once the first time you use them, which is normal and harmless.
-.SH "マシン可読な出力"
+.SH マシン可読な出力
.IX Header "マシン可読な出力"
The \fI\-\-machine\-readable\fR option can be used to make the output more machine friendly, which is useful when calling virt-builder from other programs, GUIs etc.
.PP
.PP
A list of features is printed, one per line, and the program exits with status 0.
.PP
-It is possible to specify a format string for controlling the output; see \*(L"\s-1ADVANCED MACHINE READABLE OUTPUT\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "環境変数"
+It is possible to specify a format string for controlling the output; see "ADVANCED MACHINE READABLE OUTPUT" in \fBguestfs\fR\|(3).
+.SH 環境変数
.IX Header "環境変数"
-For other environment variables which affect all libguestfs programs, see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
+For other environment variables which affect all libguestfs programs, see "ENVIRONMENT VARIABLES" in \fBguestfs\fR\|(3).
.ie n .IP """http_proxy""" 4
-.el .IP "\f(CWhttp_proxy\fR" 4
+.el .IP \f(CWhttp_proxy\fR 4
.IX Item "http_proxy"
.PD 0
.ie n .IP """https_proxy""" 4
-.el .IP "\f(CWhttps_proxy\fR" 4
+.el .IP \f(CWhttps_proxy\fR 4
.IX Item "https_proxy"
.ie n .IP """no_proxy""" 4
-.el .IP "\f(CWno_proxy\fR" 4
+.el .IP \f(CWno_proxy\fR 4
.IX Item "no_proxy"
.PD
Set the proxy for downloads. These environment variables (and more) are actually interpreted by \fBcurl\fR\|(1), not virt-builder.
.ie n .IP """HOME""" 4
-.el .IP "\f(CWHOME\fR" 4
+.el .IP \f(CWHOME\fR 4
.IX Item "HOME"
-Used to determine the location of the template cache, and the location of the user' sources. See \*(L"\s-1CACHING\*(R"\s0 and \*(L"\s-1SOURCES OF TEMPLATES\*(R"\s0.
+Used to determine the location of the template cache, and the location of the user' sources. See "CACHING" and "SOURCES OF TEMPLATES".
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
This can point to the directory containing data files used for Windows firstboot installation.
.Sp
.Sp
This directory may contain the following files:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
-This is the RHSrvAny Windows binary, used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is the RHSrvAny Windows binary, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.Sp
See also: \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-This is a Windows binary shipped with \s-1SUSE VMDP,\s0 used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is a Windows binary shipped with SUSE VMDP, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.RE
.RS 4
.RE
.ie n .IP """XDG_CACHE_HOME""" 4
-.el .IP "\f(CWXDG_CACHE_HOME\fR" 4
+.el .IP \f(CWXDG_CACHE_HOME\fR 4
.IX Item "XDG_CACHE_HOME"
-Used to determine the location of the template cache. See \*(L"\s-1CACHING\*(R"\s0.
+Used to determine the location of the template cache. See "CACHING".
.ie n .IP """XDG_CONFIG_HOME""" 4
-.el .IP "\f(CWXDG_CONFIG_HOME\fR" 4
+.el .IP \f(CWXDG_CONFIG_HOME\fR 4
.IX Item "XDG_CONFIG_HOME"
-Used to determine the location of the user' sources. See \*(L"\s-1SOURCES OF TEMPLATES\*(R"\s0.
+Used to determine the location of the user' sources. See "SOURCES OF TEMPLATES".
.ie n .IP """VIRT_BUILDER_DIRS""" 4
-.el .IP "\f(CWVIRT_BUILDER_DIRS\fR" 4
+.el .IP \f(CWVIRT_BUILDER_DIRS\fR 4
.IX Item "VIRT_BUILDER_DIRS"
-Used to determine the location of the system sources. See \*(L"\s-1SOURCES OF TEMPLATES\*(R"\s0.
-.SH "終了ステータス"
+Used to determine the location of the system sources. See "SOURCES OF TEMPLATES".
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBguestmount\fR\|(1), \fBvirt\-builder\-repository\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-customize\fR\|(1), \fBvirt\-get\-kernel\fR\|(1), \fBvirt\-install\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sysprep\fR\|(1), \fBoz\-install\fR\|(1), \fBgpg\fR\|(1), \fBgpg2\fR\|(1), \fBcurl\fR\|(1), \fBvirt\-make\-fs\fR\|(1), \fBgenisoimage\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2013 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-cat 1"
-.TH virt-cat 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-cat 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-cat \- 仮想マシンにあるファイルの表示
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-cat [\-\-options] \-d domname file [file ...]
\&
\& virt\-cat disk.img file
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\f(CW\*(C`virt\-cat\*(C'\fR は \f(CW\*(C`file\*(C'\fR の内容を表示するためにコマンドラインツールです。ここで \f(CW\*(C`file\*(C'\fR は仮想マシン (またはディスクイメージ) の中に存在します。
.PP
Multiple filenames can be given, in which case they are concatenated together. Each filename must be a full path, starting at the root directory (starting with '/').
.PP
-\&\f(CW\*(C`virt\-cat\*(C'\fR can be used to quickly view a file. To edit a file, use \f(CW\*(C`virt\-edit\*(C'\fR. For more complex cases you should look at the \fBguestfish\fR\|(1) tool (see \*(L"\s-1USING GUESTFISH\*(R"\s0 below).
-.SH "例"
+\&\f(CW\*(C`virt\-cat\*(C'\fR can be used to quickly view a file. To edit a file, use \f(CW\*(C`virt\-edit\*(C'\fR. For more complex cases you should look at the \fBguestfish\fR\|(1) tool (see "USING GUESTFISH" below).
+.SH 例
.IX Header "例"
-Display \fI/etc/fstab\fR file from inside the libvirt \s-1VM\s0 called \f(CW\*(C`mydomain\*(C'\fR:
+Display \fI/etc/fstab\fR file from inside the libvirt VM called \f(CW\*(C`mydomain\*(C'\fR:
.PP
.Vb 1
\& virt\-cat \-d mydomain /etc/fstab
\& virt\-cat \-d mydomain /var/log/wtmp > /tmp/wtmp
\& last \-f /tmp/wtmp
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a \s-1URI\s0\fR" 4
+.IP "\fB\-a URI\fR" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add \s-1URI\s0\fR" 4
+.IP "\fB\-\-add URI\fR" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
キーやパスフレーズを入力するとき、通常 virt-cat はエコーを無効化します。 そのため、入力内容を確認できません。 テンペスト攻撃の心配がなく、 部屋に誰も居なければ、 入力内容を確認するためにこのフラグを指定できます。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Specifying any mountpoint disables the inspection of the guest and the mount of its root and all of its mountpoints, so make sure to mount all the mountpoints needed to work with the filenames given as arguments.
.Sp
-If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" and \*(L"lvs\*(R" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
+If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see "list-partitions", "list-filesystems" and "lvs" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
.Sp
マウントパラメーターの三番目の (ほとんど使用されない) 項目は、 バックエンドのファイルシステムをマウントするために使用される マウントオプションの一覧です。 これが指定されていない場合、 マウントオプションは空文字列または \f(CW\*(C`ro\*(C'\fR (\fI\-\-ro\fR フラグが使用されている場合) になります。
.Sp
このフラグを使用することは、 \f(CW\*(C`mount\-options\*(C'\fR コマンドを使用することと同等です。
.Sp
パラメーターの四番目の項目は使用するファイルシステムドライバー (\f(CW\*(C`ext3\*(C'\fR や \f(CW\*(C`ntfs\*(C'\fR など) です。 これはほとんど必要ありません。 しかし、複数のドライバーがファイルシステムに対して有効である場合 (例: \f(CW\*(C`ext2\*(C'\fR と \f(CW\*(C`ext3\*(C'\fR)、 または libguestfs がファイルシステムを誤検知している場合、 これは有用です。
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "旧形式のコマンドライン引数"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 旧形式のコマンドライン引数
.IX Header "旧形式のコマンドライン引数"
以前のバージョンの virt-cat はどちらの書き込みもできます:
.PP
\&\f(CW\*(C`virt\-cat\*(C'\fR has a limited ability to understand Windows drive letters and paths (eg. \fIE:\efoo\ebar.txt\fR).
.PP
仮想マシンが Windows を実行している場合に限り:
-.IP "\(bu" 4
+.IP \(bu 4
Drive letter prefixes like \f(CW\*(C`C:\*(C'\fR are resolved against the Windows Registry to the correct filesystem.
-.IP "\(bu" 4
+.IP \(bu 4
Any backslash (\f(CW\*(C`\e\*(C'\fR) characters in the path are replaced with forward slashes so that libguestfs can process it.
-.IP "\(bu" 4
+.IP \(bu 4
The path is resolved case insensitively to locate the file that should be displayed.
.PP
There are some known shortcomings:
-.IP "\(bu" 4
-Some \s-1NTFS\s0 symbolic links may not be followed correctly.
-.IP "\(bu" 4
-\&\s-1NTFS\s0 junction points that cross filesystems are not followed.
+.IP \(bu 4
+Some NTFS symbolic links may not be followed correctly.
+.IP \(bu 4
+NTFS junction points that cross filesystems are not followed.
.SH "guestfish の使用法"
.IX Header "guestfish の使用法"
\&\fBguestfish\fR\|(1) は \f(CW\*(C`virt\-cat\*(C'\fR がうまく機能しないときに使用できる、より強力な、より低レベルなツールです。
\& guestfish \-\-ro \-i \-d domname download file \-
.Ve
.PP
-ここで \f(CW\*(C`domname\*(C'\fR は libvirt 仮想マシンの名前です。また、\f(CW\*(C`file\*(C'\fR はファイルの完全パスです。最後の \f(CW\*(C`\-\*(C'\fR (\*(L"標準出力に出力\*(R" を意味します) に注意してください。
+ここで \f(CW\*(C`domname\*(C'\fR は libvirt 仮想マシンの名前です。また、\f(CW\*(C`file\*(C'\fR はファイルの完全パスです。最後の \f(CW\*(C`\-\*(C'\fR ("標準出力に出力" を意味します) に注意してください。
.PP
The command above uses libguestfs’s guest inspection feature and so does not work on guests that libguestfs cannot inspect, or on things like arbitrary disk images that don't contain guests. To display a file from a disk image directly, use:
.PP
.Ve
.PP
where \fIdisk.img\fR is the disk image, \fI/dev/sda1\fR is the filesystem within the disk image, and \f(CW\*(C`file\*(C'\fR is the full path to the file.
-.SH "終了ステータス"
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-edit\fR\|(1), \fBvirt\-log\fR\|(1), \fBvirt\-tail\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-customize 1"
-.TH virt-customize 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-customize 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-customize \- Customize a virtual machine
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 7
\& virt\-customize
\&
\& virt\-customize [ \-V | \-\-version ]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
Virt-customize can customize a virtual machine (disk image) by installing packages, editing configuration files, and so on.
.PP
You do \fInot\fR need to run virt-customize as root. In fact we'd generally recommend that you don't.
.PP
Related tools include: \fBvirt\-sysprep\fR\|(1) and \fBvirt\-builder\fR\|(1).
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
仮想マシンからディスクイメージの \fIfile\fR を追加します。
.Sp
ディスクイメージの形式は自動的に検出されます。強制的に特定の形式を使用するには \fI\-\-format\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-Add a remote disk. The \s-1URI\s0 format is compatible with guestfish. See \*(L"\s-1ADDING REMOTE STORAGE\*(R"\s0 in \fBguestfish\fR\|(1).
-.IP "\fB\-\-attach\fR \s-1ISOFILE\s0" 4
+Add a remote disk. The URI format is compatible with guestfish. See "ADDING REMOTE STORAGE" in \fBguestfish\fR\|(1).
+.IP "\fB\-\-attach\fR ISOFILE" 4
.IX Item "--attach ISOFILE"
The given disk is attached to the libguestfs appliance. This is used to provide extra software repositories or other data for customization.
.Sp
-You probably want to ensure the volume(s) or filesystems in the attached disks are labelled (or use an \s-1ISO\s0 volume name) so that you can mount them by label in your run-scripts:
+You probably want to ensure the volume(s) or filesystems in the attached disks are labelled (or use an ISO volume name) so that you can mount them by label in your run-scripts:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
-You can have multiple \fI\-\-attach\fR options, and the format can be any disk format (not just an \s-1ISO\s0).
-.IP "\fB\-\-attach\-format\fR \s-1FORMAT\s0" 4
+You can have multiple \fI\-\-attach\fR options, and the format can be any disk format (not just an ISO).
+.IP "\fB\-\-attach\-format\fR FORMAT" 4
.IX Item "--attach-format FORMAT"
Specify the disk format for the next \fI\-\-attach\fR option. The \f(CW\*(C`FORMAT\*(C'\fR is usually \f(CW\*(C`raw\*(C'\fR or \f(CW\*(C`qcow2\*(C'\fR. Use \f(CW\*(C`raw\*(C'\fR for ISOs.
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-c\fR \s-1URI\s0" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-n\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
-Perform a read-only \*(L"dry run\*(R" on the guest. This runs the sysprep operation, but throws away any changes to the disk at the end.
-.IP "\fB\-\-echo\-keys\fR" 4
+Perform a read-only "dry run" on the guest. This runs the sysprep operation, but throws away any changes to the disk at the end.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-customize normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
-.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
+.Sp
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-m\fR \s-1MB\s0" 4
+.IP "\fB\-m\fR MB" 4
.IX Item "-m MB"
.PD 0
-.IP "\fB\-\-memsize\fR \s-1MB\s0" 4
+.IP "\fB\-\-memsize\fR MB" 4
.IX Item "--memsize MB"
.PD
Change the amount of memory allocated to \fI\-\-run\fR scripts. Increase this if you find that \fI\-\-run\fR scripts or the \fI\-\-install\fR option are running out of memory.
.Vb 1
\& guestfish get\-memsize
.Ve
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Enable or disable network access from the guest during the installation.
.Sp
Enabled is the default. Use \fI\-\-no\-network\fR to disable access.
.Sp
-The network only allows outgoing connections and has other minor limitations. See \*(L"\s-1NETWORK\*(R"\s0 in \fBvirt\-rescue\fR\|(1).
+The network only allows outgoing connections and has other minor limitations. See "NETWORK" in \fBvirt\-rescue\fR\|(1).
.Sp
If you use \fI\-\-no\-network\fR then certain other options such as \fI\-\-install\fR will not work.
.Sp
.Sp
Generally speaking you should \fInot\fR use \fI\-\-no\-network\fR. But here are some reasons why you might want to:
.RS 4
-.IP "1." 4
-Because the libguestfs backend that you are using doesn't support the network. (See: \*(L"\s-1BACKEND\*(R"\s0 in \fBguestfs\fR\|(3)).
-.IP "2." 4
-Any software you need to install comes from an attached \s-1ISO,\s0 so you don't need the network.
-.IP "3." 4
-You don’t want untrusted guest code trying to access your host network when running virt-customize. This is particularly an issue when you don't trust the source of the operating system templates. (See \*(L"\s-1SECURITY\*(R"\s0 below).
-.IP "4." 4
+.IP 1. 4
+Because the libguestfs backend that you are using doesn't support the network. (See: "BACKEND" in \fBguestfs\fR\|(3)).
+.IP 2. 4
+Any software you need to install comes from an attached ISO, so you don't need the network.
+.IP 3. 4
+You don’t want untrusted guest code trying to access your host network when running virt-customize. This is particularly an issue when you don't trust the source of the operating system templates. (See "SECURITY" below).
+.IP 4. 4
You don’t have a host network (eg. in secure/restricted environments).
.RE
.RS 4
.RE
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Don’t print log messages.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
Enable N ≥ 2 virtual CPUs for \fI\-\-run\fR scripts to use.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
+libguestfs API 呼び出しのトレースを有効にします。
.SS "Customization options"
.IX Subsection "Customization options"
-.IP "\fB\-\-append\-line\fR \s-1FILE:LINE\s0" 4
+.IP "\fB\-\-append\-line\fR FILE:LINE" 4
.IX Item "--append-line FILE:LINE"
Append a single line of text to the \f(CW\*(C`FILE\*(C'\fR. If the file does not already end with a newline, then one is added before the appended line. Also a newline is added to the end of the \f(CW\*(C`LINE\*(C'\fR string automatically.
.Sp
\& \-\-append\-line \*(Aq/etc/hosts:\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
-.IP "\fB\-\-chmod\fR \s-1PERMISSIONS:FILE\s0" 4
+.IP "\fB\-\-chmod\fR PERMISSIONS:FILE" 4
.IX Item "--chmod PERMISSIONS:FILE"
Change the permissions of \f(CW\*(C`FILE\*(C'\fR to \f(CW\*(C`PERMISSIONS\*(C'\fR.
.Sp
\&\fINote\fR: \f(CW\*(C`PERMISSIONS\*(C'\fR by default would be decimal, unless you prefix it with \f(CW0\fR to get octal, ie. use \f(CW0700\fR not \f(CW700\fR.
-.IP "\fB\-\-commands\-from\-file\fR \s-1FILENAME\s0" 4
+.IP "\fB\-\-chown\fR UID:GID:PATH" 4
+.IX Item "--chown UID:GID:PATH"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+例:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
+.IP "\fB\-\-commands\-from\-file\fR FILENAME" 4
.IX Item "--commands-from-file FILENAME"
Read the customize commands from a file, one (and its arguments) each line.
.Sp
.Ve
.Sp
The commands are handled in the same order as they are in the file, as if they were specified as \fI\-\-delete /some/file\fR on the command line.
-.IP "\fB\-\-copy\fR \s-1SOURCE:DEST\s0" 4
+.IP "\fB\-\-copy\fR SOURCE:DEST" 4
.IX Item "--copy SOURCE:DEST"
Copy files or directories recursively inside the guest.
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-copy\-in\fR \s-1LOCALPATH:REMOTEDIR\s0" 4
+.IP "\fB\-\-copy\-in\fR LOCALPATH:REMOTEDIR" 4
.IX Item "--copy-in LOCALPATH:REMOTEDIR"
Copy local files or directories recursively into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist).
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-delete\fR \s-1PATH\s0" 4
+.IP "\fB\-\-delete\fR PATH" 4
.IX Item "--delete PATH"
Delete a file from the guest. Or delete a directory (and all its contents, recursively).
.Sp
.Ve
.Sp
See also: \fI\-\-upload\fR, \fI\-\-scrub\fR.
-.IP "\fB\-\-edit\fR \s-1FILE:EXPR\s0" 4
+.IP "\fB\-\-edit\fR FILE:EXPR" 4
.IX Item "--edit FILE:EXPR"
Edit \f(CW\*(C`FILE\*(C'\fR using the Perl expression \f(CW\*(C`EXPR\*(C'\fR.
.Sp
.Sp
このオプションは Perl 5 がインストールされているときのみ利用可能であることに注意してください。
.Sp
-See \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
-.IP "\fB\-\-firstboot\fR \s-1SCRIPT\s0" 4
+See "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
+.IP "\fB\-\-firstboot\fR SCRIPT" 4
.IX Item "--firstboot SCRIPT"
Install \f(CW\*(C`SCRIPT\*(C'\fR inside the guest, so that when the guest first boots up, the script runs (as root, late in the boot process).
.Sp
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.IP "\fB\-\-firstboot\-command\fR '\s-1CMD+ARGS\s0'" 4
+.IP "\fB\-\-firstboot\-command\fR 'CMD+ARGS'" 4
.IX Item "--firstboot-command 'CMD+ARGS'"
Run command (and arguments) inside the guest when the guest first boots up (as root, late in the boot process).
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.IP "\fB\-\-firstboot\-install\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-firstboot\-install\fR PKG,PKG.." 4
.IX Item "--firstboot-install PKG,PKG.."
Install the named packages (a comma-separated list). These are installed when the guest first boots using the guest’s package manager (eg. apt, yum, etc.) and the guest’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0 in \fBvirt\-builder\fR\|(1).
-.IP "\fB\-\-hostname\fR \s-1HOSTNAME\s0" 4
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES" in \fBvirt\-builder\fR\|(1).
+.IP "\fB\-\-hostname\fR HOSTNAME" 4
.IX Item "--hostname HOSTNAME"
-Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (\s-1FQDN\s0) if you want.
-.IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0" 4
+Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (FQDN) if you want.
+.IP "\fB\-\-inject\-qemu\-ga\fR METHOD" 4
.IX Item "--inject-qemu-ga METHOD"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0" 4
+.IP "\fB\-\-inject\-virtio\-win\fR METHOD" 4
.IX Item "--inject-virtio-win METHOD"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
.RE
-.IP "\fB\-\-install\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-install\fR PKG,PKG.." 4
.IX Item "--install PKG,PKG.."
Install the named packages (a comma-separated list). These are installed during the image build using the guest’s package manager (eg. apt, yum, etc.) and the host’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES" in \fBvirt\-builder\fR\|(1).
.Sp
See also \fI\-\-update\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR TARGET:LINK[:LINK..]" 4
.IX Item "--link TARGET:LINK[:LINK..]"
Create symbolic link(s) in the guest, starting at \f(CW\*(C`LINK\*(C'\fR and pointing at \f(CW\*(C`TARGET\*(C'\fR.
-.IP "\fB\-\-mkdir\fR \s-1DIR\s0" 4
+.IP "\fB\-\-mkdir\fR DIR" 4
.IX Item "--mkdir DIR"
Create a directory in the guest.
.Sp
-This uses \f(CW\*(C`mkdir \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
-.IP "\fB\-\-move\fR \s-1SOURCE:DEST\s0" 4
+This uses \f(CW\*(C`mkdir\ \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
+.IP "\fB\-\-move\fR SOURCE:DEST" 4
.IX Item "--move SOURCE:DEST"
Move files or directories inside the guest.
.Sp
Wildcards cannot be used.
-.IP "\fB\-\-no\-logfile\fR" 4
+.IP \fB\-\-no\-logfile\fR 4
.IX Item "--no-logfile"
Scrub \f(CW\*(C`builder.log\*(C'\fR (log file from build commands) from the image after building is complete. If you don't want to reveal precisely how the image was built, use this option.
.Sp
-See also: \*(L"\s-1LOG FILE\*(R"\s0.
-.IP "\fB\-\-no\-selinux\-relabel\fR" 4
+See also: "LOG FILE".
+.IP \fB\-\-no\-selinux\-relabel\fR 4
.IX Item "--no-selinux-relabel"
Do not attempt to correct the SELinux labels of files in the guest.
.Sp
In such guests that support SELinux, customization automatically relabels files so that they have the correct SELinux label. (The relabeling is performed immediately, but if the operation fails, customization will instead touch \fI/.autorelabel\fR on the image to schedule a relabel operation for the next time the image boots.) This option disables the automatic relabeling.
.Sp
The option is a no-op for guests that do not support SELinux.
-.IP "\fB\-\-password\fR \s-1USER:SELECTOR\s0" 4
+.IP "\fB\-\-password\fR USER:SELECTOR" 4
.IX Item "--password USER:SELECTOR"
Set the password for \f(CW\*(C`USER\*(C'\fR. (Note this option does \fInot\fR create the user account).
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
When the virt tools change or set a password in the guest, this option sets the password encryption of that password to \f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`sha256\*(C'\fR or \f(CW\*(C`sha512\*(C'\fR.
.Sp
\&\f(CW\*(C`sha256\*(C'\fR and \f(CW\*(C`sha512\*(C'\fR require glibc ≥ 2.7 (check \fBcrypt\fR\|(3) inside the guest).
.Sp
-\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. \s-1RHEL 3\s0), but is not secure against modern attacks.
+\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. RHEL 3), but is not secure against modern attacks.
.Sp
-The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for \s-1SHA\-512,\s0 in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
+The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for SHA\-512, in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
.Sp
-Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
-.IP "\fB\-\-root\-password\fR \s-1SELECTOR\s0" 4
+Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+.IP "\fB\-\-root\-password\fR SELECTOR" 4
.IX Item "--root-password SELECTOR"
Set the root password.
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.Sp
Note: In virt-builder, if you \fIdon't\fR set \fI\-\-root\-password\fR then the guest is given a \fIrandom\fR root password.
-.IP "\fB\-\-run\fR \s-1SCRIPT\s0" 4
+.IP "\fB\-\-run\fR SCRIPT" 4
.IX Item "--run SCRIPT"
Run the shell script (or any program) called \f(CW\*(C`SCRIPT\*(C'\fR on the disk image. The script runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
The script is automatically chmod +x.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.IP "\fB\-\-run\-command\fR '\s-1CMD+ARGS\s0'" 4
+.IP "\fB\-\-run\-command\fR 'CMD+ARGS'" 4
.IX Item "--run-command 'CMD+ARGS'"
Run the command and arguments on the disk image. The command runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\-command\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.IP "\fB\-\-scrub\fR \s-1FILE\s0" 4
+.IP "\fB\-\-scrub\fR FILE" 4
.IX Item "--scrub FILE"
Scrub a file from the guest. This is like \fI\-\-delete\fR except that:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
It scrubs the data so a guest could not recover it.
-.IP "\(bu" 4
+.IP \(bu 4
It cannot delete directories, only regular files.
.RE
.RS 4
.RE
-.IP "\fB\-\-selinux\-relabel\fR" 4
+.IP \fB\-\-selinux\-relabel\fR 4
.IX Item "--selinux-relabel"
This is a compatibility option that does nothing.
-.IP "\fB\-\-sm\-attach\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-sm\-attach\fR SELECTOR" 4
.IX Item "--sm-attach SELECTOR"
Attach to a pool using \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
-.IP "\fB\-\-sm\-credentials\fR \s-1SELECTOR\s0" 4
+See "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+.IP "\fB\-\-sm\-credentials\fR SELECTOR" 4
.IX Item "--sm-credentials SELECTOR"
Set the credentials for \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
-.IP "\fB\-\-sm\-register\fR" 4
+See "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+.IP \fB\-\-sm\-register\fR 4
.IX Item "--sm-register"
Register the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
This requires credentials being set using \fI\-\-sm\-credentials\fR.
-.IP "\fB\-\-sm\-remove\fR" 4
+.IP \fB\-\-sm\-remove\fR 4
.IX Item "--sm-remove"
Remove all the subscriptions from the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
-.IP "\fB\-\-sm\-unregister\fR" 4
+.IP \fB\-\-sm\-unregister\fR 4
.IX Item "--sm-unregister"
Unregister the guest using \f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-ssh\-inject\fR USER[:SELECTOR]" 4
.IX Item "--ssh-inject USER[:SELECTOR]"
Inject an ssh key so the given \f(CW\*(C`USER\*(C'\fR will be able to log in over ssh without supplying a password. The \f(CW\*(C`USER\*(C'\fR must exist already in the guest.
.Sp
-See \*(L"\s-1SSH KEYS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+See "SSH KEYS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
.Sp
You can have multiple \fI\-\-ssh\-inject\fR options, for different users and also for more keys for each user.
-.IP "\fB\-\-timezone\fR \s-1TIMEZONE\s0" 4
+.IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
+.IP "\fB\-\-timezone\fR TIMEZONE" 4
.IX Item "--timezone TIMEZONE"
Set the default timezone of the guest to \f(CW\*(C`TIMEZONE\*(C'\fR. Use a location string like \f(CW\*(C`Europe/London\*(C'\fR
-.IP "\fB\-\-touch\fR \s-1FILE\s0" 4
+.IP "\fB\-\-touch\fR FILE" 4
.IX Item "--touch FILE"
This command performs a \fBtouch\fR\|(1)\-like operation on \f(CW\*(C`FILE\*(C'\fR.
-.IP "\fB\-\-truncate\fR \s-1FILE\s0" 4
+.IP "\fB\-\-truncate\fR FILE" 4
.IX Item "--truncate FILE"
This command truncates \f(CW\*(C`FILE\*(C'\fR to a zero-length file. The file must exist already.
-.IP "\fB\-\-truncate\-recursive\fR \s-1PATH\s0" 4
+.IP "\fB\-\-truncate\-recursive\fR PATH" 4
.IX Item "--truncate-recursive PATH"
This command recursively truncates all files under \f(CW\*(C`PATH\*(C'\fR to zero-length.
-.IP "\fB\-\-uninstall\fR \s-1PKG,PKG..\s0" 4
+.IP "\fB\-\-uninstall\fR PKG,PKG.." 4
.IX Item "--uninstall PKG,PKG.."
Uninstall the named packages (a comma-separated list). These are removed during the image build using the guest’s package manager (eg. apt, yum, etc.). Dependent packages may also need to be uninstalled to satisfy the request.
.Sp
See also \fI\-\-install\fR, \fI\-\-update\fR.
-.IP "\fB\-\-update\fR" 4
+.IP \fB\-\-update\fR 4
.IX Item "--update"
Do the equivalent of \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR, or whatever command is required to update the packages already installed in the template to their latest versions.
.Sp
See also \fI\-\-install\fR, \fI\-\-uninstall\fR.
-.IP "\fB\-\-upload\fR \s-1FILE:DEST\s0" 4
+.IP "\fB\-\-upload\fR FILE:DEST" 4
.IX Item "--upload FILE:DEST"
Upload local file \f(CW\*(C`FILE\*(C'\fR to destination \f(CW\*(C`DEST\*(C'\fR in the disk image. File owner and permissions from the original are preserved, so you should set them to what you want them to be in the disk image.
.Sp
If \f(CW\*(C`DEST\*(C'\fR is a directory name (which must already exist in the guest) then the file is uploaded into that directory, and it keeps the same name as on the local filesystem.
.Sp
See also: \fI\-\-mkdir\fR, \fI\-\-delete\fR, \fI\-\-scrub\fR.
-.IP "\fB\-\-write\fR \s-1FILE:CONTENT\s0" 4
+.IP "\fB\-\-write\fR FILE:CONTENT" 4
.IX Item "--write FILE:CONTENT"
Write \f(CW\*(C`CONTENT\*(C'\fR to \f(CW\*(C`FILE\*(C'\fR.
-.SH "SELinux"
+.SH SELinux
.IX Header "SELinux"
For guests which make use of SELinux, special handling for them might be needed when using operations which create new files or alter existing ones.
.PP
-For further details, see \*(L"\s-1SELINUX\*(R"\s0 in \fBvirt\-builder\fR\|(1).
-.SH "終了ステータス"
+For further details, see "SELINUX" in \fBvirt\-builder\fR\|(1).
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を返します。または、エラーが起きると 1 を返します。
-.SH "環境変数"
+.SH 環境変数
.IX Header "環境変数"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
This can point to the directory containing data files used for Windows firstboot installation.
.Sp
.Sp
This directory may contain the following files:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
-This is the RHSrvAny Windows binary, used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is the RHSrvAny Windows binary, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.Sp
See also: \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-This is a Windows binary shipped with \s-1SUSE VMDP,\s0 used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is a Windows binary shipped with SUSE VMDP, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.RE
.RS 4
.RE
.PP
-他の環境変数は \*(L"環境変数\*(R" in \fBguestfs\fR\|(3) を参照してください。
-.SH "関連項目"
+他の環境変数は "環境変数" in \fBguestfs\fR\|(3) を参照してください。
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-builder\fR\|(1), \fBvirt\-clone\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirt\-sysprep\fR\|(1), \fBvirsh\fR\|(1), \fBlvcreate\fR\|(8), \fBqemu\-img\fR\|(1), \fBscrub\fR\|(1), http://libguestfs.org/, http://libvirt.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2011\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-df 1"
-.TH virt-df 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-df 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-df \- 仮想ファイルシステムの使用状況の表示
-.SH "書式"
+.SH 書式
.IX Header "書式"
すべての仮想マシン:
.PP
\&
\& virt\-df [\-\-options] disk.img [disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\f(CW\*(C`virt\-df\*(C'\fR is a command line tool to display free space on virtual machine filesystems. Unlike other tools, it doesn't just display the size of disk allocated to a virtual machine, but can look inside disk images to see how much space is really being used.
.PP
If used without any \fI\-a\fR or \fI\-d\fR arguments, \f(CW\*(C`virt\-df\*(C'\fR checks with libvirt to get a list of all active and inactive guests, and performs a \f(CW\*(C`df\*(C'\fR\-type operation on each one in turn, printing out the results.
.PP
-If any \fI\-a\fR or \fI\-d\fR arguments are specified, \f(CW\*(C`virt\-df\*(C'\fR performs a \f(CW\*(C`df\*(C'\fR\-type operation on either the single named libvirt domain, or on the disk image(s) listed on the command line (which must all belong to a single \s-1VM\s0). \fBIn this mode (with arguments), \f(CB\*(C`virt\-df\*(C'\fB will only work for a single guest\fR. If you want to run on multiple guests, then you have to invoke \f(CW\*(C`virt\-df\*(C'\fR multiple times.
+If any \fI\-a\fR or \fI\-d\fR arguments are specified, \f(CW\*(C`virt\-df\*(C'\fR performs a \f(CW\*(C`df\*(C'\fR\-type operation on either the single named libvirt domain, or on the disk image(s) listed on the command line (which must all belong to a single VM). \fBIn this mode (with arguments), \fR\f(CB\*(C`virt\-df\*(C'\fR\fB will only work for a single guest\fR. If you want to run on multiple guests, then you have to invoke \f(CW\*(C`virt\-df\*(C'\fR multiple times.
.PP
Use the \fI\-\-csv\fR option to get a format which can be easily parsed by other programs. Other options are similar to the standard \fBdf\fR\|(1) command.
-.SH "例"
+.SH 例
.IX Header "例"
Show disk usage for a single libvirt guest called \f(CW\*(C`F14x64\*(C'\fR. Make the output human-readable:
.PP
\& Win7x32TwoDisks\-a+:/dev/sda2 12478460 7403416 5075044 60%
\& Win7x32TwoDisks\-a+:/dev/sdb1 521212 55728 465484 11%
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
-.IP "\fB\-a\fR \s-1FILE\s0" 4
+.IP "\fB\-a\fR FILE" 4
.IX Item "-a FILE"
.PD 0
-.IP "\fB\-\-add\fR \s-1FILE\s0" 4
+.IP "\fB\-\-add\fR FILE" 4
.IX Item "--add FILE"
.PD
Add \f(CW\*(C`FILE\*(C'\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Write out the results in \s-1CSV\s0 format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read \*(L"\s-1NOTE ABOUT CSV FORMAT\*(R"\s0 below.
+Write out the results in CSV format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read "NOTE ABOUT CSV FORMAT" below.
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-h\fR" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
読みやすい形式で容量を表示します。
.Sp
\&\fI\-h\fR と \fI\-\-csv\fR を同時に使用することはできません。
-.IP "\fB\-i\fR" 4
+.IP \fB\-i\fR 4
.IX Item "-i"
.PD 0
-.IP "\fB\-\-inodes\fR" 4
+.IP \fB\-\-inodes\fR 4
.IX Item "--inodes"
.PD
ブロックの代わりに inode を表示します。
-.IP "\fB\-\-one\-per\-guest\fR" 4
+.IP \fB\-\-one\-per\-guest\fR 4
.IX Item "--one-per-guest"
Since libguestfs 1.22, this is the default. This option does nothing and is left here for backwards compatibility with older scripts.
.IP "\fB\-P\fR nr_threads" 4
Since libguestfs 1.22, virt-df is multithreaded and examines guests in parallel. By default the number of threads to use is chosen based on the amount of free memory available at the time that virt-df is started. You can force virt-df to use at most \f(CW\*(C`nr_threads\*(C'\fR by using the \fI\-P\fR option.
.Sp
Note that \fI\-P 0\fR means to autodetect, and \fI\-P 1\fR means to use a single thread.
-.IP "\fB\-\-uuid\fR" 4
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
-名前の代わりに \s-1UUID\s0 を表示します。仮想マシンがマイグレーションまたは名前変更されたとき、または偶然 2 つの仮想マシンが同じ名前を持つとき、仮想マシンに使用させるために有用です。
+名前の代わりに UUID を表示します。仮想マシンがマイグレーションまたは名前変更されたとき、または偶然 2 つの仮想マシンが同じ名前を持つとき、仮想マシンに使用させるために有用です。
.Sp
Note that only domains that we fetch from libvirt come with UUIDs. For disk images, we still print the disk image name even when this option is specified.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
+libguestfs API 呼び出しのトレースを有効にします。
.SH "STATVFS NUMBERS"
.IX Header "STATVFS NUMBERS"
\&\f(CW\*(C`virt\-df\*(C'\fR (and \fBdf\fR\|(1)) get information by issuing a \fBstatvfs\fR\|(3) system call. You can get the same information directly, either from the host (using libguestfs) or inside the guest:
-.IP "ホストから" 4
+.IP ホストから 4
.IX Item "ホストから"
このコマンドを実行してください:
.Sp
.Ve
.Sp
(change \fI/\fR to see stats for other filesystems).
-.IP "仮想マシンの中から" 4
+.IP 仮想マシンの中から 4
.IX Item "仮想マシンの中から"
このコマンドを実行してください:
.Sp
(change \fI/\fR to see stats for other filesystems).
.SH "CSV 形式に関する注意"
.IX Header "CSV 形式に関する注意"
-Comma-separated values (\s-1CSV\s0) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
+Comma-separated values (CSV) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
.PP
神話: ただコンマで項目を区切る。 真実: これは正しく動き \fIません\fR。この例は 2 つの列があります:
.PP
.PP
For shell scripts, use \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv also packaged in major Linux distributions).
.PP
-For other languages, use a \s-1CSV\s0 processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
+For other languages, use a CSV processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
.PP
-Most spreadsheets and databases can import \s-1CSV\s0 directly.
-.SH "終了ステータス"
+Most spreadsheets and databases can import CSV directly.
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBdf\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-drivers\fR\|(1), \fBvirt\-filesystems\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-dib 1"
-.TH virt-dib 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-dib 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
-.IX Header "名前"
-virt-dib \- Run diskimage-builder elements
-.SH "書式"
-.IX Header "書式"
-.Vb 1
-\& virt\-dib \-B DIB\-LIB [options] elements...
-.Ve
-.SH "説明"
-.IX Header "説明"
-Virt-dib is a tool for using the elements of \f(CW\*(C`diskimage\-builder\*(C'\fR to build a new disk image, generate new ramdisks, etc.
-.PP
-Virt-dib is intended as safe replacement for \f(CW\*(C`diskimage\-builder\*(C'\fR and its \f(CW\*(C`ramdisk\-image\-create\*(C'\fR mode, see \*(L"\s-1COMPARISON WITH\s0 DISKIMAGE-BUILDER\*(R" for a quick comparison with usage of \f(CW\*(C`diskimage\-builder\*(C'\fR.
-.PP
-\&\f(CW\*(C`diskimage\-builder\*(C'\fR is part of the TripleO OpenStack project: https://wiki.openstack.org/wiki/TripleO.
-.SH "例"
-.IX Header "例"
-.SS "Build simple images of distributions"
-.IX Subsection "Build simple images of distributions"
-.Vb 6
-\& virt\-dib \e
-\& \-B /path/to/diskimage\-builder/lib \e
-\& \-p /path/to/diskimage\-builder/elements \e
-\& \-\-envvar DIB_RELEASE=jessie \e
-\& \-\-name debian\-jessie \e
-\& debian vm
-.Ve
-.PP
-This builds a Debian Jessie (8.x) disk image, suitable for running as virtual machine, saved as \fIdebian\-jessie.qcow2\fR.
-.SS "Build ramdisks"
-.IX Subsection "Build ramdisks"
-.Vb 6
-\& virt\-dib \e
-\& \-B /path/to/diskimage\-builder/lib \e
-\& \-p /path/to/diskimage\-builder/elements \e
-\& \-\-ramdisk \e
-\& \-\-name ramdisk \e
-\& ubuntu deploy\-ironic
-.Ve
-.PP
-This builds a ramdisk for the Ironic OpenStack component based on the Ubuntu distribution.
-.SH "オプション"
-.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
-.IX Item "--help"
-ヘルプを表示します。
-.IP "\fB\-B\fR \s-1PATH\s0" 4
-.IX Item "-B PATH"
-Set the path to the library directory of \f(CW\*(C`diskimage\-builder\*(C'\fR. This is usually the \fIlib\fR subdirectory in the sources and when installed, and \fI/usr/share/diskimage\-builder/lib\fR when installed in \fI/usr\fR.
-.Sp
-This parameter is \fBmandatory\fR, as virt-dib needs to provide it for the elements (as some of them might use scripts in it). Virt-dib itself does not make use of the library directory.
-.IP "\fB\-\-arch\fR \s-1ARCHITECTURE\s0" 4
-.IX Item "--arch ARCHITECTURE"
-Use the specified architecture for the output image. The default value is the same as the host running virt-dib.
-.Sp
-Right now this option does nothing more than setting the \f(CW\*(C`ARCH\*(C'\fR environment variable for the elements, and it’s up to them to produce an image for the requested architecture.
-.IP "\fB\-\-checksum\fR" 4
-.IX Item "--checksum"
-Generate checksum files for the generated image. The supported checksums are \s-1MD5,\s0 and \s-1SHA256.\s0
-.IP "\fB\-\-colors\fR" 4
-.IX Item "--colors"
-.PD 0
-.IP "\fB\-\-colours\fR" 4
-.IX Item "--colours"
-.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-\-debug\fR \s-1LEVEL\s0" 4
-.IX Item "--debug LEVEL"
-Set the debug level to \f(CW\*(C`LEVEL\*(C'\fR, which is a non-negative integer number. The default is \f(CW0\fR.
-.Sp
-This debug level is different than what \fI\-x\fR and \fI\-v\fR set, and it increases the debugging information printed out. Specifically, this sets the \f(CW\*(C`DIB_DEBUG_TRACE\*(C'\fR, and any value > \f(CW0\fR enables tracing in the scripts executed.
-.IP "\fB\-\-docker\-target\fR \s-1TARGET\s0" 4
-.IX Item "--docker-target TARGET"
-Set the repository and tag for docker.
-.Sp
-This is used only when the formats include \f(CW\*(C`docker\*(C'\fR, and it is required in that case.
-.IP "\fB\-\-drive\fR \s-1DISK\s0" 4
-.IX Item "--drive DISK"
-Add the specified disk to be used as helper drive where to cache files of the elements, like disk images, distribution packages, etc.
-.Sp
-See \*(L"\s-1HELPER DRIVE\*(R"\s0.
-.IP "\fB\-\-drive\-format\fR raw" 4
-.IX Item "--drive-format raw"
-.PD 0
-.IP "\fB\-\-drive\-format\fR qcow2" 4
-.IX Item "--drive-format qcow2"
-.PD
-Specify the format of the helper drive. If this flag is not given then it is auto-detected from the drive itself.
-.Sp
-If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
-.Sp
-This option is used only if \fI\-\-drive\fR is specified.
-.Sp
-See \*(L"\s-1HELPER DRIVE\*(R"\s0.
-.IP "\fB\-p\fR \s-1PATH\s0" 4
-.IX Item "-p PATH"
-.PD 0
-.IP "\fB\-\-element\-path\fR \s-1PATH\s0" 4
-.IX Item "--element-path PATH"
-.PD
-Add a new path with elements. Paths are used in the same order as the \fI\-p\fR parameters appear, so a path specified first is looked first, and so on.
-.Sp
-Obviously, it is recommended to add the path to the own elements of \f(CW\*(C`diskimage\-builder\*(C'\fR, as most of the other elements will rely on them.
-.IP "\fB\-\-extra\-packages\fR \s-1PACKAGE,...\s0" 4
-.IX Item "--extra-packages PACKAGE,..."
-Install additional packages in the image being built.
-.Sp
-This relies on the \f(CW\*(C`install\-packages\*(C'\fR binary provided by the package management elements.
-.Sp
-This option can be specified multiple times, each time with multiple packages separated by comma.
-.IP "\fB\-\-envvar\fR \s-1VARIABLE\s0" 4
-.IX Item "--envvar VARIABLE"
-.PD 0
-.IP "\fB\-\-envvar\fR VARIABLE=VALUE" 4
-.IX Item "--envvar VARIABLE=VALUE"
-.PD
-Carry or set an environment variable for the elements.
-.Sp
-See \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 below for more information on the interaction and usage of environment variables.
-.Sp
-This option can be used in two ways:
-.RS 4
-.IP "\fB\-\-envvar\fR \s-1VARIABLE\s0" 4
-.IX Item "--envvar VARIABLE"
-Carry the environment variable \f(CW\*(C`VARIABLE\*(C'\fR. If it is not set, nothing is exported to the elements.
-.IP "\fB\-\-envvar\fR VARIABLE=VALUE" 4
-.IX Item "--envvar VARIABLE=VALUE"
-Set the environment variable \f(CW\*(C`VARIABLE\*(C'\fR with value \f(CW\*(C`VALUE\*(C'\fR for the elements, regardless whether an environment variable with the same name exists.
-.Sp
-This can be useful to pass environment variable without exporting them in the environment where virt-dib runs.
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-exclude\-element\fR \s-1ELEMENT\s0" 4
-.IX Item "--exclude-element ELEMENT"
-Ignore the specified element.
-.IP "\fB\-\-exclude\-script\fR \s-1SCRIPT\s0" 4
-.IX Item "--exclude-script SCRIPT"
-Ignore any element script named \f(CW\*(C`SCRIPT\*(C'\fR, whichever element it is in.
-.Sp
-This can be useful in case some script does not run well with virt-dib, for example when they really need \f(CW\*(C`diskimage\-builder\*(C'\fR's environment.
-.IP "\fB\-\-formats\fR \s-1FORMAT,...\s0" 4
-.IX Item "--formats FORMAT,..."
-Set the list of output formats, separating them with comma.
-.Sp
-Supported formats are:
-.RS 4
-.ie n .IP """docker""" 4
-.el .IP "\f(CWdocker\fR" 4
-.IX Item "docker"
-Import the image to docker, running \fBdocker import\fR. The target for the image \fBmust\fR be specified using \fI\-\-docker\-target\fR.
-.Sp
-Please note this operation usually requires the docker service to be enabled, otherwise it will fail. Furthermore, \fBdocker\fR is run using \fBsudo\fR\|(8), so make sure the user has the permissions to run at least \fBdocker\fR.
-.ie n .IP """qcow2"" (enabled by default)" 4
-.el .IP "\f(CWqcow2\fR (enabled by default)" 4
-.IX Item "qcow2 (enabled by default)"
-QEMU’s qcow2. This output format requires the \f(CW\*(C`qemu\-img\*(C'\fR tool.
-.ie n .IP """raw""" 4
-.el .IP "\f(CWraw\fR" 4
-.IX Item "raw"
-Raw disk format.
-.ie n .IP """squashfs""" 4
-.el .IP "\f(CWsquashfs\fR" 4
-.IX Item "squashfs"
-An squashfs filesystem, compressed with \s-1XZ.\s0 This output format requires the \f(CW\*(C`squashfs\*(C'\fR feature; see also \*(L"\s-1AVAILABILITY\*(R"\s0 in \fBguestfs\fR\|(3).
-.ie n .IP """tar""" 4
-.el .IP "\f(CWtar\fR" 4
-.IX Item "tar"
-An uncompressed tarball.
-.ie n .IP """tgz""" 4
-.el .IP "\f(CWtgz\fR" 4
-.IX Item "tgz"
-A tarball compressed with gzip.
-.ie n .IP """vhd""" 4
-.el .IP "\f(CWvhd\fR" 4
-.IX Item "vhd"
-\&\f(CW\*(C`Virtual Hard Disk\*(C'\fR disk image. This output format requires the \f(CW\*(C`vhd\-util\*(C'\fR tool.
-.Sp
-Please note that the version of \f(CW\*(C`vhd\-util\*(C'\fR tool needs to be patched to support the \f(CW\*(C`convert\*(C'\fR subcommand, and to be bootable. The patch is available here: https://github.com/emonty/vhd\-util/blob/master/debian/patches/citrix.
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-fs\-type\fR \s-1FILESYSTEM\s0" 4
-.IX Item "--fs-type FILESYSTEM"
-Set the filesystem type to use for the root filesystem. The default is \f(CW\*(C`ext4\*(C'\fR.
-.Sp
-See also \*(L"guestfs_filesystem_available\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-image\-cache\fR \s-1DIRECTORY\s0" 4
-.IX Item "--image-cache DIRECTORY"
-Set the path in the host where cache the resources used by the elements of the \f(CW\*(C`extra\-data.d\*(C'\fR phase. The default is \fI~/.cache/image\-create\fR.
-.Sp
-Please note that most of the resources fetched in phases other than \f(CW\*(C`extra\-data.d\*(C'\fR will be cached in the helper drive specified with \fI\-\-drive\fR; see also \*(L"\s-1HELPER DRIVE\*(R"\s0.
-.IP "\fB\-\-install\-type\fR \s-1TYPE\s0" 4
-.IX Item "--install-type TYPE"
-Specify the default installation type. Defaults to \f(CW\*(C`source\*(C'\fR.
-.Sp
-Set to \f(CW\*(C`package\*(C'\fR to use package based installations by default.
-.IP "\fB\-\-machine\-readable\fR" 4
-.IX Item "--machine-readable"
-.PD 0
-.IP "\fB\-\-machine\-readable\fR=format" 4
-.IX Item "--machine-readable=format"
-.PD
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の \*(L"マシン可読な出力\*(R" 参照。
-.IP "\fB\-m\fR \s-1MB\s0" 4
-.IX Item "-m MB"
-.PD 0
-.IP "\fB\-\-memsize\fR \s-1MB\s0" 4
-.IX Item "--memsize MB"
-.PD
-Change the amount of memory allocated to the appliance. Increase this if you find that the virt-dib execution runs out of memory.
-.Sp
-The default can be found with this command:
-.Sp
-.Vb 1
-\& guestfish get\-memsize
-.Ve
-.ie n .IP "\fB\-\-mkfs\-options\fR ""OPTION STRING""" 4
-.el .IP "\fB\-\-mkfs\-options\fR \f(CWOPTION STRING\fR" 4
-.IX Item "--mkfs-options OPTION STRING"
-Add the specified options to \fBmkfs\fR\|(1), to be able to fine-tune the root filesystem creation; the options are passed to the driver of \fBmfks\fR\|(1), and not to \fBmfks\fR\|(1) itself. Note that \fI\-\-fs\-type\fR is used to change the filesystem type.
-.Sp
-You should use \fI\-\-mkfs\-options\fR at most once. To pass multiple options, separate them with space, eg:
-.Sp
-.Vb 1
-\& virt\-dib ... \-\-mkfs\-options \*(Aq\-O someopt \-I foo\*(Aq
-.Ve
-.IP "\fB\-\-network\fR" 4
-.IX Item "--network"
-.PD 0
-.IP "\fB\-\-no\-network\fR" 4
-.IX Item "--no-network"
-.PD
-Enable or disable network access from the guest during the installation.
-.Sp
-Enabled is the default. Use \fI\-\-no\-network\fR to disable access.
-.Sp
-The network only allows outgoing connections and has other minor limitations. See \*(L"\s-1NETWORK\*(R"\s0 in \fBvirt\-rescue\fR\|(1).
-.Sp
-This does not affect whether the guest can access the network once it has been booted, because that is controlled by your hypervisor or cloud environment and has nothing to do with virt-dib.
-.Sp
-If you use \fI\-\-no\-network\fR, then the environment variable \f(CW\*(C`DIB_OFFLINE\*(C'\fR is set to \f(CW1\fR, signaling the elements that they should use only cached resources when available. Note also that, unlike with \f(CW\*(C`diskimage\-builder\*(C'\fR where elements may still be able to access to the network even with \f(CW\*(C`DIB_OFFLINE=\*(C'\fR, under virt-dib network will not be accessible at all.
-.IP "\fB\-\-name\fR \s-1NAME\s0" 4
-.IX Item "--name NAME"
-Set the name of the output image file. The default is \f(CW\*(C`image\*(C'\fR.
-.Sp
-According to the chosen name, there will be the following in the current directory:
-.RS 4
-.IP "\fI\f(CI$NAME\fI.ext\fR" 4
-.IX Item "$NAME.ext"
-For each output format, a file named after the output image with the extension depending on the format; for example: \fI\f(CI$NAME\fI.qcow2\fR, \fI\f(CI$NAME\fI.raw\fR, etc.
-.Sp
-Not applicable in ramdisk mode, see \*(L"\s-1RAMDISK BUILDING\*(R"\s0.
-.IP "\fI\f(CI$NAME\fI.d\fR" 4
-.IX Item "$NAME.d"
-A directory containing any files created by the elements, for example \fIdib-manifests\fR directory (created by the \f(CW\*(C`manifests\*(C'\fR element), ramdisks and kernels in ramdisk mode, and so on.
-.IP "\fI\f(CI$NAME\fI.ext.checksum\fR" 4
-.IX Item "$NAME.ext.checksum"
-When \fI\-\-checksum\fR is specified, there will be files for each supported checksum type; for example: \fI\f(CI$NAME\fI.ext.md5\fR, \fI\f(CI$NAME\fI.ext.sha256\fR, etc.
-.Sp
-Not applicable in ramdisk mode, see \*(L"\s-1RAMDISK BUILDING\*(R"\s0.
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-no\-delete\-on\-failure\fR" 4
-.IX Item "--no-delete-on-failure"
-Don’t delete the output files on failure to build. You can use this to debug failures to run scripts.
-.Sp
-The default is to delete the output files if virt-dib fails (or, for example, some script that it runs fails).
-.IP "\fB\-\-python\fR \s-1PYTHON\s0" 4
-.IX Item "--python PYTHON"
-Specify a different Python interpreter to use. Parts of \f(CW\*(C`diskimage\-builder\*(C'\fR are implemented in Python, and thus an interpreter is needed.
-.Sp
-\&\f(CW\*(C`PYTHON\*(C'\fR can either be an executable filename (e.g. \fIpython2\fR, which is then searched in \f(CW$PATH\fR), or a full path (e.g. \fI/usr/bin/python2\fR). If not specified, the default value is \fIpython\fR.
-.IP "\fB\-q\fR" 4
-.IX Item "-q"
-.PD 0
-.IP "\fB\-\-quiet\fR" 4
-.IX Item "--quiet"
-.PD
-Don’t print ordinary progress messages.
-.IP "\fB\-\-qemu\-img\-options\fR option[,option,...]" 4
-.IX Item "--qemu-img-options option[,option,...]"
-Pass \fI\-\-qemu\-img\-options\fR option(s) to the \fBqemu\-img\fR\|(1) command to fine-tune the output format. Options available depend on the output format (see \fI\-\-formats\fR) and the installed version of the qemu-img program.
-.Sp
-You should use \fI\-\-qemu\-img\-options\fR at most once. To pass multiple options, separate them with commas, eg:
-.Sp
-.Vb 1
-\& virt\-dib ... \-\-qemu\-img\-options cluster_size=512,preallocation=metadata ...
-.Ve
-.IP "\fB\-\-ramdisk\fR" 4
-.IX Item "--ramdisk"
-Set the ramdisk building mode.
-.Sp
-See \*(L"\s-1RAMDISK BUILDING\*(R"\s0.
-.IP "\fB\-\-ramdisk\-element\fR \s-1NAME\s0" 4
-.IX Item "--ramdisk-element NAME"
-Set the name for the additional element added in ramdisk building mode. The default is \f(CW\*(C`ramdisk\*(C'\fR.
-.Sp
-See \*(L"\s-1RAMDISK BUILDING\*(R"\s0.
-.IP "\fB\-\-root\-label\fR \s-1LABEL\s0" 4
-.IX Item "--root-label LABEL"
-Set the label for the root filesystem in the created image.
-.Sp
-Please note that some filesystems have different restrictions on the length of their labels; for example, on \f(CW\*(C`ext2/3/4\*(C'\fR filesystems labels cannot be longer than 16 characters, while on \f(CW\*(C`xfs\*(C'\fR they have at most 12 characters.
-.Sp
-The default depends on the actual filesystem for the root partition (see \fI\-\-fs\-type\fR): on \f(CW\*(C`xfs\*(C'\fR is \f(CW\*(C`img\-rootfs\*(C'\fR, while \f(CW\*(C`cloudimg\-rootfs\*(C'\fR on any other filesystem.
-.IP "\fB\-\-size\fR \s-1SIZE\s0" 4
-.IX Item "--size SIZE"
-Select the size of the output disk, where the size can be specified using common names such as \f(CW\*(C`32G\*(C'\fR (32 gigabytes) etc. The default size is \f(CW\*(C`5G\*(C'\fR.
-.Sp
-To specify size in bytes, the number must be followed by the lowercase letter \fIb\fR, eg: \f(CW\*(C`\-\-size 10737418240b\*(C'\fR.
-.Sp
-See also \fBvirt\-resize\fR\|(1) for resizing partitions of an existing disk image.
-.IP "\fB\-\-skip\-base\fR" 4
-.IX Item "--skip-base"
-Skip the inclusion of the \f(CW\*(C`base\*(C'\fR element.
-.IP "\fB\-\-smp\fR N" 4
-.IX Item "--smp N"
-Enable N ≥ 2 virtual CPUs for scripts to use.
-.IP "\fB\-u\fR" 4
-.IX Item "-u"
-Do not compress resulting qcow2 images. The default is to compress them.
-.IP "\fB\-v\fR" 4
-.IX Item "-v"
-.PD 0
-.IP "\fB\-\-verbose\fR" 4
-.IX Item "--verbose"
-.PD
-デバッグメッセージを有効にします。
-.IP "\fB\-V\fR" 4
-.IX Item "-V"
-.PD 0
-.IP "\fB\-\-version\fR" 4
-.IX Item "--version"
-.PD
-バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
-.IX Item "--wrap"
-Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
-.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "環境変数"
-.IX Header "環境変数"
-Unlike with \f(CW\*(C`diskimage\-builder\*(C'\fR, the environment of the host is \fBnot\fR inherited in the appliance when running most of the elements (i.e. all except the ones in the \f(CW\*(C`extra\-data.d\*(C'\fR phase).
-.PP
-To set environment for the elements being run, it is necessary to tell virt-dib to use them, with the option \fI\-\-envvar\fR. Such option allows to selectively export environment variables when running the elements, and it is the preferred way to pass environment variables to the elements.
-.PP
-To recap: if you want the environment variable \f(CW\*(C`MYVAR\*(C'\fR (and its content) to be available to the elements, you can do either
-.PP
-.Vb 2
-\& export MYVAR # whichever is its value
-\& virt\-dib ... \-\-envvar MYVAR ...
-.Ve
-.PP
-または
-.PP
-.Vb 1
-\& virt\-dib ... \-\-envvar MYVAR=value_of_it ...
-.Ve
-.SH "HELPER DRIVE"
-.IX Header "HELPER DRIVE"
-Virt-dib runs most of the element in its own appliance, and thus not on the host. Because of this, there is no possibility for elements to cache resources directly on the host.
-.PP
-To solve this issue, virt-dib allows the usage of an helper drive where to store cached resources, like disk images, distribution packages, etc. While this means that there is a smaller space available for caching, at least it allows to limit the space on the host for caches, without assuming that elements will do that by themselves.
-.PP
-Currently this disk is either required to have a single partition on it, or the first partition on it will be used. A disk with the latter configuration can be easily created with \fBguestfish\fR\|(1) like the following:
-.PP
-.Vb 1
-\& guestfish \-N filename.img=fs:ext4:10G exit
-.Ve
-.PP
-The above will create a disk image called \fIfilename.img\fR, 10G big, with a single partition of type ext4; see \*(L"\s-1PREPARED DISK IMAGES\*(R"\s0 in \fBguestfish\fR\|(1).
-.PP
-It is recommended for it to be ≥ 10G or even more, as elements will cache disk images, distribution packages, etc. As with any disk image, the helper disk can be easily resized using \fBvirt\-resize\fR\|(1) if more space in it is needed.
-.PP
-The drive can be accessed like any other disk image, for example using other tools of libguestfs such as \fBguestfish\fR\|(1):
-.PP
-.Vb 1
-\& guestfish \-a filename.img \-m /dev/sda1
-.Ve
-.PP
-If no helper drive is specified with \fI\-\-drive\fR, all the resources cached during a virt-dib run will be discarded.
-.SS "\s-1RESOURCES INSIDE THE DRIVE\s0"
-.IX Subsection "RESOURCES INSIDE THE DRIVE"
-Inside the helper drive, it is possible to find the following resources:
-.IP "\fI/home\fR" 4
-.IX Item "/home"
-This directory is set as \f(CW\*(C`HOME\*(C'\fR environment variable during the build. It contains mostly the image cache (saved as \fI/home/.cache/image\-create\fR), and whichever other resource is cached in the home directory of the user running the various tools.
-.IP "\fI/virt\-dib\-*.log\fR" 4
-.IX Item "/virt-dib-*.log"
-These are the logs of the elements being run within the libguestfs appliance, which means all the phases except \f(CW\*(C`extra\-data.d\*(C'\fR.
-.SH "RAMDISK BUILDING"
-.IX Header "RAMDISK BUILDING"
-Virt-dib can emulate also \f(CW\*(C`ramdisk\-image\-create\*(C'\fR, which is a secondary operation mode of \f(CW\*(C`diskimage\-builder\*(C'\fR. Instead of being a different tool name, virt-dib provides easy access to this mode using the \fI\-\-ramdisk\fR switch.
-.PP
-In this mode:
-.IP "\(bu" 4
-there is an additional ramdisk element added (see \fI\-\-ramdisk\-element\fR)
-.IP "\(bu" 4
-no image is produced (so \fI\-\-formats\fR is ignored)
-.IP "\(bu" 4
-\&\fI\f(CI$NAME\fI.d\fR (see \fI\-\-name\fR) will contain initrd, kernel, etc
-.SH "TEMPORARY DIRECTORY"
-.IX Header "TEMPORARY DIRECTORY"
-Virt-dib uses the standard temporary directory used by libguestfs, see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
-.PP
-By default this location is \fI/tmp\fR (default value for \f(CW\*(C`TMPDIR\*(C'\fR), which on some systems may be on a tmpfs filesystem, and thus defaulting to a maximum size of \fIhalf\fR of physical \s-1RAM.\s0 If virt-dib exceeds this, it may hang or exit early with an error. The solution is to point \f(CW\*(C`TMPDIR\*(C'\fR to a permanent location used as temporary location, for example:
-.PP
-.Vb 3
-\& mkdir local\-tmp
-\& env TMPDIR=$PWD/local\-tmp virt\-dib ...
-\& rm \-rf local\-tmp
-.Ve
-.SH "EXTRA DEPENDENCIES"
-.IX Header "EXTRA DEPENDENCIES"
-Because of virt-dib runs most of the elements in its own appliance, all the tools and libraries used by elements running outside the guest (typically \f(CW\*(C`root.d\*(C'\fR, \f(CW\*(C`block\-device.d\*(C'\fR, and \f(CW\*(C`cleanup.d\*(C'\fR) need to be present in the appliance as well. In case they are not, scripts will fail typically with a \f(CW\*(C`command not found\*(C'\fR error.
-.PP
-For tools and libraries packaged by the distribution, the easy solution is to tell libguestfs to include additional packages in the appliance. This is doable by e.g. creating a new file with the additional packages:
-.PP
-.Vb 1
-\& # echo wget > /usr/lib64/guestfs/supermin.d/dib\-my\-extra
-.Ve
-.PP
-The actual path to the \fIsupermin.d\fR directory depends on the distribution; additional files can list more packages, each in its own line. For more details, see \fBsupermin\fR\|(1).
-.SH "COMPARISON WITH DISKIMAGE-BUILDER"
-.IX Header "COMPARISON WITH DISKIMAGE-BUILDER"
-Virt-dib is intended as safe replacement for \f(CW\*(C`diskimage\-builder\*(C'\fR and its \f(CW\*(C`ramdisk\-image\-create\*(C'\fR mode; the user-notable differences consist in:
-.IP "\(bu" 4
-the command line arguments; some of the arguments are the same as available in \f(CW\*(C`diskimage\-builder\*(C'\fR, while some have different names:
-.Sp
-.Vb 12
-\& disk\-image\-create virt\-dib
-\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-
-\& \-a ARCH \-\-arch ARCH
-\& \-\-image\-size SIZE \-\-size SIZE
-\& \-\-max\-online\-resize SIZE doable using \-\-mkfs\-options
-\& \-n \-\-skip\-base
-\& \-o IMAGENAME \-\-name IMAGENAME
-\& \-p PACKAGE(S) \-\-extra\-packages PACKAGE(S)
-\& \-t FORMAT(S) \-\-formats FORMAT(S)
-\& \-x \-\-debug 1
-\& \-x \-x \-\-debug 2
-\& \-x \-x [\-x ...] \-\-debug 3/4/etc
-.Ve
-.IP "\(bu" 4
-the location of non-image output files (like ramdisks and kernels)
-.IP "\(bu" 4
-the way some of the cached resources are saved: using an helper drive, not directly on the disk where virt-dib is run
-.IP "\(bu" 4
-the need to specify a target size for the output disk, as opposed to \f(CW\*(C`diskimage\-builder\*(C'\fR calculating an optimal one
-.IP "\(bu" 4
-the handling of environment variables, see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0.
-.Sp
-Furthermore, other than the libguestfs own environment variables (see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3)), virt-dib does not read any other environment variable: this means that all the options and behaviour changes are specified solely using command line arguments
-.IP "\(bu" 4
-extra tools needed on some out-of-chroot phases need to be available in the appliance, see \*(L"\s-1EXTRA DEPENDENCIES\*(R"\s0.
-.PP
-Elements themselves should notice no difference in they way they are run; behaviour differences may due to wrong assumptions in elements, or not correct virt-dib emulation.
-.PP
-Known issues at the moment:
-.IP "\(bu" 4
-(none)
-.SH "マシン可読な出力"
-.IX Header "マシン可読な出力"
-The \fI\-\-machine\-readable\fR option can be used to make the output more machine friendly, which is useful when calling virt-dib from other programs, GUIs etc.
-.PP
-Use the option on its own to query the capabilities of the virt-dib binary. Typical output looks like this:
-.PP
-.Vb 6
-\& $ virt\-dib \-\-machine\-readable
-\& virt\-dib
-\& output:qcow2
-\& output:tar
-\& output:raw
-\& output:vhd
-.Ve
-.PP
-A list of features is printed, one per line, and the program exits with status 0.
-.PP
-The \f(CW\*(C`output:\*(C'\fR features refer to the output formats (\fI\-\-formats\fR command line option) supported by this binary.
-.PP
-It is possible to specify a format string for controlling the output; see \*(L"\s-1ADVANCED MACHINE READABLE OUTPUT\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "TESTING"
-.IX Header "TESTING"
-Virt-dib has been tested with \f(CW\*(C`diskimage\-builder\*(C'\fR (and its elements) ≥ 0.1.43; from time to time also with \f(CW\*(C`tripleo\-image\-elements\*(C'\fR and \f(CW\*(C`sahara\-image\-elements\*(C'\fR.
-.PP
-Previous versions may work, but it is not guaranteed.
-.SH "終了ステータス"
-.IX Header "終了ステータス"
-このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
-.IX Header "関連項目"
-\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "著者"
-.IX Header "著者"
-Pino Toscano (\f(CW\*(C`ptoscano at redhat dot com\*(C'\fR)
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) 2015 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
+++ /dev/null
-
-=head1 名前
-
-virt-dib - Run diskimage-builder elements
-
-=head1 書式
-
- virt-dib -B DIB-LIB [options] elements...
-
-=head1 説明
-
-Virt-dib is a tool for using the elements of C<diskimage-builder> to build a new disk image, generate new ramdisks, etc.
-
-Virt-dib is intended as safe replacement for C<diskimage-builder> and its C<ramdisk-image-create> mode, see L</COMPARISON WITH DISKIMAGE-BUILDER> for a quick comparison with usage of C<diskimage-builder>.
-
-C<diskimage-builder> is part of the TripleO OpenStack project: L<https://wiki.openstack.org/wiki/TripleO>.
-
-=head1 例
-
-=head2 Build simple images of distributions
-
- virt-dib \
- -B /path/to/diskimage-builder/lib \
- -p /path/to/diskimage-builder/elements \
- --envvar DIB_RELEASE=jessie \
- --name debian-jessie \
- debian vm
-
-This builds a Debian Jessie (8.x) disk image, suitable for running as virtual machine, saved as F<debian-jessie.qcow2>.
-
-=head2 Build ramdisks
-
- virt-dib \
- -B /path/to/diskimage-builder/lib \
- -p /path/to/diskimage-builder/elements \
- --ramdisk \
- --name ramdisk \
- ubuntu deploy-ironic
-
-This builds a ramdisk for the Ironic OpenStack component based on the Ubuntu distribution.
-
-=head1 オプション
-
-=over 4
-
-=item B<--help>
-
-ヘルプを表示します。
-
-=item B<-B> PATH
-
-Set the path to the library directory of C<diskimage-builder>. This is usually the F<lib> subdirectory in the sources and when installed, and F</usr/share/diskimage-builder/lib> when installed in F</usr>.
-
-This parameter is B<mandatory>, as virt-dib needs to provide it for the elements (as some of them might use scripts in it). Virt-dib itself does not make use of the library directory.
-
-=item B<--arch> ARCHITECTURE
-
-Use the specified architecture for the output image. The default value is the same as the host running virt-dib.
-
-Right now this option does nothing more than setting the C<ARCH> environment variable for the elements, and it’s up to them to produce an image for the requested architecture.
-
-=item B<--checksum>
-
-Generate checksum files for the generated image. The supported checksums are MD5, and SHA256.
-
-=item B<--colors>
-
-=item B<--colours>
-
-Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
-
-=item B<--debug> LEVEL
-
-Set the debug level to C<LEVEL>, which is a non-negative integer number. The default is C<0>.
-
-This debug level is different than what I<-x> and I<-v> set, and it increases the debugging information printed out. Specifically, this sets the C<DIB_DEBUG_TRACE>, and any value E<gt> C<0> enables tracing in the scripts executed.
-
-=item B<--docker-target> TARGET
-
-Set the repository and tag for docker.
-
-This is used only when the formats include C<docker>, and it is required in that case.
-
-=item B<--drive> DISK
-
-Add the specified disk to be used as helper drive where to cache files of the elements, like disk images, distribution packages, etc.
-
-See L</HELPER DRIVE>.
-
-=item B<--drive-format> raw
-
-=item B<--drive-format> qcow2
-
-Specify the format of the helper drive. If this flag is not given then it is auto-detected from the drive itself.
-
-If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
-
-This option is used only if I<--drive> is specified.
-
-See L</HELPER DRIVE>.
-
-=item B<-p> PATH
-
-=item B<--element-path> PATH
-
-Add a new path with elements. Paths are used in the same order as the I<-p> parameters appear, so a path specified first is looked first, and so on.
-
-Obviously, it is recommended to add the path to the own elements of C<diskimage-builder>, as most of the other elements will rely on them.
-
-=item B<--extra-packages> PACKAGE,...
-
-Install additional packages in the image being built.
-
-This relies on the C<install-packages> binary provided by the package management elements.
-
-This option can be specified multiple times, each time with multiple packages separated by comma.
-
-=item B<--envvar> VARIABLE
-
-=item B<--envvar> VARIABLE=VALUE
-
-Carry or set an environment variable for the elements.
-
-See L</ENVIRONMENT VARIABLES> below for more information on the interaction and usage of environment variables.
-
-This option can be used in two ways:
-
-=over 4
-
-=item B<--envvar> VARIABLE
-
-Carry the environment variable C<VARIABLE>. If it is not set, nothing is exported to the elements.
-
-=item B<--envvar> VARIABLE=VALUE
-
-Set the environment variable C<VARIABLE> with value C<VALUE> for the elements, regardless whether an environment variable with the same name exists.
-
-This can be useful to pass environment variable without exporting them in the environment where virt-dib runs.
-
-=back
-
-=item B<--exclude-element> ELEMENT
-
-Ignore the specified element.
-
-=item B<--exclude-script> SCRIPT
-
-Ignore any element script named C<SCRIPT>, whichever element it is in.
-
-This can be useful in case some script does not run well with virt-dib, for example when they really need C<diskimage-builder>'s environment.
-
-=item B<--formats> FORMAT,...
-
-Set the list of output formats, separating them with comma.
-
-Supported formats are:
-
-=over 4
-
-=item C<docker>
-
-Import the image to docker, running B<docker import>. The target for the image B<must> be specified using I<--docker-target>.
-
-Please note this operation usually requires the docker service to be enabled, otherwise it will fail. Furthermore, B<docker> is run using L<sudo(8)>, so make sure the user has the permissions to run at least B<docker>.
-
-=item C<qcow2> (enabled by default)
-
-QEMU’s qcow2. This output format requires the C<qemu-img> tool.
-
-=item C<raw>
-
-Raw disk format.
-
-=item C<squashfs>
-
-An squashfs filesystem, compressed with XZ. This output format requires the C<squashfs> feature; see also L<guestfs(3)/AVAILABILITY>.
-
-=item C<tar>
-
-An uncompressed tarball.
-
-=item C<tgz>
-
-A tarball compressed with gzip.
-
-=item C<vhd>
-
-C<Virtual Hard Disk> disk image. This output format requires the C<vhd-util> tool.
-
-Please note that the version of C<vhd-util> tool needs to be patched to support the C<convert> subcommand, and to be bootable. The patch is available here: L<https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix>.
-
-=back
-
-=item B<--fs-type> FILESYSTEM
-
-Set the filesystem type to use for the root filesystem. The default is C<ext4>.
-
-See also L<guestfs(3)/guestfs_filesystem_available>.
-
-=item B<--image-cache> DIRECTORY
-
-Set the path in the host where cache the resources used by the elements of the C<extra-data.d> phase. The default is F<~/.cache/image-create>.
-
-Please note that most of the resources fetched in phases other than C<extra-data.d> will be cached in the helper drive specified with I<--drive>; see also L</HELPER DRIVE>.
-
-=item B<--install-type> TYPE
-
-Specify the default installation type. Defaults to C<source>.
-
-Set to C<package> to use package based installations by default.
-
-=item B<--machine-readable>
-
-=item B<--machine-readable>=format
-
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の L</マシン可読な出力> 参照。
-
-=item B<-m> MB
-
-=item B<--memsize> MB
-
-Change the amount of memory allocated to the appliance. Increase this if you find that the virt-dib execution runs out of memory.
-
-The default can be found with this command:
-
- guestfish get-memsize
-
-=item B<--mkfs-options> C<OPTION STRING>
-
-Add the specified options to L<mkfs(1)>, to be able to fine-tune the root filesystem creation; the options are passed to the driver of L<mfks(1)>, and not to L<mfks(1)> itself. Note that I<--fs-type> is used to change the filesystem type.
-
-You should use I<--mkfs-options> at most once. To pass multiple options, separate them with space, eg:
-
- virt-dib ... --mkfs-options '-O someopt -I foo'
-
-=item B<--network>
-
-=item B<--no-network>
-
-Enable or disable network access from the guest during the installation.
-
-Enabled is the default. Use I<--no-network> to disable access.
-
-The network only allows outgoing connections and has other minor limitations. See L<virt-rescue(1)/NETWORK>.
-
-This does not affect whether the guest can access the network once it has been booted, because that is controlled by your hypervisor or cloud environment and has nothing to do with virt-dib.
-
-If you use I<--no-network>, then the environment variable C<DIB_OFFLINE> is set to C<1>, signaling the elements that they should use only cached resources when available. Note also that, unlike with C<diskimage-builder> where elements may still be able to access to the network even with C<DIB_OFFLINE=>, under virt-dib network will not be accessible at all.
-
-=item B<--name> NAME
-
-Set the name of the output image file. The default is C<image>.
-
-According to the chosen name, there will be the following in the current directory:
-
-=over 4
-
-=item F<$NAME.ext>
-
-For each output format, a file named after the output image with the extension depending on the format; for example: F<$NAME.qcow2>, F<$NAME.raw>, etc.
-
-Not applicable in ramdisk mode, see L</RAMDISK BUILDING>.
-
-=item F<$NAME.d>
-
-A directory containing any files created by the elements, for example F<dib-manifests> directory (created by the C<manifests> element), ramdisks and kernels in ramdisk mode, and so on.
-
-=item F<$NAME.ext.checksum>
-
-When I<--checksum> is specified, there will be files for each supported checksum type; for example: F<$NAME.ext.md5>, F<$NAME.ext.sha256>, etc.
-
-Not applicable in ramdisk mode, see L</RAMDISK BUILDING>.
-
-=back
-
-=item B<--no-delete-on-failure>
-
-Don’t delete the output files on failure to build. You can use this to debug failures to run scripts.
-
-The default is to delete the output files if virt-dib fails (or, for example, some script that it runs fails).
-
-=item B<--python> PYTHON
-
-Specify a different Python interpreter to use. Parts of C<diskimage-builder> are implemented in Python, and thus an interpreter is needed.
-
-C<PYTHON> can either be an executable filename (e.g. F<python2>, which is then searched in C<$PATH>), or a full path (e.g. F</usr/bin/python2>). If not specified, the default value is F<python>.
-
-=item B<-q>
-
-=item B<--quiet>
-
-Don’t print ordinary progress messages.
-
-=item B<--qemu-img-options> option[,option,...]
-
-Pass I<--qemu-img-options> option(s) to the L<qemu-img(1)> command to fine-tune the output format. Options available depend on the output format (see I<--formats>) and the installed version of the qemu-img program.
-
-You should use I<--qemu-img-options> at most once. To pass multiple options, separate them with commas, eg:
-
- virt-dib ... --qemu-img-options cluster_size=512,preallocation=metadata ...
-
-=item B<--ramdisk>
-
-Set the ramdisk building mode.
-
-See L</RAMDISK BUILDING>.
-
-=item B<--ramdisk-element> NAME
-
-Set the name for the additional element added in ramdisk building mode. The default is C<ramdisk>.
-
-See L</RAMDISK BUILDING>.
-
-=item B<--root-label> LABEL
-
-Set the label for the root filesystem in the created image.
-
-Please note that some filesystems have different restrictions on the length of their labels; for example, on C<ext2/3/4> filesystems labels cannot be longer than 16 characters, while on C<xfs> they have at most 12 characters.
-
-The default depends on the actual filesystem for the root partition (see I<--fs-type>): on C<xfs> is C<img-rootfs>, while C<cloudimg-rootfs> on any other filesystem.
-
-=item B<--size> SIZE
-
-Select the size of the output disk, where the size can be specified using common names such as C<32G> (32 gigabytes) etc. The default size is C<5G>.
-
-To specify size in bytes, the number must be followed by the lowercase letter I<b>, eg: S<C<--size 10737418240b>>.
-
-See also L<virt-resize(1)> for resizing partitions of an existing disk image.
-
-=item B<--skip-base>
-
-Skip the inclusion of the C<base> element.
-
-=item B<--smp> N
-
-Enable N E<ge> 2 virtual CPUs for scripts to use.
-
-=item B<-u>
-
-Do not compress resulting qcow2 images. The default is to compress them.
-
-=item B<-v>
-
-=item B<--verbose>
-
-デバッグメッセージを有効にします。
-
-=item B<-V>
-
-=item B<--version>
-
-バージョン番号を表示して、終了します。
-
-=item B<--wrap>
-
-Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-
-=item B<-x>
-
-libguestfs API 呼び出しのトレースを有効にします。
-
-=back
-
-=head1 環境変数
-
-Unlike with C<diskimage-builder>, the environment of the host is B<not> inherited in the appliance when running most of the elements (i.e. all except the ones in the C<extra-data.d> phase).
-
-To set environment for the elements being run, it is necessary to tell virt-dib to use them, with the option I<--envvar>. Such option allows to selectively export environment variables when running the elements, and it is the preferred way to pass environment variables to the elements.
-
-To recap: if you want the environment variable C<MYVAR> (and its content) to be available to the elements, you can do either
-
- export MYVAR # whichever is its value
- virt-dib ... --envvar MYVAR ...
-
-または
-
- virt-dib ... --envvar MYVAR=value_of_it ...
-
-=head1 HELPER DRIVE
-
-Virt-dib runs most of the element in its own appliance, and thus not on the host. Because of this, there is no possibility for elements to cache resources directly on the host.
-
-To solve this issue, virt-dib allows the usage of an helper drive where to store cached resources, like disk images, distribution packages, etc. While this means that there is a smaller space available for caching, at least it allows to limit the space on the host for caches, without assuming that elements will do that by themselves.
-
-Currently this disk is either required to have a single partition on it, or the first partition on it will be used. A disk with the latter configuration can be easily created with L<guestfish(1)> like the following:
-
- guestfish -N filename.img=fs:ext4:10G exit
-
-The above will create a disk image called F<filename.img>, 10G big, with a single partition of type ext4; see L<guestfish(1)/PREPARED DISK IMAGES>.
-
-It is recommended for it to be E<ge> 10G or even more, as elements will cache disk images, distribution packages, etc. As with any disk image, the helper disk can be easily resized using L<virt-resize(1)> if more space in it is needed.
-
-The drive can be accessed like any other disk image, for example using other tools of libguestfs such as L<guestfish(1)>:
-
- guestfish -a filename.img -m /dev/sda1
-
-If no helper drive is specified with I<--drive>, all the resources cached during a virt-dib run will be discarded.
-
-=head2 RESOURCES INSIDE THE DRIVE
-
-Inside the helper drive, it is possible to find the following resources:
-
-=over 4
-
-=item F</home>
-
-This directory is set as C<HOME> environment variable during the build. It contains mostly the image cache (saved as F</home/.cache/image-create>), and whichever other resource is cached in the home directory of the user running the various tools.
-
-=item F</virt-dib-*.log>
-
-These are the logs of the elements being run within the libguestfs appliance, which means all the phases except C<extra-data.d>.
-
-=back
-
-=head1 RAMDISK BUILDING
-
-Virt-dib can emulate also C<ramdisk-image-create>, which is a secondary operation mode of C<diskimage-builder>. Instead of being a different tool name, virt-dib provides easy access to this mode using the I<--ramdisk> switch.
-
-In this mode:
-
-=over 4
-
-=item
-
-there is an additional ramdisk element added (see I<--ramdisk-element>)
-
-=item
-
-no image is produced (so I<--formats> is ignored)
-
-=item
-
-F<$NAME.d> (see I<--name>) will contain initrd, kernel, etc
-
-=back
-
-=head1 TEMPORARY DIRECTORY
-
-Virt-dib uses the standard temporary directory used by libguestfs, see L<guestfs(3)/ENVIRONMENT VARIABLES>.
-
-By default this location is F</tmp> (default value for C<TMPDIR>), which on some systems may be on a tmpfs filesystem, and thus defaulting to a maximum size of I<half> of physical RAM. If virt-dib exceeds this, it may hang or exit early with an error. The solution is to point C<TMPDIR> to a permanent location used as temporary location, for example:
-
- mkdir local-tmp
- env TMPDIR=$PWD/local-tmp virt-dib ...
- rm -rf local-tmp
-
-=head1 EXTRA DEPENDENCIES
-
-Because of virt-dib runs most of the elements in its own appliance, all the tools and libraries used by elements running outside the guest (typically C<root.d>, C<block-device.d>, and C<cleanup.d>) need to be present in the appliance as well. In case they are not, scripts will fail typically with a C<command not found> error.
-
-For tools and libraries packaged by the distribution, the easy solution is to tell libguestfs to include additional packages in the appliance. This is doable by e.g. creating a new file with the additional packages:
-
- # echo wget > /usr/lib64/guestfs/supermin.d/dib-my-extra
-
-The actual path to the F<supermin.d> directory depends on the distribution; additional files can list more packages, each in its own line. For more details, see L<supermin(1)>.
-
-=head1 COMPARISON WITH DISKIMAGE-BUILDER
-
-Virt-dib is intended as safe replacement for C<diskimage-builder> and its C<ramdisk-image-create> mode; the user-notable differences consist in:
-
-=over 4
-
-=item
-
-the command line arguments; some of the arguments are the same as available in C<diskimage-builder>, while some have different names:
-
- disk-image-create virt-dib
- ----------------- --------
- -a ARCH --arch ARCH
- --image-size SIZE --size SIZE
- --max-online-resize SIZE doable using --mkfs-options
- -n --skip-base
- -o IMAGENAME --name IMAGENAME
- -p PACKAGE(S) --extra-packages PACKAGE(S)
- -t FORMAT(S) --formats FORMAT(S)
- -x --debug 1
- -x -x --debug 2
- -x -x [-x ...] --debug 3/4/etc
-
-=item
-
-the location of non-image output files (like ramdisks and kernels)
-
-=item
-
-the way some of the cached resources are saved: using an helper drive, not directly on the disk where virt-dib is run
-
-=item
-
-the need to specify a target size for the output disk, as opposed to C<diskimage-builder> calculating an optimal one
-
-=item
-
-the handling of environment variables, see L</ENVIRONMENT VARIABLES>.
-
-Furthermore, other than the libguestfs own environment variables (see L<guestfs(3)/ENVIRONMENT VARIABLES>), virt-dib does not read any other environment variable: this means that all the options and behaviour changes are specified solely using command line arguments
-
-=item
-
-extra tools needed on some out-of-chroot phases need to be available in the appliance, see L</EXTRA DEPENDENCIES>.
-
-=back
-
-Elements themselves should notice no difference in they way they are run; behaviour differences may due to wrong assumptions in elements, or not correct virt-dib emulation.
-
-Known issues at the moment:
-
-=over 4
-
-=item
-
-(none)
-
-=back
-
-=head1 マシン可読な出力
-
-The I<--machine-readable> option can be used to make the output more machine friendly, which is useful when calling virt-dib from other programs, GUIs etc.
-
-Use the option on its own to query the capabilities of the virt-dib binary. Typical output looks like this:
-
- $ virt-dib --machine-readable
- virt-dib
- output:qcow2
- output:tar
- output:raw
- output:vhd
-
-A list of features is printed, one per line, and the program exits with status 0.
-
-The C<output:> features refer to the output formats (I<--formats> command line option) supported by this binary.
-
-It is possible to specify a format string for controlling the output; see L<guestfs(3)/ADVANCED MACHINE READABLE OUTPUT>.
-
-=head1 TESTING
-
-Virt-dib has been tested with C<diskimage-builder> (and its elements) E<ge> 0.1.43; from time to time also with C<tripleo-image-elements> and C<sahara-image-elements>.
-
-Previous versions may work, but it is not guaranteed.
-
-=head1 終了ステータス
-
-このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-
-=head1 関連項目
-
-L<guestfs(3)>, L<guestfish(1)>, L<virt-resize(1)>, L<http://libguestfs.org/>.
-
-=head1 著者
-
-Pino Toscano (C<ptoscano at redhat dot com>)
-
-=head1 COPYRIGHT
-
-Copyright (C) 2015 Red Hat Inc.
-
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-diff 1"
-.TH virt-diff 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-diff 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-diff \- Differences between files in two virtual machines
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-diff [\-\-options] \-d domain1 \-D domain2
\&
\& virt\-diff [\-\-options] \-a disk1.img [\-a ...] \-A disk2.img [\-A ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
-\&\f(CW\*(C`virt\-diff\*(C'\fR lists the differences between files in two virtual machines or disk images. The usual use case is to show the changes in a \s-1VM\s0 after it has been running for a while, by taking a snapshot, running the \s-1VM,\s0 and then using this tool to show what changed between the new \s-1VM\s0 state and the old snapshot.
+\&\f(CW\*(C`virt\-diff\*(C'\fR lists the differences between files in two virtual machines or disk images. The usual use case is to show the changes in a VM after it has been running for a while, by taking a snapshot, running the VM, and then using this tool to show what changed between the new VM state and the old snapshot.
.PP
-This tool will find differences in filenames, file sizes, checksums, extended attributes, file content and more from a virtual machine or disk image. However it \fBdoes not\fR look at the boot loader, unused space between partitions or within filesystems, \*(L"hidden\*(R" sectors and so on. In other words, it is not a security or forensics tool.
+This tool will find differences in filenames, file sizes, checksums, extended attributes, file content and more from a virtual machine or disk image. However it \fBdoes not\fR look at the boot loader, unused space between partitions or within filesystems, "hidden" sectors and so on. In other words, it is not a security or forensics tool.
.PP
To specify two guests, you have to use the \fI\-a\fR or \fI\-d\fR option(s) for the first guest, and the \fI\-A\fR or \fI\-D\fR option(s) for the second guest. The common case is:
.PP
.Vb 1
\& virt\-diff \-d oldguest \-D newguest
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from the first virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-all\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-all\fR 4
.IX Item "--all"
Same as \fI\-\-extra\-stats\fR \fI\-\-times\fR \fI\-\-uids\fR \fI\-\-xattrs\fR.
-.IP "\fB\-\-atime\fR" 4
+.IP \fB\-\-atime\fR 4
.IX Item "--atime"
The default is to ignore changes in file access times, since those are unlikely to be interesting. Using this flag shows atime differences as well.
.IP "\fB\-A\fR file" 4
.IX Item "-A file"
.PD 0
-.IP "\fB\-A\fR \s-1URI\s0" 4
+.IP "\fB\-A\fR URI" 4
.IX Item "-A URI"
.PD
Add a disk image from the second virtual machine.
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-checksum\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-checksum\fR 4
.IX Item "--checksum"
.PD 0
-.IP "\fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR" 4
+.IP \fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
Use a checksum over file contents to detect when regular files have changed content.
.Sp
With no argument, this defaults to using \fImd5\fR. Using an argument, you can select the checksum type to use. If the flag is omitted then file times and size are used to determine if a file has changed.
-.IP "\fB\-c\fR \s-1URI\s0" 4
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Write out the results in \s-1CSV\s0 format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read \*(L"\s-1NOTE ABOUT CSV FORMAT\*(R"\s0 below.
-.IP "\fB\-\-dir\-links\fR" 4
+Write out the results in CSV format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read "NOTE ABOUT CSV FORMAT" below.
+.IP \fB\-\-dir\-links\fR 4
.IX Item "--dir-links"
The default is to ignore changes in the number of links in directory entries, since those are unlikely to be interesting. Using this flag shows changes to the nlink field of directories.
-.IP "\fB\-\-dir\-times\fR" 4
+.IP \fB\-\-dir\-times\fR 4
.IX Item "--dir-times"
The default is to ignore changed times on directory entries, since those are unlikely to be interesting. Using this flag shows changes to the time fields of directories.
.IP "\fB\-d\fR guest" 4
.IP "\fB\-D\fR guest" 4
.IX Item "-D guest"
Add all the disks from the named libvirt guest, as the second guest. Domain UUIDs can be used instead of names.
-.IP "\fB\-\-echo\-keys\fR" 4
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-diff normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
-.IP "\fB\-\-extra\-stats\fR" 4
+.IP \fB\-\-extra\-stats\fR 4
.IX Item "--extra-stats"
Display extra stats.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
The default for the \fI\-a\fR/\fI\-A\fR option is to auto-detect the format of the disk image. Using this forces the disk format for \fI\-a\fR/\fI\-A\fR options which follow on the command line. Using \fI\-\-format\fR with no argument switches back to auto-detection for subsequent \fI\-a\fR/\fI\-A\fR options.
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-h\fR" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
読みやすい形式でファイル容量を表示します。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-times\fR" 4
+.IP \fB\-\-times\fR 4
.IX Item "--times"
時間の項目を表示します。
-.IP "\fB\-\-time\-days\fR" 4
+.IP \fB\-\-time\-days\fR 4
.IX Item "--time-days"
Display time fields as days before now (negative if in the future).
.Sp
-Note that \f(CW0\fR in output means \*(L"up to 1 day before now\*(R", or that the age of the file is between 0 and 86399 seconds.
-.IP "\fB\-\-time\-relative\fR" 4
+Note that \f(CW0\fR in output means "up to 1 day before now", or that the age of the file is between 0 and 86399 seconds.
+.IP \fB\-\-time\-relative\fR 4
.IX Item "--time-relative"
Display time fields as seconds before now (negative if in the future).
-.IP "\fB\-\-time\-t\fR" 4
+.IP \fB\-\-time\-t\fR 4
.IX Item "--time-t"
Display time fields as seconds since the Unix epoch.
-.IP "\fB\-\-uids\fR" 4
+.IP \fB\-\-uids\fR 4
.IX Item "--uids"
-\&\s-1UID\s0 と \s-1GID\s0 の項目を表示します。
-.IP "\fB\-v\fR" 4
+UID と GID の項目を表示します。
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.IP "\fB\-\-xattrs\fR" 4
+libguestfs API 呼び出しのトレースを有効にします。
+.IP \fB\-\-xattrs\fR 4
.IX Item "--xattrs"
Display extended attributes.
.SH "CSV 形式に関する注意"
.IX Header "CSV 形式に関する注意"
-Comma-separated values (\s-1CSV\s0) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
+Comma-separated values (CSV) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
.PP
神話: ただコンマで項目を区切る。 真実: これは正しく動き \fIません\fR。この例は 2 つの列があります:
.PP
.PP
For shell scripts, use \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv also packaged in major Linux distributions).
.PP
-For other languages, use a \s-1CSV\s0 processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
+For other languages, use a CSV processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
.PP
-Most spreadsheets and databases can import \s-1CSV\s0 directly.
-.SH "終了ステータス"
+Most spreadsheets and databases can import CSV directly.
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-ls\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-edit 1"
-.TH virt-edit 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-edit 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-edit \- 仮想マシンのファイルの編集
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-edit [\-\-options] \-d domname file [file ...]
\&
\& virt\-edit disk.img [disk.img ...] file
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\f(CW\*(C`virt\-edit\*(C'\fR は名前付きの仮想マシン（またはディスクイメージ）にある、それぞれの \f(CW\*(C`ファイル\*(C'\fR を編集するためのコマンドラインツールです。
.PP
.PP
単にファイルを表示したいだけならば、 \fBvirt\-cat\fR\|(1) を使用してください。
.PP
-より複雑な場合に対しては \fBguestfish\fR\|(1) ツールを参照してください（以下の \*(L"guestfish の使用法\*(R" 参照）。
+より複雑な場合に対しては \fBguestfish\fR\|(1) ツールを参照してください（以下の "guestfish の使用法" 参照）。
.PP
\&\f(CW\*(C`virt\-edit\*(C'\fR は新しいファイルを作成するために使用できません。 \fBguestfish\fR\|(1) はこのことやさらにいろいろなことができます。
-.SH "例"
+.SH 例
.IX Header "例"
名前付きのファイルを対話的に編集します:
.PP
\& virt\-edit \-d mywindomain \*(Aqc:\eautoexec.bat\*(Aq
.Ve
.PP
-Perl がインストールされていると、非対話的にファイルを編集することもできます（以下の \*(L"非対話的な編集方法\*(R" 参照）。 init の初期ランベルを 5 に変更するには:
+Perl がインストールされていると、非対話的にファイルを編集することもできます（以下の "非対話的な編集方法" 参照）。 init の初期ランベルを 5 に変更するには:
.PP
.Vb 1
\& virt\-edit \-d mydomain /etc/inittab \-e \*(Aqs/^id:.*/id:5:initdefault:/\*(Aq
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-b\fR \s-1EXTENSION\s0" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP "\fB\-b\fR EXTENSION" 4
.IX Item "-b EXTENSION"
.PD 0
-.IP "\fB\-\-backup\fR \s-1EXTENSION\s0" 4
+.IP "\fB\-\-backup\fR EXTENSION" 4
.IX Item "--backup EXTENSION"
.PD
\&\fI仮想マシンのディスクイメージにある\fR 元のファイルのバックアップを作成します。バックアップは元のファイル名に \f(CW\*(C`extension\*(C'\fR を加えたものになります。
.Ve
.Sp
初期設定では、バックアップファイルは作成されません。
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
仮想マシンのブロックデバイスを直接指定すると、libvirt はまったく使用されません。
-.IP "\fB\-d\fR \s-1GUEST\s0" 4
+.IP "\fB\-d\fR GUEST" 4
.IX Item "-d GUEST"
.PD 0
-.IP "\fB\-\-domain\fR \s-1GUEST\s0" 4
+.IP "\fB\-\-domain\fR GUEST" 4
.IX Item "--domain GUEST"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
キーやパスフレーズを入力するとき、通常 virt-edit はエコーを無効化します。 そのため、入力内容を確認できません。 テンペスト攻撃の心配がなく、 部屋に誰も居なければ、 入力内容を確認するためにこのフラグを指定できます。
-.IP "\fB\-e\fR \s-1EXPR\s0" 4
+.IP "\fB\-e\fR EXPR" 4
.IX Item "-e EXPR"
.PD 0
-.IP "\fB\-\-edit\fR \s-1EXPR\s0" 4
+.IP "\fB\-\-edit\fR EXPR" 4
.IX Item "--edit EXPR"
-.IP "\fB\-\-expr\fR \s-1EXPR\s0" 4
+.IP "\fB\-\-expr\fR EXPR" 4
.IX Item "--expr EXPR"
.PD
-外部エディターを起動する代わりに、ファイルにある各行に対して非対話的に Perl 表現 \f(CW\*(C`EXPR\*(C'\fR を適用します。以下の \*(L"非対話的な編集方法\*(R" を参照してください。
+外部エディターを起動する代わりに、ファイルにある各行に対して非対話的に Perl 表現 \f(CW\*(C`EXPR\*(C'\fR を適用します。以下の "非対話的な編集方法" を参照してください。
.Sp
表現がシェルにより変更されるのを防ぐために、適切に引用符でくくるよう注意してください。
.Sp
このオプションは Perl 5 がインストールされているときのみ利用可能であることに注意してください。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Specifying any mountpoint disables the inspection of the guest and the mount of its root and all of its mountpoints, so make sure to mount all the mountpoints needed to work with the filenames given as arguments.
.Sp
-If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" and \*(L"lvs\*(R" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
+If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see "list-partitions", "list-filesystems" and "lvs" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
.Sp
マウントパラメーターの三番目の (ほとんど使用されない) 項目は、 バックエンドのファイルシステムをマウントするために使用される マウントオプションの一覧です。 これが指定されていない場合、 マウントオプションは空文字列または \f(CW\*(C`ro\*(C'\fR (\fI\-\-ro\fR フラグが使用されている場合) になります。
.Sp
このフラグを使用することは、 \f(CW\*(C`mount\-options\*(C'\fR コマンドを使用することと同等です。
.Sp
パラメーターの四番目の項目は使用するファイルシステムドライバー (\f(CW\*(C`ext3\*(C'\fR や \f(CW\*(C`ntfs\*(C'\fR など) です。 これはほとんど必要ありません。 しかし、複数のドライバーがファイルシステムに対して有効である場合 (例: \f(CW\*(C`ext2\*(C'\fR と \f(CW\*(C`ext3\*(C'\fR)、 または libguestfs がファイルシステムを誤検知している場合、 これは有用です。
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "旧形式のコマンドライン引数"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 旧形式のコマンドライン引数
.IX Header "旧形式のコマンドライン引数"
前のバージョンの virt-edit はどちらを書くこともできます:
.PP
whereas in this version you should use \fI\-a\fR or \fI\-d\fR respectively to avoid the confusing case where a disk image might have the same name as a guest.
.PP
互換性のため古い形式がまだサポートされています。
-.SH "非対話的な編集方法"
+.SH 非対話的な編集方法
.IX Header "非対話的な編集方法"
\&\f(CW\*(C`virt\-edit\*(C'\fR normally calls out to \f(CW$EDITOR\fR (or vi) so the system administrator can interactively edit the file.
.PP
-There are two ways also to use \f(CW\*(C`virt\-edit\*(C'\fR from scripts in order to make automated edits to files. (Note that although you \fIcan\fR use \f(CW\*(C`virt\-edit\*(C'\fR like this, it’s less error-prone to write scripts directly using the libguestfs \s-1API\s0 and Augeas for configuration file editing.)
+There are two ways also to use \f(CW\*(C`virt\-edit\*(C'\fR from scripts in order to make automated edits to files. (Note that although you \fIcan\fR use \f(CW\*(C`virt\-edit\*(C'\fR like this, it’s less error-prone to write scripts directly using the libguestfs API and Augeas for configuration file editing.)
.PP
The first method is to temporarily set \f(CW$EDITOR\fR to any script or program you want to run. The script is invoked as \f(CW\*(C`$EDITOR tmpfile\*(C'\fR and it should update \f(CW\*(C`tmpfile\*(C'\fR in place however it likes.
.PP
\& virt\-edit \-d mydomain /etc/passwd \-e \*(Aq$_ = "" if /^apache:/\*(Aq
.Ve
.PP
-To insert a line, prepend or append it to \f(CW$_\fR. However appending lines to the end of the file is rather difficult this way since there is no concept of \*(L"last line of the file\*(R" \- your expression just doesn't get called again. You might want to use the first method (setting \f(CW$EDITOR\fR) if you want to do this.
+To insert a line, prepend or append it to \f(CW$_\fR. However appending lines to the end of the file is rather difficult this way since there is no concept of "last line of the file" \- your expression just doesn't get called again. You might want to use the first method (setting \f(CW$EDITOR\fR) if you want to do this.
.PP
The variable \f(CW$lineno\fR contains the current line number. As is traditional, the first line in the file is number \f(CW1\fR.
.PP
The return value from the expression is ignored, but the expression may call \f(CW\*(C`die\*(C'\fR in order to abort the whole program, leaving the original file untouched.
.PP
-Remember when matching the end of a line that \f(CW$_\fR may contain the final \f(CW\*(C`\en\*(C'\fR, or (for \s-1DOS\s0 files) \f(CW\*(C`\er\en\*(C'\fR, or if the file does not end with a newline then neither of these. Thus to match or substitute some text at the end of a line, use this regular expression:
+Remember when matching the end of a line that \f(CW$_\fR may contain the final \f(CW\*(C`\en\*(C'\fR, or (for DOS files) \f(CW\*(C`\er\en\*(C'\fR, or if the file does not end with a newline then neither of these. Thus to match or substitute some text at the end of a line, use this regular expression:
.PP
.Vb 1
\& /some text(\er?\en)?$/
\&\f(CW\*(C`virt\-edit\*(C'\fR has a limited ability to understand Windows drive letters and paths (eg. \fIE:\efoo\ebar.txt\fR).
.PP
仮想マシンが Windows を実行している場合に限り:
-.IP "\(bu" 4
+.IP \(bu 4
Drive letter prefixes like \f(CW\*(C`C:\*(C'\fR are resolved against the Windows Registry to the correct filesystem.
-.IP "\(bu" 4
+.IP \(bu 4
Any backslash (\f(CW\*(C`\e\*(C'\fR) characters in the path are replaced with forward slashes so that libguestfs can process it.
-.IP "\(bu" 4
+.IP \(bu 4
The path is resolved case insensitively to locate the file that should be edited.
.PP
There are some known shortcomings:
-.IP "\(bu" 4
-Some \s-1NTFS\s0 symbolic links may not be followed correctly.
-.IP "\(bu" 4
-\&\s-1NTFS\s0 junction points that cross filesystems are not followed.
+.IP \(bu 4
+Some NTFS symbolic links may not be followed correctly.
+.IP \(bu 4
+NTFS junction points that cross filesystems are not followed.
.SH "guestfish の使用法"
.IX Header "guestfish の使用法"
\&\fBguestfish\fR\|(1) is a more powerful, lower level tool which you can use when \f(CW\*(C`virt\-edit\*(C'\fR doesn't work.
\&
\& guestfish \-\-rw \-i \-d domname upload localfile /newfile
.Ve
-.SH "環境変数"
+.SH 環境変数
.IX Header "環境変数"
.ie n .IP """EDITOR""" 4
-.el .IP "\f(CWEDITOR\fR" 4
+.el .IP \f(CWEDITOR\fR 4
.IX Item "EDITOR"
設定されていると、この文字列がエディターとして使用されます。 \f(CW"emacs \-nw"\fR のように、引数を含めることもできます。
.Sp
設定されていないと、\f(CW\*(C`vi\*(C'\fR が使用されます。
-.SH "終了ステータス"
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-in\fR\|(1), \fBvirt\-tar\-in\fR\|(1), http://libguestfs.org/, \fBperl\fR\|(1), \fBperlre\fR\|(1).
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-filesystems 1"
-.TH virt-filesystems 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-filesystems 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
-virt-filesystems \- 仮想マシンまたはディスクイメージにあるファイルシステム、パーティション、ブロックデバイスおよび \s-1LVM\s0 の一覧表示
-.SH "書式"
+virt-filesystems \- 仮想マシンまたはディスクイメージにあるファイルシステム、パーティション、ブロックデバイスおよび LVM の一覧表示
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-filesystems [\-\-options] \-d domname
\&
\& virt\-filesystems [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
This tool allows you to discover filesystems, partitions, logical volumes, and their sizes in a disk image or virtual machine. It is a replacement for \fBvirt\-list\-filesystems\fR\|(1) and \fBvirt\-list\-partitions\fR\|(1).
.PP
.Ve
.PP
マシン読み込み可能な出力のために、カンマ区切り値を取得するために \fI\-\-csv\fR を使用します。
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a \s-1URI\s0\fR" 4
+.IP "\fB\-a URI\fR" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add \s-1URI\s0\fR" 4
+.IP "\fB\-\-add URI\fR" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-all\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-all\fR 4
.IX Item "--all"
すべてを表示します。これは現在これらのオプションを指定するのと同じです: \fI\-\-filesystems\fR, \fI\-\-extra\fR, \fI\-\-partitions\fR, \fI\-\-block\-devices\fR, \fI\-\-logical\-volumes\fR, \fI\-\-volume\-groups\fR, \fI\-\-physical\-volumes\fR。（将来この一覧にさらに追加されるかもしれません。）
.Sp
\&\fI\-\-long\fR 参照。
-.IP "\fB\-\-blkdevs\fR" 4
+.IP \fB\-\-blkdevs\fR 4
.IX Item "--blkdevs"
.PD 0
-.IP "\fB\-\-block\-devices\fR" 4
+.IP \fB\-\-block\-devices\fR 4
.IX Item "--block-devices"
.PD
ブロックデバイスを表示します。
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Write out the results in \s-1CSV\s0 format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read \*(L"\s-1NOTE ABOUT CSV FORMAT\*(R"\s0 below.
+Write out the results in CSV format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read "NOTE ABOUT CSV FORMAT" below.
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
キーやパスフレーズを入力するとき、通常 virt-filesystems はエコーを無効化します。 そのため、入力内容を確認できません。 テンペスト攻撃の心配がなく、 部屋に誰も居なければ、 入力内容を確認するためにこのフラグを指定できます。
-.IP "\fB\-\-extra\fR" 4
+.IP \fB\-\-extra\fR 4
.IX Item "--extra"
This causes filesystems that are not ordinary, mountable filesystems to be displayed. This category includes swapspace, and filesystems that are empty or contain unknown data.
.Sp
このオプションは \fI\-\-filesystems\fR を意味します。
-.IP "\fB\-\-filesystems\fR" 4
+.IP \fB\-\-filesystems\fR 4
.IX Item "--filesystems"
マウント可能なファイルシステムを表示します。表示オプションが選択されていなければ、このオプションが暗に指定されます。
.Sp
\&\fI\-\-extra\fR を用いると、マウントできないファイルシステムも表示されます。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-h\fR" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
\&\fI\-\-long\fR モードでは、読みやすい形式で容量を表示します。
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-l\fR" 4
+.IP \fB\-l\fR 4
.IX Item "-l"
.PD 0
-.IP "\fB\-\-long\fR" 4
+.IP \fB\-\-long\fR 4
.IX Item "--long"
.PD
-Display extra columns of data (\*(L"long format\*(R").
+Display extra columns of data ("long format").
.Sp
A title row is added unless you also specify \fI\-\-no\-title\fR.
.Sp
.Sp
Use \fI\-h\fR if you want sizes to be displayed in human-readable format. The default is to show raw numbers of \fIbytes\fR.
.Sp
-\&\s-1UUID\s0 も表示するには \fI\-\-uuid\fR を使用します。
-.IP "\fB\-\-lvs\fR" 4
+UUID も表示するには \fI\-\-uuid\fR を使用します。
+.IP \fB\-\-lvs\fR 4
.IX Item "--lvs"
.PD 0
-.IP "\fB\-\-logvols\fR" 4
+.IP \fB\-\-logvols\fR 4
.IX Item "--logvols"
-.IP "\fB\-\-logical\-volumes\fR" 4
+.IP \fB\-\-logical\-volumes\fR 4
.IX Item "--logical-volumes"
.PD
-\&\s-1LVM\s0 論理ボリュームを表示します。 このモードでは、論理ボリュームが含むファイルシステムにかかわりなく表示します。
-.IP "\fB\-\-no\-title\fR" 4
+LVM 論理ボリュームを表示します。 このモードでは、論理ボリュームが含むファイルシステムにかかわりなく表示します。
+.IP \fB\-\-no\-title\fR 4
.IX Item "--no-title"
In \fI\-\-long\fR mode, don’t add a title row.
.Sp
Note that the order of the columns is not fixed, and may change in future versions of virt-filesystems, so using this option may give you unexpected surprises.
-.IP "\fB\-\-parts\fR" 4
+.IP \fB\-\-parts\fR 4
.IX Item "--parts"
.PD 0
-.IP "\fB\-\-partitions\fR" 4
+.IP \fB\-\-partitions\fR 4
.IX Item "--partitions"
.PD
パーティションを表示します。 このモードでは、パーティションが含むファイルシステムにかかわりなく表示します。
-.IP "\fB\-\-pvs\fR" 4
+.IP \fB\-\-pvs\fR 4
.IX Item "--pvs"
.PD 0
-.IP "\fB\-\-physvols\fR" 4
+.IP \fB\-\-physvols\fR 4
.IX Item "--physvols"
-.IP "\fB\-\-physical\-volumes\fR" 4
+.IP \fB\-\-physical\-volumes\fR 4
.IX Item "--physical-volumes"
.PD
-\&\s-1LVM\s0 物理ボリュームを表示します。
-.IP "\fB\-\-uuid\fR" 4
+LVM 物理ボリュームを表示します。
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
.PD 0
-.IP "\fB\-\-uuids\fR" 4
+.IP \fB\-\-uuids\fR 4
.IX Item "--uuids"
.PD
-\&\fI\-\-long\fR モードでは \s-1UUID\s0 も表示されます。
-.IP "\fB\-v\fR" 4
+\&\fI\-\-long\fR モードでは UUID も表示されます。
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-vgs\fR" 4
+.IP \fB\-\-vgs\fR 4
.IX Item "--vgs"
.PD 0
-.IP "\fB\-\-volgroups\fR" 4
+.IP \fB\-\-volgroups\fR 4
.IX Item "--volgroups"
-.IP "\fB\-\-volume\-groups\fR" 4
+.IP \fB\-\-volume\-groups\fR 4
.IX Item "--volume-groups"
.PD
-\&\s-1LVM\s0 ボリュームグループを表示します。
-.IP "\fB\-x\fR" 4
+LVM ボリュームグループを表示します。
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "列"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 列
.IX Header "列"
出力にある列はこのツールの将来のバージョンにおいて並び替えられる場合や変更される場合があることに注意してください。
-.IP "\fB名前\fR" 4
+.IP \fB名前\fR 4
.IX Item "名前"
-ファイルシステム、パーティション、ブロックデバイスまたは \s-1LVM\s0 の名前。
+ファイルシステム、パーティション、ブロックデバイスまたは LVM の名前。
.Sp
For device and partition names these are displayed as canonical libguestfs names, so that for example \fI/dev/sda2\fR is the second partition on the first device.
.Sp
\&\fI\-\-long\fR オプションが指定されて\fBいない\fRと、名前の列のみが出力に表示されます。
-.IP "\fB種類\fR" 4
+.IP \fB種類\fR 4
.IX Item "種類"
対象の形式。たとえば、\f(CW\*(C`filesystem\*(C'\fR, \f(CW\*(C`lv\*(C'\fR, \f(CW\*(C`device\*(C'\fR など。
-.IP "\fB\s-1VFS\s0\fR" 4
+.IP \fBVFS\fR 4
.IX Item "VFS"
ファイルシステムがあれば、この列は最初に検知されたファイルシステムの形式を表示します。例: \f(CW\*(C`ext4\*(C'\fR。
-.IP "\fBラベル\fR" 4
+.IP \fBラベル\fR 4
.IX Item "ラベル"
（ファイルシステムの識別とマウントのために使用される）ラベルがオブジェクトにあれば、この列はラベルを含みます。
-.IP "\fB\s-1MBR\s0\fR" 4
+.IP \fBMBR\fR 4
.IX Item "MBR"
パーティション形式のバイト、2 桁の 16 進数として表示されます。パーティション形式の完全な一覧は次のところにあります: http://www.win.tue.nl/~aeb/partitions/partition_types\-1.html
.Sp
-これは \s-1DOS\s0 (\s-1MBR\s0) パーティションに対してのみ適用できます。
-.IP "\fB容量\fR" 4
+これは DOS (MBR) パーティションに対してのみ適用できます。
+.IP \fB容量\fR 4
.IX Item "容量"
オブジェクトのバイト単位の容量。\fI\-\-human\fR オプションが使用されていると、容量が人間可読な形式で表示されます。
-.IP "\fB親\fR" 4
+.IP \fB親\fR 4
.IX Item "親"
親カラムはオブジェクト間の親子関係を記録します。
.Sp
たとえば、オブジェクトがパーティションならば、このカラムは含んでいるデバイスの名前が含まれます。オブジェクトが論理ボリュームならば、このカラムはボリュームグループの名前です。
.Sp
複数の親があると、この列は (内部に列を持つ) カンマ区切りの一覧になります。例: \f(CW\*(C`/dev/sda,/dev/sdb\*(C'\fR。
-.IP "\fB\s-1UUID\s0\fR" 4
+.IP \fBUUID\fR 4
.IX Item "UUID"
-If the object has a \s-1UUID\s0 (used for identifying and mounting filesystems and block devices) then this column contains the \s-1UUID\s0 as a string.
+If the object has a UUID (used for identifying and mounting filesystems and block devices) then this column contains the UUID as a string.
.Sp
-\&\fI\-\-uuid\fR オプションが指定されると、 \s-1UUID\s0 のみが表示されます。
+\&\fI\-\-uuid\fR オプションが指定されると、 UUID のみが表示されます。
.SH "CSV 形式に関する注意"
.IX Header "CSV 形式に関する注意"
-Comma-separated values (\s-1CSV\s0) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
+Comma-separated values (CSV) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
.PP
神話: ただコンマで項目を区切る。 真実: これは正しく動き \fIません\fR。この例は 2 つの列があります:
.PP
.PP
For shell scripts, use \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv also packaged in major Linux distributions).
.PP
-For other languages, use a \s-1CSV\s0 processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
+For other languages, use a CSV processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
.PP
-Most spreadsheets and databases can import \s-1CSV\s0 directly.
-.SH "終了ステータス"
+Most spreadsheets and databases can import CSV directly.
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-df\fR\|(1), \fBvirt\-drivers\fR\|(1), \fBvirt\-list\-filesystems\fR\|(1), \fBvirt\-list\-partitions\fR\|(1), \fBcsvtool\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-format 1"
-.TH virt-format 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-format 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-format \- ディスクの消去および空のディスクの作成
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-format [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
-Virt-format takes an existing disk file (or it can be a host partition, \s-1LV\s0 etc), \fBerases all data on it\fR, and formats it as a blank disk. It can optionally create partition tables, empty filesystems, logical volumes and more.
+Virt-format takes an existing disk file (or it can be a host partition, LV etc), \fBerases all data on it\fR, and formats it as a blank disk. It can optionally create partition tables, empty filesystems, logical volumes and more.
.PP
To create a disk containing data, you may be better to use \fBvirt\-make\-fs\fR\|(1). If you are creating a blank disk to use in \fBguestfish\fR\|(1), you should instead use the guestfish \fI\-N\fR option.
.PP
\&\fIdisk.qcow\fR or \fI/dev/VG/LV\fR must exist already. \fBAny data on these disks will be erased by these commands\fR. These commands will create a single empty partition covering the whole disk, with no filesystem inside it.
.PP
Additional parameters can be used to control the creation of partitions, filesystems, etc. The most commonly used options are:
-.IP "\fB\-\-filesystem=[ext3|ntfs|vfat|...]\fR" 4
+.IP \fB\-\-filesystem=[ext3|ntfs|vfat|...]\fR 4
.IX Item "--filesystem=[ext3|ntfs|vfat|...]"
Create an empty filesystem (\f(CW\*(C`ext3\*(C'\fR, \f(CW\*(C`ntfs\*(C'\fR etc) inside the partition.
-.IP "\fB\-\-lvm[=/dev/VG/LV]\fR" 4
+.IP \fB\-\-lvm[=/dev/VG/LV]\fR 4
.IX Item "--lvm[=/dev/VG/LV]"
-Create a Linux \s-1LVM2\s0 logical volume on the disk. When used with \fI\-\-filesystem\fR, the filesystem is created inside the \s-1LV.\s0
+Create a Linux LVM2 logical volume on the disk. When used with \fI\-\-filesystem\fR, the filesystem is created inside the LV.
.PP
-For more information about these and other options, see \*(L"\s-1OPTIONS\*(R"\s0 below.
+For more information about these and other options, see "OPTIONS" below.
.PP
The format of the disk is normally auto-detected, but you can also force it by using the \fI\-\-format\fR option (q.v.). In situations where you do not trust the existing content of the disk, then it is advisable to use this option to avoid possible exploits.
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
.IP "\fB\-\-add\fR file" 4
.IX Item "--add file"
.PD
-\&\fIファイル\fR、ディスクイメージ、ホストのパーティション、論理ボリューム、外部 \s-1USB\s0 ディスクなどを追加します。
+\&\fIファイル\fR、ディスクイメージ、ホストのパーティション、論理ボリューム、外部 USB ディスクなどを追加します。
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
.Sp
\&\fBディスクにある既存のデータはすべて削除されます。\fR
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-filesystem=ext3|ntfs|vfat|...\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-filesystem=ext3|ntfs|vfat|...\fR 4
.IX Item "--filesystem=ext3|ntfs|vfat|..."
Create an empty filesystem of the specified type. Many filesystem types are supported by libguestfs.
-.IP "\fB\-\-filesystem=none\fR" 4
+.IP \fB\-\-filesystem=none\fR 4
.IX Item "--filesystem=none"
ファイルシステムを作成しません。 これがデフォルトです。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-label=\fR\s-1LABEL\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP \fB\-\-label=\fRLABEL 4
.IX Item "--label=LABEL"
Set the filesystem label.
-.IP "\fB\-\-lvm=/dev/\f(BI\s-1VG\s0\fB/\f(BI\s-1LV\s0\fB\fR" 4
+.IP \fB\-\-lvm=/dev/\fR\f(BIVG\fR\fB/\fR\f(BILV\fR 4
.IX Item "--lvm=/dev/VG/LV"
-Create a Linux \s-1LVM2\s0 logical volume called \fI/dev/\fI\s-1VG\s0\fI/\fI\s-1LV\s0\fI\fR. You can change the name of the volume group and logical volume.
-.IP "\fB\-\-lvm\fR" 4
+Create a Linux LVM2 logical volume called \fI/dev/VG/LV\fR. You can change the name of the volume group and logical volume.
+.IP \fB\-\-lvm\fR 4
.IX Item "--lvm"
-Create a Linux \s-1LVM2\s0 logical volume with the default name (\fI/dev/VG/LV\fR).
-.IP "\fB\-\-lvm=none\fR" 4
+Create a Linux LVM2 logical volume with the default name (\fI/dev/VG/LV\fR).
+.IP \fB\-\-lvm=none\fR 4
.IX Item "--lvm=none"
論理ボリュームを作成しません。 これがデフォルトです。
-.IP "\fB\-\-partition\fR" 4
+.IP \fB\-\-partition\fR 4
.IX Item "--partition"
-ディスク全体をカバーする \s-1MBR\s0 または \s-1GPT\s0 パーティションを作成します。ディスク容量が < 2 \s-1TB\s0 ならば \s-1MBR\s0 が選択されます。容量が ≥ 2 \s-1TB\s0 ならば \s-1GPT\s0 が選択されます。
+ディスク全体をカバーする MBR または GPT パーティションを作成します。ディスク容量が < 2 TB ならば MBR が選択されます。容量が ≥ 2 TB ならば GPT が選択されます。
.Sp
これがデフォルトです。
-.IP "\fB\-\-partition=gpt\fR" 4
+.IP \fB\-\-partition=gpt\fR 4
.IX Item "--partition=gpt"
-\&\s-1GPT\s0 パーティションを作成します。
-.IP "\fB\-\-partition=mbr\fR" 4
+GPT パーティションを作成します。
+.IP \fB\-\-partition=mbr\fR 4
.IX Item "--partition=mbr"
-\&\s-1MBR\s0 パーティションを作成します。
-.IP "\fB\-\-partition=none\fR" 4
+MBR パーティションを作成します。
+.IP \fB\-\-partition=none\fR 4
.IX Item "--partition=none"
パーティションテーブルを作成しません。Windows はこれらのディスクを認識できないかもしれないことに注意してください。
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wipe\fR" 4
+.IP \fB\-\-wipe\fR 4
.IX Item "--wipe"
Normally virt-format does not wipe data from the disk (because that takes a long time). Thus if there is data on the disk, it is only hidden and partially overwritten by virt-format, and it might be recovered by disk editing tools.
.Sp
If you use this option, virt-format writes zeroes over the whole disk so that previous data is not recoverable.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "終了ステータス"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると \f(CW0\fR、失敗すると \f(CW1\fR を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-make\-fs\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2012 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-get-kernel 1"
-.TH virt-get-kernel 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-get-kernel 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-get-kernel \- Extract kernel and ramdisk from guests
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-get\-kernel [\-\-options] \-d domname
\&
\& virt\-get\-kernel [\-\-options] \-a disk.img
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
This program extracts the kernel and initramfs from a guest.
.PP
The format of the disk image is automatically detected unless you specify it by using the \fI\-\-format\fR option.
.PP
In the case where the guest contains multiple kernels, the one with the highest version number is chosen. To extract arbitrary kernels from the disk image, see \fBguestfish\fR\|(1). To extract the entire \f(CW\*(C`/boot\*(C'\fR directory of a guest, see \fBvirt\-copy\-out\fR\|(1).
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
ヘルプを表示します。
.IP "\fB\-a\fR file" 4
仮想マシンからディスクイメージの \fIfile\fR を追加します。
.Sp
ディスクイメージの形式は自動的に検出されます。強制的に特定の形式を使用するには \fI\-\-format\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-Add a remote disk. The \s-1URI\s0 format is compatible with guestfish. See \*(L"\s-1ADDING REMOTE STORAGE\*(R"\s0 in \fBguestfish\fR\|(1).
+Add a remote disk. The URI format is compatible with guestfish. See "ADDING REMOTE STORAGE" in \fBguestfish\fR\|(1).
.IP "\fB\-\-blocksize\fR \fB512\fR" 4
.IX Item "--blocksize 512"
.PD 0
.IP "\fB\-\-blocksize\fR \fB4096\fR" 4
.IX Item "--blocksize 4096"
.PD
-This parameter sets the sector size of the disk image added with \fI\-a\fR option and is ignored for libvirt guest added with \fI\-d\fR option. See also \*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-colors\fR" 4
+This parameter sets the sector size of the disk image added with \fI\-a\fR option and is ignored for libvirt guest added with \fI\-d\fR option. See also "guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-c\fR \s-1URI\s0" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-get-kernel normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.PD
The default for the \fI\-a\fR option is to auto-detect the format of the disk image. Using this forces the disk format for the \fI\-a\fR option on the command line.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=format" 4
+.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の \*(L"マシン可読な出力\*(R" 参照。
+このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の "マシン可読な出力" 参照。
.IP "\fB\-o\fR directory" 4
.IX Item "-o directory"
.PD 0
If a prefix is specified, then there will be a dash (\f(CW\*(C`\-\*(C'\fR) after the prefix and before the rest of the file name; for example, a kernel in the guest like \f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR is saved as \f(CW\*(C`mydistro\-vmlinuz\-3.19.0\-20\-generic\*(C'\fR when the prefix is \f(CW\*(C`mydistro\*(C'\fR.
.Sp
See also \fI\-\-unversioned\-names\fR.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Don’t print ordinary progress messages.
-.IP "\fB\-\-unversioned\-names\fR" 4
+.IP \fB\-\-unversioned\-names\fR 4
.IX Item "--unversioned-names"
This option affects the destination file name of extracted files.
.Sp
If enabled, files will be saved locally just with the base name; for example, kernel and ramdisk in the guest like \f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR and \f(CW\*(C`initrd.img\-3.19.0\-20\-generic\*(C'\fR are saved respectively as \f(CW\*(C`vmlinuz\*(C'\fR and \f(CW\*(C`initrd.img\*(C'\fR.
.Sp
See also \fI\-\-prefix\fR.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "マシン可読な出力"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH マシン可読な出力
.IX Header "マシン可読な出力"
The \fI\-\-machine\-readable\fR option can be used to make the output more machine friendly, which is useful when calling virt-get-kernel from other programs, GUIs etc.
.PP
.PP
A list of features is printed, one per line, and the program exits with status 0.
.PP
-It is possible to specify a format string for controlling the output; see \*(L"\s-1ADVANCED MACHINE READABLE OUTPUT\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "環境変数"
+It is possible to specify a format string for controlling the output; see "ADVANCED MACHINE READABLE OUTPUT" in \fBguestfs\fR\|(3).
+.SH 環境変数
.IX Header "環境変数"
-For other environment variables which affect all libguestfs programs, see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "終了ステータス"
+For other environment variables which affect all libguestfs programs, see "ENVIRONMENT VARIABLES" in \fBguestfs\fR\|(3).
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBguestmount\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-drivers\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2013\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-index-validate 1"
-.TH virt-index-validate 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-index-validate 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-index-validate \- Validate virt-builder index file
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-index\-validate index
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\fBvirt\-builder\fR\|(1) uses an index file to store metadata about templates that it knows how to use. This index file has a specific format which virt-index-validate knows how to validate.
.PP
-Note that virt-index-validate can validate either the signed or unsigned index file (ie. either \fIindex\fR or \fIindex.asc\fR). It can only validate a local file, not a \s-1URL.\s0
-.SH "オプション"
+Note that virt-index-validate can validate either the signed or unsigned index file (ie. either \fIindex\fR or \fIindex.asc\fR). It can only validate a local file, not a URL.
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-compat\-1.24.0\fR" 4
+.IP \fB\-\-compat\-1.24.0\fR 4
.IX Item "--compat-1.24.0"
Check for compatibility with virt-builder 1.24.0. (Using this option implies \fI\-\-compat\-1.24.1\fR, so you don't need to use both.)
.Sp
In particular:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
This version of virt-builder could not handle \f(CW\*(C`[...]\*(C'\fR (square brackets) in field names (eg. \f(CW\*(C`checksum[sha512]=...\*(C'\fR).
-.IP "\(bu" 4
+.IP \(bu 4
It required detached signatures (\f(CW\*(C`sig=...\*(C'\fR).
.RE
.RS 4
.RE
-.IP "\fB\-\-compat\-1.24.1\fR" 4
+.IP \fB\-\-compat\-1.24.1\fR 4
.IX Item "--compat-1.24.1"
Check for compatibility with virt-builder ≥ 1.24.1.
.Sp
In particular:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
This version of virt-builder could not handle \f(CW\*(C`.\*(C'\fR (period) in field names or \f(CW\*(C`,\*(C'\fR (comma) in subfield names.
-.IP "\(bu" 4
+.IP \(bu 4
It could not handle comments appearing in the file.
.RE
.RS 4
.RE
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
ヘルプを表示します。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.SH "終了ステータス"
+.SH 終了ステータス
.IX Header "終了ステータス"
This program returns 0 if the index file validates, or non-zero if there was an error.
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBvirt\-builder\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2013 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-inspector 1"
-.TH virt-inspector 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-inspector 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-inspector \- Display operating system version and other information about a virtual machine
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-inspector [\-\-options] \-d domname
\&
\& virt\-inspector disk.img [disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\fBvirt-inspector\fR examines a virtual machine or disk image and tries to determine the version of the operating system and other information about the virtual machine.
.PP
.PP
You can also run virt-inspector directly on disk images from a single virtual machine. Use \f(CW\*(C`virt\-inspector \-a disk.img\*(C'\fR. In rare cases a domain has several block devices, in which case you should list several \fI\-a\fR options one after another, with the first corresponding to the guest’s \fI/dev/sda\fR, the second to the guest’s \fI/dev/sdb\fR and so on.
.PP
-You can also run virt-inspector on install disks, live CDs, bootable \s-1USB\s0 keys and similar.
+You can also run virt-inspector on install disks, live CDs, bootable USB keys and similar.
.PP
Virt-inspector can only inspect and report upon \fIone domain at a time\fR. To inspect several virtual machines, you have to run virt-inspector several times (for example, from a shell script for-loop).
.PP
Because virt-inspector needs direct access to guest images, it won’t normally work over remote libvirt connections.
.PP
-All of the information available from virt-inspector is also available through the core libguestfs inspection \s-1API\s0 (see \*(L"\s-1INSPECTION\*(R"\s0 in \fBguestfs\fR\|(3)). The same information can also be fetched using guestfish or via libguestfs bindings in many programming languages (see \*(L"\s-1GETTING INSPECTION DATA FROM THE LIBGUESTFS API\*(R"\s0).
+All of the information available from virt-inspector is also available through the core libguestfs inspection API (see "INSPECTION" in \fBguestfs\fR\|(3)). The same information can also be fetched using guestfish or via libguestfs bindings in many programming languages (see "GETTING INSPECTION DATA FROM THE LIBGUESTFS API").
.PP
Additional information about bootloader, kernel and drivers inside a guest can be found using \fBvirt\-drivers\fR\|(1).
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
Libvirt is only used if you specify a \f(CW\*(C`domname\*(C'\fR on the command line. If you specify guest block devices directly (\fI\-a\fR), then libvirt is not used at all.
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
キーやパスフレーズを入力するとき、通常 virt-inspector はエコーを無効化します。 そのため、入力内容を確認できません。 テンペスト攻撃の心配がなく、 部屋に誰も居なければ、 入力内容を確認するためにこのフラグを指定できます。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Specify the format of disk images given on the command line. If this is omitted then the format is autodetected from the content of the disk image.
If disk images are requested from libvirt, then this program asks libvirt for this information. In this case, the value of the format parameter is ignored.
.Sp
If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-no\-applications\fR" 4
+.IP \fB\-\-no\-applications\fR 4
.IX Item "--no-applications"
By default the output of virt-inspector includes the list of all the applications installed in the guest, if available.
.Sp
-Specify this option to disable this part of the resulting \s-1XML.\s0
-.IP "\fB\-\-no\-icon\fR" 4
+Specify this option to disable this part of the resulting XML.
+.IP \fB\-\-no\-icon\fR 4
.IX Item "--no-icon"
-By default the output of virt-inspector includes the icon of the guest, if available (see \*(L"icon\*(R").
+By default the output of virt-inspector includes the icon of the guest, if available (see "icon").
.Sp
-Specify this option to disable this part of the resulting \s-1XML.\s0
-.IP "\fB\-v\fR" 4
+Specify this option to disable this part of the resulting XML.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
+libguestfs API 呼び出しのトレースを有効にします。
.IP "\fB\-\-xpath\fR query" 4
.IX Item "--xpath query"
-Perform an XPath query on the \s-1XML\s0 on stdin, and print the result on stdout. In this mode virt-inspector simply runs an XPath query; all other inspection functions are disabled. See \*(L"\s-1XPATH QUERIES\*(R"\s0 below for some examples.
-.SH "旧形式のコマンドライン引数"
+Perform an XPath query on the XML on stdin, and print the result on stdout. In this mode virt-inspector simply runs an XPath query; all other inspection functions are disabled. See "XPATH QUERIES" below for some examples.
+.SH 旧形式のコマンドライン引数
.IX Header "旧形式のコマンドライン引数"
Previous versions of virt-inspector allowed you to write either:
.PP
互換性のため古い形式がまだサポートされています。
.SH "XML フォーマット"
.IX Header "XML フォーマット"
-The virt-inspector \s-1XML\s0 is described precisely in a \s-1RELAX NG\s0 schema file \fIvirt\-inspector.rng\fR which is supplied with libguestfs. This section is just an overview.
+The virt-inspector XML is described precisely in a RELAX NG schema file \fIvirt\-inspector.rng\fR which is supplied with libguestfs. This section is just an overview.
.PP
The top-level element is <operatingsystems>, and it contains one or more <operatingsystem> elements. You would only see more than one <operatingsystem> element if the virtual machine is multi-boot, which is vanishingly rare in real world VMs.
-.SS "<operatingsystem>"
+.SS <operatingsystem>
.IX Subsection "<operatingsystem>"
-In the <operatingsystem> tag are various optional fields that describe the operating system, its architecture, the descriptive \*(L"product name\*(R" string, the type of \s-1OS\s0 and so on, as in this example:
+In the <operatingsystem> tag are various optional fields that describe the operating system, its architecture, the descriptive "product name" string, the type of OS and so on, as in this example:
.PP
.Vb 11
\& <operatingsystems>
\& <windows_systemroot>/Windows</windows_systemroot>
.Ve
.PP
-In brief, <name> is the class of operating system (something like \f(CW\*(C`linux\*(C'\fR or \f(CW\*(C`windows\*(C'\fR), <distro> is the distribution (eg. \f(CW\*(C`fedora\*(C'\fR but many other distros are recognized) and <arch> is the guest architecture. The other fields are fairly self-explanatory, but because these fields are taken directly from the libguestfs inspection \s-1API\s0 you can find precise information from \*(L"\s-1INSPECTION\*(R"\s0 in \fBguestfs\fR\|(3).
+In brief, <name> is the class of operating system (something like \f(CW\*(C`linux\*(C'\fR or \f(CW\*(C`windows\*(C'\fR), <distro> is the distribution (eg. \f(CW\*(C`fedora\*(C'\fR but many other distros are recognized) and <arch> is the guest architecture. The other fields are fairly self-explanatory, but because these fields are taken directly from the libguestfs inspection API you can find precise information from "INSPECTION" in \fBguestfs\fR\|(3).
.PP
-The <root> element is the root filesystem device, but from the point of view of libguestfs (block devices may have completely different names inside the \s-1VM\s0 itself).
-.SS "<mountpoints>"
+The <root> element is the root filesystem device, but from the point of view of libguestfs (block devices may have completely different names inside the VM itself).
+.SS <mountpoints>
.IX Subsection "<mountpoints>"
Un*x\-like guests typically have multiple filesystems which are mounted at various mountpoints, and these are described in the <mountpoints> element which looks like this:
.PP
.Ve
.PP
As with <root>, devices are from the point of view of libguestfs, and may have completely different names inside the guest. Only mountable filesystems appear in this list, not things like swap devices.
-.SS "<filesystems>"
+.SS <filesystems>
.IX Subsection "<filesystems>"
-<filesystems> is like <mountpoints> but covers \fIall\fR filesystems belonging to the guest, including swap and empty partitions. (In the rare case of a multi-boot guest, it covers filesystems belonging to this \s-1OS\s0 or shared with this \s-1OS\s0 and other OSes).
+<filesystems> is like <mountpoints> but covers \fIall\fR filesystems belonging to the guest, including swap and empty partitions. (In the rare case of a multi-boot guest, it covers filesystems belonging to this OS or shared with this OS and other OSes).
.PP
次のように表示されることがあります:
.PP
\& </filesystem>
.Ve
.PP
-The optional elements within <filesystem> are the filesystem type, the label, and the \s-1UUID.\s0
-.SS "<applications>"
+The optional elements within <filesystem> are the filesystem type, the label, and the UUID.
+.SS <applications>
.IX Subsection "<applications>"
関連する要素 <package_format>, <package_management> および <applications> は仮想マシンにインストールされたアプリケーションを記述しています。
.PP
\& </application>
.Ve
.PP
-The version and release fields may not be available for some types guests. Other fields are possible, see \*(L"guestfs_inspect_list_applications\*(R" in \fBguestfs\fR\|(3).
-.SS "<drive_mappings>"
+The version and release fields may not be available for some types guests. Other fields are possible, see "guestfs_inspect_list_applications" in \fBguestfs\fR\|(3).
+.SS <drive_mappings>
.IX Subsection "<drive_mappings>"
For operating systems like Windows which use drive letters, virt-inspector is able to find out how drive letters map to filesystems.
.PP
.PP
In the example above, drive C maps to the filesystem on the second partition on the first disk, and drive E maps to the filesystem on the first partition on the second disk.
.PP
-Note that this only covers permanent local filesystem mappings, not things like network shares. Furthermore \s-1NTFS\s0 volume mount points may not be listed here.
-.SS "<icon>"
+Note that this only covers permanent local filesystem mappings, not things like network shares. Furthermore NTFS volume mount points may not be listed here.
+.SS <icon>
.IX Subsection "<icon>"
-Virt-inspector is sometimes able to extract an icon or logo for the guest. The icon is returned as base64\-encoded \s-1PNG\s0 data. Note that the icon can be very large and high quality.
+Virt-inspector is sometimes able to extract an icon or logo for the guest. The icon is returned as base64\-encoded PNG data. Note that the icon can be very large and high quality.
.PP
.Vb 7
\& <operatingsystems>
\& </icon>
.Ve
.PP
-To display the icon, you have to extract it and convert the base64 data back to a binary file. Use an XPath query or simply an editor to extract the data, then use the coreutils \fBbase64\fR\|(1) program to do the conversion back to a \s-1PNG\s0 file:
+To display the icon, you have to extract it and convert the base64 data back to a binary file. Use an XPath query or simply an editor to extract the data, then use the coreutils \fBbase64\fR\|(1) program to do the conversion back to a PNG file:
.PP
.Vb 1
\& base64 \-i \-d < icon.data > icon.png
.IX Header "XPath クエリー"
Virt-inspector includes built in support for running XPath queries. The reason for including XPath support directly in virt-inspector is simply that there are no good and widely available command line programs that can do XPath queries. The only good one is \fBxmlstarlet\fR\|(1) and that is not available on Red Hat Enterprise Linux.
.PP
-To perform an XPath query, use the \fI\-\-xpath\fR option. Note that in this mode, virt-inspector simply reads \s-1XML\s0 from stdin and outputs the query result on stdout. All other inspection features are disabled in this mode.
+To perform an XPath query, use the \fI\-\-xpath\fR option. Note that in this mode, virt-inspector simply reads XML from stdin and outputs the query result on stdout. All other inspection features are disabled in this mode.
.PP
例:
.PP
.IX Header "GETTING INSPECTION DATA FROM THE LIBGUESTFS API"
In early versions of libguestfs, virt-inspector was a large Perl script that contained many heuristics for inspecting guests. This had several problems: in order to do inspection from other tools (like guestfish) we had to call out to this Perl script; and it privileged Perl over other languages that libguestfs supports.
.PP
-By libguestfs 1.8 we had rewritten the Perl code in C, and incorporated it all into the core libguestfs \s-1API\s0 (\fBguestfs\fR\|(3)). Now virt-inspector is simply a thin C program over the core C \s-1API.\s0 All of the inspection information is available from all programming languages that libguestfs supports, and from guestfish.
+By libguestfs 1.8 we had rewritten the Perl code in C, and incorporated it all into the core libguestfs API (\fBguestfs\fR\|(3)). Now virt-inspector is simply a thin C program over the core C API. All of the inspection information is available from all programming languages that libguestfs supports, and from guestfish.
.PP
-For a description of the C inspection \s-1API,\s0 read \*(L"\s-1INSPECTION\*(R"\s0 in \fBguestfs\fR\|(3).
+For a description of the C inspection API, read "INSPECTION" in \fBguestfs\fR\|(3).
.PP
-For example code using the C inspection \s-1API,\s0 look for \fIinspect\-vm.c\fR which ships with libguestfs.
+For example code using the C inspection API, look for \fIinspect\-vm.c\fR which ships with libguestfs.
.PP
-\&\fIinspect\-vm.c\fR has also been translated into other languages. For example, \fIinspect_vm.pl\fR is the Perl translation, and there are other translations for OCaml, Python, etc. See \*(L"\s-1USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES\*(R"\s0 in \fBguestfs\fR\|(3) for a list of man pages which contain this example code.
-.SS "\s-1GETTING INSPECTION DATA FROM GUESTFISH\s0"
+\&\fIinspect\-vm.c\fR has also been translated into other languages. For example, \fIinspect_vm.pl\fR is the Perl translation, and there are other translations for OCaml, Python, etc. See "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" in \fBguestfs\fR\|(3) for a list of man pages which contain this example code.
+.SS "GETTING INSPECTION DATA FROM GUESTFISH"
.IX Subsection "GETTING INSPECTION DATA FROM GUESTFISH"
-If you use the guestfish \fI\-i\fR option, then the main C inspection \s-1API\s0 \*(L"guestfs_inspect_os\*(R" in \fBguestfs\fR\|(3) is called. This is equivalent to the guestfish command \f(CW\*(C`inspect\-os\*(C'\fR. You can also call this guestfish command by hand.
+If you use the guestfish \fI\-i\fR option, then the main C inspection API "guestfs_inspect_os" in \fBguestfs\fR\|(3) is called. This is equivalent to the guestfish command \f(CW\*(C`inspect\-os\*(C'\fR. You can also call this guestfish command by hand.
.PP
-\&\f(CW\*(C`inspect\-os\*(C'\fR performs inspection on the current disk image, returning the list of operating systems found. Each \s-1OS\s0 is represented by its root filesystem device. In the majority of cases, this command prints nothing (no OSes found), or a single root device, but beware that it can print multiple lines if there are multiple OSes or if there is an install \s-1CD\s0 attached to the guest.
+\&\f(CW\*(C`inspect\-os\*(C'\fR performs inspection on the current disk image, returning the list of operating systems found. Each OS is represented by its root filesystem device. In the majority of cases, this command prints nothing (no OSes found), or a single root device, but beware that it can print multiple lines if there are multiple OSes or if there is an install CD attached to the guest.
.PP
.Vb 4
\& $ guestfish \-\-ro \-a F15x32.img
\& Fedora release 15 (Lovelock)
.Ve
.PP
-Limitations of guestfish make it hard to assign the root device to a variable (since guestfish doesn't have variables), so if you want to do this reproducibly you are better off writing a script using one of the other languages that the libguestfs \s-1API\s0 supports.
+Limitations of guestfish make it hard to assign the root device to a variable (since guestfish doesn't have variables), so if you want to do this reproducibly you are better off writing a script using one of the other languages that the libguestfs API supports.
.PP
アプリケーションを一覧表示するには、まずディスクをマウントする必要があります:
.PP
\& ><fs> mount\-ro /dev/vda1 /boot
.Ve
.PP
-and then call the inspect-list-applications \s-1API:\s0
+and then call the inspect-list-applications API:
.PP
.Vb 10
\& ><fs> inspect\-list\-applications /dev/vg_f15x32/lv_root | head \-28
.Ve
.SH "古いバージョンの virt-inspector"
.IX Header "古いバージョンの virt-inspector"
-As described above, early versions of libguestfs shipped with a different virt-inspector program written in Perl (the current version is written in C). The \s-1XML\s0 output of the Perl virt-inspector was different and it could also output in other formats like text.
+As described above, early versions of libguestfs shipped with a different virt-inspector program written in Perl (the current version is written in C). The XML output of the Perl virt-inspector was different and it could also output in other formats like text.
.PP
古い virt-inspector はもはや libguestfs でサポートされず、同梱されていません。
.PP
\& virt\-inspector 古い Perl バージョンです。
\& virt\-inspector2 新しい C バージョンです。
.Ve
-.SH "終了ステータス"
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), http://www.w3.org/TR/xpath/, \fBbase64\fR\|(1), \fBxmlstarlet\fR\|(1), \fBvirt\-drivers\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
-.IP "\(bu" 4
+.IP \(bu 4
Richard W.M. Jones http://people.redhat.com/~rjones/
-.IP "\(bu" 4
+.IP \(bu 4
Matthew Booth mbooth@redhat.com
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-log 1"
-.TH virt-log 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-log 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-log \- Display log files from a virtual machine
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-log [\-\-options] \-d domname
\&
\& virt\-log [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\f(CW\*(C`virt\-log\*(C'\fR is a command line tool to display the log files from the named virtual machine (or disk image).
.PP
This tool understands and displays both plain text log files (eg. \fI/var/log/messages\fR) and binary formats such as the systemd journal.
.PP
To display other types of files, use \fBvirt\-cat\fR\|(1). To follow (tail) text log files, use \fBvirt\-tail\fR\|(1). To copy files out of a virtual machine, use \fBvirt\-copy\-out\fR\|(1). To display the contents of the Windows Registry, use \fBvirt\-win\-reg\fR\|(1).
-.SH "例"
+.SH 例
.IX Header "例"
Display the complete logs from a guest:
.PP
\& virt\-log \-d mydomain | less
.Ve
.PP
-仮想マシンが取得している \s-1DHCP IP\s0 アドレスを発見するには:
+仮想マシンが取得している DHCP IP アドレスを発見するには:
.PP
.Vb 1
\& virt\-log \-d mydomain | grep \*(Aqdhclient.*bound to\*(Aq
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a \s-1URI\s0\fR" 4
+.IP "\fB\-a URI\fR" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add \s-1URI\s0\fR" 4
+.IP "\fB\-\-add URI\fR" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-c\fR \s-1URI\s0" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-log normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "終了ステータス"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-tail\fR\|(1), \fBvirt\-tar\-out\fR\|(1), \fBvirt\-win\-reg\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-ls 1"
-.TH virt-ls 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-ls 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-ls \- 仮想マシンのファイルの一覧表示
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-ls [\-\-options] \-d domname directory [directory ...]
\&
\& virt\-ls [\-\-options] disk.img [disk.img ...] directory
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
\&\f(CW\*(C`virt\-ls\*(C'\fR lists filenames, file sizes, checksums, extended attributes and more from a virtual machine or disk image.
.PP
.PP
To list directories from a libvirt guest use the \fI\-d\fR option to specify the name of the guest. For a disk image, use the \fI\-a\fR option.
.PP
-\&\f(CW\*(C`virt\-ls\*(C'\fR can do many simple file listings. For more complicated cases you may need to use \fBguestfish\fR\|(1), or write a program directly to the \fBguestfs\fR\|(3) \s-1API.\s0
-.SH "例"
+\&\f(CW\*(C`virt\-ls\*(C'\fR can do many simple file listings. For more complicated cases you may need to use \fBguestfish\fR\|(1), or write a program directly to the \fBguestfs\fR\|(3) API.
+.SH 例
.IX Header "例"
仮想マシンにあるファイルおよびディレクトリーをすべて取得します:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest \-\-time\-days / | grep \*(Aq^\-\*(Aq | awk \*(Aq$6 < 1\*(Aq
.Ve
-.SS "\s-1DIFFERENCES IN SNAPSHOTS AND BACKING FILES\s0"
+.SS "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
.IX Subsection "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
Although it is possible to use virt-ls to look for differences, since libguestfs ≥ 1.26 a new tool is available called \fBvirt\-diff\fR\|(1).
-.SH "出力モード"
+.SH 出力モード
.IX Header "出力モード"
\&\f(CW\*(C`virt\-ls\*(C'\fR は 4 つの出力モードがあります。\fI\-l\fR および \fI\-R\fR オプションの異なる組み合わせにより制御されます。
-.SS "簡単な一覧方法"
+.SS 簡単な一覧方法
.IX Subsection "簡単な一覧方法"
簡単な一覧方法は通常の \fBls\fR\|(1) コマンドと似ています:
.PP
\& boot
\& [etc.]
.Ve
-.SS "ロング形式の一覧方法"
+.SS ロング形式の一覧方法
.IX Subsection "ロング形式の一覧方法"
\&\fI\-l\fR (\fI\-\-long\fR) オプションを用いると、出力は \f(CW\*(C`ls \-l\*(C'\fR コマンドのようになります（より具体的には \f(CW\*(C`guestfs_ll\*(C'\fR 関数と似ています）。
.PP
\& [etc.]
.Ve
.PP
-これはディレクトリーを表示するために有用ですが、他のプログラムにおいてこの出力を解析しないよう注意してください。代わりに \*(L"再帰的なロング形式の一覧方法\*(R" を使用してください。
-.SS "再帰的な一覧方法"
+これはディレクトリーを表示するために有用ですが、他のプログラムにおいてこの出力を解析しないよう注意してください。代わりに "再帰的なロング形式の一覧方法" を使用してください。
+.SS 再帰的な一覧方法
.IX Subsection "再帰的な一覧方法"
\&\fI\-R\fR (\fI\-\-recursive\fR) オプションを用いると、\f(CW\*(C`virt\-ls\*(C'\fR はファイルおよびディレクトリーを再帰的に一覧表示します:
.PP
.Ve
.PP
この出力を生成するには、\f(CW\*(C`virt\-ls\*(C'\fR が \f(CW\*(C`guestfs_find0\*(C'\fR 関数を実行して、\f(CW\*(C`\e0\*(C'\fR 文字を \f(CW\*(C`\en\*(C'\fR に変換します。
-.SS "再帰的なロング形式の一覧方法"
+.SS 再帰的なロング形式の一覧方法
.IX Subsection "再帰的なロング形式の一覧方法"
Using \fI\-lR\fR options together changes the output to display directories recursively, with file stats, and optionally other features such as checksums and extended attributes.
.PP
.Ve
.PP
これらの基本的な項目は常に表示されます:
-.IP "type" 4
+.IP type 4
.IX Item "type"
ファイル形式。次のどれかです: \f(CW\*(C`\-\*(C'\fR (通常のファイル), \f(CW\*(C`d\*(C'\fR (ディレクトリー), \f(CW\*(C`c\*(C'\fR (キャラクターデバイス), \f(CW\*(C`b\*(C'\fR (ブロックデバイス), \f(CW\*(C`p\*(C'\fR (名前付きパイプ), \f(CW\*(C`l\*(C'\fR (シンボリックリンク), \f(CW\*(C`s\*(C'\fR (ソケット) or \f(CW\*(C`u\*(C'\fR (不明)。
-.IP "パーミッション" 4
+.IP パーミッション 4
.IX Item "パーミッション"
Unix パーティション。4 桁の8進数として表示されます。
-.IP "容量" 4
+.IP 容量 4
.IX Item "容量"
ファイルの容量。 読みやすい形式の数値として表示する \fI\-h\fR または \fI\-\-human\-readable\fR オプションが指定されていなければ、バイト単位で表示されます。
-.IP "パス" 4
+.IP パス 4
.IX Item "パス"
ファイルまたはディレクトリの完全パス。
-.IP "リンク" 4
+.IP リンク 4
.IX Item "リンク"
シンボリックリンクのみに対して、リンク先。
.PP
\&\fI\-lR\fR モードでは、追加のコマンドラインオプションにより、さらなる項目の表示を有効にします。
.PP
\&\fI\-\-uids\fR フラグを用いると、これらの追加項目がパスの前に表示されます:
-.IP "uid" 4
+.IP uid 4
.IX Item "uid"
.PD 0
-.IP "gid" 4
+.IP gid 4
.IX Item "gid"
.PD
-ファイルの所有者の \s-1UID\s0 および \s-1GID\s0 (数値表記)。 これらは Unix 系の仮想マシンにおいてのみ意味があることに注意してください。
+ファイルの所有者の UID および GID (数値表記)。 これらは Unix 系の仮想マシンにおいてのみ意味があることに注意してください。
.PP
\&\fI\-\-times\fR フラグがあると、これらの追加項目が表示されます:
-.IP "atime" 4
+.IP atime 4
.IX Item "atime"
アクセス日時。
-.IP "mtime" 4
+.IP mtime 4
.IX Item "mtime"
最終変更日時。
-.IP "ctime" 4
+.IP ctime 4
.IX Item "ctime"
最終属性変更日時。
.PP
\&\fI\-\-time\-t\fR, \fI\-\-time\-relative\fR または \fI\-\-time\-days\fR フラグのどれかが指定されていなければ、日付と時間の文字列として time 項目が表示されます。
.PP
\&\fI\-\-extra\-stats\fR フラグを用いると、これらの追加項目が表示されます:
-.IP "device" 4
+.IP device 4
.IX Item "device"
The device containing the file (displayed as major:minor). This may not match devices as known to the guest.
-.IP "inode" 4
+.IP inode 4
.IX Item "inode"
inode 番号。
-.IP "nlink" 4
+.IP nlink 4
.IX Item "nlink"
ハードリンク数。
-.IP "rdev" 4
+.IP rdev 4
.IX Item "rdev"
ブロックおよびキャラクタースペシャルファイルに対する、デバイス (メジャー:マイナーとして表示)。
-.IP "ブロック" 4
+.IP ブロック 4
.IX Item "ブロック"
ファイルに割り当てられた 512 バイトブロック数。
.PP
With the \fI\-\-checksum\fR flag, the checksum of the file contents is shown (only for regular files). Computing file checksums can take a considerable amount of time.
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
Add \fIfile\fR which should be a disk image from a virtual machine. If the virtual machine has multiple block devices, you must supply all of them with separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 \fI\-\-format=..\fR オプションを使用します。
-.IP "\fB\-a \s-1URI\s0\fR" 4
+.IP "\fB\-a URI\fR" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add \s-1URI\s0\fR" 4
+.IP "\fB\-\-add URI\fR" 4
.IX Item "--add URI"
.PD
-リモートディスクを追加します。 \*(L"リモートストレージの追加\*(R" in \fBguestfish\fR\|(1) 参照。
-.IP "\fB\-\-blocksize=512\fR" 4
+リモートディスクを追加します。 "リモートストレージの追加" in \fBguestfish\fR\|(1) 参照。
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-checksum\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-checksum\fR 4
.IX Item "--checksum"
.PD 0
-.IP "\fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR" 4
+.IP \fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
Display checksum over file contents for regular files. With no argument, this defaults to using \fImd5\fR. Using an argument, you can select the checksum type to use.
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-c\fR \s-1URI\s0" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Write out the results in \s-1CSV\s0 format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read \*(L"\s-1NOTE ABOUT CSV FORMAT\*(R"\s0 below.
+Write out the results in CSV format (comma-separated values). This format can be imported easily into databases and spreadsheets, but read "NOTE ABOUT CSV FORMAT" below.
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-\-echo\-keys\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
キーやパスフレーズを入力するとき、通常 virt-ls はエコーを無効化します。 そのため、入力内容を確認できません。 テンペスト攻撃の心配がなく、 部屋に誰も居なければ、 入力内容を確認するためにこのフラグを指定できます。
-.IP "\fB\-\-extra\-stats\fR" 4
+.IP \fB\-\-extra\-stats\fR 4
.IX Item "--extra-stats"
Display extra stats.
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することにより、コマンドラインで後続の \fI\-a\fR オプションのディスク形式を強制的に指定できます。 引数なしで \fI\-\-format\fR を使用することにより、 後続の \fI\-a\fR オプションに対して自動検知に戻せます。
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-h\fR" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
読みやすい形式でファイル容量を表示します。
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Specifying any mountpoint disables the inspection of the guest and the mount of its root and all of its mountpoints, so make sure to mount all the mountpoints needed to work with the filenames given as arguments.
.Sp
-If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" and \*(L"lvs\*(R" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
+If you don’t know what filesystems a disk image contains, you can either run guestfish without this option, then list the partitions, filesystems and LVs available (see "list-partitions", "list-filesystems" and "lvs" commands), or you can use the \fBvirt\-filesystems\fR\|(1) program.
.Sp
マウントパラメーターの三番目の (ほとんど使用されない) 項目は、 バックエンドのファイルシステムをマウントするために使用される マウントオプションの一覧です。 これが指定されていない場合、 マウントオプションは空文字列または \f(CW\*(C`ro\*(C'\fR (\fI\-\-ro\fR フラグが使用されている場合) になります。
.Sp
このフラグを使用することは、 \f(CW\*(C`mount\-options\*(C'\fR コマンドを使用することと同等です。
.Sp
パラメーターの四番目の項目は使用するファイルシステムドライバー (\f(CW\*(C`ext3\*(C'\fR や \f(CW\*(C`ntfs\*(C'\fR など) です。 これはほとんど必要ありません。 しかし、複数のドライバーがファイルシステムに対して有効である場合 (例: \f(CW\*(C`ext2\*(C'\fR と \f(CW\*(C`ext3\*(C'\fR)、 または libguestfs がファイルシステムを誤検知している場合、 これは有用です。
-.IP "\fB\-l\fR" 4
+.IP \fB\-l\fR 4
.IX Item "-l"
.PD 0
-.IP "\fB\-\-long\fR" 4
+.IP \fB\-\-long\fR 4
.IX Item "--long"
-.IP "\fB\-R\fR" 4
+.IP \fB\-R\fR 4
.IX Item "-R"
-.IP "\fB\-\-recursive\fR" 4
+.IP \fB\-\-recursive\fR 4
.IX Item "--recursive"
.PD
-Select the mode. With neither of these options, \f(CW\*(C`virt\-ls\*(C'\fR produces a simple, flat list of the files in the named directory. See \*(L"\s-1SIMPLE LISTING\*(R"\s0.
+Select the mode. With neither of these options, \f(CW\*(C`virt\-ls\*(C'\fR produces a simple, flat list of the files in the named directory. See "SIMPLE LISTING".
.Sp
-\&\f(CW\*(C`virt\-ls \-l\*(C'\fR produces a \*(L"long listing\*(R", which shows more detail. See \*(L"\s-1LONG LISTING\*(R"\s0.
+\&\f(CW\*(C`virt\-ls \-l\*(C'\fR produces a "long listing", which shows more detail. See "LONG LISTING".
.Sp
-\&\f(CW\*(C`virt\-ls \-R\*(C'\fR produces a recursive list of files starting at the named directory. See \*(L"\s-1RECURSIVE LISTING\*(R"\s0.
+\&\f(CW\*(C`virt\-ls \-R\*(C'\fR produces a recursive list of files starting at the named directory. See "RECURSIVE LISTING".
.Sp
-\&\f(CW\*(C`virt\-ls \-lR\*(C'\fR produces a recursive long listing which can be more easily parsed. See \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0.
-.IP "\fB\-\-times\fR" 4
+\&\f(CW\*(C`virt\-ls \-lR\*(C'\fR produces a recursive long listing which can be more easily parsed. See "RECURSIVE LONG LISTING".
+.IP \fB\-\-times\fR 4
.IX Item "--times"
時間の項目を表示します。
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-time\-days\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-\-time\-days\fR 4
.IX Item "--time-days"
Display time fields as days before now (negative if in the future).
.Sp
-Note that \f(CW0\fR in output means \*(L"up to 1 day before now\*(R", or that the age of the file is between 0 and 86399 seconds.
+Note that \f(CW0\fR in output means "up to 1 day before now", or that the age of the file is between 0 and 86399 seconds.
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-time\-relative\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-\-time\-relative\fR 4
.IX Item "--time-relative"
Display time fields as seconds before now (negative if in the future).
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-time\-t\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-\-time\-t\fR 4
.IX Item "--time-t"
Display time fields as seconds since the Unix epoch.
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-\-uids\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-\-uids\fR 4
.IX Item "--uids"
-\&\s-1UID\s0 と \s-1GID\s0 の項目を表示します。
+UID と GID の項目を表示します。
.Sp
-このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0 参照。
-.IP "\fB\-v\fR" 4
+このオプションは \fI\-lR\fR 出力モードにおいてのみ効果があります。 上の "RECURSIVE LONG LISTING" 参照。
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "旧形式のコマンドライン引数"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH 旧形式のコマンドライン引数
.IX Header "旧形式のコマンドライン引数"
前のバージョンの virt-ls により、次のどちらも書くことができます:
.PP
互換性のため古い形式がまだサポートされています。
.SH "CSV 形式に関する注意"
.IX Header "CSV 形式に関する注意"
-Comma-separated values (\s-1CSV\s0) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
+Comma-separated values (CSV) is a deceptive format. It \fIseems\fR like it should be easy to parse, but it is definitely not easy to parse.
.PP
神話: ただコンマで項目を区切る。 真実: これは正しく動き \fIません\fR。この例は 2 つの列があります:
.PP
.PP
For shell scripts, use \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv also packaged in major Linux distributions).
.PP
-For other languages, use a \s-1CSV\s0 processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
+For other languages, use a CSV processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl or Python’s built-in csv library).
.PP
-Most spreadsheets and databases can import \s-1CSV\s0 directly.
-.SH "終了ステータス"
+Most spreadsheets and databases can import CSV directly.
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-diff\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-make-fs 1"
-.TH virt-make-fs 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-make-fs 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-make-fs \- tar アーカイブまたはファイルからファイルシステムの作成
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-make\-fs [\-\-options] input.tar output.img
\&
\& virt\-make\-fs [\-\-options] directory output.img
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
-Virt-make-fs is a command line tool for creating a filesystem from a tar archive or some files in a directory. It is similar to tools like \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1) and \fBmksquashfs\fR\|(1). Unlike those tools, it can create common filesystem types like ext2/3 or \s-1NTFS,\s0 which can be useful if you want to attach these filesystems to existing virtual machines (eg. to import large amounts of read-only data to a \s-1VM\s0).
+Virt-make-fs is a command line tool for creating a filesystem from a tar archive or some files in a directory. It is similar to tools like \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1) and \fBmksquashfs\fR\|(1). Unlike those tools, it can create common filesystem types like ext2/3 or NTFS, which can be useful if you want to attach these filesystems to existing virtual machines (eg. to import large amounts of read-only data to a VM).
.PP
To create blank disks, use \fBvirt\-format\fR\|(1). To create complex layouts, use \fBguestfish\fR\|(1).
.PP
\& virt\-make\-fs input output.img
.Ve
.PP
-where \f(CW\*(C`input\*(C'\fR is either a directory containing files that you want to add, or a tar archive (either uncompressed tar or gzip-compressed tar); and \fIoutput.img\fR is a disk image. The input type is detected automatically. The output disk image defaults to a raw ext2 sparse image unless you specify extra flags (see \*(L"\s-1OPTIONS\*(R"\s0 below).
-.SS "ファイルシステム形式"
+where \f(CW\*(C`input\*(C'\fR is either a directory containing files that you want to add, or a tar archive (either uncompressed tar or gzip-compressed tar); and \fIoutput.img\fR is a disk image. The input type is detected automatically. The output disk image defaults to a raw ext2 sparse image unless you specify extra flags (see "OPTIONS" below).
+.SS ファイルシステム形式
.IX Subsection "ファイルシステム形式"
-The default filesystem type is \f(CW\*(C`ext2\*(C'\fR. Just about any filesystem type that libguestfs supports can be used (but \fInot\fR read-only formats like \s-1ISO9660\s0). Here are some of the more common choices:
-.IP "\fIext3\fR" 4
+The default filesystem type is \f(CW\*(C`ext2\*(C'\fR. Just about any filesystem type that libguestfs supports can be used (but \fInot\fR read-only formats like ISO9660). Here are some of the more common choices:
+.IP \fIext3\fR 4
.IX Item "ext3"
-Note that ext3 filesystems contain a journal, typically 1\-32 \s-1MB\s0 in size. If you are not going to use the filesystem in a way that requires the journal, then this is just wasted overhead.
+Note that ext3 filesystems contain a journal, typically 1\-32 MB in size. If you are not going to use the filesystem in a way that requires the journal, then this is just wasted overhead.
.IP "\fIntfs\fR または \fIvfat\fR" 4
.IX Item "ntfs または vfat"
Useful if exporting data to a Windows guest.
-.IP "\fIminix\fR" 4
+.IP \fIminix\fR 4
.IX Item "minix"
Lower overhead than \f(CW\*(C`ext2\*(C'\fR, but certain limitations on filename length and total filesystem size.
.PP
.Vb 1
\& virt\-make\-fs \-\-type=minix input minixfs.img
.Ve
-.SS "\s-1TO PARTITION OR NOT TO PARTITION\s0"
+.SS "TO PARTITION OR NOT TO PARTITION"
.IX Subsection "TO PARTITION OR NOT TO PARTITION"
Optionally virt-make-fs can add a partition table to the output disk.
.PP
\fI例\fR
.IX Subsection "例"
.PP
-\&\s-1MBR\s0 パーティションを追加します:
+MBR パーティションを追加します:
.PP
.Vb 1
\& virt\-make\-fs \-\-partition \-\- input disk.img
.Vb 1
\& virt\-make\-fs \-\-partition=gpt \-\-size=+4T \-\-format=qcow2 input disk.img
.Ve
-.SS "\s-1EXTRA SPACE\s0"
+.SS "EXTRA SPACE"
.IX Subsection "EXTRA SPACE"
-Unlike formats such as tar and squashfs, a filesystem does not \*(L"just fit\*(R" the files that it contains, but might have extra space. Depending on how you are going to use the output, you might think this extra space is wasted and want to minimize it, or you might want to leave space so that more files can be added later. Virt-make-fs defaults to minimizing the extra space, but you can use the \fI\-\-size\fR flag to leave space in the filesystem if you want it.
+Unlike formats such as tar and squashfs, a filesystem does not "just fit" the files that it contains, but might have extra space. Depending on how you are going to use the output, you might think this extra space is wasted and want to minimize it, or you might want to leave space so that more files can be added later. Virt-make-fs defaults to minimizing the extra space, but you can use the \fI\-\-size\fR flag to leave space in the filesystem if you want it.
.PP
-An alternative way to leave extra space but not make the output image any bigger is to use an alternative disk image format (instead of the default \*(L"raw\*(R" format). Using \fI\-\-format=qcow2\fR will use the native qemu/KVM qcow2 image format (check your hypervisor supports this before using it). This allows you to choose a large \fI\-\-size\fR but the extra space won't actually be allocated in the image until you try to store something in it.
+An alternative way to leave extra space but not make the output image any bigger is to use an alternative disk image format (instead of the default "raw" format). Using \fI\-\-format=qcow2\fR will use the native qemu/KVM qcow2 image format (check your hypervisor supports this before using it). This allows you to choose a large \fI\-\-size\fR but the extra space won't actually be allocated in the image until you try to store something in it.
.PP
Don’t forget that you can also use local commands including \fBresize2fs\fR\|(8) and \fBvirt\-resize\fR\|(1) to resize existing filesystems, or rerun virt-make-fs to build another image from scratch.
.PP
.Vb 1
\& virt\-make\-fs \-\-format=qcow2 \-\-size=+200M input output.img
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
.PD
This parameter sets the sector size of the output disk image.
.Sp
The default is \f(CW512\fR bytes.
.Sp
-See also \*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-floppy\fR" 4
+See also "guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-floppy\fR 4
.IX Item "--floppy"
仮想フロッピーディスクを作成します。
.Sp
-今のところ、容量 (1440K)、パーティション形式 (\s-1MBR\s0) およびファイルシステム形式 (\s-1VFAT\s0) が事前に選択されています。将来的に、ジオメトリーを選択できるようになる可能性があります。
-.IP "\fB\-\-size=\fRN" 4
+今のところ、容量 (1440K)、パーティション形式 (MBR) およびファイルシステム形式 (VFAT) が事前に選択されています。将来的に、ジオメトリーを選択できるようになる可能性があります。
+.IP \fB\-\-size=\fRN 4
.IX Item "--size=N"
.PD 0
-.IP "\fB\-\-size=+\fRN" 4
+.IP \fB\-\-size=+\fRN 4
.IX Item "--size=+N"
.IP "\fB\-s\fR N" 4
.IX Item "-s N"
.Sp
To choose a fixed size output disk, specify an absolute number followed by b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or Exabytes. This must be large enough to contain all the input files, else you will get an error.
.Sp
-To leave extra space, specify \f(CW\*(C`+\*(C'\fR (plus sign) and a number followed by b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or Exabytes. For example: \fI\-\-size=+200M\fR means enough space for the input files, and (approximately) an extra 200 \s-1MB\s0 free space.
+To leave extra space, specify \f(CW\*(C`+\*(C'\fR (plus sign) and a number followed by b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or Exabytes. For example: \fI\-\-size=+200M\fR means enough space for the input files, and (approximately) an extra 200 MB free space.
.Sp
Note that virt-make-fs estimates free space, and therefore will not produce filesystems containing precisely the free space requested. (It is much more expensive and time-consuming to produce a filesystem which has precisely the desired free space).
-.IP "\fB\-\-format=\fR\s-1FMT\s0" 4
+.IP \fB\-\-format=\fRFMT 4
.IX Item "--format=FMT"
.PD 0
-.IP "\fB\-F\fR \s-1FMT\s0" 4
+.IP "\fB\-F\fR FMT" 4
.IX Item "-F FMT"
.PD
出力するディスクイメージ形式を選択します。
.Sp
デフォルトは \f(CW\*(C`raw\*(C'\fR です (スパースな raw 形式のディスクイメージ)。
-.IP "\fB\-\-type=\fR\s-1FS\s0" 4
+.IP \fB\-\-type=\fRFS 4
.IX Item "--type=FS"
.PD 0
-.IP "\fB\-t\fR \s-1FS\s0" 4
+.IP "\fB\-t\fR FS" 4
.IX Item "-t FS"
.PD
出力ファイルシステム形式を選択します。
デフォルトは \f(CW\*(C`ext2\*(C'\fR です。
.Sp
Any filesystem which is supported read-write by libguestfs can be used here.
-.IP "\fB\-\-label=\fR\s-1LABEL\s0" 4
+.IP \fB\-\-label=\fRLABEL 4
.IX Item "--label=LABEL"
Set the filesystem label.
-.IP "\fB\-\-partition\fR" 4
+.IP \fB\-\-partition\fR 4
.IX Item "--partition"
.PD 0
-.IP "\fB\-\-partition=\fR\s-1PARTTYPE\s0" 4
+.IP \fB\-\-partition=\fRPARTTYPE 4
.IX Item "--partition=PARTTYPE"
.PD
-このフラグが指定されていると、出力ディスクイメージに \s-1MBR\s0 パーティションテーブルを追加します。
+このフラグが指定されていると、出力ディスクイメージに MBR パーティションテーブルを追加します。
.Sp
You can change the partition table type, eg. \fI\-\-partition=gpt\fR for large disks.
.Sp
-For \s-1MBR,\s0 virt-make-fs sets the partition type byte automatically.
-.IP "\fB\-v\fR" 4
+For MBR, virt-make-fs sets the partition type byte automatically.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ情報を有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Enable libguestfs trace.
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfish\fR\|(1), \fBvirt\-format\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-tar\-in\fR\|(1), \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1), \fBmksquashfs\fR\|(1), \fBmke2fs\fR\|(8), \fBresize2fs\fR\|(8), \fBguestfs\fR\|(3), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-resize 1"
-.TH virt-resize 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-resize 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-resize \- 仮想マシンのディスクの容量変更
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 3
\& virt\-resize [\-\-resize /dev/sdaN=[+/\-]<size>[%]]
\& [\-\-expand /dev/sdaN] [\-\-shrink /dev/sdaN]
\& [\-\-ignore /dev/sdaN] [\-\-delete /dev/sdaN] [...] indisk outdisk
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
Virt-resize is a tool which can resize a virtual machine disk, making it larger or smaller overall, and resizing or deleting any partitions contained within.
.PP
Virt-resize \fBcannot\fR resize disk images in-place. Virt-resize \fBshould not\fR be used on live virtual machines \- for consistent results, shut the virtual machine down before resizing it.
.PP
If you are not familiar with the associated tools: \fBvirt\-filesystems\fR\|(1) and \fBvirt\-df\fR\|(1), we recommend you go and read those manual pages first.
-.SH "例"
+.SH 例
.IX Header "例"
-.IP "1." 4
+.IP 1. 4
This example takes \f(CW\*(C`olddisk\*(C'\fR and resizes it into \f(CW\*(C`newdisk\*(C'\fR, extending one of the guest’s partitions to fill the extra 5GB of space:
.Sp
.Vb 1
\& # "/dev/sda2" は "olddisk" ファイルの中にあるパーティションであることに注意してください。
\& virt\-resize \-\-expand /dev/sda2 olddisk newdisk
.Ve
-.IP "2." 4
+.IP 2. 4
As above, but make the /boot partition 200MB bigger, while giving the remaining space to /dev/sda2:
.Sp
.Vb 2
\& virt\-resize \-\-resize /dev/sda1=+200M \-\-expand /dev/sda2 \e
\& olddisk newdisk
.Ve
-.IP "3." 4
-As in the first example, but expand a logical volume as the final step. This is what you would typically use for Linux guests that use \s-1LVM:\s0
+.IP 3. 4
+As in the first example, but expand a logical volume as the final step. This is what you would typically use for Linux guests that use LVM:
.Sp
.Vb 2
\& virt\-resize \-\-expand /dev/sda2 \-\-LV\-expand /dev/vg_guest/lv_root \e
\& olddisk newdisk
.Ve
-.IP "4." 4
+.IP 4. 4
As in the first example, but the output format will be qcow2 instead of a raw disk:
.Sp
.Vb 2
\& qemu\-img create \-f qcow2 \-o preallocation=metadata newdisk.qcow2 15G
\& virt\-resize \-\-expand /dev/sda2 olddisk newdisk.qcow2
.Ve
-.SH "詳細な使用法"
+.SH 詳細な使用法
.IX Header "詳細な使用法"
-.SS "仮想マシンのディスクの拡張方法"
+.SS 仮想マシンのディスクの拡張方法
.IX Subsection "仮想マシンのディスクの拡張方法"
.IP "1. 仮想マシンをシャットダウンします" 4
.IX Item "1. 仮想マシンをシャットダウンします"
\& /dev/sda device 8.0G \-
.Ve
.Sp
-(This example is a virtual machine with an 8 \s-1GB\s0 disk which we would like to expand up to 10 \s-1GB\s0).
+(This example is a virtual machine with an 8 GB disk which we would like to expand up to 10 GB).
.IP "4. 出力ディスクを作成します" 4
.IX Item "4. 出力ディスクを作成します"
Virt-resize cannot do in-place disk modifications. You have to have space to store the resized output disk.
.Ve
.IP "5. 容量を変更します" 4
.IX Item "5. 容量を変更します"
-virt-resize takes two mandatory parameters, the input disk and the output disk (both can be e.g. a device, a file, or a \s-1URI\s0 to a remote disk). The output disk is the one created in the previous step.
+virt-resize takes two mandatory parameters, the input disk and the output disk (both can be e.g. a device, a file, or a URI to a remote disk). The output disk is the one created in the previous step.
.Sp
.Vb 1
\& # virt\-resize indisk outdisk
.Sp
This command just copies disk image \f(CW\*(C`indisk\*(C'\fR to disk image \f(CW\*(C`outdisk\*(C'\fR \fIwithout\fR resizing or changing any existing partitions. If \f(CW\*(C`outdisk\*(C'\fR is larger, then an extra, empty partition is created at the end of the disk covering the extra space. If \f(CW\*(C`outdisk\*(C'\fR is smaller, then it will give an error.
.Sp
-More realistically you'd want to expand existing partitions in the disk image by passing extra options (for the full list see the \*(L"\s-1OPTIONS\*(R"\s0 section below).
+More realistically you'd want to expand existing partitions in the disk image by passing extra options (for the full list see the "OPTIONS" section below).
.Sp
-\&\*(L"\-\-expand\*(R" is the most useful option. It expands the named partition within the disk to fill any extra space:
+"\-\-expand" is the most useful option. It expands the named partition within the disk to fill any extra space:
.Sp
.Vb 1
\& # virt\-resize \-\-expand /dev/sda2 indisk outdisk
.Sp
(In this case, an extra partition is \fInot\fR created at the end of the disk, because there will be no unused space).
.Sp
-\&\*(L"\-\-resize\*(R" is the other commonly used option. The following would increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the rest of the available space:
+"\-\-resize" is the other commonly used option. The following would increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the rest of the available space:
.Sp
.Vb 2
\& # virt\-resize \-\-resize /dev/sda1=+200M \-\-expand /dev/sda2 \e
\& indisk outdisk
.Ve
.Sp
-If the expanded partition in the image contains a filesystem or \s-1LVM PV,\s0 then if virt-resize knows how, it will resize the contents, the equivalent of calling a command such as \fBpvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8), or \fBresize.f2fs\fR\|(8). However virt-resize does not know how to resize some filesystems, so you would have to online resize them after booting the guest.
+If the expanded partition in the image contains a filesystem or LVM PV, then if virt-resize knows how, it will resize the contents, the equivalent of calling a command such as \fBpvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8), or \fBresize.f2fs\fR\|(8). However virt-resize does not know how to resize some filesystems, so you would have to online resize them after booting the guest.
.Sp
.Vb 1
\& # virt\-resize \-\-expand /dev/sda2 nbd://example.com outdisk
.Ve
.Sp
-The input disk can be a \s-1URI,\s0 in order to use a remote disk as the source. The \s-1URI\s0 format is compatible with guestfish. See \*(L"\s-1ADDING REMOTE STORAGE\*(R"\s0 in \fBguestfish\fR\|(1).
+The input disk can be a URI, in order to use a remote disk as the source. The URI format is compatible with guestfish. See "ADDING REMOTE STORAGE" in \fBguestfish\fR\|(1).
.Sp
他のオプションは以下に記載しています。
.IP "6. テストします" 4
.IX Item "6. テストします"
Thoroughly test the new disk image \fIbefore\fR discarding the old one.
.Sp
-libvirt を使用しているならば、新しいディスクを指し示すよう \s-1XML\s0 を編集します:
+libvirt を使用しているならば、新しいディスクを指し示すよう XML を編集します:
.Sp
.Vb 1
\& # virsh edit guestname
\& # virsh start guestname
.Ve
.Sp
-and check that it still works. See also the \*(L"\s-1NOTES\*(R"\s0 section below for additional information.
+and check that it still works. See also the "NOTES" section below for additional information.
.IP "7. Resize LVs etc inside the guest" 4
.IX Item "7. Resize LVs etc inside the guest"
(This can also be done offline using \fBguestfish\fR\|(1))
.Sp
Once the guest has booted you should see the new space available, at least for filesystems that virt-resize knows how to resize, and for PVs. The user may need to resize LVs inside PVs, and also resize filesystem types that virt-resize does not know how to expand.
-.SS "仮想マシンのディスクの縮小"
+.SS 仮想マシンのディスクの縮小
.IX Subsection "仮想マシンのディスクの縮小"
縮小は拡張よりもいくらか複雑です。ここでは概要のみを示します。
.PP
After shrinking PVs and filesystems, shut down the guest, and proceed with steps 3 and 4 above to allocate a new disk image.
.PP
Then run virt-resize with any of the \fI\-\-shrink\fR and/or \fI\-\-resize\fR options.
-.SS "\s-1IGNORING OR DELETING PARTITIONS\s0"
+.SS "IGNORING OR DELETING PARTITIONS"
.IX Subsection "IGNORING OR DELETING PARTITIONS"
virt-resize also gives a convenient way to ignore or delete partitions when copying from the input disk to the output disk. Ignoring a partition speeds up the copy where you don't care about the existing contents of a partition. Deleting a partition removes it completely, but note that it also renumbers any partitions after the one which is deleted, which can leave some guests unbootable.
-.SS "\s-1QCOW2 AND\s0 NON-SPARSE \s-1RAW FORMATS\s0"
+.SS "QCOW2 AND NON-SPARSE RAW FORMATS"
.IX Subsection "QCOW2 AND NON-SPARSE RAW FORMATS"
If the input disk is in qcow2 format, then you may prefer that the output is in qcow2 format as well. Alternately, virt-resize can convert the format on the fly. The output format is simply determined by the format of the empty output container that you provide. Thus to create qcow2 output, use:
.PP
.Ve
.PP
(on older systems that don’t have the \fBfallocate\fR\|(1) command use \f(CW\*(C`dd if=/dev/zero of=outdisk bs=1M count=..\*(C'\fR)
-.SS "論理パーティション"
+.SS 論理パーティション
.IX Subsection "論理パーティション"
-Logical partitions (a.k.a. \fI/dev/sda5+\fR on disks using \s-1DOS\s0 partition tables) cannot be resized.
+Logical partitions (a.k.a. \fI/dev/sda5+\fR on disks using DOS partition tables) cannot be resized.
.PP
-To understand what is going on, firstly one of the four partitions \fI/dev/sda1\-4\fR will have \s-1MBR\s0 partition type \f(CW05\fR or \f(CW\*(C`0f\*(C'\fR. This is called the \fBextended partition\fR. Use \fBvirt\-filesystems\fR\|(1) to see the \s-1MBR\s0 partition type.
+To understand what is going on, firstly one of the four partitions \fI/dev/sda1\-4\fR will have MBR partition type \f(CW05\fR or \f(CW\*(C`0f\*(C'\fR. This is called the \fBextended partition\fR. Use \fBvirt\-filesystems\fR\|(1) to see the MBR partition type.
.PP
Logical partitions live inside the extended partition.
.PP
The extended partition can be expanded, but not shrunk (unless you force it, which is not advisable). When the extended partition is copied across, all the logical partitions contained inside are copied over implicitly. Virt-resize does not look inside the extended partition, so it copies the logical partitions blindly.
.PP
You cannot specify a logical partition (\fI/dev/sda5+\fR) at all on the command line. Doing so will give an error.
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
ヘルプを表示します。
.IP "\fB\-\-align\-first\fR \fBauto\fR" 4
.RE
.RS 4
.RE
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-d\fR" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
-.IP "\fB\-\-debug\fR" 4
+.IP \fB\-\-debug\fR 4
.IX Item "--debug"
.PD
(Deprecated: use \fI\-v\fR option instead)
.Sp
デバッグメッセージを有効にします。
-.IP "\fB\-\-delete\fR \s-1PART\s0" 4
+.IP "\fB\-\-delete\fR PART" 4
.IX Item "--delete PART"
-Delete the named partition. It would be more accurate to describe this as \*(L"don't copy it over\*(R", since virt-resize doesn't do in-place changes and the original disk image is left intact.
+Delete the named partition. It would be more accurate to describe this as "don't copy it over", since virt-resize doesn't do in-place changes and the original disk image is left intact.
.Sp
Note that when you delete a partition, then anything contained in the partition is also deleted. Furthermore, this causes any partitions that come after to be \fIrenumbered\fR, which can easily make your guest unbootable.
.Sp
このオプションは複数回指定できます。
-.IP "\fB\-\-expand\fR \s-1PART\s0" 4
+.IP "\fB\-\-expand\fR PART" 4
.IX Item "--expand PART"
Expand the named partition so it uses up all extra space (space left over after any other resize changes that you request have been done).
.Sp
-If virt-resize knows how, it will expand the direct content of the partition. For example, if the partition is an \s-1LVM PV,\s0 it will expand the \s-1PV\s0 to fit (like calling \fBpvresize\fR\|(8)). Virt-resize leaves any other content it doesn't know about alone.
+If virt-resize knows how, it will expand the direct content of the partition. For example, if the partition is an LVM PV, it will expand the PV to fit (like calling \fBpvresize\fR\|(8)). Virt-resize leaves any other content it doesn't know about alone.
.Sp
Currently virt-resize can resize:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
ext2, ext3, ext4 ファイルシステム。
-.IP "\(bu" 4
-\&\s-1NTFS\s0 filesystems, if libguestfs was compiled with support for \s-1NTFS.\s0
+.IP \(bu 4
+NTFS filesystems, if libguestfs was compiled with support for NTFS.
.Sp
The filesystem must have been shut down consistently last time it was used. Additionally, \fBntfsresize\fR\|(8) marks the resized filesystem as requiring a consistency check, so at the first boot after resizing Windows will check the disk.
-.IP "\(bu" 4
-\&\s-1LVM\s0 PVs (physical volumes). virt-resize does not usually resize anything inside the \s-1PV,\s0 but see the \fI\-\-LV\-expand\fR option. The user could also resize LVs as desired after boot.
-.IP "\(bu" 4
+.IP \(bu 4
+LVM PVs (physical volumes). virt-resize does not usually resize anything inside the PV, but see the \fI\-\-LV\-expand\fR option. The user could also resize LVs as desired after boot.
+.IP \(bu 4
Btrfs filesystems, if libguestfs was compiled with support for btrfs.
-.IP "\(bu" 4
-\&\s-1XFS\s0 filesystems, if libguestfs was compiled with support for \s-1XFS.\s0
-.IP "\(bu" 4
+.IP \(bu 4
+XFS filesystems, if libguestfs was compiled with support for XFS.
+.IP \(bu 4
Linux swap partitions.
.Sp
Please note that libguestfs \fIdestroys\fR the existing swap content by recreating it with \f(CW\*(C`mkswap\*(C'\fR, so this should not be used when the guest is suspended.
-.IP "\(bu" 4
+.IP \(bu 4
f2fs filesystems, if libguestfs was compiled with support for f2fs.
.RE
.RS 4
.Sp
If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
.Sp
-Note that this option \fIdoes not\fR affect the output format. See \*(L"\s-1QCOW2 AND\s0 NON-SPARSE \s-1RAW FORMATS\*(R"\s0.
-.IP "\fB\-\-ignore\fR \s-1PART\s0" 4
+Note that this option \fIdoes not\fR affect the output format. See "QCOW2 AND NON-SPARSE RAW FORMATS".
+.IP "\fB\-\-ignore\fR PART" 4
.IX Item "--ignore PART"
Ignore the named partition. Effectively this means the partition is allocated on the destination disk, but the content is not copied across from the source disk. The content of the partition will be blank (all zero bytes).
.Sp
このオプションは複数回指定できます。
-.IP "\fB\-\-LV\-expand\fR \s-1LOGVOL\s0" 4
+.IP "\fB\-\-LV\-expand\fR LOGVOL" 4
.IX Item "--LV-expand LOGVOL"
-This takes the logical volume and, as a final step, expands it to fill all the space available in its volume group. A typical usage, assuming a Linux guest with a single \s-1PV\s0 \fI/dev/sda2\fR and a root device called \fI/dev/vg_guest/lv_root\fR would be:
+This takes the logical volume and, as a final step, expands it to fill all the space available in its volume group. A typical usage, assuming a Linux guest with a single PV \fI/dev/sda2\fR and a root device called \fI/dev/vg_guest/lv_root\fR would be:
.Sp
.Vb 2
\& virt\-resize indisk outdisk \e
\& \-\-expand /dev/sda2 \-\-LV\-expand /dev/vg_guest/lv_root
.Ve
.Sp
-This would first expand the partition (and \s-1PV\s0), and then expand the root device to fill the extra space in the \s-1PV.\s0
+This would first expand the partition (and PV), and then expand the root device to fill the extra space in the PV.
.Sp
-The contents of the \s-1LV\s0 are also resized if virt-resize knows how to do that. You can stop virt-resize from trying to expand the content by using the option \fI\-\-no\-expand\-content\fR.
+The contents of the LV are also resized if virt-resize knows how to do that. You can stop virt-resize from trying to expand the content by using the option \fI\-\-no\-expand\-content\fR.
.Sp
仮想マシンにあるファイルシステムを一覧表示するには \fBvirt\-filesystems\fR\|(1) を使用します。
.Sp
You can give this option multiple times, \fIbut\fR it doesn't make sense to do this unless the logical volumes you specify are all in different volume groups.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=format" 4
+.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の \*(L"マシン可読な出力\*(R" 参照。
-.IP "\fB\-n\fR" 4
+このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の "マシン可読な出力" 参照。
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
Print a summary of what would be done, but don’t do anything.
-.IP "\fB\-\-no\-copy\-boot\-loader\fR" 4
+.IP \fB\-\-no\-copy\-boot\-loader\fR 4
.IX Item "--no-copy-boot-loader"
-By default, virt-resize copies over some sectors at the start of the disk (up to the beginning of the first partition). Commonly these sectors contain the Master Boot Record (\s-1MBR\s0) and the boot loader, and are required in order for the guest to boot correctly.
+By default, virt-resize copies over some sectors at the start of the disk (up to the beginning of the first partition). Commonly these sectors contain the Master Boot Record (MBR) and the boot loader, and are required in order for the guest to boot correctly.
.Sp
If you specify this flag, then this initial copy is not done. You may need to reinstall the boot loader in this case.
-.IP "\fB\-\-no\-extra\-partition\fR" 4
+.IP \fB\-\-no\-extra\-partition\fR 4
.IX Item "--no-extra-partition"
By default, virt-resize creates an extra partition if there is any extra, unused space after all resizing has happened. Use this option to prevent the extra partition from being created. If you do this then the extra space will be inaccessible until you run fdisk, parted, or some other partitioning tool in the guest.
.Sp
-Note that if the surplus space is smaller than 10 \s-1MB,\s0 no extra partition will be created.
-.IP "\fB\-\-no\-expand\-content\fR" 4
+Note that if the surplus space is smaller than 10 MB, no extra partition will be created.
+.IP \fB\-\-no\-expand\-content\fR 4
.IX Item "--no-expand-content"
By default, virt-resize will try to expand the direct contents of partitions, if it knows how (see \fI\-\-expand\fR option above).
.Sp
\&\fI\-\-no\-expand\-content\fR オプションを指定すると、virt\-resize はこれを試行しません。
-.IP "\fB\-\-no\-sparse\fR" 4
+.IP \fB\-\-no\-sparse\fR 4
.IX Item "--no-sparse"
-Turn off sparse copying. See \*(L"\s-1SPARSE COPYING\*(R"\s0 below.
-.IP "\fB\-\-ntfsresize\-force\fR" 4
+Turn off sparse copying. See "SPARSE COPYING" below.
+.IP \fB\-\-ntfsresize\-force\fR 4
.IX Item "--ntfsresize-force"
\&\fBntfsresize\fR\|(8) に \fI\-\-force\fR オプションを渡します。これにより、NTFS ディスクが整合性の確認が必要であるという印をつけたときでも、容量の変更を許可します。Windows 仮想マシンを各容量において起動することなく、何回も容量変更したいならば、このオプションを使用する必要があります。
.IP "\fB\-\-output\-format\fR \fBraw\fR" 4
.Sp
If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
.Sp
-Note that this option \fIdoes not create\fR the output format. This option just tells libguestfs what it is so it doesn't try to guess it. You still need to create the output disk with the right format. See \*(L"\s-1QCOW2 AND\s0 NON-SPARSE \s-1RAW FORMATS\*(R"\s0.
-.IP "\fB\-q\fR" 4
+Note that this option \fIdoes not create\fR the output format. This option just tells libguestfs what it is so it doesn't try to guess it. You still need to create the output disk with the right format. See "QCOW2 AND NON-SPARSE RAW FORMATS".
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Don’t print the summary.
This is the same as \fI\-\-resize\fR except that it will let you decrease the size of any partition. Generally this means you will lose any data which was at the end of the partition you shrink, but you may not care about that (eg. if shrinking an unused partition, or if you can easily recreate it such as a swap partition).
.Sp
\&\fI\-\-ignore\fR オプション参照。
-.IP "\fB\-\-shrink\fR \s-1PART\s0" 4
+.IP "\fB\-\-shrink\fR PART" 4
.IX Item "--shrink PART"
-Shrink the named partition until the overall disk image fits in the destination. The named partition \fBmust\fR contain a filesystem or \s-1PV\s0 which has already been shrunk using another tool (eg. \fBguestfish\fR\|(1) or other online tools). Virt-resize will check this and give an error if it has not been done.
+Shrink the named partition until the overall disk image fits in the destination. The named partition \fBmust\fR contain a filesystem or PV which has already been shrunk using another tool (eg. \fBguestfish\fR\|(1) or other online tools). Virt-resize will check this and give an error if it has not been done.
.Sp
-The amount by which the overall disk must be shrunk (after carrying out all other operations requested by the user) is called the \*(L"deficit\*(R". For example, a straight copy (assume no other operations) from a 5GB disk image to a 4GB disk image results in a 1GB deficit. In this case, virt-resize would give an error unless the user specified a partition to shrink and that partition had more than a gigabyte of free space.
+The amount by which the overall disk must be shrunk (after carrying out all other operations requested by the user) is called the "deficit". For example, a straight copy (assume no other operations) from a 5GB disk image to a 4GB disk image results in a 1GB deficit. In this case, virt-resize would give an error unless the user specified a partition to shrink and that partition had more than a gigabyte of free space.
.Sp
Note that you cannot use \fI\-\-expand\fR and \fI\-\-shrink\fR together.
.IP "\fB\-\-unknown\-filesystems\fR \fBignore\fR" 4
.Sp
\&\fI\-\-unknown\-filesystems error\fR will cause virt-resize to error out at the first filesystem that cannot be expanded.
.Sp
-See also \*(L"unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV\*(R"\s0.
-.IP "\fB\-v\fR" 4
+See also "unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV".
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.SH "マシン可読な出力"
+libguestfs API 呼び出しのトレースを有効にします。
+.SH マシン可読な出力
.IX Header "マシン可読な出力"
-\&\fI\-\-machine\-readable\fR オプションはよりマシンに易しい出力を作成するために使用できます。これは他のプログラムや \s-1GUI\s0 などから virt-resize を呼び出すときに有用です。
+\&\fI\-\-machine\-readable\fR オプションはよりマシンに易しい出力を作成するために使用できます。これは他のプログラムや GUI などから virt-resize を呼び出すときに有用です。
.PP
このオプションを使用するには 2 通りの方法があります。
.PP
Secondly use the option in conjunction with other options to make the regular program output more machine friendly.
.PP
At the moment this means:
-.IP "1." 4
+.IP 1. 4
Progress bar messages can be parsed from stdout by looking for this regular expression:
.Sp
.Vb 1
\& ^[0\-9]+/[0\-9]+$
.Ve
-.IP "2." 4
+.IP 2. 4
The calling program should treat messages sent to stdout (except for progress bar messages) as status messages. They can be logged and/or displayed to the user.
-.IP "3." 4
+.IP 3. 4
The calling program should treat messages sent to stderr as error messages. In addition, virt-resize exits with a non-zero status code if there was a fatal error.
.PP
Versions of the program prior to 1.13.9 did not support the \fI\-\-machine\-readable\fR option and will return an error.
.PP
-It is possible to specify a format string for controlling the output; see \*(L"\s-1ADVANCED MACHINE READABLE OUTPUT\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "注記"
+It is possible to specify a format string for controlling the output; see "ADVANCED MACHINE READABLE OUTPUT" in \fBguestfs\fR\|(3).
+.SH 注記
.IX Header "注記"
-.ie n .SS """Partition 1 does not end on cylinder boundary."""
-.el .SS "``Partition 1 does not end on cylinder boundary.''"
-.IX Subsection "Partition 1 does not end on cylinder boundary."
-Virt-resize aligns partitions to multiples of 128 sectors (see the \fI\-\-alignment\fR parameter). Usually this means the partitions will not be aligned to the ancient \s-1CHS\s0 geometry. However \s-1CHS\s0 geometry is meaningless for disks manufactured since the early 1990s, and doubly so for virtual hard drives. Alignment of partitions to cylinders is not required by any modern operating system.
-.ie n .SS "\s-1GUEST BOOT STUCK AT ""GRUB""\s0"
-.el .SS "\s-1GUEST BOOT STUCK AT ``GRUB''\s0"
-.IX Subsection "GUEST BOOT STUCK AT GRUB"
+.SS """Partition 1 does not end on cylinder boundary."""
+.IX Subsection """Partition 1 does not end on cylinder boundary."""
+Virt-resize aligns partitions to multiples of 128 sectors (see the \fI\-\-alignment\fR parameter). Usually this means the partitions will not be aligned to the ancient CHS geometry. However CHS geometry is meaningless for disks manufactured since the early 1990s, and doubly so for virtual hard drives. Alignment of partitions to cylinders is not required by any modern operating system.
+.SS "GUEST BOOT STUCK AT ""GRUB"""
+.IX Subsection "GUEST BOOT STUCK AT ""GRUB"""
If a Linux guest does not boot after resizing, and the boot is stuck after printing \f(CW\*(C`GRUB\*(C'\fR on the console, try reinstalling grub.
.PP
.Vb 6
.Ve
.PP
For more flexible guest reconfiguration, including if you need to specify other parameters to grub-install, use \fBvirt\-rescue\fR\|(1).
-.SS "\s-1RESIZING WINDOWS BOOT PARTITIONS\s0"
+.SS "RESIZING WINDOWS BOOT PARTITIONS"
.IX Subsection "RESIZING WINDOWS BOOT PARTITIONS"
In Windows Vista and later versions, Microsoft switched to using a separate boot partition. In these VMs, typically \fI/dev/sda1\fR is the boot partition and \fI/dev/sda2\fR is the main (C:) drive. Resizing the first (boot) partition causes the bootloader to fail with \f(CW0xC0000225\fR error. Resizing the second partition (ie. C: drive) should work.
-.SS "\s-1WINDOWS CHKDSK\s0"
+.SS "WINDOWS CHKDSK"
.IX Subsection "WINDOWS CHKDSK"
-Windows disks which use \s-1NTFS\s0 must be consistent before virt-resize can be used. If the ntfsresize operation fails, try booting the original \s-1VM\s0 and running \f(CW\*(C`chkdsk /f\*(C'\fR on all \s-1NTFS\s0 partitions, then shut down the \s-1VM\s0 cleanly. For further information see: https://bugzilla.redhat.com/show_bug.cgi?id=975753
+Windows disks which use NTFS must be consistent before virt-resize can be used. If the ntfsresize operation fails, try booting the original VM and running \f(CW\*(C`chkdsk /f\*(C'\fR on all NTFS partitions, then shut down the VM cleanly. For further information see: https://bugzilla.redhat.com/show_bug.cgi?id=975753
.PP
-\&\fIAfter resize\fR Windows may initiate a lengthy \*(L"chkdsk\*(R" on first boot if \s-1NTFS\s0 partitions have been expanded. This is just a safety check and (unless it find errors) is nothing to worry about.
-.SS "Windows \s-1UNMOUNTABLE_BOOT_VOLUME BSOD\s0"
+\&\fIAfter resize\fR Windows may initiate a lengthy "chkdsk" on first boot if NTFS partitions have been expanded. This is just a safety check and (unless it find errors) is nothing to worry about.
+.SS "Windows UNMOUNTABLE_BOOT_VOLUME BSOD"
.IX Subsection "Windows UNMOUNTABLE_BOOT_VOLUME BSOD"
-Windows 仮想マシンを sysprep して、virt\-resize を用いて容量を変更した後、仮想マシンが \f(CW\*(C`UNMOUNTABLE_BOOT_VOLUME\*(C'\fR \s-1BSOD\s0 で起動に失敗するかもしれません。このエラーは sysprep.inf ファイルに \f(CW\*(C`ExtendOemPartition=1\*(C'\fR があることにより引き起こされます。sysprep する前にこの行を削除することにより、この問題を解決できます。
-.SS "\s-1WINDOWS 8\s0"
+Windows 仮想マシンを sysprep して、virt\-resize を用いて容量を変更した後、仮想マシンが \f(CW\*(C`UNMOUNTABLE_BOOT_VOLUME\*(C'\fR BSOD で起動に失敗するかもしれません。このエラーは sysprep.inf ファイルに \f(CW\*(C`ExtendOemPartition=1\*(C'\fR があることにより引き起こされます。sysprep する前にこの行を削除することにより、この問題を解決できます。
+.SS "WINDOWS 8"
.IX Subsection "WINDOWS 8"
-Windows 8 \*(L"fast startup\*(R" can prevent virt-resize from resizing \s-1NTFS\s0 partitions. See \*(L"\s-1WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP\*(R"\s0 in \fBguestfs\fR\|(3).
-.SS "\s-1SPARSE COPYING\s0"
+Windows 8 "fast startup" can prevent virt-resize from resizing NTFS partitions. See "WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" in \fBguestfs\fR\|(3).
+.SS "SPARSE COPYING"
.IX Subsection "SPARSE COPYING"
You should create a fresh, zeroed target disk image for virt-resize to use.
.PP
Virt-resize by default performs sparse copying. This means that it does not copy blocks from the source disk which are all zeroes. This improves speed and efficiency, but will produce incorrect results if the target disk image contains unzeroed data.
.PP
-The main time this can be a problem is if the target is a host partition (eg. \f(CW\*(C`virt\-resize source.img /dev/sda4\*(C'\fR) because the usual partitioning tools tend to leave whatever data happened to be on the disk before.
+The main time this can be a problem is if the target is a host partition (eg. \f(CW\*(C`virt\-resize\ source.img\ /dev/sda4\*(C'\fR) because the usual partitioning tools tend to leave whatever data happened to be on the disk before.
.PP
If you have to reuse a target which contains data already, you should use the \fI\-\-no\-sparse\fR option. Note this can be much slower.
-.ie n .SS """unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV""\s0"
-.el .SS "``unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV''\s0"
-.IX Subsection "unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"
+.SS """unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"""
+.IX Subsection """unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"""
Virt-resize was asked to expand a partition or a logical volume containing a filesystem with the type \f(CW\*(C`TYPE\*(C'\fR, but there is no available nor known expanding method for that filesystem.
.PP
This may be due to either of the following:
-.IP "1." 4
+.IP 1. 4
There corresponding filesystem is not available in libguestfs, because there is no proper package in the host with utilities for it. This is usually the case for \f(CW\*(C`btrfs\*(C'\fR, \f(CW\*(C`ntfs\*(C'\fR, \f(CW\*(C`xfs\*(C'\fR, and \f(CW\*(C`f2fs\*(C'\fR filesystems.
.Sp
Check the results of:
.Ve
.Sp
In this case, it is enough to install the proper packages adding support for them. For example, \f(CW\*(C`libguestfs\-xfs\*(C'\fR on Red Hat Enterprise Linux, CentOS, Debian, Ubuntu, and distributions derived from them, for supporting the \f(CW\*(C`xfs\*(C'\fR filesystem.
-.IP "2." 4
+.IP 2. 4
Virt-resize has no support for expanding that type of filesystem.
.Sp
In this case, there’s nothing that can be done to let virt-resize expand that type of filesystem.
.PP
In both cases, virt-resize will not expand the mentioned filesystem; the result (unless \fI\-\-unknown\-filesystems error\fR is specified) is that the partitions containing such filesystems will be actually bigger as requested, but the filesystems will still be usable at their older sizes.
-.SH "代替ツール"
+.SH 代替ツール
.IX Header "代替ツール"
There are several proprietary tools for resizing partitions. We won't mention any here.
.PP
-\&\fBparted\fR\|(8) and its graphical shell gparted can do some types of resizing operations on disk images. They can resize and move partitions, but I don't think they can do anything with the contents, and they certainly don't understand \s-1LVM.\s0
+\&\fBparted\fR\|(8) and its graphical shell gparted can do some types of resizing operations on disk images. They can resize and move partitions, but I don't think they can do anything with the contents, and they certainly don't understand LVM.
.PP
\&\fBguestfish\fR\|(1) can do everything that virt-resize can do and a lot more, but at a much lower level. You will probably end up hand-calculating sector offsets, which is something that virt-resize was designed to avoid. If you want to see the guestfish-equivalent commands that virt-resize runs, use the \fI\-\-debug\fR flag.
.PP
-\&\fBdracut\fR\|(8) includes a module called \f(CW\*(C`dracut\-modules\-growroot\*(C'\fR which can be used to grow the root partition when the guest first boots up. There is documentation for this module in an associated \s-1README\s0 file.
-.SH "終了ステータス"
+\&\fBdracut\fR\|(8) includes a module called \f(CW\*(C`dracut\-modules\-growroot\*(C'\fR which can be used to grow the root partition when the guest first boots up. There is documentation for this module in an associated README file.
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBvirt\-filesystems\fR\|(1), \fBvirt\-df\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBlvm\fR\|(8), \fBpvresize\fR\|(8), \fBlvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8), \fBresize.f2fs\fR\|(8), \fBvirsh\fR\|(1), \fBparted\fR\|(8), \fBtruncate\fR\|(1), \fBfallocate\fR\|(1), \fBgrub\fR\|(8), \fBgrub\-install\fR\|(8), \fBvirt\-rescue\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirt\-alignment\-scan\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-sparsify 1"
-.TH virt-sparsify 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-sparsify 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-sparsify \- 仮想マシンのディスクをスパースにします
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-sparsify [\-\-options] indisk outdisk
\&
\& virt\-sparsify [\-\-options] \-\-in\-place disk
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
Virt-sparsify is a tool which can make a virtual machine disk (or any disk image) sparse a.k.a. thin-provisioned. This means that free space within the disk image can be converted back to free space on the host.
.PP
-Virt-sparsify can locate and sparsify free space in most filesystems (eg. ext2/3/4, btrfs, \s-1NTFS,\s0 etc.), and also in \s-1LVM\s0 physical volumes.
+Virt-sparsify can locate and sparsify free space in most filesystems (eg. ext2/3/4, btrfs, NTFS, etc.), and also in LVM physical volumes.
.PP
Virt-sparsify はさまざまなディスクフォーマットを変換することができます。例えば、raw ディスクイメージをシンプロビジョニングされた qcow2 イメージに変換することができます。
.PP
Virt-sparsify can operate on any disk image, not just ones from virtual machines. However if a virtual machine has multiple disks and uses volume management, then virt-sparsify will work but not be very effective (http://bugzilla.redhat.com/887826).
-.SS "\s-1IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES\s0"
+.SS "IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES"
.IX Subsection "IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES"
If the input is raw, then the default output is raw sparse. \fBYou must check the output size using a tool that understands sparseness\fR such as \f(CW\*(C`du \-sh\*(C'\fR. It can make a huge difference:
.PP
.Ve
.PP
(見た目の容量 \fB100M\fR と実際の容量 \fB3.6M\fR を比較します)
-.SS "\s-1IMPORTANT LIMITATIONS\s0"
+.SS "IMPORTANT LIMITATIONS"
.IX Subsection "IMPORTANT LIMITATIONS"
-.IP "\(bu" 4
+.IP \(bu 4
The virtual machine \fImust be shut down\fR before using this tool.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify may require up to 2x the virtual size of the source disk image (1 temporary copy + 1 destination image). This is in the worst case and usually much less space is required.
.Sp
If you are using the \fI\-\-in\-place\fR option, then large amounts of temporary space are \fBnot\fR required.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify cannot resize disk images. To do that, use \fBvirt\-resize\fR\|(1).
-.IP "\(bu" 4
+.IP \(bu 4
virt-sparsify は暗号化されたディスクを処理できません。 libguestfs は暗号化されたディスクをサポートしますが、暗号化されたディスク自体はスパース化できません。
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify cannot yet sparsify the space between partitions. Note that this space is often used for critical items like bootloaders so it's not really unused.
-.IP "\(bu" 4
+.IP \(bu 4
In copy mode, qcow2 internal snapshots are not copied over to the destination image.
.PP
You may also want to read the manual pages for the associated tools \fBvirt\-filesystems\fR\|(1) and \fBvirt\-df\fR\|(1) before starting.
-.SH "例"
+.SH 例
.IX Header "例"
一般的な使用法は次のとおりです:
.PP
.Vb 1
\& virt\-sparsify \-\-in\-place disk.img
.Ve
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
ヘルプを表示します。
.IP "\fB\-\-check\-tmpdir\fR \fBignore\fR" 4
.IP "\fB\-\-check\-tmpdir\fR \fBfail\fR" 4
.IX Item "--check-tmpdir fail"
.PD
-Check if \*(L"\s-1TMPDIR\*(R"\s0 or \fI\-\-tmp\fR directory has enough space to complete the operation. This is just an estimate.
+Check if "TMPDIR" or \fI\-\-tmp\fR directory has enough space to complete the operation. This is just an estimate.
.Sp
If the check indicates a problem, then you can either:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBignore\fR it,
-.IP "\(bu" 4
+.IP \(bu 4
print a warning and \fBcontinue\fR,
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBwarn\fR and wait for the user to press the Return key (this is the default), or:
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBfail\fR and exit.
.RE
.RS 4
.Sp
You cannot use this option and \fI\-\-in\-place\fR together.
.RE
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-\-compress\fR" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP \fB\-\-compress\fR 4
.IX Item "--compress"
出力ファイルを圧縮します。これは 出力形式が \f(CW\*(C`qcow2\*(C'\fR の場合 \fIのみ\fR 機能します。
.Sp
.Sp
サポートされる既知の動作済み出力形式は次のとおりです: \f(CW\*(C`raw\*(C'\fR, \f(CW\*(C`qcow2\*(C'\fR, \f(CW\*(C`vdi\*(C'\fR。
.Sp
-\&\fBqemu\-img\fR\|(1) プログラムによりサポートされるすべての形式を使用できます。たとえば、\f(CW\*(C`vmdk\*(C'\fR ですが、他の形式のサポートは \s-1QEMU\s0 に依存します。
+\&\fBqemu\-img\fR\|(1) プログラムによりサポートされるすべての形式を使用できます。たとえば、\f(CW\*(C`vmdk\*(C'\fR ですが、他の形式のサポートは QEMU に依存します。
.Sp
Specifying the \fI\-\-convert\fR option is usually a good idea, because then virt-sparsify doesn't need to try to guess the input format.
.Sp
出力形式を詳細に調整します。関連項目: \fI\-\-compress\fR, \fI\-o\fR.
.Sp
You cannot use this option and \fI\-\-in\-place\fR together.
-.IP "\fB\-\-echo\-keys\fR" 4
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-sparsify normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
.IP "\fB\-\-format\fR raw" 4
In the second form, this ignores the named volume group. Use the volume group name without the \fI/dev/\fR prefix, eg. \fI\-\-ignore vg_foo\fR
.Sp
このオプションは複数回指定できます。
-.IP "\fB\-\-in\-place\fR" 4
+.IP \fB\-\-in\-place\fR 4
.IX Item "--in-place"
-Do in-place sparsification instead of copying sparsification. See \*(L"IN-PLACE \s-1SPARSIFICATION\*(R"\s0 below.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Do in-place sparsification instead of copying sparsification. See "IN-PLACE SPARSIFICATION" below.
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=format" 4
+.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
-このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の \*(L"マシン可読な出力\*(R" 参照。
+このオプションは、他のプログラムにより解析されるときに、よりマシンに易しい出力を作成するために使用されます。以下の "マシン可読な出力" 参照。
.IP "\fB\-o\fR option[,option,...]" 4
.IX Item "-o option[,option,...]"
Pass \fI\-o\fR option(s) to the \fBqemu\-img\fR\|(1) command to fine-tune the output format. Options available depend on the output format (see \fI\-\-convert\fR) and the installed version of the qemu-img program.
.Ve
.Sp
You cannot use this option and \fI\-\-in\-place\fR together.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
This disables progress bars and other unnecessary output.
.IP "\fB\-\-tmp\fR dir" 4
.IX Item "--tmp dir"
.PD
-In copying mode only, use the named device or directory as the location of the temporary overlay (see also \*(L"\s-1TMPDIR\*(R"\s0 below).
+In copying mode only, use the named device or directory as the location of the temporary overlay (see also "TMPDIR" below).
.Sp
If the parameter given is a block device, then the block device is written to directly. \fBNote this erases the existing contents of the block device\fR.
.Sp
-If the parameter is a directory, then this is the same as setting the \*(L"\s-1TMPDIR\*(R"\s0 environment variable.
+If the parameter is a directory, then this is the same as setting the "TMPDIR" environment variable.
.Sp
You cannot use this option and \fI\-\-in\-place\fR together.
.IP "\fB\-\-tmp\fR prebuilt:file" 4
.IX Item "--tmp prebuilt:file"
In copying mode only, the specialized option \fI\-\-tmp prebuilt:file\fR (where \f(CW\*(C`prebuilt:\*(C'\fR is a literal string) causes virt-sparsify to use the qcow2 \f(CW\*(C`file\*(C'\fR as temporary space.
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
The file \fBmust\fR be freshly formatted as qcow2, with indisk as the backing file.
-.IP "\(bu" 4
+.IP \(bu 4
If you rerun virt-sparsify, you \fBmust\fR recreate the file before each run.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify does not delete the file.
.RE
.RS 4
.Sp
This option is used by oVirt which requires a specially formatted temporary file.
.RE
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
+libguestfs API 呼び出しのトレースを有効にします。
.IP "\fB\-\-zero\fR パーティション" 4
.IX Item "--zero パーティション"
.PD 0
Some options are not compatible with this mode: \fI\-\-convert\fR, \fI\-\-compress\fR and \fI\-o\fR because they require wholesale disk format changes; \fI\-\-check\-tmpdir\fR because large amounts of temporary space are not required.
.PP
In-place sparsification works using discard (a.k.a trim or unmap) support.
-.SH "マシン可読な出力"
+.SH マシン可読な出力
.IX Header "マシン可読な出力"
The \fI\-\-machine\-readable\fR option can be used to make the output more machine friendly, which is useful when calling virt-sparsify from other programs, GUIs etc.
.PP
Secondly use the option in conjunction with other options to make the regular program output more machine friendly.
.PP
At the moment this means:
-.IP "1." 4
+.IP 1. 4
Progress bar messages can be parsed from stdout by looking for this regular expression:
.Sp
.Vb 1
\& ^[0\-9]+/[0\-9]+$
.Ve
-.IP "2." 4
+.IP 2. 4
The calling program should treat messages sent to stdout (except for progress bar messages) as status messages. They can be logged and/or displayed to the user.
-.IP "3." 4
+.IP 3. 4
The calling program should treat messages sent to stderr as error messages. In addition, virt-sparsify exits with a non-zero status code if there was a fatal error.
.PP
All versions of virt-sparsify have supported the \fI\-\-machine\-readable\fR option.
.PP
-It is possible to specify a format string for controlling the output; see \*(L"\s-1ADVANCED MACHINE READABLE OUTPUT\*(R"\s0 in \fBguestfs\fR\|(3).
+It is possible to specify a format string for controlling the output; see "ADVANCED MACHINE READABLE OUTPUT" in \fBguestfs\fR\|(3).
.SH "WINDOWS 8"
.IX Header "WINDOWS 8"
-Windows 8 \*(L"fast startup\*(R" can prevent virt-sparsify from working. See \*(L"\s-1WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "環境変数"
+Windows 8 "fast startup" can prevent virt-sparsify from working. See "WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" in \fBguestfs\fR\|(3).
+.SH 環境変数
.IX Header "環境変数"
-.IP "\s-1TMPDIR\s0" 4
+.IP TMPDIR 4
.IX Item "TMPDIR"
Location of the temporary directory used for the potentially large temporary overlay file.
.Sp
.Sp
This defaults to \fI/tmp\fR.
.Sp
-Note that if \f(CW$TMPDIR\fR is a tmpfs (eg. if \fI/tmp\fR is on tmpfs, or if you use \f(CW\*(C`TMPDIR=/dev/shm\*(C'\fR), tmpfs defaults to a maximum size of \fIhalf\fR of physical \s-1RAM.\s0 If virt-sparsify exceeds this, it will hang. The solution is either to use a real disk, or to increase the maximum size of the tmpfs mountpoint, eg:
+Note that if \f(CW$TMPDIR\fR is a tmpfs (eg. if \fI/tmp\fR is on tmpfs, or if you use \f(CW\*(C`TMPDIR=/dev/shm\*(C'\fR), tmpfs defaults to a maximum size of \fIhalf\fR of physical RAM. If virt-sparsify exceeds this, it will hang. The solution is either to use a real disk, or to increase the maximum size of the tmpfs mountpoint, eg:
.Sp
.Vb 1
\& mount \-o remount,size=10G /tmp
.Sp
If you are using the \fI\-\-in\-place\fR option, then large amounts of temporary space are \fBnot\fR required.
.PP
-他の環境変数は \*(L"環境変数\*(R" in \fBguestfs\fR\|(3) を参照してください。
-.SH "終了ステータス"
+他の環境変数は "環境変数" in \fBguestfs\fR\|(3) を参照してください。
+.SH 終了ステータス
.IX Header "終了ステータス"
This program returns 0 if the operation completed without errors. (This doesn't necessarily mean that space could be freed up.)
.PP
A non-zero exit code indicates an error.
.PP
If the exit code is \f(CW3\fR and the \fI\-\-in\-place\fR option was used, that indicates that discard support is not available in libguestfs, so copying mode must be used instead.
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBvirt\-df\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBtruncate\fR\|(1), \fBfallocate\fR\|(1), \fBqemu\-img\fR\|(1), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2011\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-sysprep 1"
-.TH virt-sysprep 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-sysprep 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-sysprep \- 仮想マシンをクローンできるよう、再設定、設定解除またはカスタマイズします
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-sysprep [\-\-options] \-d domname
\&
\& virt\-sysprep [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
-.SH "説明"
+.SH 説明
.IX Header "説明"
-Virt-sysprep can reset or unconfigure a virtual machine so that clones can be made from it. Steps in this process include removing \s-1SSH\s0 host keys, removing persistent network \s-1MAC\s0 configuration, and removing user accounts. Virt-sysprep can also customize a virtual machine, for instance by adding \s-1SSH\s0 keys, users or logos. Each step can be enabled or disabled as required.
+Virt-sysprep can reset or unconfigure a virtual machine so that clones can be made from it. Steps in this process include removing SSH host keys, removing persistent network MAC configuration, and removing user accounts. Virt-sysprep can also customize a virtual machine, for instance by adding SSH keys, users or logos. Each step can be enabled or disabled as required.
.PP
-Virt-sysprep modifies the guest or disk image \fIin place\fR. The guest must be shut down. If you want to preserve the existing contents of the guest, \fIyou must snapshot, copy or clone the disk first\fR. See \*(L"\s-1COPYING AND CLONING\*(R"\s0 below.
+Virt-sysprep modifies the guest or disk image \fIin place\fR. The guest must be shut down. If you want to preserve the existing contents of the guest, \fIyou must snapshot, copy or clone the disk first\fR. See "COPYING AND CLONING" below.
.PP
You do \fInot\fR need to run virt-sysprep as root. In fact we'd generally recommend that you don't. The time you might want to run it as root is when you need root in order to access the disk image, but even in this case it would be better to change the permissions on the disk image to be writable as the non-root user running virt-sysprep.
.PP
-\&\*(L"Sysprep\*(R" stands for \*(L"system preparation\*(R" tool. The name comes from the Microsoft program \fIsysprep.exe\fR which is used to unconfigure Windows machines in preparation for cloning them. Having said that, virt-sysprep does \fInot\fR currently work on Microsoft Windows guests. We plan to support Windows sysprepping in a future version, and we already have code to do it.
-.SH "オプション"
+"Sysprep" stands for "system preparation" tool. The name comes from the Microsoft program \fIsysprep.exe\fR which is used to unconfigure Windows machines in preparation for cloning them. Having said that, virt-sysprep does \fInot\fR currently work on Microsoft Windows guests. We plan to support Windows sysprepping in a future version, and we already have code to do it.
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
仮想マシンからディスクイメージの \fIfile\fR を追加します。
.Sp
ディスクイメージの形式は自動的に検出されます。強制的に特定の形式を使用するには \fI\-\-format\fR オプションを使用します。
-.IP "\fB\-a\fR \s-1URI\s0" 4
+.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
-.IP "\fB\-\-add\fR \s-1URI\s0" 4
+.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
-Add a remote disk. The \s-1URI\s0 format is compatible with guestfish. See \*(L"\s-1ADDING REMOTE STORAGE\*(R"\s0 in \fBguestfish\fR\|(1).
-.IP "\fB\-\-colors\fR" 4
+Add a remote disk. The URI format is compatible with guestfish. See "ADDING REMOTE STORAGE" in \fBguestfish\fR\|(1).
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Use \s-1ANSI\s0 colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, \s-1ANSI\s0 colour sequences are disabled unless you use this option.
-.IP "\fB\-c\fR \s-1URI\s0" 4
+Use ANSI colour sequences to colourize messages. This is the default when the output is a tty. If the output of the program is redirected to a file, ANSI colour sequences are disabled unless you use this option.
+.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect\fR \s-1URI\s0" 4
+.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
-名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの \s-1UUID\s0 を使用できます。
-.IP "\fB\-n\fR" 4
+名前付きの libvirt 仮想マシンからすべてのディスクを追加します。 名前の代わりに仮想マシンの UUID を使用できます。
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
-Perform a read-only \*(L"dry run\*(R" on the guest. This runs the sysprep operation, but throws away any changes to the disk at the end.
+Perform a read-only "dry run" on the guest. This runs the sysprep operation, but throws away any changes to the disk at the end.
.IP "\fB\-\-enable\fR operations" 4
.IX Item "--enable operations"
Choose which sysprep operations to perform. Give a comma-separated list of operations, for example:
\& \-\-enable ssh\-hostkeys,udev\-persistent\-net
.Ve
.Sp
-would enable \s-1ONLY\s0 \f(CW\*(C`ssh\-hostkeys\*(C'\fR and \f(CW\*(C`udev\-persistent\-net\*(C'\fR operations.
+would enable ONLY \f(CW\*(C`ssh\-hostkeys\*(C'\fR and \f(CW\*(C`udev\-persistent\-net\*(C'\fR operations.
.Sp
If the \fI\-\-enable\fR option is not given, then we default to trying most sysprep operations (see \fI\-\-list\-operations\fR to show which are enabled).
.Sp
.Sp
特定のバージョンの virt-sysprep によりサポートされる操作の一覧を表示するには \fI\-\-list\-operations\fR を使用します。
.Sp
-See \*(L"\s-1OPERATIONS\*(R"\s0 below for a list and an explanation of each operation.
+See "OPERATIONS" below for a list and an explanation of each operation.
.IP "\fB\-\-operation\fR operations" 4
.IX Item "--operation operations"
.PD 0
\& \-\-operations ssh\-hostkeys,udev\-persistent\-net
.Ve
.Sp
-would enable \s-1ONLY\s0 \f(CW\*(C`ssh\-hostkeys\*(C'\fR and \f(CW\*(C`udev\-persistent\-net\*(C'\fR operations.
+would enable ONLY \f(CW\*(C`ssh\-hostkeys\*(C'\fR and \f(CW\*(C`udev\-persistent\-net\*(C'\fR operations.
.Sp
\&\fI\-\-operations\fR allows you to enable and disable any operation, including the default ones (which would be tried when specifying neither \fI\-\-operations\fR nor \fI\-\-enable\fR) and all the available ones; prepending a \f(CW\*(C`\-\*(C'\fR in front of an operation name removes it from the list of enabled operations, while the meta-names \f(CW\*(C`defaults\*(C'\fR and \f(CW\*(C`all\*(C'\fR represent respectively the operations enabled by default and all the available ones. For example:
.Sp
.Sp
特定のバージョンの virt-sysprep によりサポートされる操作の一覧を表示するには \fI\-\-list\-operations\fR を使用します。
.Sp
-See \*(L"\s-1OPERATIONS\*(R"\s0 below for a list and an explanation of each operation.
-.IP "\fB\-\-echo\-keys\fR" 4
+See "OPERATIONS" below for a list and an explanation of each operation.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-sysprep normally turns echoing off so you cannot see what you are typing. If you are not worried about Tempest attacks and there is no one else in the room you can specify this flag to see what you are typing.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.Sp
forces raw format (no auto-detection) for \fIdisk.img\fR and reverts to auto-detection for \fIanother.img\fR.
.Sp
-仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (\s-1CVE\-2010\-3851\s0)。
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE\-2010\-3851)。
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
-.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
+.Sp
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-list\-operations\fR" 4
+.IP \fB\-\-list\-operations\fR 4
.IX Item "--list-operations"
virt-sysprep プログラムによりサポートされる操作を一覧表示します。
.Sp
Before libguestfs 1.17.33 only the first (operation name) field was shown and all operations were enabled by default.
.IP "\fB\-\-mount\-options\fR mp:opts[;mp:opts;...]" 4
.IX Item "--mount-options mp:opts[;mp:opts;...]"
-Set the mount options used when libguestfs opens the disk image. Note this has no effect on the guest. It is used when opening certain guests such as ones using the \s-1UFS\s0 (\s-1BSD\s0) filesystem.
+Set the mount options used when libguestfs opens the disk image. Note this has no effect on the guest. It is used when opening certain guests such as ones using the UFS (BSD) filesystem.
.Sp
Use a semicolon-separated list of \f(CW\*(C`mountpoint:options\*(C'\fR pairs. You may need to quote this list to protect it from the shell.
.Sp
.Ve
.Sp
will do the same, plus mount \fI/var\fR with \f(CW\*(C`rw,nodiratime\*(C'\fR.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Don’t print log messages.
.Sp
To enable detailed logging of individual file operations, use \fI\-x\fR.
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Enable or disable network access from the guest during the installation.
In virt-sysprep, the network is \fIdisabled\fR by default. You must use \fI\-\-network\fR to enable it, in order that options such as \fI\-\-install\fR or \fI\-\-update\fR will work.
.Sp
\&\fBvirt\-builder\fR\|(1) has more information about the security advantages of disabling the network.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
バージョン番号を表示して、終了します。
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
-libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
-.ie n .IP "\fB\-\-append\-line\fR \s-1FILE:LINE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-append\-line\fR \s-1FILE:LINE\s0 (see \f(CWcustomize\fR below)" 4
+libguestfs API 呼び出しのトレースを有効にします。
+.ie n .IP "\fB\-\-append\-line\fR FILE:LINE (see ""customize"" below)" 4
+.el .IP "\fB\-\-append\-line\fR FILE:LINE (see \f(CWcustomize\fR below)" 4
.IX Item "--append-line FILE:LINE (see customize below)"
Append a single line of text to the \f(CW\*(C`FILE\*(C'\fR. If the file does not already end with a newline, then one is added before the appended line. Also a newline is added to the end of the \f(CW\*(C`LINE\*(C'\fR string automatically.
.Sp
\& \-\-append\-line \*(Aq/etc/hosts:\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
-.ie n .IP "\fB\-\-chmod\fR \s-1PERMISSIONS:FILE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-chmod\fR \s-1PERMISSIONS:FILE\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-chmod\fR PERMISSIONS:FILE (see ""customize"" below)" 4
+.el .IP "\fB\-\-chmod\fR PERMISSIONS:FILE (see \f(CWcustomize\fR below)" 4
.IX Item "--chmod PERMISSIONS:FILE (see customize below)"
Change the permissions of \f(CW\*(C`FILE\*(C'\fR to \f(CW\*(C`PERMISSIONS\*(C'\fR.
.Sp
\&\fINote\fR: \f(CW\*(C`PERMISSIONS\*(C'\fR by default would be decimal, unless you prefix it with \f(CW0\fR to get octal, ie. use \f(CW0700\fR not \f(CW700\fR.
-.ie n .IP "\fB\-\-commands\-from\-file\fR \s-1FILENAME\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-commands\-from\-file\fR \s-1FILENAME\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-chown\fR UID:GID:PATH (see ""customize"" below)" 4
+.el .IP "\fB\-\-chown\fR UID:GID:PATH (see \f(CWcustomize\fR below)" 4
+.IX Item "--chown UID:GID:PATH (see customize below)"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+例:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
+.ie n .IP "\fB\-\-commands\-from\-file\fR FILENAME (see ""customize"" below)" 4
+.el .IP "\fB\-\-commands\-from\-file\fR FILENAME (see \f(CWcustomize\fR below)" 4
.IX Item "--commands-from-file FILENAME (see customize below)"
Read the customize commands from a file, one (and its arguments) each line.
.Sp
.Ve
.Sp
The commands are handled in the same order as they are in the file, as if they were specified as \fI\-\-delete /some/file\fR on the command line.
-.ie n .IP "\fB\-\-copy\fR \s-1SOURCE:DEST\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-copy\fR \s-1SOURCE:DEST\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-copy\fR SOURCE:DEST (see ""customize"" below)" 4
+.el .IP "\fB\-\-copy\fR SOURCE:DEST (see \f(CWcustomize\fR below)" 4
.IX Item "--copy SOURCE:DEST (see customize below)"
Copy files or directories recursively inside the guest.
.Sp
Wildcards cannot be used.
-.ie n .IP "\fB\-\-copy\-in\fR \s-1LOCALPATH:REMOTEDIR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-copy\-in\fR \s-1LOCALPATH:REMOTEDIR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-copy\-in\fR LOCALPATH:REMOTEDIR (see ""customize"" below)" 4
+.el .IP "\fB\-\-copy\-in\fR LOCALPATH:REMOTEDIR (see \f(CWcustomize\fR below)" 4
.IX Item "--copy-in LOCALPATH:REMOTEDIR (see customize below)"
Copy local files or directories recursively into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist).
.Sp
Wildcards cannot be used.
-.ie n .IP "\fB\-\-delete\fR \s-1PATH\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-delete\fR \s-1PATH\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-delete\fR PATH (see ""customize"" below)" 4
+.el .IP "\fB\-\-delete\fR PATH (see \f(CWcustomize\fR below)" 4
.IX Item "--delete PATH (see customize below)"
Delete a file from the guest. Or delete a directory (and all its contents, recursively).
.Sp
.Ve
.Sp
See also: \fI\-\-upload\fR, \fI\-\-scrub\fR.
-.ie n .IP "\fB\-\-edit\fR \s-1FILE:EXPR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-edit\fR \s-1FILE:EXPR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-edit\fR FILE:EXPR (see ""customize"" below)" 4
+.el .IP "\fB\-\-edit\fR FILE:EXPR (see \f(CWcustomize\fR below)" 4
.IX Item "--edit FILE:EXPR (see customize below)"
Edit \f(CW\*(C`FILE\*(C'\fR using the Perl expression \f(CW\*(C`EXPR\*(C'\fR.
.Sp
.Sp
このオプションは Perl 5 がインストールされているときのみ利用可能であることに注意してください。
.Sp
-See \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
-.ie n .IP "\fB\-\-firstboot\fR \s-1SCRIPT\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-firstboot\fR \s-1SCRIPT\s0 (see \f(CWcustomize\fR below)" 4
+See "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
+.ie n .IP "\fB\-\-firstboot\fR SCRIPT (see ""customize"" below)" 4
+.el .IP "\fB\-\-firstboot\fR SCRIPT (see \f(CWcustomize\fR below)" 4
.IX Item "--firstboot SCRIPT (see customize below)"
Install \f(CW\*(C`SCRIPT\*(C'\fR inside the guest, so that when the guest first boots up, the script runs (as root, late in the boot process).
.Sp
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.ie n .IP "\fB\-\-firstboot\-command\fR '\s-1CMD+ARGS\s0' (see ""customize"" below)" 4
-.el .IP "\fB\-\-firstboot\-command\fR '\s-1CMD+ARGS\s0' (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-firstboot\-command\fR 'CMD+ARGS' (see ""customize"" below)" 4
+.el .IP "\fB\-\-firstboot\-command\fR 'CMD+ARGS' (see \f(CWcustomize\fR below)" 4
.IX Item "--firstboot-command 'CMD+ARGS' (see customize below)"
Run command (and arguments) inside the guest when the guest first boots up (as root, late in the boot process).
.Sp
You can have multiple \fI\-\-firstboot\fR options. They run in the same order that they appear on the command line.
.Sp
-Please take a look at \*(L"\s-1FIRST BOOT SCRIPTS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
+Please take a look at "FIRST BOOT SCRIPTS" in \fBvirt\-builder\fR\|(1) for more information and caveats about the first boot scripts.
.Sp
See also \fI\-\-run\fR.
-.ie n .IP "\fB\-\-firstboot\-install\fR \s-1PKG,PKG..\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-firstboot\-install\fR \s-1PKG,PKG..\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-firstboot\-install\fR PKG,PKG.. (see ""customize"" below)" 4
+.el .IP "\fB\-\-firstboot\-install\fR PKG,PKG.. (see \f(CWcustomize\fR below)" 4
.IX Item "--firstboot-install PKG,PKG.. (see customize below)"
Install the named packages (a comma-separated list). These are installed when the guest first boots using the guest’s package manager (eg. apt, yum, etc.) and the guest’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0 in \fBvirt\-builder\fR\|(1).
-.ie n .IP "\fB\-\-hostname\fR \s-1HOSTNAME\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-hostname\fR \s-1HOSTNAME\s0 (see \f(CWcustomize\fR below)" 4
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES" in \fBvirt\-builder\fR\|(1).
+.ie n .IP "\fB\-\-hostname\fR HOSTNAME (see ""customize"" below)" 4
+.el .IP "\fB\-\-hostname\fR HOSTNAME (see \f(CWcustomize\fR below)" 4
.IX Item "--hostname HOSTNAME (see customize below)"
-Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (\s-1FQDN\s0) if you want.
-.ie n .IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0 (see \f(CWcustomize\fR below)" 4
+Set the hostname of the guest to \f(CW\*(C`HOSTNAME\*(C'\fR. You can use a dotted hostname.domainname (FQDN) if you want.
+.ie n .IP "\fB\-\-inject\-qemu\-ga\fR METHOD (see ""customize"" below)" 4
+.el .IP "\fB\-\-inject\-qemu\-ga\fR METHOD (see \f(CWcustomize\fR below)" 4
.IX Item "--inject-qemu-ga METHOD (see customize below)"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.ie n .IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-inject\-virtio\-win\fR METHOD (see ""customize"" below)" 4
+.el .IP "\fB\-\-inject\-virtio\-win\fR METHOD (see \f(CWcustomize\fR below)" 4
.IX Item "--inject-virtio-win METHOD (see customize below)"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
.RE
-.ie n .IP "\fB\-\-install\fR \s-1PKG,PKG..\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-install\fR \s-1PKG,PKG..\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-install\fR PKG,PKG.. (see ""customize"" below)" 4
+.el .IP "\fB\-\-install\fR PKG,PKG.. (see \f(CWcustomize\fR below)" 4
.IX Item "--install PKG,PKG.. (see customize below)"
Install the named packages (a comma-separated list). These are installed during the image build using the guest’s package manager (eg. apt, yum, etc.) and the host’s network connection.
.Sp
-For an overview on the different ways to install packages, see \*(L"\s-1INSTALLING PACKAGES\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+For an overview on the different ways to install packages, see "INSTALLING PACKAGES" in \fBvirt\-builder\fR\|(1).
.Sp
See also \fI\-\-update\fR, \fI\-\-uninstall\fR.
-.ie n .IP "\fB\-\-keep\-user\-accounts\fR \s-1USERS\s0 (see ""user\-account"" below)" 4
-.el .IP "\fB\-\-keep\-user\-accounts\fR \s-1USERS\s0 (see \f(CWuser\-account\fR below)" 4
+.ie n .IP "\fB\-\-keep\-user\-accounts\fR USERS (see ""user\-account"" below)" 4
+.el .IP "\fB\-\-keep\-user\-accounts\fR USERS (see \f(CWuser\-account\fR below)" 4
.IX Item "--keep-user-accounts USERS (see user-account below)"
The user accounts to be kept in the guest. The value of this option is a list of user names separated by comma, where specifying an user means it is going to be kept. For example:
.Sp
.el .IP "\fB\-\-link\fR TARGET:LINK[:LINK..] (see \f(CWcustomize\fR below)" 4
.IX Item "--link TARGET:LINK[:LINK..] (see customize below)"
Create symbolic link(s) in the guest, starting at \f(CW\*(C`LINK\*(C'\fR and pointing at \f(CW\*(C`TARGET\*(C'\fR.
-.ie n .IP "\fB\-\-mkdir\fR \s-1DIR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-mkdir\fR \s-1DIR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-mkdir\fR DIR (see ""customize"" below)" 4
+.el .IP "\fB\-\-mkdir\fR DIR (see \f(CWcustomize\fR below)" 4
.IX Item "--mkdir DIR (see customize below)"
Create a directory in the guest.
.Sp
-This uses \f(CW\*(C`mkdir \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
-.ie n .IP "\fB\-\-move\fR \s-1SOURCE:DEST\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-move\fR \s-1SOURCE:DEST\s0 (see \f(CWcustomize\fR below)" 4
+This uses \f(CW\*(C`mkdir\ \-p\*(C'\fR so any intermediate directories are created, and it also works if the directory already exists.
+.ie n .IP "\fB\-\-move\fR SOURCE:DEST (see ""customize"" below)" 4
+.el .IP "\fB\-\-move\fR SOURCE:DEST (see \f(CWcustomize\fR below)" 4
.IX Item "--move SOURCE:DEST (see customize below)"
Move files or directories inside the guest.
.Sp
.IX Item "--no-logfile (see customize below)"
Scrub \f(CW\*(C`builder.log\*(C'\fR (log file from build commands) from the image after building is complete. If you don't want to reveal precisely how the image was built, use this option.
.Sp
-See also: \*(L"\s-1LOG FILE\*(R"\s0.
+See also: "LOG FILE".
.ie n .IP "\fB\-\-no\-selinux\-relabel\fR (see ""customize"" below)" 4
.el .IP "\fB\-\-no\-selinux\-relabel\fR (see \f(CWcustomize\fR below)" 4
.IX Item "--no-selinux-relabel (see customize below)"
In such guests that support SELinux, customization automatically relabels files so that they have the correct SELinux label. (The relabeling is performed immediately, but if the operation fails, customization will instead touch \fI/.autorelabel\fR on the image to schedule a relabel operation for the next time the image boots.) This option disables the automatic relabeling.
.Sp
The option is a no-op for guests that do not support SELinux.
-.ie n .IP "\fB\-\-password\fR \s-1USER:SELECTOR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-password\fR \s-1USER:SELECTOR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-password\fR USER:SELECTOR (see ""customize"" below)" 4
+.el .IP "\fB\-\-password\fR USER:SELECTOR (see \f(CWcustomize\fR below)" 4
.IX Item "--password USER:SELECTOR (see customize below)"
Set the password for \f(CW\*(C`USER\*(C'\fR. (Note this option does \fInot\fR create the user account).
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.ie n .IP "\fB\-\-password\-crypto\fR md5|sha256|sha512 (see ""customize"" below)" 4
.el .IP "\fB\-\-password\-crypto\fR md5|sha256|sha512 (see \f(CWcustomize\fR below)" 4
.IX Item "--password-crypto md5|sha256|sha512 (see customize below)"
.Sp
\&\f(CW\*(C`sha256\*(C'\fR and \f(CW\*(C`sha512\*(C'\fR require glibc ≥ 2.7 (check \fBcrypt\fR\|(3) inside the guest).
.Sp
-\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. \s-1RHEL 3\s0), but is not secure against modern attacks.
+\&\f(CW\*(C`md5\*(C'\fR will work with relatively old Linux guests (eg. RHEL 3), but is not secure against modern attacks.
.Sp
-The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for \s-1SHA\-512,\s0 in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
+The default is \f(CW\*(C`sha512\*(C'\fR unless libguestfs detects an old guest that didn't have support for SHA\-512, in which case it will use \f(CW\*(C`md5\*(C'\fR. You can override libguestfs by specifying this option.
.Sp
-Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
-.ie n .IP "\fB\-\-remove\-user\-accounts\fR \s-1USERS\s0 (see ""user\-account"" below)" 4
-.el .IP "\fB\-\-remove\-user\-accounts\fR \s-1USERS\s0 (see \f(CWuser\-account\fR below)" 4
+Note this does not change the default password encryption used by the guest when you create new user accounts inside the guest. If you want to do that, then you should use the \fI\-\-edit\fR option to modify \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) or \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+.ie n .IP "\fB\-\-remove\-user\-accounts\fR USERS (see ""user\-account"" below)" 4
+.el .IP "\fB\-\-remove\-user\-accounts\fR USERS (see \f(CWuser\-account\fR below)" 4
.IX Item "--remove-user-accounts USERS (see user-account below)"
The user accounts to be removed from the guest. The value of this option is a list of user names separated by comma, where specifying an user means it is going to be removed. For example:
.Sp
would only remove the user accounts \f(CW\*(C`bob\*(C'\fR and \f(CW\*(C`eve\*(C'\fR.
.Sp
This option can be specified multiple times.
-.ie n .IP "\fB\-\-root\-password\fR \s-1SELECTOR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-root\-password\fR \s-1SELECTOR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-root\-password\fR SELECTOR (see ""customize"" below)" 4
+.el .IP "\fB\-\-root\-password\fR SELECTOR (see \f(CWcustomize\fR below)" 4
.IX Item "--root-password SELECTOR (see customize below)"
Set the root password.
.Sp
-See \*(L"\s-1USERS AND PASSWORDS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
+See "USERS AND PASSWORDS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field, and also how to set up user accounts.
.Sp
Note: In virt-builder, if you \fIdon't\fR set \fI\-\-root\-password\fR then the guest is given a \fIrandom\fR root password.
-.ie n .IP "\fB\-\-run\fR \s-1SCRIPT\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-run\fR \s-1SCRIPT\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-run\fR SCRIPT (see ""customize"" below)" 4
+.el .IP "\fB\-\-run\fR SCRIPT (see \f(CWcustomize\fR below)" 4
.IX Item "--run SCRIPT (see customize below)"
Run the shell script (or any program) called \f(CW\*(C`SCRIPT\*(C'\fR on the disk image. The script runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
The script is automatically chmod +x.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.ie n .IP "\fB\-\-run\-command\fR '\s-1CMD+ARGS\s0' (see ""customize"" below)" 4
-.el .IP "\fB\-\-run\-command\fR '\s-1CMD+ARGS\s0' (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-run\-command\fR 'CMD+ARGS' (see ""customize"" below)" 4
+.el .IP "\fB\-\-run\-command\fR 'CMD+ARGS' (see \f(CWcustomize\fR below)" 4
.IX Item "--run-command 'CMD+ARGS' (see customize below)"
Run the command and arguments on the disk image. The command runs virtualized inside a small appliance, chrooted into the guest filesystem.
.Sp
-If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. \s-1ISO\s0 files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
+If libguestfs supports it then a limited network connection is available but it only allows outgoing network connections. You can also attach data disks (eg. ISO files) as another way to provide data (eg. software packages) to the script without needing a network connection (\fI\-\-attach\fR). You can also upload data files (\fI\-\-upload\fR).
.Sp
You can have multiple \fI\-\-run\-command\fR options. They run in the same order that they appear on the command line.
.Sp
See also: \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
-.ie n .IP "\fB\-\-script\fR \s-1SCRIPT\s0 (see ""script"" below)" 4
-.el .IP "\fB\-\-script\fR \s-1SCRIPT\s0 (see \f(CWscript\fR below)" 4
+.ie n .IP "\fB\-\-script\fR SCRIPT (see ""script"" below)" 4
+.el .IP "\fB\-\-script\fR SCRIPT (see \f(CWscript\fR below)" 4
.IX Item "--script SCRIPT (see script below)"
Run the named \f(CW\*(C`SCRIPT\*(C'\fR (a shell script or program) against the guest. The script can be any program on the host. The script’s current directory will be the guest’s root directory.
.Sp
\&\fBNote:\fR If the script is not on the \f(CW$PATH\fR, then you must give the full absolute path to the script.
-.ie n .IP "\fB\-\-scriptdir\fR \s-1SCRIPTDIR\s0 (see ""script"" below)" 4
-.el .IP "\fB\-\-scriptdir\fR \s-1SCRIPTDIR\s0 (see \f(CWscript\fR below)" 4
+.ie n .IP "\fB\-\-scriptdir\fR SCRIPTDIR (see ""script"" below)" 4
+.el .IP "\fB\-\-scriptdir\fR SCRIPTDIR (see \f(CWscript\fR below)" 4
.IX Item "--scriptdir SCRIPTDIR (see script below)"
The mount point (an empty directory on the host) used when the \f(CW\*(C`script\*(C'\fR operation is enabled and one or more scripts are specified using \fI\-\-script\fR parameter(s).
.Sp
\&\fBNote:\fR \f(CW\*(C`SCRIPTDIR\*(C'\fR \fBmust\fR be an absolute path.
.Sp
If \fI\-\-scriptdir\fR is not specified then a temporary mountpoint will be created.
-.ie n .IP "\fB\-\-scrub\fR \s-1FILE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-scrub\fR \s-1FILE\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-scrub\fR FILE (see ""customize"" below)" 4
+.el .IP "\fB\-\-scrub\fR FILE (see \f(CWcustomize\fR below)" 4
.IX Item "--scrub FILE (see customize below)"
Scrub a file from the guest. This is like \fI\-\-delete\fR except that:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
It scrubs the data so a guest could not recover it.
-.IP "\(bu" 4
+.IP \(bu 4
It cannot delete directories, only regular files.
.RE
.RS 4
.el .IP "\fB\-\-selinux\-relabel\fR (see \f(CWcustomize\fR below)" 4
.IX Item "--selinux-relabel (see customize below)"
This is a compatibility option that does nothing.
-.ie n .IP "\fB\-\-sm\-attach\fR \s-1SELECTOR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-sm\-attach\fR \s-1SELECTOR\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-sm\-attach\fR SELECTOR (see ""customize"" below)" 4
+.el .IP "\fB\-\-sm\-attach\fR SELECTOR (see \f(CWcustomize\fR below)" 4
.IX Item "--sm-attach SELECTOR (see customize below)"
Attach to a pool using \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
-.ie n .IP "\fB\-\-sm\-credentials\fR \s-1SELECTOR\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-sm\-credentials\fR \s-1SELECTOR\s0 (see \f(CWcustomize\fR below)" 4
+See "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+.ie n .IP "\fB\-\-sm\-credentials\fR SELECTOR (see ""customize"" below)" 4
+.el .IP "\fB\-\-sm\-credentials\fR SELECTOR (see \f(CWcustomize\fR below)" 4
.IX Item "--sm-credentials SELECTOR (see customize below)"
Set the credentials for \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-See \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+See "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
.ie n .IP "\fB\-\-sm\-register\fR (see ""customize"" below)" 4
.el .IP "\fB\-\-sm\-register\fR (see \f(CWcustomize\fR below)" 4
.IX Item "--sm-register (see customize below)"
.IX Item "--ssh-inject USER[:SELECTOR] (see customize below)"
Inject an ssh key so the given \f(CW\*(C`USER\*(C'\fR will be able to log in over ssh without supplying a password. The \f(CW\*(C`USER\*(C'\fR must exist already in the guest.
.Sp
-See \*(L"\s-1SSH KEYS\*(R"\s0 in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
+See "SSH KEYS" in \fBvirt\-builder\fR\|(1) for the format of the \f(CW\*(C`SELECTOR\*(C'\fR field.
.Sp
You can have multiple \fI\-\-ssh\-inject\fR options, for different users and also for more keys for each user.
-.ie n .IP "\fB\-\-timezone\fR \s-1TIMEZONE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-timezone\fR \s-1TIMEZONE\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR (see ""customize"" below)" 4
+.el .IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR (see \f(CWcustomize\fR below)" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR (see customize below)"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
+.ie n .IP "\fB\-\-timezone\fR TIMEZONE (see ""customize"" below)" 4
+.el .IP "\fB\-\-timezone\fR TIMEZONE (see \f(CWcustomize\fR below)" 4
.IX Item "--timezone TIMEZONE (see customize below)"
Set the default timezone of the guest to \f(CW\*(C`TIMEZONE\*(C'\fR. Use a location string like \f(CW\*(C`Europe/London\*(C'\fR
-.ie n .IP "\fB\-\-touch\fR \s-1FILE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-touch\fR \s-1FILE\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-touch\fR FILE (see ""customize"" below)" 4
+.el .IP "\fB\-\-touch\fR FILE (see \f(CWcustomize\fR below)" 4
.IX Item "--touch FILE (see customize below)"
This command performs a \fBtouch\fR\|(1)\-like operation on \f(CW\*(C`FILE\*(C'\fR.
-.ie n .IP "\fB\-\-truncate\fR \s-1FILE\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-truncate\fR \s-1FILE\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-truncate\fR FILE (see ""customize"" below)" 4
+.el .IP "\fB\-\-truncate\fR FILE (see \f(CWcustomize\fR below)" 4
.IX Item "--truncate FILE (see customize below)"
This command truncates \f(CW\*(C`FILE\*(C'\fR to a zero-length file. The file must exist already.
-.ie n .IP "\fB\-\-truncate\-recursive\fR \s-1PATH\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-truncate\-recursive\fR \s-1PATH\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-truncate\-recursive\fR PATH (see ""customize"" below)" 4
+.el .IP "\fB\-\-truncate\-recursive\fR PATH (see \f(CWcustomize\fR below)" 4
.IX Item "--truncate-recursive PATH (see customize below)"
This command recursively truncates all files under \f(CW\*(C`PATH\*(C'\fR to zero-length.
-.ie n .IP "\fB\-\-uninstall\fR \s-1PKG,PKG..\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-uninstall\fR \s-1PKG,PKG..\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-uninstall\fR PKG,PKG.. (see ""customize"" below)" 4
+.el .IP "\fB\-\-uninstall\fR PKG,PKG.. (see \f(CWcustomize\fR below)" 4
.IX Item "--uninstall PKG,PKG.. (see customize below)"
Uninstall the named packages (a comma-separated list). These are removed during the image build using the guest’s package manager (eg. apt, yum, etc.). Dependent packages may also need to be uninstalled to satisfy the request.
.Sp
Do the equivalent of \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR, or whatever command is required to update the packages already installed in the template to their latest versions.
.Sp
See also \fI\-\-install\fR, \fI\-\-uninstall\fR.
-.ie n .IP "\fB\-\-upload\fR \s-1FILE:DEST\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-upload\fR \s-1FILE:DEST\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-upload\fR FILE:DEST (see ""customize"" below)" 4
+.el .IP "\fB\-\-upload\fR FILE:DEST (see \f(CWcustomize\fR below)" 4
.IX Item "--upload FILE:DEST (see customize below)"
Upload local file \f(CW\*(C`FILE\*(C'\fR to destination \f(CW\*(C`DEST\*(C'\fR in the disk image. File owner and permissions from the original are preserved, so you should set them to what you want them to be in the disk image.
.Sp
If \f(CW\*(C`DEST\*(C'\fR is a directory name (which must already exist in the guest) then the file is uploaded into that directory, and it keeps the same name as on the local filesystem.
.Sp
See also: \fI\-\-mkdir\fR, \fI\-\-delete\fR, \fI\-\-scrub\fR.
-.ie n .IP "\fB\-\-write\fR \s-1FILE:CONTENT\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-write\fR \s-1FILE:CONTENT\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-write\fR FILE:CONTENT (see ""customize"" below)" 4
+.el .IP "\fB\-\-write\fR FILE:CONTENT (see \f(CWcustomize\fR below)" 4
.IX Item "--write FILE:CONTENT (see customize below)"
Write \f(CW\*(C`CONTENT\*(C'\fR to \f(CW\*(C`FILE\*(C'\fR.
-.SH "OPERATIONS"
+.SH OPERATIONS
.IX Header "OPERATIONS"
If the \fI\-\-enable\fR/\fI\-\-operations\fR option is \fInot\fR given, then most sysprep operations are enabled.
.PP
\&\f(CW\*(C`*\*(C'\fR = enabled by default when no \fI\-\-enable\fR/\fI\-\-operations\fR option is given.
.SS "\fBabrt-data\fP *"
.IX Subsection "abrt-data *"
-\&\s-1ABRT\s0 により生成されたクラッシュデータを削除します。
+ABRT により生成されたクラッシュデータを削除します。
.PP
-\&\f(CW\*(C`/var/spool/abrt/\*(C'\fR に自動的に生成された \s-1ABRT\s0 クラッシュデータを削除します。
+\&\f(CW\*(C`/var/spool/abrt/\*(C'\fR に自動的に生成された ABRT クラッシュデータを削除します。
.SS "\fBbackup-files\fP *"
.IX Subsection "backup-files *"
Remove editor backup files from the guest.
.PP
The following files are removed from anywhere in the guest filesystem:
-.IP "·" 4
+.IP · 4
*.bak
-.IP "·" 4
+.IP · 4
*~
.PP
On Linux and Unix operating systems, only the following filesystems will be examined:
-.IP "·" 4
+.IP · 4
/etc
-.IP "·" 4
+.IP · 4
/root
-.IP "·" 4
+.IP · 4
/srv
-.IP "·" 4
+.IP · 4
/tmp
-.IP "·" 4
+.IP · 4
/var
.SS "\fBbash-history\fP *"
.IX Subsection "bash-history *"
仮想マシンにおいて bash 履歴を削除します。
.PP
-ユーザー \*(L"root\*(R" および他のあらゆるユーザーのホームディレクトリーに \f(CW\*(C`.bash_history\*(C'\fR ファイルを持つユーザーの bash 履歴を削除します。
+ユーザー "root" および他のあらゆるユーザーのホームディレクトリーに \f(CW\*(C`.bash_history\*(C'\fR ファイルを持つユーザーの bash 履歴を削除します。
.PP
\fINotes on bash-history\fR
.IX Subsection "Notes on bash-history"
.SS "\fBblkid-tab\fP *"
.IX Subsection "blkid-tab *"
ゲストにある blkid テーブルを削除します。
-.SS "\fBca-certificates\fP"
+.SS \fBca-certificates\fP
.IX Subsection "ca-certificates"
-仮想マシンにおいて \s-1CA\s0 証明書を削除します。
+仮想マシンにおいて CA 証明書を削除します。
.PP
-In case any certificate is removed, the system \s-1CA\s0 store is updated.
+In case any certificate is removed, the system CA store is updated.
.SS "\fBcrash-data\fP *"
.IX Subsection "crash-data *"
kexec-tools により生成されたクラッシュデータを削除します。
Customize the guest by providing \fBvirt\-customize\fR\|(1) options for installing packages, editing files and so on.
.SS "\fBdhcp-client-state\fP *"
.IX Subsection "dhcp-client-state *"
-\&\s-1DHCP\s0 クライアントのリースを削除します。
+DHCP クライアントのリースを削除します。
.SS "\fBdhcp-server-state\fP *"
.IX Subsection "dhcp-server-state *"
-\&\s-1DHCP\s0 サーバーのリースを削除します。
+DHCP サーバーのリースを削除します。
.SS "\fBdovecot-data\fP *"
.IX Subsection "dovecot-data *"
Dovecot (メールサーバー) のデータを削除します。
-.SS "\fBfirewall-rules\fP"
+.SS \fBfirewall-rules\fP
.IX Subsection "firewall-rules"
ファイアウォールルールを削除します。
.PP
This removes custom firewall rules by removing \f(CW\*(C`/etc/sysconfig/iptables\*(C'\fR or custom firewalld configuration in \f(CW\*(C`/etc/firewalld/*/*\*(C'\fR.
.PP
Note this is \fInot\fR enabled by default since it may expose guests to exploits. Use with care.
-.SS "\fBflag-reconfiguration\fP"
+.SS \fBflag-reconfiguration\fP
.IX Subsection "flag-reconfiguration"
Flag the system for reconfiguration.
.PP
For Linux guests, this touches \f(CW\*(C`/.unconfigured\*(C'\fR, which causes the first boot to interactively query the user for settings such as the root password and timezone.
-.SS "\fBfs-uuids\fP"
+.SS \fBfs-uuids\fP
.IX Subsection "fs-uuids"
Change filesystem UUIDs.
.PP
参照: https://bugzilla.redhat.com/show_bug.cgi?id=991641
.SS "\fBipa-client\fP *"
.IX Subsection "ipa-client *"
-Remove the \s-1IPA\s0 files.
+Remove the IPA files.
.PP
-Remove all the files related to an \s-1IPA\s0 (Identity, Policy, Audit) system. This effectively unenrolls the guest from an \s-1IPA\s0 server without interacting with it.
+Remove all the files related to an IPA (Identity, Policy, Audit) system. This effectively unenrolls the guest from an IPA server without interacting with it.
.PP
This operation does not run \f(CW\*(C`ipa\-client\*(C'\fR.
-.SS "\fBkerberos-data\fP"
+.SS \fBkerberos-data\fP
.IX Subsection "kerberos-data"
仮想マシンにおいて Kerberos のデータを削除します。
.SS "\fBkerberos-hostkeytab\fP *"
仮想マシンから多くのログファイルを削除します。
.PP
Linux においては以下のファイルが削除されます:
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.cnf
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.crt
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.csr
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.pem
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.srl
-.IP "·" 4
+.IP · 4
/root/anaconda\-ks.cfg
-.IP "·" 4
+.IP · 4
/root/anaconda\-post.log
-.IP "·" 4
+.IP · 4
/root/initial\-setup\-ks.cfg
-.IP "·" 4
+.IP · 4
/root/install.log
-.IP "·" 4
+.IP · 4
/root/install.log.syslog
-.IP "·" 4
+.IP · 4
/root/original\-ks.cfg
-.IP "·" 4
+.IP · 4
/var/cache/fontconfig/*
-.IP "·" 4
+.IP · 4
/var/cache/gdm/*
-.IP "·" 4
+.IP · 4
/var/cache/man/*
-.IP "·" 4
+.IP · 4
/var/lib/AccountService/users/*
-.IP "·" 4
+.IP · 4
/var/lib/fprint/*
-.IP "·" 4
+.IP · 4
/var/lib/logrotate.status
-.IP "·" 4
+.IP · 4
/var/log/*.log*
-.IP "·" 4
+.IP · 4
/var/log/BackupPC/LOG
-.IP "·" 4
+.IP · 4
/var/log/ConsoleKit/*
-.IP "·" 4
+.IP · 4
/var/log/anaconda.syslog
-.IP "·" 4
+.IP · 4
/var/log/anaconda/*
-.IP "·" 4
+.IP · 4
/var/log/apache2/*_log
-.IP "·" 4
+.IP · 4
/var/log/apache2/*_log\-*
-.IP "·" 4
+.IP · 4
/var/log/apt/*
-.IP "·" 4
+.IP · 4
/var/log/aptitude*
-.IP "·" 4
+.IP · 4
/var/log/audit/*
-.IP "·" 4
+.IP · 4
/var/log/btmp*
-.IP "·" 4
+.IP · 4
/var/log/ceph/*.log
-.IP "·" 4
+.IP · 4
/var/log/chrony/*.log
-.IP "·" 4
+.IP · 4
/var/log/cron*
-.IP "·" 4
+.IP · 4
/var/log/cups/*_log*
-.IP "·" 4
+.IP · 4
/var/log/debug*
-.IP "·" 4
+.IP · 4
/var/log/dmesg*
-.IP "·" 4
+.IP · 4
/var/log/exim4/*
-.IP "·" 4
+.IP · 4
/var/log/faillog*
-.IP "·" 4
+.IP · 4
/var/log/firewalld*
-.IP "·" 4
+.IP · 4
/var/log/gdm/*
-.IP "·" 4
+.IP · 4
/var/log/glusterfs/*glusterd.vol.log
-.IP "·" 4
+.IP · 4
/var/log/glusterfs/glusterfs.log
-.IP "·" 4
+.IP · 4
/var/log/grubby*
-.IP "·" 4
+.IP · 4
/var/log/httpd/*log
-.IP "·" 4
+.IP · 4
/var/log/installer/*
-.IP "·" 4
+.IP · 4
/var/log/jetty/jetty\-console.log
-.IP "·" 4
+.IP · 4
/var/log/journal/*
-.IP "·" 4
+.IP · 4
/var/log/lastlog*
-.IP "·" 4
+.IP · 4
/var/log/libvirt/libvirtd.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/libxl/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/lxc/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/qemu/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/uml/*.log
-.IP "·" 4
+.IP · 4
/var/log/lightdm/*
-.IP "·" 4
+.IP · 4
/var/log/mail/*
-.IP "·" 4
+.IP · 4
/var/log/maillog*
-.IP "·" 4
+.IP · 4
/var/log/messages*
-.IP "·" 4
+.IP · 4
/var/log/ntp
-.IP "·" 4
+.IP · 4
/var/log/ntpstats/*
-.IP "·" 4
+.IP · 4
/var/log/ppp/connect\-errors
-.IP "·" 4
+.IP · 4
/var/log/rhsm/*
-.IP "·" 4
+.IP · 4
/var/log/sa/*
-.IP "·" 4
+.IP · 4
/var/log/secure*
-.IP "·" 4
+.IP · 4
/var/log/setroubleshoot/*.log
-.IP "·" 4
+.IP · 4
/var/log/spooler*
-.IP "·" 4
+.IP · 4
/var/log/squid/*.log
-.IP "·" 4
+.IP · 4
/var/log/syslog*
-.IP "·" 4
+.IP · 4
/var/log/tallylog*
-.IP "·" 4
+.IP · 4
/var/log/tuned/tuned.log
-.IP "·" 4
+.IP · 4
/var/log/wtmp*
-.IP "·" 4
+.IP · 4
/var/log/xferlog*
-.IP "·" 4
+.IP · 4
/var/named/data/named.run
.SS "\fBlvm-system-devices\fP *"
.IX Subsection "lvm-system-devices *"
-Remove \s-1LVM2\s0 system.devices file.
+Remove LVM2 system.devices file.
.PP
-On Linux guests, \s-1LVM2\s0's scanning for physical volumes (PVs) may be restricted to those block devices whose WWIDs are listed in \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR. When cloning VMs, WWIDs may change, breaking \f(CW\*(C`lvm pvscan\*(C'\fR. Remove \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR.
+On Linux guests, LVM2's scanning for physical volumes (PVs) may be restricted to those block devices whose WWIDs are listed in \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR. When cloning VMs, WWIDs may change, breaking \f(CW\*(C`lvm pvscan\*(C'\fR. Remove \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR.
.SS "\fBlvm-uuids\fP *"
.IX Subsection "lvm-uuids *"
-\&\s-1LVM2\s0 の \s-1PV\s0 および \s-1VG\s0 の \s-1UUID\s0 を変更します。
+LVM2 の PV および VG の UUID を変更します。
.PP
-\&\s-1LVM2\s0 物理ボリューム (\s-1PV\s0) またはボリュームグループ (\s-1VG\s0) を持つ Linux 仮想マシンにおいて、新しいランダムな \s-1UUID\s0 が生成され、これらの \s-1PV\s0 や \s-1VG\s0 に割り当てられます。
+LVM2 物理ボリューム (PV) またはボリュームグループ (VG) を持つ Linux 仮想マシンにおいて、新しいランダムな UUID が生成され、これらの PV や VG に割り当てられます。
.SS "\fBmachine-id\fP *"
.IX Subsection "machine-id *"
-ローカルマシン \s-1ID\s0 を削除します。
+ローカルマシン ID を削除します。
.PP
-The machine \s-1ID\s0 is usually generated from a random source during system installation and stays constant for all subsequent boots. Optionally, for stateless systems it is generated during runtime at boot if it is found to be empty.
+The machine ID is usually generated from a random source during system installation and stays constant for all subsequent boots. Optionally, for stateless systems it is generated during runtime at boot if it is found to be empty.
.SS "\fBmail-spool\fP *"
.IX Subsection "mail-spool *"
ローカルのメールスプールのディレクトリから電子メールを削除します。
.SS "\fBnet-hostname\fP *"
.IX Subsection "net-hostname *"
-Remove \s-1HOSTNAME\s0 and \s-1DHCP_HOSTNAME\s0 in network interface configuration.
+Remove HOSTNAME and DHCP_HOSTNAME in network interface configuration.
.PP
Fedora および Red Hat Enterprise Linux に対して、これは \f(CW\*(C`ifcfg\-*\*(C'\fR ファイルから削除されます。
.SS "\fBnet-hwaddr\fP *"
.IX Subsection "net-hwaddr *"
-\&\s-1HWADDR\s0 (ハードコードされた \s-1MAC\s0 アドレス) 設定を削除します。
+HWADDR (ハードコードされた MAC アドレス) 設定を削除します。
.PP
Fedora および Red Hat Enterprise Linux に対して、これは \f(CW\*(C`ifcfg\-*\*(C'\fR ファイルから削除されます。
.SS "\fBnet-nmconn\fP *"
パッケージマネージャーのキャッシュを削除します。
.SS "\fBpam-data\fP *"
.IX Subsection "pam-data *"
-ゲストにある \s-1PAM\s0 データを削除します。
+ゲストにある PAM データを削除します。
.SS "\fBpasswd-backups\fP *"
.IX Subsection "passwd-backups *"
Remove /etc/passwd\- and similar backup files.
.PP
Linux においては以下のファイルが削除されます:
-.IP "·" 4
+.IP · 4
/etc/group\-
-.IP "·" 4
+.IP · 4
/etc/gshadow\-
-.IP "·" 4
+.IP · 4
/etc/passwd\-
-.IP "·" 4
+.IP · 4
/etc/shadow\-
-.IP "·" 4
+.IP · 4
/etc/subgid\-
-.IP "·" 4
+.IP · 4
/etc/subuid\-
.SS "\fBpuppet-data-log\fP *"
.IX Subsection "puppet-data-log *"
Puppet のデータおよびログファイルを削除します。
.SS "\fBrh-subscription-manager\fP *"
.IX Subsection "rh-subscription-manager *"
-Remove the \s-1RH\s0 subscription manager files.
+Remove the RH subscription manager files.
.SS "\fBrhn-systemid\fP *"
.IX Subsection "rhn-systemid *"
-\&\s-1RHN\s0 システム \s-1ID\s0 を削除します。
+RHN システム ID を削除します。
.SS "\fBrpm-db\fP *"
.IX Subsection "rpm-db *"
-Remove host-specific \s-1RPM\s0 database files.
+Remove host-specific RPM database files.
.PP
-Remove host-specific \s-1RPM\s0 database files and locks. \s-1RPM\s0 will recreate these files automatically if needed.
+Remove host-specific RPM database files and locks. RPM will recreate these files automatically if needed.
.SS "\fBsamba-db-log\fP *"
.IX Subsection "samba-db-log *"
Samba のデータベースおよびログファイルを削除します。
.PP
The \f(CW\*(C`script\*(C'\fR module lets you run arbitrary shell scripts or programs against the guest.
.PP
-Note this feature requires \s-1FUSE\s0 support. You may have to enable this in your host, for example by adding the current user to the \f(CW\*(C`fuse\*(C'\fR group, or by loading a kernel module.
+Note this feature requires FUSE support. You may have to enable this in your host, for example by adding the current user to the \f(CW\*(C`fuse\*(C'\fR group, or by loading a kernel module.
.PP
Use one or more \fI\-\-script\fR parameters to specify scripts or programs that will be run against the guest.
.PP
-The script or program is run with its current directory being the guest’s root directory, so relative paths should be used. For example: \f(CW\*(C`rm etc/resolv.conf\*(C'\fR in the script would remove a Linux guest’s \s-1DNS\s0 configuration file, but \f(CW\*(C`rm /etc/resolv.conf\*(C'\fR would (try to) remove the host’s file.
+The script or program is run with its current directory being the guest’s root directory, so relative paths should be used. For example: \f(CW\*(C`rm etc/resolv.conf\*(C'\fR in the script would remove a Linux guest’s DNS configuration file, but \f(CW\*(C`rm /etc/resolv.conf\*(C'\fR would (try to) remove the host’s file.
.PP
Normally a temporary mount point for the guest is used, but you can choose a specific one by using the \fI\-\-scriptdir\fR parameter.
.PP
\&\fBNote:\fR This is different from \fI\-\-firstboot\fR scripts (which run in the context of the guest when it is booting first time). \fI\-\-script\fR scripts run on the host, not in the guest.
.SS "\fBsmolt-uuid\fP *"
.IX Subsection "smolt-uuid *"
-Smolt ハードウェア \s-1UUID\s0 を削除します。
+Smolt ハードウェア UUID を削除します。
.SS "\fBssh-hostkeys\fP *"
.IX Subsection "ssh-hostkeys *"
-仮想マシンの \s-1SSH\s0 ホストキーを削除します。
+仮想マシンの SSH ホストキーを削除します。
.PP
-仮想マシンの次回起動時に（異なる） \s-1SSH\s0 ホストキーが再生成されます。
+仮想マシンの次回起動時に（異なる） SSH ホストキーが再生成されます。
.PP
-クローン後、仮想マシンが同じ \s-1IP\s0 アドレスを取得すると、ホストキーが変更されたという警告が ssh により表示されます:
+クローン後、仮想マシンが同じ IP アドレスを取得すると、ホストキーが変更されたという警告が ssh により表示されます:
.PP
.Vb 4
\& @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
.Ve
.SS "\fBssh-userdir\fP *"
.IX Subsection "ssh-userdir *"
-仮想マシンにある \*(L".ssh\*(R" ディレクトリーを削除します。
+仮想マシンにある ".ssh" ディレクトリーを削除します。
.PP
-ユーザー \*(L"root\*(R" 、およびホームディレクトリーに \f(CW\*(C`.ssh\*(C'\fR ディレクトリーがある他のすべてのユーザーの、\f(CW\*(C`.ssh\*(C'\fR ディレクトリーを削除します。
+ユーザー "root" 、およびホームディレクトリーに \f(CW\*(C`.ssh\*(C'\fR ディレクトリーがある他のすべてのユーザーの、\f(CW\*(C`.ssh\*(C'\fR ディレクトリーを削除します。
.PP
\fINotes on ssh-userdir\fR
.IX Subsection "Notes on ssh-userdir"
Currently this only looks in \f(CW\*(C`/root\*(C'\fR and \f(CW\*(C`/home/*\*(C'\fR for home directories, so users with home directories in other locations won't have the ssh files removed.
.SS "\fBsssd-db-log\fP *"
.IX Subsection "sssd-db-log *"
-\&\s-1SSSD\s0 のデータベースとログファイルを削除します。
+SSSD のデータベースとログファイルを削除します。
.SS "\fBtmp-files\fP *"
.IX Subsection "tmp-files *"
一時ファイルを削除します。
.IX Subsection "udev-persistent-net *"
udev persistent net ルールを削除します。
.PP
-Remove udev persistent net rules which map the guest’s existing \s-1MAC\s0 address to a fixed ethernet device (eg. eth0).
+Remove udev persistent net rules which map the guest’s existing MAC address to a fixed ethernet device (eg. eth0).
.PP
-仮想マシンをクローンした後、通常 \s-1MAC\s0 アドレスは変わります。古い \s-1MAC\s0 アドレスは古い名前（たとえば eth0）を占有するため、このことは新しい \s-1MAC\s0 アドレスが新しい名前（たとえば eth1）に割り当てられることを意味します。それは、一般的に好ましくありません。 udev の永続的な net ルールを削除することにより、これを避けます。
-.SS "\fBuser-account\fP"
+仮想マシンをクローンした後、通常 MAC アドレスは変わります。古い MAC アドレスは古い名前（たとえば eth0）を占有するため、このことは新しい MAC アドレスが新しい名前（たとえば eth1）に割り当てられることを意味します。それは、一般的に好ましくありません。 udev の永続的な net ルールを削除することにより、これを避けます。
+.SS \fBuser-account\fP
.IX Subsection "user-account"
仮想マシンにあるユーザーアカウントを削除します。
.PP
-By default remove all the user accounts and their home directories. The \*(L"root\*(R" account is not removed.
+By default remove all the user accounts and their home directories. The "root" account is not removed.
.PP
See the \fI\-\-remove\-user\-accounts\fR parameter for a way to specify how to remove only some users, or to not remove some others.
.SS "\fButmp\fP *"
This file records who is currently logged in on a machine. In modern Linux distros it is stored in a ramdisk and hence not part of the virtual machine’s disk, but it was stored on disk in older distros.
.SS "\fByum-uuid\fP *"
.IX Subsection "yum-uuid *"
-yum \s-1UUID\s0 を削除します。
+yum UUID を削除します。
.PP
-yum は元々の \s-1UUID\s0 が削除されたことを通知するとき、次の実行時に新しい \s-1UUID\s0 を作成します。
-.SH "コピー方法およびクローン方法"
+yum は元々の UUID が削除されたことを通知するとき、次の実行時に新しい UUID を作成します。
+.SH コピー方法およびクローン方法
.IX Header "コピー方法およびクローン方法"
virt-sysprep は仮想マシンをクローンするプロセスの一部として使用できます。もしくは、クローンされた仮想マシンからテンプレートを準備するために使用できます。仮想化ツールを使用してこれを実現する他の方法がいろいろとあります。このセクションは単に概要を説明します。
.PP
仮想マシン（停止状態の場合）は 2 つの部分からなります:
-.IP "\fIconfiguration\fR" 4
+.IP \fIconfiguration\fR 4
.IX Item "configuration"
-仮想マシンの設定または説明。 例: libvirt \s-1XML\s0 (\f(CW\*(C`virsh dumpxml\*(C'\fR 参照) 、仮想マシンの実行中の設定、または \s-1OVF\s0 のような他の外部形式。
+仮想マシンの設定または説明。 例: libvirt XML (\f(CW\*(C`virsh dumpxml\*(C'\fR 参照) 、仮想マシンの実行中の設定、または OVF のような他の外部形式。
.Sp
いくつかの設定項目は変更する必要があるかもしれません:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
名前
-.IP "\(bu" 4
-\&\s-1UUID\s0
-.IP "\(bu" 4
+.IP \(bu 4
+UUID
+.IP \(bu 4
ブロックデバイスへのパス
-.IP "\(bu" 4
-ネットワークカードの \s-1MAC\s0 アドレス
+.IP \(bu 4
+ネットワークカードの MAC アドレス
.RE
.RS 4
.RE
-.IP "\fIブロックデバイス\fR" 4
+.IP \fIブロックデバイス\fR 4
.IX Item "ブロックデバイス"
One or more hard disk images, themselves containing files, directories, applications, kernels, configuration, etc.
.Sp
Some things inside the block devices that might need to be changed:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
ホスト名および他のネットワーク設定
-.IP "\(bu" 4
-\&\s-1UUID\s0
-.IP "\(bu" 4
-\&\s-1SSH\s0 ホストキー
-.IP "\(bu" 4
-Windows の一意なセキュリティ \s-1ID\s0 (\s-1SID\s0)
-.IP "\(bu" 4
+.IP \(bu 4
+UUID
+.IP \(bu 4
+SSH ホストキー
+.IP \(bu 4
+Windows の一意なセキュリティ ID (SID)
+.IP \(bu 4
Puppet の登録
.RE
.RS 4
.RE
-.SS "ブロックデバイスのコピー法"
+.SS ブロックデバイスのコピー法
.IX Subsection "ブロックデバイスのコピー法"
Starting with an original guest, you probably wish to copy the guest block device and its configuration to make a template. Then once you are happy with the template, you will want to make many clones from it.
.PP
\& 元の仮想マシン \-\-\-\-> テンプレート \-\-\-\-> コピー済み \-\-\-\-\-\-> カスタム
\& テンプレート 仮想マシン
.Ve
-.IP "\(bu" 4
+.IP \(bu 4
Create a snapshot using qemu-img:
.Sp
.Vb 1
The advantage is that you don’t need to copy the original (very fast) and only changes are stored (less storage required).
.Sp
Note that writing to the backing file once you have created guests on top of it is not possible: you will corrupt the guests.
-.IP "\(bu" 4
+.IP \(bu 4
\&\f(CW\*(C`lvcreate \-\-snapshot\*(C'\fR を使用してスナップショットを作成します。
-.IP "\(bu" 4
+.IP \(bu 4
Other ways to create snapshots include using filesystems-level tools (for filesystems such as btrfs).
.Sp
-Most Network Attached Storage (\s-1NAS\s0) devices can also create cheap snapshots from files or LUNs.
-.IP "\(bu" 4
-Get your \s-1NAS\s0 to duplicate the \s-1LUN.\s0 Most \s-1NAS\s0 devices can also duplicate LUNs very cheaply (they copy them on-demand in the background).
-.IP "\(bu" 4
+Most Network Attached Storage (NAS) devices can also create cheap snapshots from files or LUNs.
+.IP \(bu 4
+Get your NAS to duplicate the LUN. Most NAS devices can also duplicate LUNs very cheaply (they copy them on-demand in the background).
+.IP \(bu 4
\&\fBvirt\-sparsify\fR\|(1) を使用してテンプレートを準備します。以下を参照してください。
-.SS "virt-clone"
+.SS virt-clone
.IX Subsection "virt-clone"
-A separate tool, \fBvirt\-clone\fR\|(1), can be used to duplicate the block device and/or modify the external libvirt configuration of a guest. It will reset the name, \s-1UUID\s0 and \s-1MAC\s0 address of the guest in the libvirt \s-1XML.\s0
+A separate tool, \fBvirt\-clone\fR\|(1), can be used to duplicate the block device and/or modify the external libvirt configuration of a guest. It will reset the name, UUID and MAC address of the guest in the libvirt XML.
.PP
\&\fBvirt\-clone\fR\|(1) does not use libguestfs and cannot look inside the disk image. This was the original motivation to write virt-sysprep.
-.SS "スパース化"
+.SS スパース化
.IX Subsection "スパース化"
.Vb 2
\& virt\-sparsify
\&\fBvirt\-sparsify\fR\|(1) can be used to make the cloning template smaller, making it easier to compress and/or faster to copy.
.PP
Notice that since virt-sparsify also copies the image, you can use it to make the initial copy (instead of \f(CW\*(C`dd\*(C'\fR).
-.SS "容量変更"
+.SS 容量変更
.IX Subsection "容量変更"
.Vb 5
\& virt\-resize
.IX Header "FIRSTBOOT VS SCRIPT"
The two options \fI\-\-firstboot\fR and \fI\-\-script\fR both supply shell scripts that are run against the guest. However these two options are significantly different.
.PP
-\&\fI\-\-firstboot script\fR uploads the file \f(CW\*(C`script\*(C'\fR into the guest and arranges that it will run, in the guest, when the guest is next booted. (The script will only run once, at the \*(L"first boot\*(R").
+\&\fI\-\-firstboot script\fR uploads the file \f(CW\*(C`script\*(C'\fR into the guest and arranges that it will run, in the guest, when the guest is next booted. (The script will only run once, at the "first boot").
.PP
\&\fI\-\-script script\fR runs the shell \f(CW\*(C`script\*(C'\fR \fIon the host\fR, with its current directory inside the guest filesystem.
.PP
On the other hand if you need to make adjustments to the guest filesystem (eg. copying in files), then \fI\-\-script\fR is ideal since (a) it has access to the host filesystem and (b) you will get immediate feedback on errors.
.PP
Either or both options can be used multiple times on the command line.
-.SH "セキュリティ"
+.SH セキュリティ
.IX Header "セキュリティ"
-Virtual machines that employ full disk encryption \fIinternally to the guest\fR should not be considered for cloning and distribution, as it provides multiple parties with the same internal volume key, enabling any one such party to decrypt all the other clones. Refer to the \s-1LUKS FAQ\s0 for details.
+Virtual machines that employ full disk encryption \fIinternally to the guest\fR should not be considered for cloning and distribution, as it provides multiple parties with the same internal volume key, enabling any one such party to decrypt all the other clones. Refer to the LUKS FAQ for details.
.PP
-Although virt-sysprep removes some sensitive information from the guest, it does not pretend to remove all of it. You should examine the \*(L"\s-1OPERATIONS\*(R"\s0 above and the guest afterwards.
+Although virt-sysprep removes some sensitive information from the guest, it does not pretend to remove all of it. You should examine the "OPERATIONS" above and the guest afterwards.
.PP
Sensitive files are simply removed. The data they contained may still exist on the disk, easily recovered with a hex editor or undelete tool. The \fI\-\-scrub\fR option can be used to scrub files instead of just deleting them. \fBvirt\-sparsify\fR\|(1) is another way to remove this content. See also the \fBscrub\fR\|(1) command to get rid of deleted content in directory entries and inodes.
-.SS "乱数の種"
+.SS 乱数の種
.IX Subsection "乱数の種"
\&\fI(このセクションは Linux 仮想マシンのみに適用します)\fR
.PP
For supported guests, virt-sysprep writes a few bytes of randomness from the host into the guest’s random seed file.
.PP
-If this is just done once and the guest is cloned from the same template, then each guest will start with the same entropy, and things like \s-1SSH\s0 host keys and \s-1TCP\s0 sequence numbers may be predictable.
+If this is just done once and the guest is cloned from the same template, then each guest will start with the same entropy, and things like SSH host keys and TCP sequence numbers may be predictable.
.PP
Therefore you should arrange to add more randomness \fIafter\fR cloning from a template too, which can be done by enabling just the customize module:
.PP
\& cp template.img newguest.img
\& virt\-sysprep \-\-enable customize \-a newguest.img
.Ve
-.SH "SELinux"
+.SH SELinux
.IX Header "SELinux"
For guests which make use of SELinux, special handling for them might be needed when using operations which create new files or alter existing ones.
.PP
-For further details, see \*(L"\s-1SELINUX\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+For further details, see "SELINUX" in \fBvirt\-builder\fR\|(1).
.SH "WINDOWS 8"
.IX Header "WINDOWS 8"
-Windows 8 \*(L"fast startup\*(R" can prevent virt-sysprep from working. See \*(L"\s-1WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "終了ステータス"
+Windows 8 "fast startup" can prevent virt-sysprep from working. See "WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" in \fBguestfs\fR\|(3).
+.SH 終了ステータス
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を返します。または、エラーが起きると 1 を返します。
-.SH "環境変数"
+.SH 環境変数
.IX Header "環境変数"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
This can point to the directory containing data files used for Windows firstboot installation.
.Sp
.Sp
This directory may contain the following files:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
-This is the RHSrvAny Windows binary, used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is the RHSrvAny Windows binary, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.Sp
See also: \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-This is a Windows binary shipped with \s-1SUSE VMDP,\s0 used to install a \*(L"firstboot\*(R" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
+This is a Windows binary shipped with SUSE VMDP, used to install a "firstboot" script in Windows guests. It is required if you intend to use the \fI\-\-firstboot\fR or \fI\-\-firstboot\-command\fR options with Windows guests.
.RE
.RS 4
.RE
.PP
-他の環境変数は \*(L"環境変数\*(R" in \fBguestfs\fR\|(3) を参照してください。
-.SH "関連項目"
+他の環境変数は "環境変数" in \fBguestfs\fR\|(3) を参照してください。
+.SH 関連項目
.IX Header "関連項目"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-builder\fR\|(1), \fBvirt\-clone\fR\|(1), \fBvirt\-customize\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirsh\fR\|(1), \fBlvcreate\fR\|(8), \fBqemu\-img\fR\|(1), \fBscrub\fR\|(1), http://libguestfs.org/, http://libvirt.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
.PP
Wanlong Gao, Fujitsu Ltd.
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2011\-2023 Red Hat Inc.
.PP
Copyright (C) 2012 Fujitsu Ltd.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-win-reg 1"
-.TH virt-win-reg 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-win-reg 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "名前"
+.SH 名前
.IX Header "名前"
virt-win-reg \- Windows 仮想マシンからの Windows レジストリエントリーのエクスポートおよびマージ
-.SH "書式"
+.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-win\-reg domname \*(AqHKLM\ePath\eTo\eSubkey\*(Aq
\&
\& virt\-win\-reg [\-\-options] disk.img ... # 仮想マシン名の代わり
.Ve
-.SH "警告"
+.SH 警告
.IX Header "警告"
-You must \fInot\fR use \f(CW\*(C`virt\-win\-reg\*(C'\fR with the \fI\-\-merge\fR option on live virtual machines. If you do this, you \fIwill\fR get irreversible disk corruption in the \s-1VM.\s0 \f(CW\*(C`virt\-win\-reg\*(C'\fR tries to stop you from doing this, but doesn't catch all cases.
+You must \fInot\fR use \f(CW\*(C`virt\-win\-reg\*(C'\fR with the \fI\-\-merge\fR option on live virtual machines. If you do this, you \fIwill\fR get irreversible disk corruption in the VM. \f(CW\*(C`virt\-win\-reg\*(C'\fR tries to stop you from doing this, but doesn't catch all cases.
.PP
Modifying the Windows Registry is an inherently risky operation. The format is deliberately obscure and undocumented, and Registry changes can leave the system unbootable. Therefore when using the \fI\-\-merge\fR option, make sure you have a reliable backup first.
-.SH "説明"
+.SH 説明
.IX Header "説明"
このプログラムは Windows 仮想マシンから Windows レジストリのエントリーをエクスポートおよびマージできます。
.PP
.Vb 1
\& $ virt\-win\-reg \-\-merge Windows7 changes.reg
.Ve
-.SS "注記"
+.SS 注記
.IX Subsection "注記"
This program is only meant for simple access to the registry. If you want to do complicated things with the registry, we suggest you download the Registry hive files from the guest using \fBlibguestfs\fR\|(3) or \fBguestfish\fR\|(1) and access them locally, eg. using \fBhivex\fR\|(3), \fBhivexsh\fR\|(1) or \fBhivexregedit\fR\|(1).
-.SH "オプション"
+.SH オプション
.IX Header "オプション"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
簡単なヘルプを表示します。
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
バージョン番号を表示して、終了します。
-.IP "\fB\-\-debug\fR" 4
+.IP \fB\-\-debug\fR 4
.IX Item "--debug"
デバッグメッセージを有効にします。
-.IP "\fB\-c \s-1URI\s0\fR" 4
+.IP "\fB\-c URI\fR" 4
.IX Item "-c URI"
.PD 0
-.IP "\fB\-\-connect \s-1URI\s0\fR" 4
+.IP "\fB\-\-connect URI\fR" 4
.IX Item "--connect URI"
.PD
-libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
+libvirt を使用していると、指定された \fIURI\fR に接続します。 省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
仮想マシンのブロックデバイスを直接指定すると、libvirt はまったく使用されません。
.IP "\fB\-\-format\fR raw" 4
If disk images are requested from libvirt, then this program asks libvirt for this information. In this case, the value of the format parameter is ignored.
.Sp
If working with untrusted raw-format guest disk images, you should ensure the format is always specified.
-.IP "\fB\-\-merge\fR" 4
+.IP \fB\-\-merge\fR 4
.IX Item "--merge"
In merge mode, this merges a textual regedit file into the Windows Registry of the virtual machine. If this flag is \fInot\fR given then virt-win-reg displays or exports Registry entries instead.
.Sp
Note that \fI\-\-merge\fR is \fIunsafe\fR to use on live virtual machines, and will result in disk corruption. However exporting (without this flag) is always safe.
.IP "\fB\-\-encoding\fR UTF\-16LE|ASCII" 4
.IX Item "--encoding UTF-16LE|ASCII"
-When merging (only), you may need to specify the encoding for strings to be used in the hive file. This is explained in detail in \*(L"\s-1ENCODING STRINGS\*(R"\s0 in \fBWin::Hivex::Regedit\fR\|(3).
+When merging (only), you may need to specify the encoding for strings to be used in the hive file. This is explained in detail in "ENCODING STRINGS" in \fBWin::Hivex::Regedit\fR\|(3).
.Sp
-The default is to use \s-1UTF\-16LE,\s0 which should work with recent versions of Windows.
-.IP "\fB\-\-unsafe\-printable\-strings\fR" 4
+The default is to use UTF\-16LE, which should work with recent versions of Windows.
+.IP \fB\-\-unsafe\-printable\-strings\fR 4
.IX Item "--unsafe-printable-strings"
-When exporting (only), assume strings are \s-1UTF\-16LE\s0 and print them as strings instead of hex sequences. Remove the final zero codepoint from strings if present.
+When exporting (only), assume strings are UTF\-16LE and print them as strings instead of hex sequences. Remove the final zero codepoint from strings if present.
.Sp
This is unsafe and does not preserve the fidelity of strings in the original Registry for various reasons:
.RS 4
-.IP "\(bu" 4
-Assumes the original encoding is \s-1UTF\-16LE.\s0 \s-1ASCII\s0 strings and strings in other encodings will be corrupted by this transformation.
-.IP "\(bu" 4
+.IP \(bu 4
+Assumes the original encoding is UTF\-16LE. ASCII strings and strings in other encodings will be corrupted by this transformation.
+.IP \(bu 4
Assumes that everything which has type 1 or 2 is really a string and that everything else is not a string, but the type field in real Registries is not reliable.
-.IP "\(bu" 4
+.IP \(bu 4
Loses information about whether a zero codepoint followed the string in the Registry or not.
.RE
.RS 4
.Sp
-This all happens because the Registry itself contains no information about how strings are encoded (see \*(L"\s-1ENCODING STRINGS\*(R"\s0 in \fBWin::Hivex::Regedit\fR\|(3)).
+This all happens because the Registry itself contains no information about how strings are encoded (see "ENCODING STRINGS" in \fBWin::Hivex::Regedit\fR\|(3)).
.Sp
You should only use this option for quick hacking and debugging of the Registry contents, and \fInever\fR use it if the output is going to be passed into another program or stored in another Registry.
.RE
-.SH "サポートされるシステム"
+.SH サポートされるシステム
.IX Header "サポートされるシステム"
-The program currently supports Windows NT-derived guests starting with Windows \s-1XP\s0 through to at least Windows 8.
+The program currently supports Windows NT-derived guests starting with Windows XP through to at least Windows 8.
.PP
以下のレジストリキーがサポートされます:
.ie n .IP """HKEY_LOCAL_MACHINE\eSAM""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSAM\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSAM\fR 4
.IX Item "HKEY_LOCAL_MACHINESAM"
.PD 0
.ie n .IP """HKEY_LOCAL_MACHINE\eSECURITY""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSECURITY\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSECURITY\fR 4
.IX Item "HKEY_LOCAL_MACHINESECURITY"
.ie n .IP """HKEY_LOCAL_MACHINE\eSOFTWARE""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSOFTWARE\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSOFTWARE\fR 4
.IX Item "HKEY_LOCAL_MACHINESOFTWARE"
.ie n .IP """HKEY_LOCAL_MACHINE\eSYSTEM""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSYSTEM\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSYSTEM\fR 4
.IX Item "HKEY_LOCAL_MACHINESYSTEM"
.ie n .IP """HKEY_USERS\e.DEFAULT""" 4
-.el .IP "\f(CWHKEY_USERS\e.DEFAULT\fR" 4
+.el .IP \f(CWHKEY_USERS\e.DEFAULT\fR 4
.IX Item "HKEY_USERS.DEFAULT"
-.ie n .IP """HKEY_USERS\e\fISID\fP""" 4
-.el .IP "\f(CWHKEY_USERS\e\f(CISID\f(CW\fR" 4
+.ie n .IP """HKEY_USERS\e\fISID\fR""" 4
+.el .IP \f(CWHKEY_USERS\e\fR\f(CISID\fR\f(CW\fR 4
.IX Item "HKEY_USERSSID"
.PD
-ここで \fI\s-1SID\s0\fR は Windows User \s-1SID\s0 です (例: \f(CW\*(C`S\-1\-5\-18\*(C'\fR)。
-.ie n .IP """HKEY_USERS\e\fIusername\fP""" 4
-.el .IP "\f(CWHKEY_USERS\e\f(CIusername\f(CW\fR" 4
+ここで \fISID\fR は Windows User SID です (例: \f(CW\*(C`S\-1\-5\-18\*(C'\fR)。
+.ie n .IP """HKEY_USERS\e\fIusername\fR""" 4
+.el .IP \f(CWHKEY_USERS\e\fR\f(CIusername\fR\f(CW\fR 4
.IX Item "HKEY_USERSusername"
ここで \fIusername\fR はローカルユーザー名です (これは libguestfs の拡張です)。
.PP
You can use \f(CW\*(C`HKLM\*(C'\fR as a shorthand for \f(CW\*(C`HKEY_LOCAL_MACHINE\*(C'\fR, and \f(CW\*(C`HKU\*(C'\fR for \f(CW\*(C`HKEY_USERS\*(C'\fR.
.PP
-The literal keys \f(CW\*(C`HKEY_USERS\e$SID\*(C'\fR and \f(CW\*(C`HKEY_CURRENT_USER\*(C'\fR are not supported (there is no \*(L"current user\*(R").
-.SS "\s-1WINDOWS 8\s0"
+The literal keys \f(CW\*(C`HKEY_USERS\e$SID\*(C'\fR and \f(CW\*(C`HKEY_CURRENT_USER\*(C'\fR are not supported (there is no "current user").
+.SS "WINDOWS 8"
.IX Subsection "WINDOWS 8"
-Windows 8 \*(L"fast startup\*(R" can prevent virt-win-reg from being able to edit the Registry. See \*(L"\s-1WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "エンコーディング"
+Windows 8 "fast startup" can prevent virt-win-reg from being able to edit the Registry. See "WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" in \fBguestfs\fR\|(3).
+.SH エンコーディング
.IX Header "エンコーディング"
-\&\f(CW\*(C`virt\-win\-reg\*(C'\fR expects that regedit files have already been reencoded in the local encoding. Usually on Linux hosts, this means \s-1UTF\-8\s0 with Unix-style line endings. Since Windows regedit files are often in \s-1UTF\-16LE\s0 with Windows-style line endings, you may need to reencode the whole file before or after processing.
+\&\f(CW\*(C`virt\-win\-reg\*(C'\fR expects that regedit files have already been reencoded in the local encoding. Usually on Linux hosts, this means UTF\-8 with Unix-style line endings. Since Windows regedit files are often in UTF\-16LE with Windows-style line endings, you may need to reencode the whole file before or after processing.
.PP
To reencode a file from Windows format to Linux (before processing it with the \fI\-\-merge\fR option), you would do something like this:
.PP
.PP
エンコーディングの詳細は \fBWin::Hivex::Regedit\fR\|(3) を参照してください。
.PP
-If you are unsure about the current encoding, use the \fBfile\fR\|(1) command. Recent versions of Windows regedit.exe produce a \s-1UTF\-16LE\s0 file with Windows-style (\s-1CRLF\s0) line endings, like this:
+If you are unsure about the current encoding, use the \fBfile\fR\|(1) command. Recent versions of Windows regedit.exe produce a UTF\-16LE file with Windows-style (CRLF) line endings, like this:
.PP
.Vb 3
\& $ file software.reg
\& "LastKnownGood"=dword:00000002
.Ve
.PP
-\&\*(L"Current\*(R" is the one which Windows will choose when it boots.
+"Current" is the one which Windows will choose when it boots.
.PP
Similarly, other \f(CW\*(C`Current...\*(C'\fR keys in the path may need to be replaced.
-.SH "レジストリーキーおよび値の削除方法"
+.SH レジストリーキーおよび値の削除方法
.IX Header "レジストリーキーおよび値の削除方法"
レジストリキー全体を削除するには、この構文を使用します:
.PP
.SH "Windows のヒント"
.IX Header "Windows のヒント"
Note that some of these tips modify the guest disk image. The guest \fImust\fR be shut off, else you will get disk corruption.
-.SS "\s-1RUNNING A BATCH SCRIPT WHEN A USER LOGS IN\s0"
+.SS "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
.IX Subsection "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
-Prepare a \s-1DOS\s0 batch script, VBScript or executable. Upload this using \fBguestfish\fR\|(1). For this example the script is called \f(CW\*(C`test.bat\*(C'\fR and it is uploaded into \f(CW\*(C`C:\e\*(C'\fR:
+Prepare a DOS batch script, VBScript or executable. Upload this using \fBguestfish\fR\|(1). For this example the script is called \f(CW\*(C`test.bat\*(C'\fR and it is uploaded into \f(CW\*(C`C:\e\*(C'\fR:
.PP
.Vb 1
\& guestfish \-i \-d WindowsGuest upload test.bat /test.bat
.Vb 1
\& virt\-win\-reg \-\-merge WindowsGuest test.reg
.Ve
-.SS "サービスのインストール方法"
+.SS サービスのインストール方法
.IX Subsection "サービスのインストール方法"
This section assumes you are familiar with Windows services, and you either have a program which handles the Windows Service Control Protocol directly or you want to run any program using a service wrapper like SrvAny or the free RHSrvAny.
.PP
.Ve
.PP
注:
-.IP "\(bu" 4
+.IP \(bu 4
For use of \f(CW\*(C`ControlSet001\*(C'\fR see the section above in this manual page. You may need to adjust this according to the control set that is in use by the guest.
-.IP "\(bu" 4
+.IP \(bu 4
\&\f(CW"ObjectName"\fR controls the privileges that the service will have. An alternative is \f(CW"ObjectName"="LocalSystem"\fR which would be the most privileged account.
-.IP "\(bu" 4
-マジックナンバーの意味は次の Microsoft \s-1KB\s0 記事を参照してください: http://support.microsoft.com/kb/103000.
+.IP \(bu 4
+マジックナンバーの意味は次の Microsoft KB 記事を参照してください: http://support.microsoft.com/kb/103000.
.PP
レジストリを更新します:
.PP
シェルにおいて \f(CW\*(C`\e\*(C'\fR (backslash) を含むパラメーターを渡すとき、注意する必要があります。通常シェルからそれらを保護するには、'単一引用符' または二つのバックスラッシュ (しかし、両方ではない) を使用する必要があります。
.PP
パスおよび値の名前は大文字小文字を区別します。
-.SH "関連項目"
+.SH 関連項目
.IX Header "関連項目"
\&\fBhivex\fR\|(3), \fBhivexsh\fR\|(1), \fBhivexregedit\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-tail\fR\|(1), \fBSys::Guestfs\fR\|(3), \fBWin::Hivex\fR\|(3), \fBWin::Hivex::Regedit\fR\|(3), \fBSys::Virt\fR\|(3), http://libguestfs.org/.
-.SH "著者"
+.SH 著者
.IX Header "著者"
Richard W.M. Jones http://people.redhat.com/~rjones/
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2010 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 10:33+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
common/options/keys-from-stdin-option.pod
customize/virt-customize.pod
df/virt-df.pod
-dib/virt-dib.pod
diff/virt-diff.pod
docs/guestfs-tools-release-notes-1.48.pod
docs/guestfs-tools-release-notes-1.50.pod
+docs/guestfs-tools-release-notes-1.52.pod
drivers/virt-drivers.pod
edit/virt-edit.pod
format/virt-format.pod
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2017-01-29 09:50+0000\n"
"Last-Translator: Rodrigo de Araujo Sousa Fonseca "
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2015-02-21 10:34+0000\n"
"Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2019-06-03 03:49+0000\n"
"Last-Translator: Yuri Chornoivan <yurchor@ukr.net>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
-msgstr "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
+msgstr "L<https://lists.libguestfs.org>"
#. type: =head1
#: ../docs/guestfs-testing.pod:26
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
I<Зауваження>: типово C<ПРАВА_ДОСТУПУ> записуються у десятковому форматі, якщо ви не додасте початковий C<0> , щоб вказати вісімкове число, тобто скористаєтеся C<0700>, а не C<700>.
+=item B<--chown> UID:GID:PATH
+
+Change the owner user and group ID of a file or directory in the guest. Note:
+
+=over 4
+
+=item *
+
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+
+=item *
+
+This will not work with Windows guests.
+
+=back
+
+Приклад:
+
+ virt-customize --chown '0:0:/var/log/audit.log'
+
+See also: I<--upload>.
+
=item B<--commands-from-file> НАЗВА_ФАЙЛА
Прочитати команди налаштовування з файла, по одній (разом із аргументами) на рядок.
Ви можете додати декілька параметрів I<--ssh-inject> для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.
+=item B<--tar-in> TARFILE:REMOTEDIR
+
+Copy local files or directories from a local tar file called C<TARFILE> into the disk image, placing them in the directory C<REMOTEDIR> (which must exist). Note that the tar file must be uncompressed (F<.tar.gz> files will not work here)
+
=item B<--timezone> ЧАСОВИЙ_ПОЯС
Встановити типовий часовий пояс гостьової системи у значення C<ЧАСОВИЙ_ПОЯС>. Скористайтеся рядком місця у форматі C<Europe/London>
--- /dev/null
+
+=head1 НАЗВА
+
+guestfs-tools-release-notes - guestfs tools release Notes
+
+=head1 RELEASE NOTES FOR GUESTFS TOOLS 1.52
+
+These are the release notes for guestfs tools stable release 1.52. This describes the major changes since 1.50.
+
+Guestfs tools 1.52.0 was released on B<5 January 2024>.
+
+=begin коментар
+
+=head2 Безпека
+
+=end коментар
+
+=head2 virt-dib was removed
+
+virt-dib, a tool that built disk images using diskimage-builder descriptions has been removed. It only supported an older version of the diskimage-builder metadata. See also: L<https://bugzilla.redhat.com/1910039>
+
+=head2 virt-builder
+
+L<virt-builder(1)> now prints better error messages when a specific URL cannot be downloaded.
+
+=head2 virt-builder-repository
+
+Fix GPG repository signing (thanks Allard Berends).
+
+=head2 virt-customize
+
+New L<virt-customize(1)> I<--chown> and I<--tar-in> options. (Also available in virt-builder and virt-sysprep.)
+
+=head2 virt-diff
+
+L<virt-diff(1)> no longer considers C<st_dev> and C<st_ino> fields, which means that guests where a file has moved across a mountpoint but is otherwise identical (size, path, etc) will not show up as a difference.
+
+=head2 virt-drivers
+
+L<virt-drivers(1)> a tool which looks at the device drivers needed by a guest, can now look up vendor and device names using the PCI and USB IDs databases.
+
+=head2 Common changes
+
+The common I<--key> option now recognizes LVM names like F</dev/mapper/rhel_bootp--73--75--123-root> (Laszlo Ersek).
+
+The I<--key> option also supports a new S<I<--key all:...>> selector to try the same key on all devices.
+
+=head2 Зміни у збиранні
+
+Support for OCaml 5, and OCaml E<ge> 4.07 is now the minimum (thanks Guillaume Munch-Maccagnoni, Jerry James, Josh Berdine, Jürgen Hötzel, Vincent Laviron).
+
+Fix compatibility issues with libxml2 2.12.
+
+=head2 Внутрішня частина роботи програми
+
+Fix an off-by-one error which caused very rare crashes in some of the virt tools.
+
+=head2 Виправлені вади
+
+=begin коментар
+
+https_proxy= ./bugs-in-changelog.sh v1.50.0..
+
+=end коментар
+
+=over 4
+
+=item L<https://bugzilla.redhat.com/2175703>
+
+virt-v2v failed to inspect RHEL9.2 guest due to kernel-core / kernel-modules-core subpackage split
+
+=item L<https://bugzilla.redhat.com/2168506>
+
+RFE: Virt-v2v should recognize partition names like '/dev/mapper/rhel boot--73--75--123-root' in related keys option
+
+=item L<https://bugzilla.redhat.com/1910039>
+
+virt-dib doesn't work with newer diskimage-builder version on RHEL8
+
+=back
+
+=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ
+
+L<http://libguestfs.org/>
+
+=head1 АВТОРИ
+
+=begin коментар
+
+git shortlog -s v1.50.0..
+
+=end коментар
+
+=over 4
+
+=item Jürgen Hötzel
+
+=item Laszlo Ersek
+
+=item Richard W.M. Jones
+
+=back
+
+=head1 АВТОРСЬКІ ПРАВА
+
+Copyright (C) 2009-2024 Red Hat Inc.
+
=item B<--key> ВАРІАНТ
-Specify a key for LUKS, to automatically open a LUKS device when using the inspection. C<ID> can be either the libguestfs device name, or the UUID of the LUKS device.
+Specify a key for LUKS, to automatically open a LUKS device when using the inspection.
=over 4
-=item B<--key> C<ID>:key:KEY_STRING
+=item B<--key> NAMEB<:key:>KEY_STRING
+
+=item B<--key> UUIDB<:key:>KEY_STRING
+
+=item B<--key> B<all:key:>KEY_STRING
+
+C<NAME> is the libguestfs device name (eg. C</dev/sda1>). C<UUID> is the device UUID. C<all> means try the key against any encrypted device.
Використовувати вказаний C<РЯДОК_КЛЮЧА> як пароль.
-=item B<--key> C<ID>:file:FILENAME
+=item B<--key> NAMEB<:file:>FILENAME
+
+=item B<--key> UUIDB<:file:>FILENAME
+
+=item B<--key> B<all:file:>FILENAME
Прочитати пароль з файла F<НАЗВА_ФАЙЛА>.
-=item B<--key> C<ID>:clevis
+=item B<--key> NAMEB<:clevis>
+
+=item B<--key> UUIDB<:clevis>
+
+=item B<--key> B<all:clevis>
-Attempt passphrase-less unlocking for C<ID> with Clevis, over the network. Please refer to L<guestfs(3)/ENCRYPTED DISKS> for more information on network-bound disk encryption (NBDE).
+Attempt passphrase-less unlocking for the device with Clevis, over the network. Please refer to L<guestfs(3)/ENCRYPTED DISKS> for more information on network-bound disk encryption (NBDE).
Note that if any such option is present on the command line, QEMU user networking will be automatically enabled for the libguestfs appliance.
I<Зауваження>: типово C<ПРАВА_ДОСТУПУ> записуються у десятковому форматі, якщо ви не додасте початковий C<0> , щоб вказати вісімкове число, тобто скористаєтеся C<0700>, а не C<700>.
+=item B<--chown> UID:GID:PATH (see C<customize> below)
+
+Change the owner user and group ID of a file or directory in the guest. Note:
+
+=over 4
+
+=item *
+
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+
+=item *
+
+This will not work with Windows guests.
+
+=back
+
+Приклад:
+
+ virt-customize --chown '0:0:/var/log/audit.log'
+
+See also: I<--upload>.
+
=item B<--commands-from-file> НАЗВА_ФАЙЛА (див. C<customize> нижче)
Прочитати команди налаштовування з файла, по одній (разом із аргументами) на рядок.
Ви можете додати декілька параметрів I<--ssh-inject> для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.
+=item B<--tar-in> TARFILE:REMOTEDIR (see C<customize> below)
+
+Copy local files or directories from a local tar file called C<TARFILE> into the disk image, placing them in the directory C<REMOTEDIR> (which must exist). Note that the tar file must be uncompressed (F<.tar.gz> files will not work here)
+
=item B<--timezone> ЧАСОВИЙ_ПОЯС (див. C<customize> нижче)
Встановити типовий часовий пояс гостьової системи у значення C<ЧАСОВИЙ_ПОЯС>. Скористайтеся рядком місця у форматі C<Europe/London>
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-alignment-scan 1"
-.TH virt-alignment-scan 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-alignment-scan 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-alignment-scan — перевірка вирівнювання розділів віртуальної машини
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-alignment\-scan [\-\-параметри]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Під час встановлення застарілих операційних систем засоби розподілу диска можуть розташувати розділ на секторі з помилковим вирівнюванням відносно системи зберігання даних (типово, перший розділ починається з сектора \f(CW63\fR). Розділи з помилковим вирівнюванням можуть призвести до неоптимальної кількості запитів щодо виведення та введення даних від операційної системи.
.PP
Програма virt-alignment-scan виконує перевірку вирівнювання розділів у віртуальних машинах та образів дисків і повідомляє вам, якщо буде виявлено помилки вирівнювання.
.PP
У поточній версії не передбачено програми для виправлення помилок, пов’язаних з вирівнюванням. Ви можете лише перевстановити гостьову операційну систему. У цьому документі можна знайти короткі описи помилок та можливі шляхи усування цих помилок: http://media.netapp.com/documents/tr\-3747.pdf
-.SH "ВИВЕДЕННЯ"
+.SH ВИВЕДЕННЯ
.IX Header "ВИВЕДЕННЯ"
Щоб запустити цю програму безпосередньо для образу диска, скористайтеся параметром \fI\-a\fR:
.PP
.IX Item "стовпчик 1"
Назва пристрою і розділу (наприклад, \fI/dev/sda\fR означає перший розділ на першому блоковому пристрої).
.Sp
-У пунктах списків всіх доменів libvirt (без вказаного параметра \fI\-a\fR або \fI\-d\fR) записи у цьому стовпчику матимуть префікс назви libvirt або \s-1UUID\s0 (якщо вказано \fI\-\-uuid\fR). Приклад: \f(CW\*(C`WinXP:/dev/sda1\*(C'\fR
+У пунктах списків всіх доменів libvirt (без вказаного параметра \fI\-a\fR або \fI\-d\fR) записи у цьому стовпчику матимуть префікс назви libvirt або UUID (якщо вказано \fI\-\-uuid\fR). Приклад: \f(CW\*(C`WinXP:/dev/sda1\*(C'\fR
.IP "стовпчик 2" 4
.IX Item "стовпчик 2"
позиція початку розділу у байтах
.IX Item "стовпчик 5 і далі"
додаткові пояснення у довільному форматі.
.PP
-Код виходу програми залежить від того, чи буде знайдено розділи з помилковим вирівнюванням. Див. розділ \*(L"СТАН ВИХОДУ\*(R" нижче.
+Код виходу програми залежить від того, чи буде знайдено розділи з помилковим вирівнюванням. Див. розділ "СТАН ВИХОДУ" нижче.
.PP
Якщо вам потрібен лише код виходу без виведення даних, скористайтеся параметром \fI\-q\fR.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
.IP "\fB\-P\fR кількість_потоків" 4
.IX Item "-P кількість_потоків"
З версії libguestfs 1.22 у virt-alignment-scan передбачено обробку у декілька потоків і паралельне вивчення гостьових систем. Типово кількість потоків виконання, що використовуються, вибирається на основі доступного обсягу вільної пам’яті на час запуску virt-alignment-scan. Ви можете примусово наказати virt-alignment-scan використовувати не більше за \f(CW\*(C`кількість_потоків\*(C'\fR за допомогою параметра \fI\-P\fR.
.Sp
Зауважте, що \fI\-P 0\fR означає автоматичне визначення, а \fI\-P 1\fR означає використання одного потоку виконання.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
-Нічого не виводити. Просто встановити значення коду виходу (див. розділ \*(L"СТАН ВИХОДУ\*(R" нижче).
-.IP "\fB\-\-uuid\fR" 4
+Нічого не виводити. Просто встановити значення коду виходу (див. розділ "СТАН ВИХОДУ" нижче).
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
-Виводити \s-1UUID\s0 замість назв. Корисно для слідкування за гостьовою системою, навіть після перенесення або перейменування, або якщо дві гостьові системи мають однакові назви.
+Виводити UUID замість назв. Корисно для слідкування за гостьовою системою, навіть після перенесення або перейменування, або якщо дві гостьові системи мають однакові назви.
.Sp
Цей параметр застосовується лише для побудови списку всіх доменів libvirt (якщо не вказано параметрів \fI\-a\fR і \fI\-d\fR).
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "РЕКОМЕНДОВАНЕ ВИРІВНЮВАННЯ"
.IX Header "РЕКОМЕНДОВАНЕ ВИРІВНЮВАННЯ"
-Операційні системи, старіші за Windows 2008, та Linux до приблизно 2010 року розташовують перший сектор на першому розділі у секторі 63 і використовують розмір сектору у 512 байтів. Причини суто історичні. Драйвери мають повідомити дані щодо геометрії (циліндр / голівка / сектор або \s-1CHS\s0) до \s-1BIOS.\s0 Ця геометрія є повністю непотрібною на сучасних дисках, але, так трапляється, що повідомлені драйвером дані вказують на те, що у доріжці 63 сектори. Тому операційна система розташовує перший розділ на початку другої «доріжки» у секторі 63.
+Операційні системи, старіші за Windows 2008, та Linux до приблизно 2010 року розташовують перший сектор на першому розділі у секторі 63 і використовують розмір сектору у 512 байтів. Причини суто історичні. Драйвери мають повідомити дані щодо геометрії (циліндр / голівка / сектор або CHS) до BIOS. Ця геометрія є повністю непотрібною на сучасних дисках, але, так трапляється, що повідомлені драйвером дані вказують на те, що у доріжці 63 сектори. Тому операційна система розташовує перший розділ на початку другої «доріжки» у секторі 63.
.PP
Якщо гостьову операційну систему віртуалізовано, основна операційна система і гіпервізор можуть надавати перевагу доступу, вирівняному за одним з таких значень:
-.IP "\(bu" 4
+.IP \(bu 4
512 байти
.Sp
якщо основна операційна система використовує локальне сховище даних безпосередньо на розділах твердого диска, а на твердому диску розмір фізичних секторів дорівнює 512 байтам.
-.IP "\(bu" 4
+.IP \(bu 4
4 кілобайтів
.Sp
для локальних сховищ даних на нових твердих дисках із фізичними секторами у 4 кілобайти; для файлових сховищ даних на файлових системах із розміром блоку у 4 кілобайти; або для деяких типів мережевих сховищ даних.
-.IP "\(bu" 4
+.IP \(bu 4
64 кілобайтів
.Sp
для висококласних сховищ даних, з’єднаних із мережею. Оптимальний розмір блоку для апаратного забезпечення NetApp.
-.IP "\(bu" 4
+.IP \(bu 4
1 мегабайт
.Sp
-див. \*(L"ВИРІВНЮВАННЯ РОЗДІЛІВ НА ПОЗНАЧКИ 1 МБ\*(R" нижче.
+див. "ВИРІВНЮВАННЯ РОЗДІЛІВ НА ПОЗНАЧКИ 1 МБ" нижче.
.PP
Розділи, які не вирівняно належним чином щодо основного сховища даних, можуть спричиняти зайві помилки введення\-виведення. Приклад:
.PP
.Ve
.PP
У цьому прикладі під час кожного читання блоку у 4 кілобайти гостьової системи має бути отримати доступ до двох блоків основної системи (отже, здійснено удвічі більший обмін даними введення\-виведення). Якщо у гостьовій системі записується блок у 4 кілобайти, у основній системі має бути прочитано два блоки, старі і нові дані має бути поєднано, і має бути записано назад два блоки (учетверо більший обмін даними введення\-виведення).
-.SS "БЛОК ОСНОВНОЇ СИСТЕМИ \s-1LINUX\s0 І РОЗМІР ВВЕДЕННЯ\-ВИВЕДЕННЯ"
+.SS "БЛОК ОСНОВНОЇ СИСТЕМИ LINUX І РОЗМІР ВВЕДЕННЯ\-ВИВЕДЕННЯ"
.IX Subsection "БЛОК ОСНОВНОЇ СИСТЕМИ LINUX І РОЗМІР ВВЕДЕННЯ-ВИВЕДЕННЯ"
У нових версіях ядра Linux можна регулювати розміри фізичних і логічних блоків, а також мінімальний і рекомендований розмір блоку введення\-виведення.
.PP
\& 0
.Ve
.PP
-Для NetApp \s-1LUN:\s0
+Для NetApp LUN:
.PP
.Vb 8
\& $ cat /sys/block/sdc/queue/logical_block_size
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає:
-.IP "\(bu" 4
+.IP \(bu 4
0
.Sp
успішне завершення, всі розділи вирівняно на ≥ 64 кБ для отримання найкращої швидкодії
-.IP "\(bu" 4
+.IP \(bu 4
1
.Sp
під час сканування образу диска або гостьової системи сталася помилка
-.IP "\(bu" 4
+.IP \(bu 4
2
.Sp
успішне завершення роботи, деякі розділи може бути вирівняно на < 64 кБ, що може призвести до погіршення швидкодії на високошвидкісних мережевих сховищах
-.IP "\(bu" 4
+.IP \(bu 4
3
.Sp
успішне завершення роботи, деякі розділи може бути вирівняно на < 4 кБ, що може призвести до погіршення швидкодії у більшості гіпервізорів
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
© Red Hat Inc., 2011
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-builder 1"
-.TH virt-builder 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-builder 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-builder — засіб швидкої побудови образів для віртуальної машини
.SH "КОРОТКИЙ ОПИС"
\& virt\-builder \-\-get\-kernel ОБРАЗДИСКА
\& [\-\-format raw|qcow2] [\-\-output КАТАЛОГВИВЕДЕННЯ]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Virt-builder — інструмент для швидкого збирання нових віртуальних машин. За його допомогою ви зможете зібрати цілий спектр віртуальних машин для локального використання або використання у «хмарі». Зазвичай, для цього достатньо декількох хвилин. Крім того, у virt-builder передбачено багато способів налаштовування зібраних віртуальних машин. Усі команди віддаються за допомогою командного рядка. Для роботи програми не потрібні права доступу адміністратора системи, тому збирання нових віртуальних машин просто автоматизувати або керувати ним за допомогою скриптів.
.PP
Зауважте, що virt-builder не встановлює гостьові системи «з нуля». Програма використовує ретельного приготовані, підписані цифровими підписами шаблони операційних систем і налаштовує їх. Такий підхід використано, оскільки він є набагато швидшим за інші. Втім, якщо потрібно встановити систему «з нуля», ви можете скористатися \fBvirt\-install\fR\|(1) та \fBoz\-install\fR\|(1).
.PP
Найпростіше буде розпочати з прикладів з наступного розділу.
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
.SS "Показ списку доступних віртуальних машин"
.IX Subsection "Показ списку доступних віртуальних машин"
.PP
Потреби у запуску цієї програми від імені root \fIнемає\fR.
.PP
-Першого разу доведеться отримати шаблон мережею, а наступні операції може бути кешовано (див. \*(L"КЕШУВАННЯ\*(R").
+Першого разу доведеться отримати шаблон мережею, а наступні операції може бути кешовано (див. "КЕШУВАННЯ").
.PP
Назву файла результатів буде визначено на основі назви шаблона, отже для наведеного вище прикладу буде \fIfedora\-27.img\fR. Змінити назву файла результатів можна за допомогою параметра \fI\-o\fR:
.PP
.PP
Зауважте, що якщо ви \fIне встановите\fR \fI\-\-root\-password\fR, гостьовій системі буде надано \fIвипадковий\fR пароль адміністратора root, який буде виведено до стандартного виведення.
.PP
-Крім того, ви можете створювати облікові записи користувачів. Див. \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" нижче.
+Крім того, ви можете створювати облікові записи користувачів. Див. "КОРИСТУВАЧІ І ПАРОЛІ" нижче.
.SS "Встановити назву вузла"
.IX Subsection "Встановити назву вузла"
.Vb 1
буде змінено \fI/etc/dnf/dnf.conf\fR у образі диска (під час створення образу диска, задовго до завантаження).
.PP
Ви можете поєднувати ці параметри і додавати декілька параметрів усіх типів.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати довідкове повідомлення.
.IP "\fB\-\-arch\fR АРХІТЕКТУРА" 4
.IX Item "--arch АРХІТЕКТУРА"
Використовувати для образу\-результату вказану архітектуру. Це означає, що мають бути початкові коди шаблона для вказаної архітектури.
.Sp
-Див. також \*(L"АРХІТЕКТУРА\*(R".
+Див. також "АРХІТЕКТУРА".
.IP "\fB\-\-attach\fR ФАЙЛ_ISO" 4
.IX Item "--attach ФАЙЛ_ISO"
Під час етапу налаштовування вказаний диск долучається до базової системи libguestfs. Цей диск використовується для отримання даних додаткових сховищ програмного забезпечення або інших даних для створення нетипової системи.
.Sp
-Ймовірно, вам варто додати мітки для долучених дисків (або скористатися назвою тому \s-1ISO\s0), щоб надалі монтувати диски за міткою у ваших скриптах запуску:
+Ймовірно, вам варто додати мітки для долучених дисків (або скористатися назвою тому ISO), щоб надалі монтувати диски за міткою у ваших скриптах запуску:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
-Параметр \fI\-\-attach\fR можна вказати декілька разів, а форматом може бути будь\-який формат образу (не лише \s-1ISO\s0).
+Параметр \fI\-\-attach\fR можна вказати декілька разів, а форматом може бути будь\-який формат образу (не лише ISO).
.Sp
-Див. також \fI\-\-run\fR, \*(L"Встановлення пакунків зі стороннього сховища під час збирання\*(R", \fBgenisoimage\fR\|(1), \fBvirt\-make\-fs\fR\|(1).
+Див. також \fI\-\-run\fR, "Встановлення пакунків зі стороннього сховища під час збирання", \fBgenisoimage\fR\|(1), \fBvirt\-make\-fs\fR\|(1).
.IP "\fB\-\-attach\-format\fR ФОРМАТ" 4
.IX Item "--attach-format ФОРМАТ"
-Вказати формат диска для наступного параметра \fI\-\-attach\fR. Значенням аргументу \f(CW\*(C`ФОРМАТ\*(C'\fR зазвичай є \f(CW\*(C`raw\*(C'\fR або \f(CW\*(C`qcow2\*(C'\fR. Для образів \s-1ISO\s0 скористайтеся варіантом \f(CW\*(C`raw\*(C'\fR.
+Вказати формат диска для наступного параметра \fI\-\-attach\fR. Значенням аргументу \f(CW\*(C`ФОРМАТ\*(C'\fR зазвичай є \f(CW\*(C`raw\*(C'\fR або \f(CW\*(C`qcow2\*(C'\fR. Для образів ISO скористайтеся варіантом \f(CW\*(C`raw\*(C'\fR.
.IP "\fB\-\-cache\fR КАТАЛОГ" 4
.IX Item "--cache КАТАЛОГ"
.PD 0
-.IP "\fB\-\-no\-cache\fR" 4
+.IP \fB\-\-no\-cache\fR 4
.IX Item "--no-cache"
.PD
-\&\fI\-\-cache\fR КАТАЛОГ встановлює каталог зберігання і пошуку файлів кешованих шаблонів. Якщо значення не встановлено, типовим значенням буде \fI\f(CI$XDG_CACHE_HOME\fI/virt\-builder/\fR або \fI\f(CI$HOME\fI/.cache/virt\-builder/\fR.
+\&\fI\-\-cache\fR КАТАЛОГ встановлює каталог зберігання і пошуку файлів кешованих шаблонів. Якщо значення не встановлено, типовим значенням буде \fR\f(CI$XDG_CACHE_HOME\fR\fI/virt\-builder/\fR або \fI\fR\f(CI$HOME\fR\fI/.cache/virt\-builder/\fR.
.Sp
\&\fI\-\-no\-cache\fR вимикає кешування шаблонів.
-.IP "\fB\-\-cache\-all\-templates\fR" 4
+.IP \fB\-\-cache\-all\-templates\fR 4
.IX Item "--cache-all-templates"
-Отримати усі шаблони до кешу і завершити роботу. Див. \*(L"КЕШУВАННЯ\*(R".
+Отримати усі шаблони до кешу і завершити роботу. Див. "КЕШУВАННЯ".
.Sp
Зауважте, що кешуються не усі дані. Можна вивантажити додаткові шаблони. Крім того, не кешуються пакунки (параметри \fI\-\-install\fR, \fI\-\-update\fR).
-.IP "\fB\-\-check\-signature\fR" 4
+.IP \fB\-\-check\-signature\fR 4
.IX Item "--check-signature"
.PD 0
-.IP "\fB\-\-no\-check\-signature\fR" 4
+.IP \fB\-\-no\-check\-signature\fR 4
.IX Item "--no-check-signature"
.PD
Перевіряти чи не перевіряти цифровий підпис шаблону операційної системи. Типово, програма перевіряє підпис і завершує роботу, якщо підпис не збігається із еталонним. Обійти цю перевірку можна за допомогою параметра \fI\-\-no\-check\-signature\fR.
.Sp
Див. також \fI\-\-fingerprint\fR.
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
-.IP "\fB\-\-curl\fR \s-1CURL\s0" 4
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
+.IP "\fB\-\-curl\fR CURL" 4
.IX Item "--curl CURL"
Вказати альтернативний виконуваний файл \fBcurl\fR\|(1). Ви також можете скористатися цим параметром для додавання параметрів curl, наприклад, щоб вимкнути перевірку сертифікатів https:
.Sp
.Vb 1
\& virt\-builder \-\-curl "curl \-\-insecure" [...]
.Ve
-.IP "\fB\-\-delete\-cache\fR" 4
+.IP \fB\-\-delete\-cache\fR 4
.IX Item "--delete-cache"
-Вилучити кеш шаблонів. Див. \*(L"КЕШУВАННЯ\*(R".
-.IP "\fB\-\-no\-delete\-on\-failure\fR" 4
+Вилучити кеш шаблонів. Див. "КЕШУВАННЯ".
+.IP \fB\-\-no\-delete\-on\-failure\fR 4
.IX Item "--no-delete-on-failure"
-Не вилучати файл виведених даних, якщо під час збирання станеться помилка. Даними з цього файла можна скористатися для діагностування причин помилки. Див. \*(L"ДІАГНОСТИЧНІ ЗБІРКИ\*(R", щоб дізнатися більше про діагностику образів.
+Не вилучати файл виведених даних, якщо під час збирання станеться помилка. Даними з цього файла можна скористатися для діагностування причин помилки. Див. "ДІАГНОСТИЧНІ ЗБІРКИ", щоб дізнатися більше про діагностику образів.
.Sp
Типовою є поведінка, коли файл результатів буде вилучено, якщо станеться помилка у virt-builder (або, наприклад, помилка у одному зі скриптів, які запускає ця програма).
-.IP "\fB\-\-fingerprint\fR '\s-1AAAA BBBB ...\s0'" 4
+.IP "\fB\-\-fingerprint\fR 'AAAA BBBB ...'" 4
.IX Item "--fingerprint 'AAAA BBBB ...'"
Перевірка того, що покажчик та шаблони підписано ключем із вказаним відбитком (Відбитком, зазвичай, є доволі довгий рядок, що складається з 10 груп 4 шістнадцяткових цифр).
.Sp
.Sp
З \fI\-\-get\-kernel\fR визначає формат вхідних даних.
.Sp
-Для створення файла qcow2 у застарілому стилі (для сумісності з \s-1RHEL 6\s0 або дуже старим qemu < 1.1) після виконання програми virt-builder скористайтеся такою командою:
+Для створення файла qcow2 у застарілому стилі (для сумісності з RHEL 6 або дуже старим qemu < 1.1) після виконання програми virt-builder скористайтеся такою командою:
.Sp
.Vb 1
\& qemu\-img amend \-f qcow2 \-o compat=0.10 output.qcow2
Формат образу диска буде визначено автоматично, якщо ви не вкажете його за допомогою параметра \fI\-\-format\fR.
.Sp
Якщо у гостьовій системі декілька ядер, буде вибрано ядро із найбільшим номером. Щоб видобути із образу диска ядро з певним номером версії, скористайтеся \fBguestfish\fR\|(1). Щоб видобути із гостьової системи увесь вміст каталогу \fI/boot\fR, скористайтеся \fBvirt\-copy\-out\fR\|(1).
-.IP "\fB\-\-gpg\fR \s-1GPG\s0" 4
+.IP "\fB\-\-gpg\fR GPG" 4
.IX Item "--gpg GPG"
-Вказати альтернативний виконуваний файл \fBgpg\fR\|(1) (\s-1GNU\s0 Privacy Guard). Типово, virt-builder шукає \f(CW\*(C`gpg2\*(C'\fR або \f(CW\*(C`gpg\*(C'\fR у каталогах, вказаних за допомогою змінної \f(CW$PATH\fR.
+Вказати альтернативний виконуваний файл \fBgpg\fR\|(1) (GNU Privacy Guard). Типово, virt-builder шукає \f(CW\*(C`gpg2\*(C'\fR або \f(CW\*(C`gpg\*(C'\fR у каталогах, вказаних за допомогою змінної \f(CW$PATH\fR.
.Sp
Ви можете скористатися цим параметром для додавання параметрів до основної програми gpg, наприклад, для визначення альтернативного домашнього каталогу:
.Sp
.Sp
Ви можете вибрати формат виведення за допомогою параметра \fI\-\-list\-format\fR для шаблонів списку:
.RS 4
-.IP "\fBshort\fR" 4
+.IP \fBshort\fR 4
.IX Item "short"
Типовий формат: виводиться лише ідентифікатор шаблона і, поряд з ним, його короткий опис.
-.IP "\fBlong\fR" 4
+.IP \fBlong\fR 4
.IX Item "long"
Виводить тестовий список із даними щодо доступних джерел і список даних щодо доступних шаблонів після нього.
-.IP "\fBjson\fR" 4
+.IP \fBjson\fR 4
.IX Item "json"
-Вивести об’єкт \s-1JSON\s0 із подробицями щодо доступних джерел та подробиці щодо доступних шаблонів.
+Вивести об’єкт JSON із подробицями щодо доступних джерел та подробиці щодо доступних шаблонів.
.Sp
-Ключ \f(CW\*(C`version\*(C'\fR у основному об'єкті визначає «версію сумісності», його значення слід збільшувати кожного разу, коли результат використання \s-1JSON\s0 ставатиме несумісним із попередніми версіями (наприклад, через зміну структури або прибирання основних ключів).
+Ключ \f(CW\*(C`version\*(C'\fR у основному об'єкті визначає «версію сумісності», його значення слід збільшувати кожного разу, коли результат використання JSON ставатиме несумісним із попередніми версіями (наприклад, через зміну структури або прибирання основних ключів).
.RE
.RS 4
.Sp
\&\fI\-\-long\fR — скорочення для формату \f(CW\*(C`long\*(C'\fR.
.Sp
-Див також: \fI\-\-source\fR, \fI\-\-notes\fR, \*(L"ДЖЕРЕЛА ШАБЛОНІВ\*(R".
+Див також: \fI\-\-source\fR, \fI\-\-notes\fR, "ДЖЕРЕЛА ШАБЛОНІВ".
.RE
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=формат" 4
+.IP \fB\-\-machine\-readable\fR=формат 4
.IX Item "--machine-readable=формат"
.PD
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. \*(L"ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" нижче.
+За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" нижче.
.IP "\fB\-m\fR МБ" 4
.IX Item "-m МБ"
.PD 0
.Vb 1
\& guestfish get\-memsize
.Ve
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Увімкнути чи вимкнути доступ до мережі для гостьової системи під час встановлення.
.Sp
Типово увімкнено. Скористайтеся параметром \fI\-\-no\-network\fR, щоб вимкнути доступ.
.Sp
-У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. \*(L"МЕРЕЖА\*(R" in \fBvirt\-rescue\fR\|(1).
+У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. "МЕРЕЖА" in \fBvirt\-rescue\fR\|(1).
.Sp
Якщо ви скористаєтеся параметром \fI\-\-no\-network\fR, тоді інші параметри, зокрема \fI\-\-install\fR, не працюватимуть.
.Sp
.Sp
Загалом кажучи, вам \fIне варто\fR використовувати \fI\-\-no\-network\fR. Але ось декілька випадків, коли у вас може виникнути потреба у використанні цього параметра:
.RS 4
-.IP "1." 4
-У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки мережі. (Див. \*(L"МОДУЛЬ\*(R" in \fBguestfs\fR\|(3)).
-.IP "2." 4
-Усе програмне забезпечення, яке ви маєте намір встановити, походить з долученого образу \s-1ISO,\s0 отже потреби у мережі немає.
-.IP "3." 4
-Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати доступ до мережевого з'єднання вашої основної системи під час роботи virt-builder. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу шаблонів операційних систем. (Див. \*(L"БЕЗПЕКА\*(R" нижче).
-.IP "4." 4
+.IP 1. 4
+У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки мережі. (Див. "МОДУЛЬ" in \fBguestfs\fR\|(3)).
+.IP 2. 4
+Усе програмне забезпечення, яке ви маєте намір встановити, походить з долученого образу ISO, отже потреби у мережі немає.
+.IP 3. 4
+Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати доступ до мережевого з'єднання вашої основної системи під час роботи virt-builder. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу шаблонів операційних систем. (Див. "БЕЗПЕКА" нижче).
+.IP 4. 4
Ви не хочете користуватися мережею основної системи (наприклад, через захищеність або обмеженість середовища у ній).
.RE
.RS 4
.RE
-.IP "\fB\-\-no\-sync\fR" 4
+.IP \fB\-\-no\-sync\fR 4
.IX Item "--no-sync"
Не синхронізувати файл виведення під час завершення роботи.
.Sp
Virt-builder виконує синхронізацію \f(CW\*(C`fsync\*(C'\fR файла результатів або образу диска, якщо такий існує.
.Sp
-Причина полягає у тому, що типовим режимом кешування у qemu та \s-1KVM\s0 є \f(CW\*(C`none\*(C'\fR або \f(CW\*(C`directsync\*(C'\fR, і у обох цих режимах не використовується кеш сторінок основної системи. Тому ці режими не працюватимуть належним чином, якщо ви негайно запустите гостьову систему після запуску virt-builder — гостьова система просто не побачить файл результатів повністю . (Зауважте, що вам не варто користуватися обома цими режимами кешування — вони непрацездатні на базовому рівні з цієї та інших причин.)
+Причина полягає у тому, що типовим режимом кешування у qemu та KVM є \f(CW\*(C`none\*(C'\fR або \f(CW\*(C`directsync\*(C'\fR, і у обох цих режимах не використовується кеш сторінок основної системи. Тому ці режими не працюватимуть належним чином, якщо ви негайно запустите гостьову систему після запуску virt-builder — гостьова система просто не побачить файл результатів повністю . (Зауважте, що вам не варто користуватися обома цими режимами кешування — вони непрацездатні на базовому рівні з цієї та інших причин.)
.Sp
Якщо ви не використовуєте ці помилкові режими кешування, ви можете скористатися параметром \fI\-\-no\-sync\fR, щоб усунути непотрібну синхронізацію і значно пришвидшити роботу програми.
.IP "\fB\-\-notes\fR версія\-ОС" 4
Зауважте, що назвою файла виведення результатів може бути пристрій, розділ або логічний том.
.Sp
Якщо використовується з \fI\-\-get\-kernel\fR, цей параметр задає каталог виведення даних.
-.IP "\fB\-\-print\-cache\fR" 4
+.IP \fB\-\-print\-cache\fR 4
.IX Item "--print-cache"
-Вивести інформацію щодо кешу шаблонів. Див. \*(L"КЕШУВАННЯ\*(R".
-.IP "\fB\-q\fR" 4
+Вивести інформацію щодо кешу шаблонів. Див. "КЕШУВАННЯ".
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Не виводити звичайних повідомлень щодо поступу.
.Sp
Якщо розмір не задано, можлива реалізація двох сценаріїв. Якщо дані виводяться до файла, його розмір буде таким самим, як у шаблона. Якщо дані виводяться на пристрій, розділ тощо, буде використано розмір відповідного пристрою.
.Sp
-Щоб вказати розмір у байтах, додайте до числа малу літеру \fIb\fR, наприклад \f(CW\*(C`\-\-size 10737418240b\*(C'\fR.
+Щоб вказати розмір у байтах, додайте до числа малу літеру \fIb\fR, наприклад \f(CW\*(C`\-\-size\ 10737418240b\*(C'\fR.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
Увімкнути N ≥ 2 віртуальних процесорів для використання у скриптах \fI\-\-run\fR.
.Sp
Цей параметр можна вказати декілька разів, щоб визначити декілька джерел.
.Sp
-Див. також \*(L"ДЖЕРЕЛА ШАБЛОНІВ\*(R" нижче.
+Див. також "ДЖЕРЕЛА ШАБЛОНІВ" нижче.
.Sp
Зауважте, що не варто вказувати для \fI\-\-source\fR джерела, яким ви не довіряєте (якщо їх не підписано кимось, кому ви довіряєте). Див. також параметр \fI\-\-no\-network\fR.
-.IP "\fB\-\-no\-warn\-if\-partition\fR" 4
+.IP \fB\-\-no\-warn\-if\-partition\fR 4
.IX Item "--no-warn-if-partition"
-Не видавати попередження, якщо пристроєм виведення даних є розділ. Це попередження надає змогу уникнути типової помилки користувача під час записування на флеш\-накопичувач \s-1USB\s0 або зовнішній диск — запису на розділ, коли слід виконувати перезапис усього пристрою (\fI\-\-output /dev/sdX\fR), а не розділу на ньому (\fI\-\-output /dev/sdX1\fR). Скористайтеся цим параметром, щоб \fIпридушити\fR відповідне попередження.
-.IP "\fB\-v\fR" 4
+Не видавати попередження, якщо пристроєм виведення даних є розділ. Це попередження надає змогу уникнути типової помилки користувача під час записування на флеш\-накопичувач USB або зовнішній диск — запису на розділ, коли слід виконувати перезапис усього пристрою (\fI\-\-output\ /dev/sdX\fR), а не розділу на ньому (\fI\-\-output\ /dev/sdX1\fR). Скористайтеся цим параметром, щоб \fIпридушити\fR відповідне попередження.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути діагностичні повідомлення і/або режим докладних повідомлень.
.Sp
Коли повідомлятимете про вади, скористайтеся цим параметром і долучіть усі виведені дані до звіту щодо вади.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SS "Параметри налаштовування"
Змінити права доступу до файла \f(CW\*(C`ФАЙЛ\*(C'\fR на \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR.
.Sp
\&\fIЗауваження\fR: типово \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR записуються у десятковому форматі, якщо ви не додасте початковий \f(CW0\fR , щоб вказати вісімкове число, тобто скористаєтеся \f(CW0700\fR, а не \f(CW700\fR.
+.IP "\fB\-\-chown\fR UID:GID:PATH" 4
+.IX Item "--chown UID:GID:PATH"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+Приклад:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
.IP "\fB\-\-commands\-from\-file\fR НАЗВА_ФАЙЛА" 4
.IX Item "--commands-from-file НАЗВА_ФАЙЛА"
Прочитати команди налаштовування з файла, по одній (разом із аргументами) на рядок.
.Sp
Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено Perl 5.
.Sp
-Див. \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
+Див. "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
.IP "\fB\-\-firstboot\fR СКРИПТ" 4
.IX Item "--firstboot СКРИПТ"
Встановити \f(CW\*(C`СКРИПТ\*(C'\fR у гостьовій системі і запустити його під час першого завантаження гостьової системи (від імені root, у останній частині процесу завантаження).
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R", щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ", щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-command\fR 'КОМАНДА+ПАРАМЕТРИ'" 4
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R", щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ", щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-install\fR ПАКУНОК,ПАКУНОК.." 4
.IX Item "--firstboot-install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час першого завантаження гостьової системи за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею гостьової системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R".
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ".
.IP "\fB\-\-hostname\fR НАЗВА_ВУЗЛА" 4
.IX Item "--hostname НАЗВА_ВУЗЛА"
-Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (\s-1FQDN\s0).
-.IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0" 4
+Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (FQDN).
+.IP "\fB\-\-inject\-qemu\-ga\fR METHOD" 4
.IX Item "--inject-qemu-ga METHOD"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0" 4
+.IP "\fB\-\-inject\-virtio\-win\fR METHOD" 4
.IX Item "--inject-virtio-win METHOD"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.IX Item "--install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею основної системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R".
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ".
.Sp
Див. також \fI\-\-update\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR ПРИЗНАЧЕННЯ:ПОСИЛАННЯ[:ПОСИЛАННЯ..]" 4
.IX Item "--mkdir КАТАЛОГ"
Створити каталог у гостьовій системі.
.Sp
-Використовується \f(CW\*(C`mkdir \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
+Використовується \f(CW\*(C`mkdir\ \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
.IP "\fB\-\-move\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ" 4
.IX Item "--move ДЖЕРЕЛО:ПРИЗНАЧЕННЯ"
Пересунути файли або каталоги у межах гостьової системи.
.Sp
Не можна використовувати символи\-замінники.
-.IP "\fB\-\-no\-logfile\fR" 4
+.IP \fB\-\-no\-logfile\fR 4
.IX Item "--no-logfile"
Витерти \f(CW\*(C`builder.log\*(C'\fR (файл журналу із командами збирання) з образу після завершення збирання. Якщо ви не хочете явним чином показувати, як було зібрано образ, скористайтеся цим параметром.
.Sp
-Див. також \*(L"\s-1LOG FILE\*(R"\s0.
-.IP "\fB\-\-no\-selinux\-relabel\fR" 4
+Див. також "LOG FILE".
+.IP \fB\-\-no\-selinux\-relabel\fR 4
.IX Item "--no-selinux-relabel"
Do not attempt to correct the SELinux labels of files in the guest.
.Sp
.IX Item "--password КОРИСТУВАЧ:ВАРІАНТ"
Встановити пароль для користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR. (Зауважте, що за допомогою цього параметра \fIне можна\fR створювати облікові записи користувачів.)
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R".
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ".
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
Якщо змінюється чи встановлюється пароль для гостьової системи, за допомогою цього параметра можна встановити шифрування для цього пароля у значення \f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`sha256\*(C'\fR або \f(CW\*(C`sha512\*(C'\fR.
.Sp
\&\f(CW\*(C`md5\*(C'\fR працюватиме з відносно давніми гостьовими системами Linux (наприкладRHEL 3), але є незахищеним щодо новітніх способів атак.
.Sp
-Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку \s-1SHA\-512.\s0 Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
+Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку SHA\-512. Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
.Sp
-Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
.IP "\fB\-\-root\-password\fR ВАРІАНТ" 4
.IX Item "--root-password ВАРІАНТ"
Встановити пароль користувача root.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R".
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ".
.Sp
Зауваження: якщо у virt-builder ви \fIне встановите\fR \fI\-\-root\-password\fR, для гостьової системи буде використано \fIвипадковий\fR пароль root.
.IP "\fB\-\-run\fR СКРИПТ" 4
.Sp
Для скрипту буде автоматично використано команду chmod +x.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--run-command 'КОМАНДА+ПАРАМЕТРИ'"
Виконати команду із аргументами у образі диска. Команду буде виконано у віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової файлової системи.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\-command\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--scrub ФАЙЛ"
Витерти файл з гостьової системи. Подібне до \fI\-\-delete\fR, окрім того, що:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Витирає дані так, що їх не можна буде відновити з гостьової системи.
-.IP "\(bu" 4
+.IP \(bu 4
Не може вилучати каталоги, лише звичайні файли.
.RE
.RS 4
.RE
-.IP "\fB\-\-selinux\-relabel\fR" 4
+.IP \fB\-\-selinux\-relabel\fR 4
.IX Item "--selinux-relabel"
This is a compatibility option that does nothing.
.IP "\fB\-\-sm\-attach\fR ВАРІАНТ" 4
.IX Item "--sm-attach ВАРІАНТ"
Долучити систему до буфера передплати за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R".
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER".
.IP "\fB\-\-sm\-credentials\fR ВАРІАНТ" 4
.IX Item "--sm-credentials ВАРІАНТ"
Встановити реєстраційні дані для \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R".
-.IP "\fB\-\-sm\-register\fR" 4
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER".
+.IP \fB\-\-sm\-register\fR 4
.IX Item "--sm-register"
Зареєструвати гостьову систему за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
Потребує встановлення реєстраційних даних за допомогою \fI\-\-sm\-credentials\fR.
-.IP "\fB\-\-sm\-remove\fR" 4
+.IP \fB\-\-sm\-remove\fR 4
.IX Item "--sm-remove"
Вилучити усі передплати з гостьової системи за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
-.IP "\fB\-\-sm\-unregister\fR" 4
+.IP \fB\-\-sm\-unregister\fR 4
.IX Item "--sm-unregister"
Зняти гостьову систему з реєстрації за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-ssh\-inject\fR КОРИСТУВАЧ[:ВАРІАНТ]" 4
.IX Item "--ssh-inject КОРИСТУВАЧ[:ВАРІАНТ]"
Вставити ключ ssh так, щоб вказаний \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR зміг увійти до системи з використанням ssh без потреби у визначенні пароля. Запис користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR має вже існувати у гостьовій системі.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"КЛЮЧІ \s-1SSH\*(R"\s0.
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "КЛЮЧІ SSH".
.Sp
Ви можете додати декілька параметрів \fI\-\-ssh\-inject\fR для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.
+.IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
.IP "\fB\-\-timezone\fR ЧАСОВИЙ_ПОЯС" 4
.IX Item "--timezone ЧАСОВИЙ_ПОЯС"
Встановити типовий часовий пояс гостьової системи у значення \f(CW\*(C`ЧАСОВИЙ_ПОЯС\*(C'\fR. Скористайтеся рядком місця у форматі \f(CW\*(C`Europe/London\*(C'\fR
Вилучити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде вилучено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо). З метою виконання запиту також може бути вилучено пакунки, залежні від вилучених пакунків.
.Sp
Див. також \fI\-\-install\fR, \fI\-\-update\fR.
-.IP "\fB\-\-update\fR" 4
+.IP \fB\-\-update\fR 4
.IX Item "--update"
Виконує еквівалент \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR або якоїсь іншої команди, яка потрібна для оновлення пакунків, які вже встановлено у шаблоні, до найсвіжіших версій.
.Sp
.IP "\fB\-\-write\fR ФАЙЛ:ДАНІ" 4
.IX Item "--write ФАЙЛ:ДАНІ"
Записати \f(CW\*(C`ДАНІ\*(C'\fR до файла \f(CW\*(C`ФАЙЛ\*(C'\fR.
-.SH "ДОВІДНИК"
+.SH ДОВІДНИК
.IX Header "ДОВІДНИК"
.SS "ВСТАНОВЛЕННЯ ПАКУНКІВ"
.IX Subsection "ВСТАНОВЛЕННЯ ПАКУНКІВ"
\fIВстановлення пакунків зі стороннього сховища під час збирання\fR
.IX Subsection "Встановлення пакунків зі стороннього сховища під час збирання"
.PP
-Якщо програмного забезпечення, яке ви хочете встановити, немає у основному сховищі пакунків гостьової системи, ви можете додати стороннє сховище. Зазвичай, таке сховище є файлом образу \s-1ISO\s0 (образом компакт\-диска), у якому містяться дані додаткових пакунків.
+Якщо програмного забезпечення, яке ви хочете встановити, немає у основному сховищі пакунків гостьової системи, ви можете додати стороннє сховище. Зазвичай, таке сховище є файлом образу ISO (образом компакт\-диска), у якому містяться дані додаткових пакунків.
.PP
Ви можете створити образ диска за допомогою \fBgenisoimage\fR\|(1) або \fBvirt\-make\-fs\fR\|(1). Для genisoimage скористайтеся такою командою:
.PP
\& genisoimage \-o extra\-packages.iso \-R \-J \-V EXTRA cdcontents/
.Ve
.PP
-Створіть скрипт, який монтує \s-1ISO\s0 і налаштовує сховище. Для dnf створіть /tmp/install.sh з таким вмістом:
+Створіть скрипт, який монтує ISO і налаштовує сховище. Для dnf створіть /tmp/install.sh з таким вмістом:
.PP
.Vb 2
\& mkdir /tmp/mount
.PP
Докладніший опис можна знайти за посиланнями \fBlocalectl\fR\|(1) та https://www.happyassassin.net/2013/11/23/keyboard\-layouts\-in\-fedora\-20\-and\-previously/.
.PP
-\fIВизначення розкладки клавіатури за допомогою \fI/etc/sysconfig/keyboard\fI\fR
+\fIВизначення розкладки клавіатури за допомогою /etc/sysconfig/keyboard\fR
.IX Subsection "Визначення розкладки клавіатури за допомогою /etc/sysconfig/keyboard"
.PP
-Для \s-1RHEL\s0 ≤ 6, Fedora ≤ 18 та подібних систем можна вивантажити із змінити файл налаштувань клавіатури за допомогою параметрів \fI\-\-upload\fR, \fI\-\-write\fR або \fI\-\-edit\fR. Приклад:
+Для RHEL ≤ 6, Fedora ≤ 18 та подібних систем можна вивантажити із змінити файл налаштувань клавіатури за допомогою параметрів \fI\-\-upload\fR, \fI\-\-write\fR або \fI\-\-edit\fR. Приклад:
.PP
.Vb 2
\& virt\-builder centos\-6 \e
.Ve
.PP
Див. https://wiki.debian.org/Keyboard.
-.SS "МОВА"
+.SS МОВА
.IX Subsection "МОВА"
У більшості дистрибутивів Linux передбачено можливість зміни локалі, отже ви можете бачити повідомлення гостьової системи нестандартною мовою, наприклад українською.
.PP
.SS "ФАЙЛ ЖУРНАЛУ"
.IX Subsection "ФАЙЛ ЖУРНАЛУ"
Скрипти та засоби встановлення пакунків, які працюватимуть під час збирання (\fI\-\-run\fR, \fI\-\-run\-command\fR, \fI\-\-install\fR, \fI\-\-update\fR, але \fIне\fR firstboot), записуватимуть повідомлення до одного з таких файлів:
-.IP "\fI/tmp/builder.log\fR" 4
+.IP \fI/tmp/builder.log\fR 4
.IX Item "/tmp/builder.log"
-У Linux, \s-1BSD\s0 та інших гостьових системах, відмінних від Windows.
-.IP "\fIC:\eTemp\ebuilder.log\fR" 4
+У Linux, BSD та інших гостьових системах, відмінних від Windows.
+.IP \fIC:\eTemp\ebuilder.log\fR 4
.IX Item "C:Tempbuilder.log"
-У гостьових системах Windows, \s-1DOS.\s0
-.IP "\fI/builder.log\fR" 4
+У гостьових системах Windows, DOS.
+.IP \fI/builder.log\fR 4
.IX Item "/builder.log"
Якщо немає \fI/tmp\fR або \fIC:\eTemp\fR.
.PP
Якщо ви не хочете, щоб до остаточного образу було записано файл журналу, скористайтеся параметром рядка команди \fI\-\-no\-logfile\fR.
-.SS "КЛЮЧІ \s-1SSH\s0"
+.SS "КЛЮЧІ SSH"
.IX Subsection "КЛЮЧІ SSH"
Параметр \fI\-\-ssh\-inject\fR використовується для вставляння ключів ssh для користувачів у гостьовій системі, щоб вони могли входити до системи без зазначення пароля.
.PP
Прочитати ключ ssh з файла \fIНАЗВА ФАЙЛА\fR. Файлом зазвичай є файл \fI.pub\fR.
.IP "\fB\-\-ssh\-inject\fR КОРИСТУВАЧ:string:РЯДОК_КЛЮЧА" 4
.IX Item "--ssh-inject КОРИСТУВАЧ:string:РЯДОК_КЛЮЧА"
-Використати вказаний \f(CW\*(C`РЯДОК_КЛЮЧА\*(C'\fR. Зазвичай, \f(CW\*(C`РЯДОК_КЛЮЧА\*(C'\fR — рядок відкритого ключа у форматі \fIssh-rsa \s-1AAAA....\s0 user@localhost\fR.
+Використати вказаний \f(CW\*(C`РЯДОК_КЛЮЧА\*(C'\fR. Зазвичай, \f(CW\*(C`РЯДОК_КЛЮЧА\*(C'\fR — рядок відкритого ключа у форматі \fIssh-rsa AAAA.... user@localhost\fR.
.PP
Який би з варіантів не було вибрано, буде створено каталог \fI~USER/.ssh\fR і файл \fI~USER/.ssh/authorized_keys\fR, якщо вони досі не існували.
.SS "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ"
За допомогою параметрів \fI\-\-firstboot\fR та \fI\-\-firstboot\-command\fR ви можете визначити команди, які буде виконано під час першого завантаження гостьової системи. Для цього у гостьовій системі встановлюється скрипт ініціалізації, який виконує завдання із запуску усіх доданих скриптів і виконання усіх доданих команд.
.PP
Підтримувані операційні системи:
-.IP "Linux" 4
+.IP Linux 4
.IX Item "Linux"
Передбачено підтримку таких систем ініціалізації: systemd, System-V init (також відома як sysvinit) та Upstart (з використанням скриптів System-V).
.Sp
Зауважте, що, зазвичай, скрипти ініціалізації виконуються від імені адміністратора (root), але у набагато обмеженішому середовищі ніж те, яке доступне зі звичайної оболонки. Наприклад, значення змінної середовища \f(CW$HOME\fR може бути не встановленим або порожнім.
.Sp
Дані, виведені скриптами першого запуску, у гостьовій системі зберігатимуться у \fI~root/virt\-sysprep\-firstboot.log\fR.
-.IP "Windows" 4
+.IP Windows 4
.IX Item "Windows"
-Для запуску скриптів першого завантаження встановлюється \fIrhsrvany.exe\fR, початковий код якого можна знайти у https://github.com/rwmjones/rhsrvany, або \fIpvvxsvc.exe\fR, який є частиною \s-1SUSE VMDP.\s0 Наявність цих файлів є обов'язковою. Якщо файлів не буде знайдено, скрипти першого завантаження виконати не вдасться.
+Для запуску скриптів першого завантаження встановлюється \fIrhsrvany.exe\fR, початковий код якого можна знайти у https://github.com/rwmjones/rhsrvany, або \fIpvvxsvc.exe\fR, який є частиною SUSE VMDP. Наявність цих файлів є обов'язковою. Якщо файлів не буде знайдено, скрипти першого завантаження виконати не вдасться.
.Sp
\&\fIrhsrvany.exe\fR або \fIpvvxsvc.exe\fR буде просто скопійовано з місця, на яке вказує змінна середовища \f(CW\*(C`VIRT_TOOLS_DATA_DIR\*(C'\fR; якщо значення змінної середовища не встановлено, буде використано типове місце, визначене під час компіляції (щось схоже на \fI/usr/share/virt\-tools\fR).
.Sp
Дані, виведені скриптами першого завантаження, можна знайти у гостьовій системі за адресою \fIC:\eProgram Files\eGuestfs\eFirstboot\elog.txt\fR.
-.SS "SUBSCRIPTION-MANAGER"
+.SS SUBSCRIPTION-MANAGER
.IX Subsection "SUBSCRIPTION-MANAGER"
Передбачено можливість автоматизації реєстрації та долучення до системи передплат за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR. Потреба у подібному налаштовуванні типово виникає у системах Red Hat Enterprise Linux. Передбачено декілька параметрів, які спрощують процедуру, усувають потребу у введенні команд вручну та не роблять загальнодоступними паролі, вказані у рядку команди.
.PP
.SS "ПРОЦЕДУРА ВСТАНОВЛЕННЯ"
.IX Subsection "ПРОЦЕДУРА ВСТАНОВЛЕННЯ"
Після виклику virt-builder встановлення виконується таким чином:
-.IP "\(bu" 4
+.IP \(bu 4
Отримується образ шаблону.
.Sp
-Якщо образ шаблону вже є у кеші, використовується кешована версія. (Див. \*(L"КЕШУВАННЯ\*(R").
-.IP "\(bu" 4
+Якщо образ шаблону вже є у кеші, використовується кешована версія. (Див. "КЕШУВАННЯ").
+.IP \(bu 4
Перевіряється підпис шаблону.
-.IP "\(bu" 4
+.IP \(bu 4
Шаблон розпаковується до файла tmp.
-.IP "\(bu" 4
+.IP \(bu 4
Розмір образ шаблону змінюється так, щоб від дорівнював розміру системи призначення, за допомогою \fBvirt\-resize\fR\|(1).
-.IP "\(bu" 4
+.IP \(bu 4
Долучаються додаткові диски (\fI\-\-attach\fR).
-.IP "\(bu" 4
+.IP \(bu 4
Створюється нова база псевдовипадкових чисел для гостьової системи.
-.IP "\(bu" 4
+.IP \(bu 4
Виконується налаштовування гостьової системи у порядку, який задається рядком команди.
-.IP "\(bu" 4
+.IP \(bu 4
SELinux relabelling is done unless disabled with \fI\-\-no\-selinux\-relabel\fR.
.SS "ІМПОРТУВАННЯ ОБРАЗУ ДИСКА"
.IX Subsection "ІМПОРТУВАННЯ ОБРАЗУ ДИСКА"
.Ve
.PP
Нотатки:
-.IP "1." 4
+.IP 1. 4
Вам \fIслід\fR вказати правильний формат. Форматом є \f(CW\*(C`raw\*(C'\fR, якщо вами не було використано параметр virt-builder \fI\-\-format\fR.
-.IP "2." 4
+.IP 2. 4
Наполегливо рекомендуємо скористатися \fI\-\-os\-variant\fR, оскільки він надає змогу підібрати оптимальний набір пристроїв, які слід увімкнути у системі, щоб гостьова система працювала найефективніше. Щоб отримати список усіх варіантів, скористайтеся такою командою:
.Sp
.Vb 1
.Ve
.Sp
Вказана вище програма є частиною пакунка libosinfo.
-.IP "3." 4
-Запускати virt-install можна від імені адміністратора (root) або від імені простого користувача. Між цими способами є незначні відмінності, оскільки libvirt керує різними наборами віртуальних машин для кожного користувача. Зокрема, virt-manager показує віртуальні машини, власником яких є root, а «Коробки» з \s-1GNOME\s0 показують лише віртуальні машини поточного користувача. Інші ж програми можуть також мати свої особливості показу.
+.IP 3. 4
+Запускати virt-install можна від імені адміністратора (root) або від імені простого користувача. Між цими способами є незначні відмінності, оскільки libvirt керує різними наборами віртуальних машин для кожного користувача. Зокрема, virt-manager показує віртуальні машини, власником яких є root, а «Коробки» з GNOME показують лише віртуальні машини поточного користувача. Інші ж програми можуть також мати свої особливості показу.
.PP
\fIІмпортування до OpenStack\fR
.IX Subsection "Імпортування до OpenStack"
.PP
Параметр \fI\-\-file\fR визначає створений за допомогою virt-builder образ диска. Його значення має узгоджуватися із значення параметра \fI\-\-output\fR virt-builder. Значення параметра \fI\-\-disk\-format\fR має узгоджуватися зі значенням параметра \fI\-\-format\fR virt-builder (або бути рівним \f(CW\*(C`raw\*(C'\fR, якщо ви не вказували цього параметра). Значенням параметра \fI\-\-container\-format\fR завжди має бути \f(CW\*(C`bare\*(C'\fR, оскільки virt-builder ніколи не вкладає образ до контейнерів.
.PP
-Ви можете скористатися командою \f(CW\*(C`glance image\-show \f(CIfedora\-27\-image\f(CW\*(C'\fR, щоб переглянути властивості образу.
+Ви можете скористатися командою \f(CW\*(C`glance\ image\-show\ \fR\f(CIfedora\-27\-image\fR\f(CW\*(C'\fR, щоб переглянути властивості образу.
.PP
Для завантаження екземпляра вашого образу на обчислювальному вузлі Nova віддайте таку команду:
.PP
\& \-\-flavor m1.medium
.Ve
.PP
-Скористайтеся командою \f(CW\*(C`nova flavor\-list\*(C'\fR, щоб переглянути список можливих варіантів машин. Скористайтеся командою \f(CW\*(C`nova list\*(C'\fR, щоб переглянути список запущених екземплярів.
+Скористайтеся командою \f(CW\*(C`nova\ flavor\-list\*(C'\fR, щоб переглянути список можливих варіантів машин. Скористайтеся командою \f(CW\*(C`nova\ list\*(C'\fR, щоб переглянути список запущених екземплярів.
.PP
-\fIБезпосереднє завантаження за допомогою qemu або \s-1KVM\s0\fR
+\fIБезпосереднє завантаження за допомогою qemu або KVM\fR
.IX Subsection "Безпосереднє завантаження за допомогою qemu або KVM"
.PP
Командний рядок qemu не є ні надто стабільним, ні простим у користуванні, тому, якщо це можливо, слід користуватися libvirt. Втім, для завантаження віртуальної машини можна скористатися чимось подібним до вказаного нижче:
Точний перелік настанов залежить від дистрибутива Linux. Докладніше про це тут: https://docs.puppet.com/puppet/latest/install_pre.html
.SS "ДІАГНОСТИКА ЗБИРАННЯ"
.IX Subsection "ДІАГНОСТИКА ЗБИРАННЯ"
-Якщо сам virt-builder не може виконати роботу, слід увімкнути діагностику (\fI\-v\fR) і повідомити про ваду розробників (див. розділ \*(L"ВАДИ\*(R" нижче).
+Якщо сам virt-builder не може виконати роботу, слід увімкнути діагностику (\fI\-v\fR) і повідомити про ваду розробників (див. розділ "ВАДИ" нижче).
.PP
Якщо причиною неможливості виконання завдання virt-builder є який скрипт або пакунок, який програма не може встановити, спробуйте скористатися параметром \fI\-\-no\-delete\-on\-failure\fR, щоб зберегти файл результатів, і продовжіть вивчення цього розділу підручника.
.PP
Скористайтеся командами guestfish, зокрема \f(CW\*(C`ll /каталог\*(C'\fR і \f(CW\*(C`cat /файл\*(C'\fR, для перевірки каталогів та файлів.
.IP "Використання guestmount" 4
.IX Item "Використання guestmount"
-Безпечно змонтувати образ диска у основній системі за допомогою \s-1FUSE\s0 і \fBguestmount\fR\|(1):
+Безпечно змонтувати образ диска у основній системі за допомогою FUSE і \fBguestmount\fR\|(1):
.Sp
.Vb 3
\& mkdir /tmp/mp
.SS "ДЖЕРЕЛА ШАБЛОНІВ"
.IX Subsection "ДЖЕРЕЛА ШАБЛОНІВ"
virt-builder читає доступні джерела із файлів налаштування, файлів із суфіксом назви \fI.conf\fR, які зберігаються у одному з таких місць:
-.IP "\(bu" 4
-\&\f(CW$XDG_CONFIG_HOME\fR/virt\-builder/reposd/ (\f(CW$XDG_CONFIG_HOME\fR дорівнює \fI\f(CI$HOME\fI/.config\fR, якщо не встановлено).
-.IP "\(bu" 4
+.IP \(bu 4
+\&\f(CW$XDG_CONFIG_HOME\fR/virt\-builder/reposd/ (\f(CW$XDG_CONFIG_HOME\fR дорівнює \fR\f(CI$HOME\fR\fI/.config\fR, якщо не встановлено).
+.IP \(bu 4
\&\f(CW$VIRT_BUILDER_DIRS\fR/virt\-builder/repos.d/ (where \f(CW$VIRT_BUILDER_DIRS\fR means any of the directories in that environment variable, or just \fI/etc\fR if not set).
.PP
Кожен з файлів \fI.conf\fR у вказаних каталогах зберігає дані у простому текстовому форматі, ось так:
.PP
Можуть з’явитися такі поля:
.ie n .IP """uri=АДРЕСА""" 4
-.el .IP "\f(CWuri=АДРЕСА\fR" 4
+.el .IP \f(CWuri=АДРЕСА\fR 4
.IX Item "uri=АДРЕСА"
Адреса файла покажчика, на який посилається це сховище.
.Sp
Це поле слід заповнити.
.ie n .IP """gpgkey=АДРЕСА""" 4
-.el .IP "\f(CWgpgkey=АДРЕСА\fR" 4
+.el .IP \f(CWgpgkey=АДРЕСА\fR 4
.IX Item "gpgkey=АДРЕСА"
Це необов'язкове поле відповідає адресі (хоча прийнятними є лише адреси \fIfile://\fR) ключа, який використано для підписування файла покажчика. Якщо поля немає, файл покажчика, на який посилається \fIuri=..\fR, не підписано.
.ie n .IP """proxy=РЕЖИМ""" 4
-.el .IP "\f(CWproxy=РЕЖИМ\fR" 4
+.el .IP \f(CWproxy=РЕЖИМ\fR 4
.IX Item "proxy=РЕЖИМ"
Це необов'язкове поле вказує на режим проксі, яким слід скористатися для отримання файла покажчика цього сховища. Можливі значення:
.RS 4
.IP "\fBno\fR, \fBoff\fR" 4
.IX Item "no, off"
Не використовувати проксі взагалі, незважаючи на налаштування системи.
-.IP "\fBsystem\fR" 4
+.IP \fBsystem\fR 4
.IX Item "system"
Використаний проксі\-сервер є системним.
.IP "\fIусе інше\fR" 4
Якщо значення не вказано, буде використано параметри проксі\-сервера системи (тобто все буде так, наче вказано \fBsystem\fR).
.RE
.ie n .IP """format=ФОРМАТ""" 4
-.el .IP "\f(CWformat=ФОРМАТ\fR" 4
+.el .IP \f(CWformat=ФОРМАТ\fR 4
.IX Item "format=ФОРМАТ"
Це необов'язкове поле задає формат сховища. Можливі такі значення:
.RS 4
-.IP "\fBnative\fR" 4
+.IP \fBnative\fR 4
.IX Item "native"
-Природний формат сховища \f(CW\*(C`virt\-builder\*(C'\fR. Див. також розділ \*(L"Створення і підписування файла покажчика\*(R" нижче.
-.IP "\fBsimplestreams\fR" 4
+Природний формат сховища \f(CW\*(C`virt\-builder\*(C'\fR. Див. також розділ "Створення і підписування файла покажчика" нижче.
+.IP \fBsimplestreams\fR 4
.IX Item "simplestreams"
Адреса, яка визначає кореневий каталог ієрархії метаданих Simple Streams версії 1.0.
.Sp
.PP
Ви можете створити власний сайт із файлом покажчика (index) і деякими шаблонами, а потім вказати virt-builder на цей сайт за допомогою вмісту файла \fI.conf\fR.
.PP
-Зауважте, що якщо ваш покажчик підписано, вам слід належним чином заповнити поле \fIgpgkey=..\fR у вашому файлі \fI.conf\fR, а також додати файл ключа \s-1GPG.\s0
+Зауважте, що якщо ваш покажчик підписано, вам слід належним чином заповнити поле \fIgpgkey=..\fR у вашому файлі \fI.conf\fR, а також додати файл ключа GPG.
.PP
.Vb 3
\& virt\-builder \-\-source https://example.com/builder/index.asc \e
\& \-\-list
.Ve
.PP
-Ви можете розмістити сайт будь\-якому мережевому сервері або сервері \s-1FTP\s0 чи у локальній або мережевій файловій системі.
+Ви можете розмістити сайт будь\-якому мережевому сервері або сервері FTP чи у локальній або мережевій файловій системі.
.PP
-\fIВстановлення ключа \s-1GPG\s0\fR
+\fIВстановлення ключа GPG\fR
.IX Subsection "Встановлення ключа GPG"
.PP
Якщо у вас ще немає ключа GnuPG, вам слід налаштувати такий. (Строго кажучи, це не є обов'язковою умовою, але якщо ваш файл покажчика і файл шаблона не буде підписано, користувачам virt-builder доведеться додавати параметр \fI\-\-no\-check\-signature\fR до команди кожного разу, коли їм потрібно буде скористатися virt-builder.)
.PP
-Інструкцію зі створення ключа можна знайти у підручнику з \s-1GPG:\s0 http://www.gnupg.org/gph/en/manual.html.
+Інструкцію зі створення ключа можна знайти у підручнику з GPG: http://www.gnupg.org/gph/en/manual.html.
.PP
-Експортувати ваш відкрити ключ \s-1GPG:\s0
+Експортувати ваш відкрити ключ GPG:
.PP
.Vb 1
\& gpg \-\-export \-a "you@example.com" > pubkey
.PP
Існує багато способів створення шаблонів. Наприклад, ви можете клонувати наявні гостьові системи (див. \fBvirt\-sysprep\fR\|(1)) або встановити гостьову систему вручну (\fBvirt\-install\fR\|(1)). Щоб ознайомитися із способами створення шаблонів для virt-builder, вивчіть скрипти у \f(CW\*(C`builder/templates\*(C'\fR
.PP
-У virt-builder передбачено підтримку усіх форматів образів (наприклад, raw, qcow2 тощо) як шаблонів, у звичайному форматі та у форматі, стисненому \s-1XZ.\s0 Таким чином, як шаблонами можна скористатися наявними образами (наприклад, образами, очищеними за допомогою \fBvirt\-sysprep\fR\|(1)).
+У virt-builder передбачено підтримку усіх форматів образів (наприклад, raw, qcow2 тощо) як шаблонів, у звичайному форматі та у форматі, стисненому XZ. Таким чином, як шаблонами можна скористатися наявними образами (наприклад, образами, очищеними за допомогою \fBvirt\-sysprep\fR\|(1)).
.PP
Для досягнення найкращих результатів під час стискання шаблонів скористайтеся такими параметрами програми xz (пояснення щодо цих параметрів можна знайти на сторінці довідки до \fBnbdkit\-xz\-plugin\fR\|(1)):
.PP
.PP
Можуть з’явитися такі поля:
.ie n .IP """name=НАЗВА""" 4
-.el .IP "\f(CWname=НАЗВА\fR" 4
+.el .IP \f(CWname=НАЗВА\fR 4
.IX Item "name=НАЗВА"
Зручна для користувача назва цього шаблона. Назву буде показано у виведених даних команди з параметром \fI\-\-list\fR, більше ніде програма її не використовує.
.ie n .IP """osinfo=ІДЕНТИФІКАТОР""" 4
-.el .IP "\f(CWosinfo=ІДЕНТИФІКАТОР\fR" 4
+.el .IP \f(CWosinfo=ІДЕНТИФІКАТОР\fR 4
.IX Item "osinfo=ІДЕНТИФІКАТОР"
Це додаткове поле пов'язує операційну систему із відповідним ідентифікатором libosinfo. Virt-builder (ще) не використовує ці дані.
.ie n .IP """arch=АРХІТЕКТУРА""" 4
-.el .IP "\f(CWarch=АРХІТЕКТУРА\fR" 4
+.el .IP \f(CWarch=АРХІТЕКТУРА\fR 4
.IX Item "arch=АРХІТЕКТУРА"
Архітектура операційної системи, яку встановлено у цьому шаблоні. Це поле є обов'язковим.
.ie n .IP """file=ШЛЯХ""" 4
-.el .IP "\f(CWfile=ШЛЯХ\fR" 4
+.el .IP \f(CWfile=ШЛЯХ\fR 4
.IX Item "file=ШЛЯХ"
Шлях (відносно покажчика) стисненого xz шаблона.
.Sp
Зауважте, що тут \fBне\fR можна використовувати абсолютні шляхи або адреси файлів. Причиною є те, що у virt-builder використовується правило «одного походження» для шаблонів, тому вони не можуть походити з інших серверів.
.ie n .IP """sig=ШЛЯХ""" 4
-.el .IP "\f(CWsig=ШЛЯХ\fR" 4
+.el .IP \f(CWsig=ШЛЯХ\fR 4
.IX Item "sig=ШЛЯХ"
\&\fBЦей параметр вважається застарілим\fR. Використовуйте замість нього поле контрольної суми (checksum).
.Sp
-Шлях (відносно покажчика) від'єднаного підпису \s-1GPG\s0 файла xz.
+Шлях (відносно покажчика) від'єднаного підпису GPG файла xz.
.Sp
Зауважте, що тут \fBне\fR можна використовувати абсолютні шляхи або адреси файлів. Причиною є те, що у virt-builder використовується правило «одного походження» для шаблонів, тому вони не можуть походити з інших серверів.
.Sp
\& gpg \-\-detach\-sign \-\-armor \-o disk.xz.sig disk.xz
.Ve
.ie n .IP """checksum[sha512]=7b882fe9b82eb0fef...""" 4
-.el .IP "\f(CWchecksum[sha512]=7b882fe9b82eb0fef...\fR" 4
+.el .IP \f(CWchecksum[sha512]=7b882fe9b82eb0fef...\fR 4
.IX Item "checksum[sha512]=7b882fe9b82eb0fef..."
-Контрольну суму \s-1SHA\-512\s0 файла, вказаного у виразі \fIfile=..\fR, буде перевірено після завершення отримання даних. Для визначення підпису скористайтеся такою командою:
+Контрольну суму SHA\-512 файла, вказаного у виразі \fIfile=..\fR, буде перевірено після завершення отримання даних. Для визначення підпису скористайтеся такою командою:
.Sp
.Vb 1
\& sha512sum disk.xz
.Sp
Зауважте, що якщо ви користуєтеся цим параметром, вам не потрібно підписувати файл, тобто використовувати параметр \f(CW\*(C`sig\*(C'\fR. Цей параметр має вищий пріоритет за параметра \f(CW\*(C`sig\*(C'\fR.
.ie n .IP """checksum=7b882fe9b82eb0fef...""" 4
-.el .IP "\f(CWchecksum=7b882fe9b82eb0fef...\fR" 4
+.el .IP \f(CWchecksum=7b882fe9b82eb0fef...\fR 4
.IX Item "checksum=7b882fe9b82eb0fef..."
\&\f(CW\*(C`checksum\*(C'\fR є скороченою формою запису \f(CW\*(C`checksum[sha512]\*(C'\fR.
.Sp
Якщо вам доводиться працювати з virt-builder = 1.24.0, слід користуватися \f(CW\*(C`checksum\*(C'\fR, оскільки ця версію видаватиме повідомлення про помилку обробки, якщо у ключі поля використано квадратні дужки і цифри. Цю помилку виправлено у версіях virt-builder ≥ 1.24.1.
.ie n .IP """revision=N""" 4
-.el .IP "\f(CWrevision=N\fR" 4
+.el .IP \f(CWrevision=N\fR 4
.IX Item "revision=N"
Модифікація (revision) — ціле число, яке використовується для керування кешем шаблонів. Збільшення номера модифікації призводить до того, що клієнти отримують шаблон, навіть якщо у них є копія у кеші.
.Sp
Номер модифікації є необов’язковим. Якщо його не вказано, типовим значенням вважається \f(CW1\fR.
.ie n .IP """format=raw""" 4
-.el .IP "\f(CWformat=raw\fR" 4
+.el .IP \f(CWformat=raw\fR 4
.IX Item "format=raw"
.PD 0
.ie n .IP """format=qcow2""" 4
-.el .IP "\f(CWformat=qcow2\fR" 4
+.el .IP \f(CWformat=qcow2\fR 4
.IX Item "format=qcow2"
.PD
Визначає формат образу диска; якщо дані стиснено, слід вказати формат до стискання. Якщо формат не вказано, його буде визначено автоматично, але все ж варто явним чином вказати бажаний формат.
.Sp
Зауважте, що це формат початкових даних, який відрізняється від параметра \fI\-\-format\fR (бажаний формат результату). Virt-builder виконує перетворення «на льоту» з початкового формату до бажаного формату результату.
.ie n .IP """size=NNN""" 4
-.el .IP "\f(CWsize=NNN\fR" 4
+.el .IP \f(CWsize=NNN\fR 4
.IX Item "size=NNN"
Віртуальний розмір образу у байтах. Це розмір нестисненого образу. Якщо використано формат, відмінний від raw, зокрема qcow2, це значення означає розмір віртуального диска, а не розмір файла qcow2.
.Sp
.Sp
Virt-builder також використовує це значення як мінімальний розмір, запит щодо якого можуть надсилати користувачів за допомогою параметра \fI\-\-size\fR, або типовий розмір, якщо не вказано параметр \fI\-\-size\fR.
.ie n .IP """compressed_size=NNN""" 4
-.el .IP "\f(CWcompressed_size=NNN\fR" 4
+.el .IP \f(CWcompressed_size=NNN\fR 4
.IX Item "compressed_size=NNN"
Справжній розмір образу диска у байтах, тобто розмір, який було вказано у \fIfile=..\fR. Це значення використовується лише для інформування (якщо використовуються формати \f(CW\*(C`long\*(C'\fR і \f(CW\*(C`json\*(C'\fR у параметрі \fI\-\-list\fR).
.ie n .IP """expand=/dev/sdaX""" 4
-.el .IP "\f(CWexpand=/dev/sdaX\fR" 4
+.el .IP \f(CWexpand=/dev/sdaX\fR 4
.IX Item "expand=/dev/sdaX"
При розпаковуванні образу до його остаточного розміру, наказати \fBvirt\-resize\fR\|(1) розпакувати дані до іменованого розділу у образі гостьової системи для заповнення усього доступного місця. Це працює подібно до параметра \fI\-\-expand\fR virt-resize.
.Sp
.Sp
Цим елементом варто скористатися, але це не обов'язково. Якщо поле пропущено, virt-resize створить додатковий розділ наприкінці диска для заповнення порожнього місця, що набагато менш зручно.
.ie n .IP """lvexpand=/пристрій/група_томів/логічний_том""" 4
-.el .IP "\f(CWlvexpand=/пристрій/група_томів/логічний_том\fR" 4
+.el .IP \f(CWlvexpand=/пристрій/група_томів/логічний_том\fR 4
.IX Item "lvexpand=/пристрій/група_томів/логічний_том"
При розпаковуванні образу до його остаточного розміру, наказати \fBvirt\-resize\fR\|(1) розпакувати дані до іменованого логічного тому у образі гостьової системи для заповнення усього доступного місця. Це працює подібно до параметра \fI\-\-lv\-expand\fR virt-resize.
.Sp
-Якщо у гостьовій системі використовується \s-1LVM2,\s0 тут слід вказати логічний том кореневої файлової системи гостьової операційної системи. Якщо у гостьовій операційній системі не використовується \s-1LVM2\s0 або її коренева файлова система не зберігається на логічному томі, не використовуйте цей параметр.
+Якщо у гостьовій системі використовується LVM2, тут слід вказати логічний том кореневої файлової системи гостьової операційної системи. Якщо у гостьовій операційній системі не використовується LVM2 або її коренева файлова система не зберігається на логічному томі, не використовуйте цей параметр.
.ie n .IP """notes=НОТАТКИ""" 4
-.el .IP "\f(CWnotes=НОТАТКИ\fR" 4
+.el .IP \f(CWnotes=НОТАТКИ\fR 4
.IX Item "notes=НОТАТКИ"
Будь\-які нотатки, які стосуються цього образу, особливо нотатки із описом пакунків образу, способу створення образу та даних щодо ліцензування.
.Sp
\& ...
.Ve
.ie n .IP """hidden=true""" 4
-.el .IP "\f(CWhidden=true\fR" 4
+.el .IP \f(CWhidden=true\fR 4
.IX Item "hidden=true"
Використання прапорця hidden усуває шаблон зі списку, який буде показано у відповідь на використання параметра \fI\-\-list\fR (лишаючи образ придатним до встановлення). Цей прапорець використовується для тестових образів.
.ie n .IP """aliases=ПСЕВДОНІМ1 ПСЕВДОНІМ2 ...""" 4
.PP
Зауважте, що обробник і інструмент може працювати як із підписаним, так і з непідписаним файлом покажчика (тобто з \fIindex\fR або з\fIindex.asc\fR).
.PP
-Кодуванням покажчика завжди є \s-1UTF\-8.\s0
-.SS "КЕШУВАННЯ"
+Кодуванням покажчика завжди є UTF\-8.
+.SS КЕШУВАННЯ
.IX Subsection "КЕШУВАННЯ"
\fIКешування шаблонів\fR
.IX Subsection "Кешування шаблонів"
.PP
Оскільки шаблоні зазвичай є дуже великими, отримані шаблони зберігають у кеші домашнього каталогу користувача.
.PP
-Кеш розміщується у \fI\f(CI$XDG_CACHE_HOME\fI/virt\-builder/\fR або \fI\f(CI$HOME\fI/.cache/virt\-builder\fR.
+Кеш розміщується у \fR\f(CI$XDG_CACHE_HOME\fR\fI/virt\-builder/\fR або \fI\fR\f(CI$HOME\fR\fI/.cache/virt\-builder\fR.
.PP
Ви можете отримати дані щодо каталогу кешу, зокрема дані щодо того, які гостьові системи кешуються, за допомогою такої команди:
.PP
.PP
Virt-builder використовує для отримання файлів \fBcurl\fR\|(1), а також використовує поточні параметри \f(CW\*(C`http_proxy\*(C'\fR (та інші) під час встановлення пакунків (\fI\-\-install\fR, \fI\-\-update\fR).
.PP
-Тому ви можете встановити ці змінні середовища з метою максимізації обсягу локального кешування. Див. \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" та \fBcurl\fR\|(1).
+Тому ви можете встановити ці змінні середовища з метою максимізації обсягу локального кешування. Див. "ЗМІННІ СЕРЕДОВИЩА" та \fBcurl\fR\|(1).
.PP
\fIЛокальні дзеркала\fR
.IX Subsection "Локальні дзеркала"
.Ve
.SS "ЦИФРОВІ ПІДПИСИ"
.IX Subsection "ЦИФРОВІ ПІДПИСИ"
-Virt-builder використовує \s-1GNU\s0 Privacy Guard (GnuPG або gpg) для забезпечення невтручання до покажчика і шаблонів.
+Virt-builder використовує GNU Privacy Guard (GnuPG або gpg) для забезпечення невтручання до покажчика і шаблонів.
.PP
Джерело вказує на файл покажчика, який можна підписати.
.PP
Під час отримання шаблона його підпис буде перевірено у той самий спосіб.
.PP
Хоча підписи і не є обов'язковими, якщо ви їх не використаєте, користувачам virt-builder доведеться використовувати параметр \fI\-\-no\-check\-signature\fR у рядку команди. За допомогою підпису можна запобігти заміні зловмисником підписаного файла покажчика непідписаним файлом. При цьому virt-builder без перевірки підпису не повідомлятиме про підміну. Щоб там не сталося, наполегливо рекомендуємо вам створювати підписаний покажчик і шаблони.
-.SS "АРХІТЕКТУРА"
+.SS АРХІТЕКТУРА
.IX Subsection "АРХІТЕКТУРА"
-Virt-builder може збирати образ гостьової системи для будь\-якої архітектури, незалежно від архітектури основної системи. Наприклад, можна зібрати образ гостьової системи архітектури x86\-64 на основній системі архітектури \s-1ARM.\s0
+Virt-builder може збирати образ гостьової системи для будь\-якої архітектури, незалежно від архітектури основної системи. Наприклад, можна зібрати образ гостьової системи архітектури x86\-64 на основній системі архітектури ARM.
.PP
Втім, деякі з параметрів не працюватимуть, особливо параметри, які потребують виконання команд у гостьовій системі під час процесу збирання: \fI\-\-install\fR, \fI\-\-update\fR, \fI\-\-run\fR, \fI\-\-run\-command\fR. Вам варто замінити ці команди на їхні еквіваленти у firstboot.
.PP
Основна система архітектури x86\-64, збираючи гостьові системи 32\-бітової архітектури i686, має працювати без використання будь\-яких додаткових кроків налаштовування.
-.SS "БЕЗПЕКА"
+.SS БЕЗПЕКА
.IX Subsection "БЕЗПЕКА"
Virt-builder не потребує запуску від імені користувача root (фактично, програму не слід запускати від імені root) і не використовує setuid, \f(CW\*(C`sudo\*(C'\fR або будь\-яких інших подібних механізмів.
.PP
.PP
Команди першого завантаження виконуються у контексті гостьової системи, тому слід брати до уваги параметри захисту у вашому гіпервізорі або обчислювальній хмарі.
.PP
-Virt-builder додає випадкову базу псевдовипадкових чисел до кожної гостьової системи, яку зібрано за його допомогою. Це допомагає забезпеченню справжньої випадковості номерів послідовності \s-1TCP, UUID,\s0 ключів вузла ssh тощо під час завантаження гостьової системи.
+Virt-builder додає випадкову базу псевдовипадкових чисел до кожної гостьової системи, яку зібрано за його допомогою. Це допомагає забезпеченню справжньої випадковості номерів послідовності TCP, UUID, ключів вузла ssh тощо під час завантаження гостьової системи.
.PP
Вам слід перевіряти цифрові підписи і не ігнорувати повідомлення про помилки під час таких перевірок.
-.SS "КЛОНИ"
+.SS КЛОНИ
.IX Subsection "КЛОНИ"
Якщо вам потрібно створити багато гостьових систем одного типу, виникає спокуса запустити virt-builder один раз, а потім просто скопіювати файл\-результат. Втім, так \fBне\fR слід робити. Вам слід запустити virt-builder окремо для кожної нової гостьової системи, яку ви хочете створити.
.PP
-Так слід робити тому, що кожен клон повинен мати (принаймні) окрему базу для псевдовипадкових чисел, а також, ймовірно, інші унікальні властивості (зокрема \s-1UUID\s0 файлових систем) у майбутніх версіях virt-builder.
+Так слід робити тому, що кожен клон повинен мати (принаймні) окрему базу для псевдовипадкових чисел, а також, ймовірно, інші унікальні властивості (зокрема UUID файлових систем) у майбутніх версіях virt-builder.
.PP
-Ще однією річчю, яку вам \fIне\fR слід робити, є клонування завантаженого образу диска. Причиною цього є те, що деякі гостьові системи створюють унікальні ідентифікатори машини, ключі \s-1SSH\s0 вузла та інші дані під час першого завантаження, а дублювання таких ідентифікаторів у клонах є вкрай небажаним.
+Ще однією річчю, яку вам \fIне\fR слід робити, є клонування завантаженого образу диска. Причиною цього є те, що деякі гостьові системи створюють унікальні ідентифікатори машини, ключі SSH вузла та інші дані під час першого завантаження, а дублювання таких ідентифікаторів у клонах є вкрай небажаним.
.PP
Див. також \fBvirt\-sysprep\fR\|(1).
-.SS "ШВИДКОДІЯ"
+.SS ШВИДКОДІЯ
.IX Subsection "ШВИДКОДІЯ"
-Найважливішим аспектом пришвидшення роботи програми є кешування. Шаблон завантажується до кешу, коли його вперше використовують, або якщо було використано параметр команди \fI\-\-cache\-all\-templates\fR. Докладніше про це у розділі \*(L"КЕШУВАННЯ\*(R" вище.
+Найважливішим аспектом пришвидшення роботи програми є кешування. Шаблон завантажується до кешу, коли його вперше використовують, або якщо було використано параметр команди \fI\-\-cache\-all\-templates\fR. Докладніше про це у розділі "КЕШУВАННЯ" вище.
.PP
Пакунки, потрібні для виконання завдань із параметрами \fI\-\-install\fR та \fI\-\-update\fR, отримуються за допомогою з'єднання з мережею основної системи. Встановлення значень змінних середовища \f(CW\*(C`http_proxy\*(C'\fR, \f(CW\*(C`https_proxy\*(C'\fR та \f(CW\*(C`ftp_proxy\*(C'\fR таким чином, щоб вони вказували на локальний кеш, може забезпечити режим, за якого ці пакунки отримуватимуться із інтернету лише один раз. Ви також можете спробувати скористатися локальним сховищем пакунків, хоча налаштовування такого сховища може бути складною справою, специфічною для того дистрибутива Linux, який ви намагаєтеся встановити.
.PP
-\fIКористування \fI\-\-no\-sync\fI\fR
+\fIКористування \-\-no\-sync\fR
.IX Subsection "Користування --no-sync"
.PP
-Скористайтеся \fI\-\-no\-sync\fR. Втім, ознайомтеся із можливими проблемами, описаними у розділі \*(L"ПАРАМЕТРИ\*(R" вище, оскільки це може призвести до пошкодження даних на диску, якщо використовувати неправильно.
+Скористайтеся \fI\-\-no\-sync\fR. Втім, ознайомтеся із можливими проблемами, описаними у розділі "ПАРАМЕТРИ" вище, оскільки це може призвести до пошкодження даних на диску, якщо використовувати неправильно.
.PP
\fIПропускання virt-resize\fR
.IX Subsection "Пропускання virt-resize"
.PP
За певних умов virt-builder може пропускати крок virt-resize. Це значно пришвидшує роботу virt-builder. Умови пропускання є такими:
-.IP "\(bu" 4
+.IP \(bu 4
дані слід виводити до звичайного файла (не на блоковий пристрій), \fBі\fR
-.IP "\(bu" 4
+.IP \(bu 4
користувачем \fBне\fR використано параметр \fI\-\-size\fR, \fBі\fR
-.IP "\(bu" 4
+.IP \(bu 4
формат виведення є тим самим, що і формат шаблона (зазвичай raw).
.PP
\fIpxzcat\fR
.IX Subsection "pxzcat"
.PP
Virt-builder використовує внутрішню реалізацію pxzcat (паралельного xzcat), якщо під час збирання програми було знайдено liblzma. Якщо liblzma не було знайдено під час збирання, використовуватиметься звичайний \f(CW\*(C`xzcat\*(C'\fR, який працює у один потік.
-.SS "\s-1SELINUX\s0"
+.SS SELINUX
.IX Subsection "SELINUX"
Гостьові системи, у яких використовується SELinux (зокрема Fedora і Red Hat Enterprise Linux) потребують коректної мітки SELinux для кожного файла.
.PP
.PP
Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.
.PP
-Можна вказати рядок форматування для керування виведенням, див. \*(L"РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" in \fBguestfs\fR\|(3).
+Можна вказати рядок форматування для керування виведенням, див. "РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" in \fBguestfs\fR\|(3).
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
-Опис інших змінних середовища, які стосуються усіх програм libguestfs, наведено у розділі \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" in \fBguestfs\fR\|(3).
+Опис інших змінних середовища, які стосуються усіх програм libguestfs, наведено у розділі "ЗМІННІ СЕРЕДОВИЩА" in \fBguestfs\fR\|(3).
.ie n .IP """http_proxy""" 4
-.el .IP "\f(CWhttp_proxy\fR" 4
+.el .IP \f(CWhttp_proxy\fR 4
.IX Item "http_proxy"
.PD 0
.ie n .IP """https_proxy""" 4
-.el .IP "\f(CWhttps_proxy\fR" 4
+.el .IP \f(CWhttps_proxy\fR 4
.IX Item "https_proxy"
.ie n .IP """no_proxy""" 4
-.el .IP "\f(CWno_proxy\fR" 4
+.el .IP \f(CWno_proxy\fR 4
.IX Item "no_proxy"
.PD
Встановити проксі\-сервер для отримання даних. Ці змінні середовища (та інші) насправді обробляються \fBcurl\fR\|(1), а не virt-builder.
.ie n .IP """HOME""" 4
-.el .IP "\f(CWHOME\fR" 4
+.el .IP \f(CWHOME\fR 4
.IX Item "HOME"
-Використовується для визначення місця кешу шаблонів та місця джерел користувача. Див. \*(L"КЕШУВАННЯ\*(R" і \*(L"ДЖЕРЕЛА ШАБЛОНІВ\*(R".
+Використовується для визначення місця кешу шаблонів та місця джерел користувача. Див. "КЕШУВАННЯ" і "ДЖЕРЕЛА ШАБЛОНІВ".
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
Ця змінна визначає каталог, у якому містяться файли даних, які використовуються для встановлення Windows з першим завантаженням.
.Sp
.Sp
Цей каталог може містити такі файли:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
Це виконуваний файл для Windows RHSrvAny, який використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.Sp
Див. також \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-Це виконуваний файл Windows, що постачається разом із \s-1VMDP SUSE,\s0 використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
+Це виконуваний файл Windows, що постачається разом із VMDP SUSE, використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.RE
.RS 4
.RE
.ie n .IP """XDG_CACHE_HOME""" 4
-.el .IP "\f(CWXDG_CACHE_HOME\fR" 4
+.el .IP \f(CWXDG_CACHE_HOME\fR 4
.IX Item "XDG_CACHE_HOME"
-Використовується для визначення місця кешу шаблонів. Див. \*(L"КЕШУВАННЯ\*(R".
+Використовується для визначення місця кешу шаблонів. Див. "КЕШУВАННЯ".
.ie n .IP """XDG_CONFIG_HOME""" 4
-.el .IP "\f(CWXDG_CONFIG_HOME\fR" 4
+.el .IP \f(CWXDG_CONFIG_HOME\fR 4
.IX Item "XDG_CONFIG_HOME"
-Використовується для визначення місця джерел користувача. Див. \*(L"ДЖЕРЕЛА ШАБЛОНІВ\*(R".
+Використовується для визначення місця джерел користувача. Див. "ДЖЕРЕЛА ШАБЛОНІВ".
.ie n .IP """VIRT_BUILDER_DIRS""" 4
-.el .IP "\f(CWVIRT_BUILDER_DIRS\fR" 4
+.el .IP \f(CWVIRT_BUILDER_DIRS\fR 4
.IX Item "VIRT_BUILDER_DIRS"
-Використовується для визначення місця джерел системи. Див. \*(L"ДЖЕРЕЛА ШАБЛОНІВ\*(R".
+Використовується для визначення місця джерел системи. Див. "ДЖЕРЕЛА ШАБЛОНІВ".
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBguestmount\fR\|(1), \fBvirt\-builder\-repository\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-customize\fR\|(1), \fBvirt\-get\-kernel\fR\|(1), \fBvirt\-install\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sysprep\fR\|(1), \fBoz\-install\fR\|(1), \fBgpg\fR\|(1), \fBgpg2\fR\|(1), \fBcurl\fR\|(1), \fBvirt\-make\-fs\fR\|(1), \fBgenisoimage\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
© Red Hat Inc., 2013
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-cat 1"
-.TH virt-cat 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-cat 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-cat — показ файлів у віртуальній машині
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-cat диск.img файл
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-cat\*(C'\fR — інструмент командного рядка для показу вмісту \f(CW\*(C`файла\*(C'\fR, який зберігається у вказаній віртуальній машині (або образі диска).
.PP
Ви можете вказати декілька назв файлів. Вміст таких файлів буде об’єднано. Назви файлів слід вказувати повністю (разом зі шляхом), починаючи з кореневого каталогу (тобто назва має починатися з «/»).
.PP
-\&\f(CW\*(C`virt\-cat\*(C'\fR можна скористатися для пришвидшення перегляду файла. Для редагування даних слід користуватися \f(CW\*(C`virt\-edit\*(C'\fR. Для виконання складніших дій можна скористатися програмою \fBguestfish\fR\|(1) (див. \*(L"ВИКОРИСТАННЯ \s-1GUESTFISH\*(R"\s0 нижче).
-.SH "ПРИКЛАДИ"
+\&\f(CW\*(C`virt\-cat\*(C'\fR можна скористатися для пришвидшення перегляду файла. Для редагування даних слід користуватися \f(CW\*(C`virt\-edit\*(C'\fR. Для виконання складніших дій можна скористатися програмою \fBguestfish\fR\|(1) (див. "ВИКОРИСТАННЯ GUESTFISH" нижче).
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Показати вміст файл \fI/etc/fstab\fR у віртуальній машині libvirt з назвою \f(CW\*(C`mydomain\*(C'\fR:
.PP
\& virt\-cat \-d mydomain /var/log/wtmp > /tmp/wtmp
\& last \-f /tmp/wtmp
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-cat попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Визначення точки монтування вимикає інспектування гостьової системи і призводить до монтування її кореневої системи та усіх її точок монтування. Тому вам слід забезпечити монтування усіх точок монтування, потрібних для роботи із файлами, назви яких вказано як аргументи.
.Sp
-Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" і \*(L"lvs\*(R"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
+Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди "list-partitions", "list-filesystems" і "lvs"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
.Sp
-Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (\s-1ACL\s0) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
+Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (ACL) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
Використання цього прапорця є еквівалентним до використання команди \f(CW\*(C`mount\-options\*(C'\fR.
.Sp
Четвертою частиною параметра є назва драйвера файлової системи, якою слід скористатися, зокрема \f(CW\*(C`ext3\*(C'\fR або \f(CW\*(C`ntfs\*(C'\fR. У визначенні цієї частини параметра рідко виникає потреба, але вона може бути корисною, якщо для файлової системи можна скористатися декількома драйверами (приклад: \f(CW\*(C`ext2\*(C'\fR і \f(CW\*(C`ext3\*(C'\fR), або libguestfs визначає файлову систему помилково.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
У \f(CW\*(C`virt\-cat\*(C'\fR передбачено обмежені можливості щодо обробки літерних дисків та шляхів у Windows (наприклад \fIE:\efoo\ebar.txt\fR).
.PP
Тоді і лише тоді, коли у гостьовій системі працює Windows:
-.IP "\(bu" 4
+.IP \(bu 4
Літери дисків, наприклад \f(CW\*(C`C:\*(C'\fR, замінюються на адреси відповідних файлових систем на основі даних з регістру Windows.
-.IP "\(bu" 4
+.IP \(bu 4
Усі символи зворотної похилої риски (\f(CW\*(C`\e\*(C'\fR) у шляху замінюються символами звичайної похилої риски так, щоб libguestfs змогла обробити адресу.
-.IP "\(bu" 4
+.IP \(bu 4
Шлях до файла, вміст якого має бути показано, визначається без врахування регістру символів у його записі.
.PP
Відомі певні недоліки програми:
-.IP "\(bu" 4
-Перехід за деякими символічними посиланнями \s-1NTFS\s0 може здійснюватися з помилками.
-.IP "\(bu" 4
-Точки з'єднання \s-1NTFS,\s0 які виходять за межі однією файлової системи використовувати не можна.
+.IP \(bu 4
+Перехід за деякими символічними посиланнями NTFS може здійснюватися з помилками.
+.IP \(bu 4
+Точки з'єднання NTFS, які виходять за межі однією файлової системи використовувати не можна.
.SH "ВИКОРИСТАННЯ GUESTFISH"
.IX Header "ВИКОРИСТАННЯ GUESTFISH"
\&\fBguestfish\fR\|(1) є потужнішим інструментом нижчого рівня, яким можна скористатися, якщо \f(CW\*(C`virt\-cat\*(C'\fR не працює.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-edit\fR\|(1), \fBvirt\-log\fR\|(1), \fBvirt\-tail\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-customize 1"
-.TH virt-customize 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-customize 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-customize — налаштовування віртуальної машини
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-customize [ \-V | \-\-version ]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
За допомогою virt-customize можна налаштувати віртуальну машину (образ диска) встановленням пакунків, редагуванням файлів налаштувань тощо.
.PP
Вам \fIне потрібно\fR запускати virt-customize від імені користувача root. Фактично, запуск у такому режимі є нерекомендованим.
.PP
Пов'язані інструменти: \fBvirt\-sysprep\fR\|(1) і \fBvirt\-builder\fR\|(1).
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
+Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
.IP "\fB\-\-attach\fR ФАЙЛ_ISO" 4
.IX Item "--attach ФАЙЛ_ISO"
Вказаний диск долучається до базової системи libguestfs. Цей диск використовується для отримання даних додаткових сховищ програмного забезпечення або інших даних для створення нетипової системи.
.Sp
-Ймовірно, вам варто додати мітки для долучених дисків (або скористатися назвою тому \s-1ISO\s0), щоб надалі монтувати диски за міткою у ваших скриптах запуску:
+Ймовірно, вам варто додати мітки для долучених дисків (або скористатися назвою тому ISO), щоб надалі монтувати диски за міткою у ваших скриптах запуску:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
-Параметр \fI\-\-attach\fR можна вказати декілька разів, а форматом може бути будь\-який формат образу (не лише \s-1ISO\s0).
+Параметр \fI\-\-attach\fR можна вказати декілька разів, а форматом може бути будь\-який формат образу (не лише ISO).
.IP "\fB\-\-attach\-format\fR ФОРМАТ" 4
.IX Item "--attach-format ФОРМАТ"
-Вказати формат диска для наступного параметра \fI\-\-attach\fR. Значенням аргументу \f(CW\*(C`ФОРМАТ\*(C'\fR зазвичай є \f(CW\*(C`raw\*(C'\fR або \f(CW\*(C`qcow2\*(C'\fR. Для образів \s-1ISO\s0 скористайтеся варіантом \f(CW\*(C`raw\*(C'\fR.
-.IP "\fB\-\-colors\fR" 4
+Вказати формат диска для наступного параметра \fI\-\-attach\fR. Значенням аргументу \f(CW\*(C`ФОРМАТ\*(C'\fR зазвичай є \f(CW\*(C`raw\*(C'\fR або \f(CW\*(C`qcow2\*(C'\fR. Для образів ISO скористайтеся варіантом \f(CW\*(C`raw\*(C'\fR.
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-n\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
Виконати тестову обробку гостьової системи у режимі «лише читання». Буде виконано дію sysprep, але наприкінці усі зміни до диска буде відкинуто.
-.IP "\fB\-\-echo\-keys\fR" 4
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-customize попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
-.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
+.Sp
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Vb 1
\& guestfish get\-memsize
.Ve
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Увімкнути чи вимкнути доступ до мережі для гостьової системи під час встановлення.
.Sp
Типово увімкнено. Скористайтеся параметром \fI\-\-no\-network\fR, щоб вимкнути доступ.
.Sp
-У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. \*(L"МЕРЕЖА\*(R" in \fBvirt\-rescue\fR\|(1).
+У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. "МЕРЕЖА" in \fBvirt\-rescue\fR\|(1).
.Sp
Якщо ви скористаєтеся параметром \fI\-\-no\-network\fR, тоді інші параметри, зокрема \fI\-\-install\fR, не працюватимуть.
.Sp
.Sp
Загалом кажучи, вам \fIне варто\fR використовувати \fI\-\-no\-network\fR. Але ось декілька випадків, коли у вас може виникнути потреба у використанні цього параметра:
.RS 4
-.IP "1." 4
-У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки мережі. (Див. \*(L"МОДУЛЬ\*(R" in \fBguestfs\fR\|(3)).
-.IP "2." 4
-Усе програмне забезпечення, яке ви маєте намір встановити, походить з долученого образу \s-1ISO,\s0 отже потреби у мережі немає.
-.IP "3." 4
-Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати доступ до мережевого з'єднання вашої основної системи під час роботи virt-customize. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу шаблонів операційних систем. (Див. \*(L"БЕЗПЕКА\*(R" нижче).
-.IP "4." 4
+.IP 1. 4
+У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки мережі. (Див. "МОДУЛЬ" in \fBguestfs\fR\|(3)).
+.IP 2. 4
+Усе програмне забезпечення, яке ви маєте намір встановити, походить з долученого образу ISO, отже потреби у мережі немає.
+.IP 3. 4
+Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати доступ до мережевого з'єднання вашої основної системи під час роботи virt-customize. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу шаблонів операційних систем. (Див. "БЕЗПЕКА" нижче).
+.IP 4. 4
Ви не хочете користуватися мережею основної системи (наприклад, через захищеність або обмеженість середовища у ній).
.RE
.RS 4
.RE
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Не виводити повідомлення до журналу.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
Увімкнути N ≥ 2 віртуальних процесорів для використання у скриптах \fI\-\-run\fR.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SS "Параметри налаштовування"
Змінити права доступу до файла \f(CW\*(C`ФАЙЛ\*(C'\fR на \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR.
.Sp
\&\fIЗауваження\fR: типово \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR записуються у десятковому форматі, якщо ви не додасте початковий \f(CW0\fR , щоб вказати вісімкове число, тобто скористаєтеся \f(CW0700\fR, а не \f(CW700\fR.
+.IP "\fB\-\-chown\fR UID:GID:PATH" 4
+.IX Item "--chown UID:GID:PATH"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+Приклад:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
.IP "\fB\-\-commands\-from\-file\fR НАЗВА_ФАЙЛА" 4
.IX Item "--commands-from-file НАЗВА_ФАЙЛА"
Прочитати команди налаштовування з файла, по одній (разом із аргументами) на рядок.
.Sp
Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено Perl 5.
.Sp
-Див. \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
+Див. "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
.IP "\fB\-\-firstboot\fR СКРИПТ" 4
.IX Item "--firstboot СКРИПТ"
Встановити \f(CW\*(C`СКРИПТ\*(C'\fR у гостьовій системі і запустити його під час першого завантаження гостьової системи (від імені root, у останній частині процесу завантаження).
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-command\fR 'КОМАНДА+ПАРАМЕТРИ'" 4
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-install\fR ПАКУНОК,ПАКУНОК.." 4
.IX Item "--firstboot-install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час першого завантаження гостьової системи за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею гостьової системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-hostname\fR НАЗВА_ВУЗЛА" 4
.IX Item "--hostname НАЗВА_ВУЗЛА"
-Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (\s-1FQDN\s0).
-.IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0" 4
+Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (FQDN).
+.IP "\fB\-\-inject\-qemu\-ga\fR METHOD" 4
.IX Item "--inject-qemu-ga METHOD"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0" 4
+.IP "\fB\-\-inject\-virtio\-win\fR METHOD" 4
.IX Item "--inject-virtio-win METHOD"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.IX Item "--install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею основної системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ" in \fBvirt\-builder\fR\|(1).
.Sp
Див. також \fI\-\-update\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR ПРИЗНАЧЕННЯ:ПОСИЛАННЯ[:ПОСИЛАННЯ..]" 4
.IX Item "--mkdir КАТАЛОГ"
Створити каталог у гостьовій системі.
.Sp
-Використовується \f(CW\*(C`mkdir \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
+Використовується \f(CW\*(C`mkdir\ \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
.IP "\fB\-\-move\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ" 4
.IX Item "--move ДЖЕРЕЛО:ПРИЗНАЧЕННЯ"
Пересунути файли або каталоги у межах гостьової системи.
.Sp
Не можна використовувати символи\-замінники.
-.IP "\fB\-\-no\-logfile\fR" 4
+.IP \fB\-\-no\-logfile\fR 4
.IX Item "--no-logfile"
Витерти \f(CW\*(C`builder.log\*(C'\fR (файл журналу із командами збирання) з образу після завершення збирання. Якщо ви не хочете явним чином показувати, як було зібрано образ, скористайтеся цим параметром.
.Sp
-Див. також \*(L"\s-1LOG FILE\*(R"\s0.
-.IP "\fB\-\-no\-selinux\-relabel\fR" 4
+Див. також "LOG FILE".
+.IP \fB\-\-no\-selinux\-relabel\fR 4
.IX Item "--no-selinux-relabel"
Do not attempt to correct the SELinux labels of files in the guest.
.Sp
.IX Item "--password КОРИСТУВАЧ:ВАРІАНТ"
Встановити пароль для користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR. (Зауважте, що за допомогою цього параметра \fIне можна\fR створювати облікові записи користувачів.)
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
Якщо змінюється чи встановлюється пароль для гостьової системи, за допомогою цього параметра можна встановити шифрування для цього пароля у значення \f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`sha256\*(C'\fR або \f(CW\*(C`sha512\*(C'\fR.
.Sp
\&\f(CW\*(C`md5\*(C'\fR працюватиме з відносно давніми гостьовими системами Linux (наприкладRHEL 3), але є незахищеним щодо новітніх способів атак.
.Sp
-Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку \s-1SHA\-512.\s0 Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
+Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку SHA\-512. Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
.Sp
-Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
.IP "\fB\-\-root\-password\fR ВАРІАНТ" 4
.IX Item "--root-password ВАРІАНТ"
Встановити пароль користувача root.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ" in \fBvirt\-builder\fR\|(1).
.Sp
Зауваження: якщо у virt-builder ви \fIне встановите\fR \fI\-\-root\-password\fR, для гостьової системи буде використано \fIвипадковий\fR пароль root.
.IP "\fB\-\-run\fR СКРИПТ" 4
.Sp
Для скрипту буде автоматично використано команду chmod +x.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--run-command 'КОМАНДА+ПАРАМЕТРИ'"
Виконати команду із аргументами у образі диска. Команду буде виконано у віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової файлової системи.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\-command\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--scrub ФАЙЛ"
Витерти файл з гостьової системи. Подібне до \fI\-\-delete\fR, окрім того, що:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Витирає дані так, що їх не можна буде відновити з гостьової системи.
-.IP "\(bu" 4
+.IP \(bu 4
Не може вилучати каталоги, лише звичайні файли.
.RE
.RS 4
.RE
-.IP "\fB\-\-selinux\-relabel\fR" 4
+.IP \fB\-\-selinux\-relabel\fR 4
.IX Item "--selinux-relabel"
This is a compatibility option that does nothing.
.IP "\fB\-\-sm\-attach\fR ВАРІАНТ" 4
.IX Item "--sm-attach ВАРІАНТ"
Долучити систему до буфера передплати за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-sm\-credentials\fR ВАРІАНТ" 4
.IX Item "--sm-credentials ВАРІАНТ"
Встановити реєстраційні дані для \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
-.IP "\fB\-\-sm\-register\fR" 4
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1).
+.IP \fB\-\-sm\-register\fR 4
.IX Item "--sm-register"
Зареєструвати гостьову систему за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
Потребує встановлення реєстраційних даних за допомогою \fI\-\-sm\-credentials\fR.
-.IP "\fB\-\-sm\-remove\fR" 4
+.IP \fB\-\-sm\-remove\fR 4
.IX Item "--sm-remove"
Вилучити усі передплати з гостьової системи за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
-.IP "\fB\-\-sm\-unregister\fR" 4
+.IP \fB\-\-sm\-unregister\fR 4
.IX Item "--sm-unregister"
Зняти гостьову систему з реєстрації за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-ssh\-inject\fR КОРИСТУВАЧ[:ВАРІАНТ]" 4
.IX Item "--ssh-inject КОРИСТУВАЧ[:ВАРІАНТ]"
Вставити ключ ssh так, щоб вказаний \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR зміг увійти до системи з використанням ssh без потреби у визначенні пароля. Запис користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR має вже існувати у гостьовій системі.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"КЛЮЧІ \s-1SSH\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "КЛЮЧІ SSH" in \fBvirt\-builder\fR\|(1).
.Sp
Ви можете додати декілька параметрів \fI\-\-ssh\-inject\fR для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.
+.IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
.IP "\fB\-\-timezone\fR ЧАСОВИЙ_ПОЯС" 4
.IX Item "--timezone ЧАСОВИЙ_ПОЯС"
Встановити типовий часовий пояс гостьової системи у значення \f(CW\*(C`ЧАСОВИЙ_ПОЯС\*(C'\fR. Скористайтеся рядком місця у форматі \f(CW\*(C`Europe/London\*(C'\fR
Вилучити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде вилучено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо). З метою виконання запиту також може бути вилучено пакунки, залежні від вилучених пакунків.
.Sp
Див. також \fI\-\-install\fR, \fI\-\-update\fR.
-.IP "\fB\-\-update\fR" 4
+.IP \fB\-\-update\fR 4
.IX Item "--update"
Виконує еквівалент \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR або якоїсь іншої команди, яка потрібна для оновлення пакунків, які вже встановлено у шаблоні, до найсвіжіших версій.
.Sp
.IP "\fB\-\-write\fR ФАЙЛ:ДАНІ" 4
.IX Item "--write ФАЙЛ:ДАНІ"
Записати \f(CW\*(C`ДАНІ\*(C'\fR до файла \f(CW\*(C`ФАЙЛ\*(C'\fR.
-.SH "SELINUX"
+.SH SELINUX
.IX Header "SELINUX"
Для гостьових систем, у яких використовується SELinux, може знадобитися спеціальна обробка, якщо використовуються дії, які створюють нові файли або вносять зміни до наявних файлів.
.PP
-Докладніший опис наведено у розділі \*(L"\s-1SELINUX\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+Докладніший опис наведено у розділі "SELINUX" in \fBvirt\-builder\fR\|(1).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає 0, якщо роботу виконано успішно, і 1, якщо сталися помилки.
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
Ця змінна визначає каталог, у якому містяться файли даних, які використовуються для встановлення Windows з першим завантаженням.
.Sp
.Sp
Цей каталог може містити такі файли:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
Це виконуваний файл для Windows RHSrvAny, який використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.Sp
Див. також \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-Це виконуваний файл Windows, що постачається разом із \s-1VMDP SUSE,\s0 використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
+Це виконуваний файл Windows, що постачається разом із VMDP SUSE, використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.RE
.RS 4
.RE
.PP
-Опис інших змінних середовища наведено у розділі \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
+Опис інших змінних середовища наведено у розділі "ENVIRONMENT VARIABLES" in \fBguestfs\fR\|(3).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-builder\fR\|(1), \fBvirt\-clone\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirt\-sysprep\fR\|(1), \fBvirsh\fR\|(1), \fBlvcreate\fR\|(8), \fBqemu\-img\fR\|(1), \fBscrub\fR\|(1), http://libguestfs.org/, http://libvirt.org/.
-.SH "АВТОРИ"
+.SH АВТОРИ
.IX Header "АВТОРИ"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2011\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-df 1"
-.TH virt-df 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-df 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-df — програма для показу даних щодо вільного місця на віртуальних файлових системах
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-df [\-\-параметри] диск.img [диск.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-df\*(C'\fR — інструмент командного рядка для показу вільного місця у файлових системах віртуальної машини. На відміну від інших інструментів, він не показує розмір диску, який отримано для віртуальної машини, а може зазирнути всередину образу диска і визначити, скільки саме місця насправді використовується.
.PP
Якщо команду віддано без аргументів \fI\-a\fR або \fI\-d\fR, \f(CW\*(C`virt\-df\*(C'\fR отримає від libvirt список активних і неактивних гостьових систем і виконає дію типу \f(CW\*(C`df\*(C'\fR для кожного з них послідовно, а потім виведе результати.
.PP
-Якщо вказано якийсь із аргументів, \fI\-a\fR або \fI\-d\fR, \f(CW\*(C`virt\-df\*(C'\fR виконає дію типу \f(CW\*(C`df\*(C'\fR або над окремим вказаним за назвою доменом libvirt, або над образами дисків, вказаних у форматі списку у командному рядку (усі вони мають належати до однієї віртуальної машини). \fBУ цьому режимі (з аргументами), \f(CB\*(C`virt\-df\*(C'\fB працюватиме для однієї гостьової системи\fR. Якщо ви хочете обробити декілька гостьових систем, вам слід викликати \f(CW\*(C`virt\-df\*(C'\fR декілька разів.
+Якщо вказано якийсь із аргументів, \fI\-a\fR або \fI\-d\fR, \f(CW\*(C`virt\-df\*(C'\fR виконає дію типу \f(CW\*(C`df\*(C'\fR або над окремим вказаним за назвою доменом libvirt, або над образами дисків, вказаних у форматі списку у командному рядку (усі вони мають належати до однієї віртуальної машини). \fBУ цьому режимі (з аргументами), \fR\f(CB\*(C`virt\-df\*(C'\fR\fB працюватиме для однієї гостьової системи\fR. Якщо ви хочете обробити декілька гостьових систем, вам слід викликати \f(CW\*(C`virt\-df\*(C'\fR декілька разів.
.PP
Скористайтеся параметром \fI\-\-csv\fR, щоб отримати формат у вигляді даних, які може бути просто оброблено у інших програмах. Інші параметри подібні до параметрів стандартної команди \fBdf\fR\|(1).
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Показати використання диска для окремої гостьової системи libvirt, яка називається \f(CW\*(C`F14x64\*(C'\fR. Зробити виведені дані зручними для читання:
.PP
\& Win7x32TwoDisks\-a+:/dev/sda2 12478460 7403416 5075044 60%
\& Win7x32TwoDisks\-a+:/dev/sdb1 521212 55728 465484 11%
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR ФАЙЛ" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Вивести результати до формату \s-1CSV\s0 (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом \*(L"НОТАТКА ЩОДО ФОРМАТУ \s-1CSV\*(R"\s0, наведеним нижче.
+Вивести результати до формату CSV (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом "НОТАТКА ЩОДО ФОРМАТУ CSV", наведеним нижче.
.IP "\fB\-d\fR гість" 4
.IX Item "-d гість"
.PD 0
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-h\fR" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
Вивести дані щодо розмірів у зручному для читання форматі.
.Sp
Параметри \fI\-h\fR і \fI\-\-csv\fR не можна використовувати одночасно.
-.IP "\fB\-i\fR" 4
+.IP \fB\-i\fR 4
.IX Item "-i"
.PD 0
-.IP "\fB\-\-inodes\fR" 4
+.IP \fB\-\-inodes\fR 4
.IX Item "--inodes"
.PD
Вивести дані щодо inode замість даних щодо блоків.
-.IP "\fB\-\-one\-per\-guest\fR" 4
+.IP \fB\-\-one\-per\-guest\fR 4
.IX Item "--one-per-guest"
З версії libguestfs 1.22 ця поведінка є типовою. Використання цього параметра не має жодних наслідків. Параметр збережено лише з міркувань зворотної сумісності із давніми скриптами.
.IP "\fB\-P\fR кількість_потоків" 4
З версії libguestfs 1.22 у virt-df передбачено обробку у декілька потоків і паралельне вивчення гостьових систем. Типово кількість потоків виконання, що використовуються, вибирається на основі доступного обсягу вільної пам’яті на час запуску virt-df. Ви можете примусово наказати virt-df використовувати не більше за \f(CW\*(C`кількість_потоків\*(C'\fR за допомогою параметра \fI\-P\fR.
.Sp
Зауважте, що \fI\-P 0\fR означає автоматичне визначення, а \fI\-P 1\fR означає використання одного потоку виконання.
-.IP "\fB\-\-uuid\fR" 4
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
-Виводити \s-1UUID\s0 замість назв. Корисно для слідкування за гостьовою системою, навіть після перенесення або перейменування, або якщо дві гостьові системи мають однакові назви.
+Виводити UUID замість назв. Корисно для слідкування за гостьовою системою, навіть після перенесення або перейменування, або якщо дві гостьові системи мають однакові назви.
.Sp
-Зауважте, що \s-1UUID\s0 матимуть лише ті домени, які ми отримуємо з libvirt. Для образів дисків ми виводимо назви образів дисків, навіть якщо вказано цей параметр.
-.IP "\fB\-v\fR" 4
+Зауважте, що UUID матимуть лише ті домени, які ми отримуємо з libvirt. Для образів дисків ми виводимо назви образів дисків, навіть якщо вказано цей параметр.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ЧИСЛОВІ ДАНІ ЩОДО STATVFS"
(замініть \fI/\fR, щоб переглянути статистику для інших файлових систем).
.SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
.IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
-Формат значень, які відокремлено комами (\s-1CSV\s0), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
+Формат значень, які відокремлено комами (CSV), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
.PP
Міф: достатньо розділити поля за комами. Реальність: поділ комами \fIне\fR працює у надійний спосіб. Ось приклад із двома стовпчиками:
.PP
.PP
Для скриптів командної оболонки скористайтеся \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv також є серед пакунків основних дистрибутивів Linux).
.PP
-Для інших мов програмування використовуйте бібліотеку для обробки даних \s-1CSV\s0 (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
+Для інших мов програмування використовуйте бібліотеку для обробки даних CSV (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
.PP
-У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних \s-1CSV.\s0
+У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних CSV.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBdf\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-drivers\fR\|(1), \fBvirt\-filesystems\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-dib 1"
-.TH virt-dib 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-dib 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
-.IX Header "НАЗВА"
-virt-dib \- виконати елементи diskimage-builder
-.SH "КОРОТКИЙ ОПИС"
-.IX Header "КОРОТКИЙ ОПИС"
-.Vb 1
-\& virt\-dib \-B DIB\-LIB [параметри] елементи...
-.Ve
-.SH "ОПИС"
-.IX Header "ОПИС"
-Virt-dib — інструмент для використання елементів \f(CW\*(C`diskimage\-builder\*(C'\fR з метою побудови нового образу диска, створення нових дисків у пам'яті тощо.
-.PP
-Virt-dib призначено для безпечної заміни \f(CW\*(C`diskimage\-builder\*(C'\fR і її режиму \f(CW\*(C`ramdisk\-image\-create\*(C'\fR, див. \*(L"ПОРІВНЯННЯ З DISKIMAGE-BUILDER\*(R", щоб ознайомитися із коротким порівнянням із використанням \f(CW\*(C`diskimage\-builder\*(C'\fR.
-.PP
-\&\f(CW\*(C`diskimage\-builder\*(C'\fR є частиною проєкту TripleO OpenStack: https://wiki.openstack.org/wiki/TripleO.
-.SH "ПРИКЛАДИ"
-.IX Header "ПРИКЛАДИ"
-.SS "Збирання простих образів дистрибутивів"
-.IX Subsection "Збирання простих образів дистрибутивів"
-.Vb 6
-\& virt\-dib \e
-\& \-B /шлях/до/diskimage\-builder/lib \e
-\& \-p /шлях/до/diskimage\-builder/elements \e
-\& \-\-envvar DIB_RELEASE=jessie \e
-\& \-\-name debian\-jessie \e
-\& debian vm
-.Ve
-.PP
-Ця команда збирає образ диска Debian Jessie (8.x), який є придатним для запуску у форматі віртуальної машини, який буде збережено як \fIdebian\-jessie.qcow2\fR.
-.SS "Збирання дисків у пам’яті"
-.IX Subsection "Збирання дисків у пам’яті"
-.Vb 6
-\& virt\-dib \e
-\& \-B /шлях/до/diskimage\-builder/lib \e
-\& \-p /шлях/до/diskimage\-builder/elements \e
-\& \-\-ramdisk \e
-\& \-\-name ramdisk \e
-\& ubuntu deploy\-ironic
-.Ve
-.PP
-Ця команда збирає диск у пам’яті для компонента Ironic OpenStack на основі дистрибутива Ubuntu.
-.SH "ПАРАМЕТРИ"
-.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
-.IX Item "--help"
-Показати довідкове повідомлення.
-.IP "\fB\-B\fR ШЛЯХ" 4
-.IX Item "-B ШЛЯХ"
-Встановити шлях до каталогу бібліотеки \f(CW\*(C`diskimage\-builder\*(C'\fR. Типово, це підкаталог \fIlib\fR у початкових кодах, а після встановлення до \fI/usr\fR каталог \fI/usr/share/diskimage\-builder/lib\fR.
-.Sp
-Цей параметр є \fBобов'язковим\fR, оскільки virt-dib має надати його елементам (оскільки деякі з них можуть використовувати скрипти у каталозі). Сама ж програма virt-dib не використовує цей каталог бібліотеки безпосередньо.
-.IP "\fB\-\-arch\fR АРХІТЕКТУРА" 4
-.IX Item "--arch АРХІТЕКТУРА"
-Використовувати для образу\-результату вказану архітектуру. Типовим є значення, яке збігається зі значенням архітектури для основної системи, на якій запущено virt-dib.
-.Sp
-У поточній версії цей параметр виконує лише встановлення змінної середовища \f(CW\*(C`ARCH\*(C'\fR для елементів, а елементи вже створюють образ для потрібної користувачу архітектури.
-.IP "\fB\-\-checksum\fR" 4
-.IX Item "--checksum"
-Створювати файли контрольних сум для образу. Підтримуваними є контрольні суми \s-1MD5\s0 та \s-1SHA256.\s0
-.IP "\fB\-\-colors\fR" 4
-.IX Item "--colors"
-.PD 0
-.IP "\fB\-\-colours\fR" 4
-.IX Item "--colours"
-.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
-.IP "\fB\-\-debug\fR РІВЕНЬ" 4
-.IX Item "--debug РІВЕНЬ"
-Встановити значення рівня діагностики \f(CW\*(C`РІВЕНЬ\*(C'\fR. Рівнем є невід'ємне ціле число. Типовим є рівень \f(CW0\fR.
-.Sp
-Цей рівень діагностики відрізняється від рівня, який встановлюється \fI\-x\fR і \fI\-v\fR, він збільшує обсяг діагностичної інформації, яка виводиться. Зокрема, він встановлює \f(CW\*(C`DIB_DEBUG_TRACE\*(C'\fR, усі значення рівня > \f(CW0\fR уможливлюють трасування у виконуваних скриптах.
-.IP "\fB\-\-docker\-target\fR ЦІЛЬ" 4
-.IX Item "--docker-target ЦІЛЬ"
-Встановити сховище і мітку для docker.
-.Sp
-Використовується лише тоді, коли серед форматів є \f(CW\*(C`docker\*(C'\fR, і є обов'язковим у цьому випадку.
-.IP "\fB\-\-drive\fR ДИСК" 4
-.IX Item "--drive ДИСК"
-Додати вказаний диск як допоміжний, такий, де зберігатимуться файли кешу елементів, зокрема образи дисків, пакунки дистрибутива тощо.
-.Sp
-Див. \*(L"ДОПОМІЖНИЙ ДИСК\*(R".
-.IP "\fB\-\-drive\-format\fR raw" 4
-.IX Item "--drive-format raw"
-.PD 0
-.IP "\fB\-\-drive\-format\fR qcow2" 4
-.IX Item "--drive-format qcow2"
-.PD
-Вказати формат допоміжного диска. Якщо цей прапорець не вказано, його буде автоматично визначено на основі даних самого диска.
-.Sp
-Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
-.Sp
-Цей параметр використовується, лише якщо вказано \fI\-\-drive\fR.
-.Sp
-Див. \*(L"ДОПОМІЖНИЙ ДИСК\*(R".
-.IP "\fB\-p\fR ШЛЯХ" 4
-.IX Item "-p ШЛЯХ"
-.PD 0
-.IP "\fB\-\-element\-path\fR ШЛЯХ" 4
-.IX Item "--element-path ШЛЯХ"
-.PD
-Додати новий шлях з елементами. Шляхи використовуватимуться у тому самому порядку, у якому з’являються параметри \fI\-p\fR, отже, пошук за шляхом, вказаним першим, відбуватиметься спочатку.
-.Sp
-Очевидно, варто додати шлях до власних елементів \f(CW\*(C`diskimage\-builder\*(C'\fR, оскільки більшість інших елементів покладатимуться на ці дані.
-.IP "\fB\-\-extra\-packages\fR ПАКУНОК,..." 4
-.IX Item "--extra-packages ПАКУНОК,..."
-Встановити додаткові пакунки у образ, який збиратиметься.
-.Sp
-Робота цього параметра залежить від виконуваного файла \f(CW\*(C`install\-packages\*(C'\fR, який визначається елементами керування пакунками.
-.Sp
-Цей параметр може бути використано декілька разів, декілька пакунків у аргументах слід відокремлювати комами.
-.IP "\fB\-\-envvar\fR ЗМІННА" 4
-.IX Item "--envvar ЗМІННА"
-.PD 0
-.IP "\fB\-\-envvar\fR ЗМІННА=ЗНАЧЕННЯ" 4
-.IX Item "--envvar ЗМІННА=ЗНАЧЕННЯ"
-.PD
-Передати або встановити змінну середовища для елементів.
-.Sp
-Див. \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" нижче, щоб дізнатися більше про взаємодію і використання змінних середовища.
-.Sp
-Цим параметром можна скористатися у декілька способів:
-.RS 4
-.IP "\fB\-\-envvar\fR ЗМІННА" 4
-.IX Item "--envvar ЗМІННА"
-Передати змінну середовища \f(CW\*(C`ЗМІННА\*(C'\fR. Якщо змінну не встановлено, до елементів нічого не експортуватиметься.
-.IP "\fB\-\-envvar\fR ЗМІННА=ЗНАЧЕННЯ" 4
-.IX Item "--envvar ЗМІННА=ЗНАЧЕННЯ"
-Встановити для змінної середовища \f(CW\*(C`ЗМІННА\*(C'\fR значення \f(CW\*(C`ЗНАЧЕННЯ\*(C'\fR для елементів, незалежно від того, чи вже існує змінна середовища із тією самою назвою.
-.Sp
-Може бути корисним для передавання змінної середовища без експортування у середовище, де запущено virt-dib.
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-exclude\-element\fR ЕЛЕМЕНТ" 4
-.IX Item "--exclude-element ЕЛЕМЕНТ"
-Ігнорувати вказаний елемент.
-.IP "\fB\-\-exclude\-script\fR СКРИПТ" 4
-.IX Item "--exclude-script СКРИПТ"
-Ігнорувати будь\-який скрипт елемента із назвою \f(CW\*(C`СКРИПТ\*(C'\fR, байдуже, до якого елемента він належатиме.
-.Sp
-Це може бути корисним, якщо якийсь скрипт погано працює з virt-dib, наприклад, якщо скриптові справді потрібне середовище \f(CW\*(C`diskimage\-builder\*(C'\fR.
-.IP "\fB\-\-formats\fR ФОРМАТ,..." 4
-.IX Item "--formats ФОРМАТ,..."
-Встановити список форматів виведення даних, відокремлених комами.
-.Sp
-Підтримувані формати:
-.RS 4
-.ie n .IP """docker""" 4
-.el .IP "\f(CWdocker\fR" 4
-.IX Item "docker"
-Імпортувати образ до docker за допомогою команди \fBdocker import\fR. Призначення для образу \fBмає\fR бути вказано за допомогою \fI\-\-docker\-target\fR.
-.Sp
-Будь ласка, зауважте, що виконання цієї дії зазвичай потребує вмикання служби docker, інакше його не вдасться виконати. Крім того, \fBdocker\fR працює з використанням \fBsudo\fR\|(8), отже, переконайтеся, що користувач має право запускати принаймні \fBdocker\fR.
-.ie n .IP """qcow2"" (типово увімкнено)" 4
-.el .IP "\f(CWqcow2\fR (типово увімкнено)" 4
-.IX Item "qcow2 (типово увімкнено)"
-qcow2 для \s-1QEMU.\s0 Для роботи з цим форматом потрібна програма \f(CW\*(C`qemu\-img\*(C'\fR.
-.ie n .IP """raw""" 4
-.el .IP "\f(CWraw\fR" 4
-.IX Item "raw"
-Формат даних диска без обробки.
-.ie n .IP """squashfs""" 4
-.el .IP "\f(CWsquashfs\fR" 4
-.IX Item "squashfs"
-Файлова система squashfs, яку стиснуто за допомогою \s-1XZ.\s0 Для користування цим форматом виведення даних потрібна можливість \f(CW\*(C`squashfs\*(C'\fR; див. також \*(L"ДОСТУПНІСТЬ\*(R" in \fBguestfs\fR\|(3).
-.ie n .IP """tar""" 4
-.el .IP "\f(CWtar\fR" 4
-.IX Item "tar"
-Архів без стискання.
-.ie n .IP """tgz""" 4
-.el .IP "\f(CWtgz\fR" 4
-.IX Item "tgz"
-Архів tar, стиснутий за допомогою gzip.
-.ie n .IP """vhd""" 4
-.el .IP "\f(CWvhd\fR" 4
-.IX Item "vhd"
-Образ диска \f(CW\*(C`Virtual Hard Disk\*(C'\fR. Виведення даних у цьому форматі вимагає наявності \f(CW\*(C`vhd\-util\*(C'\fR.
-.Sp
-Будь ласка, зверніть увагу на те, що версія \f(CW\*(C`vhd\-util\*(C'\fR повинна бути зібраною із латкою, яка вмикає підтримку підкоманди \f(CW\*(C`convert\*(C'\fR, і бути придатною до завантаження. Латку можна знайти тут: https://github.com/emonty/vhd\-util/blob/master/debian/patches/citrix.
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-fs\-type\fR ФАЙЛОВА СИСТЕМА" 4
-.IX Item "--fs-type ФАЙЛОВА СИСТЕМА"
-Встановити файлову систему, яку буде використано для кореневої теки системи. Типовою є \f(CW\*(C`ext4\*(C'\fR.
-.Sp
-Див. також \*(L"guestfs_filesystem_available\*(R" in \fBguestfs\fR\|(3)
-.IP "\fB\-\-image\-cache\fR КАТАЛОГ" 4
-.IX Item "--image-cache КАТАЛОГ"
-Встановити каталог у основній системі, до якого кешуватимуться ресурси, які використовуються елементами фази \f(CW\*(C`extra\-data.d\*(C'\fR. Типовим є \fI~/.cache/image\-create\fR.
-.Sp
-Будь ласка, зауважте, що більшість ресурсів, які отримуватимуться на фазах, відмінних від \f(CW\*(C`extra\-data.d\*(C'\fR, кешуватимуться на допоміжному диску, вказаному за допомогою \fI\-\-drive\fR; див. також \*(L"ДОПОМІЖНИЙ ДИСК\*(R".
-.IP "\fB\-\-install\-type\fR ТИП" 4
-.IX Item "--install-type ТИП"
-Вказати типовий тип встановлення. Стандартним є \f(CW\*(C`source\*(C'\fR.
-.Sp
-Встановіть значення \f(CW\*(C`package\*(C'\fR, щоб типово використовувати засноване на пакунках встановлення.
-.IP "\fB\-\-machine\-readable\fR" 4
-.IX Item "--machine-readable"
-.PD 0
-.IP "\fB\-\-machine\-readable\fR=формат" 4
-.IX Item "--machine-readable=формат"
-.PD
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. \*(L"ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" нижче.
-.IP "\fB\-m\fR МБ" 4
-.IX Item "-m МБ"
-.PD 0
-.IP "\fB\-\-memsize\fR МБ" 4
-.IX Item "--memsize МБ"
-.PD
-Змінити обсяг пам'яті, який надаватиметься для базової системи. Збільште це значення, якщо для виконання virt-dib не вистачає пам'яті.
-.Sp
-Типові значення можна визначити за допомогою такої команди:
-.Sp
-.Vb 1
-\& guestfish get\-memsize
-.Ve
-.ie n .IP "\fB\-\-mkfs\-options\fR ""РЯДОК ПАРАМЕТРІВ""" 4
-.el .IP "\fB\-\-mkfs\-options\fR \f(CWРЯДОК ПАРАМЕТРІВ\fR" 4
-.IX Item "--mkfs-options РЯДОК ПАРАМЕТРІВ"
-Додати вказані параметри до \fBmkfs\fR\|(1), щоб мати змогу скоригувати параметри створення кореневої файлової системи; параметри передаються драйверу \fBmfks\fR\|(1), а не самій \fBmfks\fR\|(1). Зауважте, що для зміни типу файлової системи використовується \fI\-\-fs\-type\fR.
-.Sp
-Вам слід скористатися \fI\-\-mkfs\-options\fR не більше одного разу. Щоб передати декілька параметрів, відокремте їх пробілами. Приклад:
-.Sp
-.Vb 1
-\& virt\-dib ... \-\-mkfs\-options \*(Aq\-O якийсь_параметр \-I щось_ще\*(Aq
-.Ve
-.IP "\fB\-\-network\fR" 4
-.IX Item "--network"
-.PD 0
-.IP "\fB\-\-no\-network\fR" 4
-.IX Item "--no-network"
-.PD
-Увімкнути чи вимкнути доступ до мережі для гостьової системи під час встановлення.
-.Sp
-Типово увімкнено. Скористайтеся параметром \fI\-\-no\-network\fR, щоб вимкнути доступ.
-.Sp
-У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. \*(L"МЕРЕЖА\*(R" in \fBvirt\-rescue\fR\|(1).
-.Sp
-Це не вплине на доступність мережі для гостьової системи після її завантаження, оскільки така доступність керується вашим гіпервізором або хмарним середовищем і не має нічого спільного з virt-dib.
-.Sp
-Якщо ви використаєте параметр \fI\-\-no\-network\fR, змінній середовища \f(CW\*(C`DIB_OFFLINE\*(C'\fR буде надано значення \f(CW1\fR, що сигналізуватиме елементам про те, що їм слід використовувати лише кешовані ресурси, якщо вони доступні. Також слід зауважити, що, на відміну від \f(CW\*(C`diskimage\-builder\*(C'\fR, де елементи все ще можуть отримувати доступ до мережі навіть із \f(CW\*(C`DIB_OFFLINE=\*(C'\fR, у virt-dib мережа буде зовсім недоступною.
-.IP "\fB\-\-name\fR НАЗВА" 4
-.IX Item "--name НАЗВА"
-Встановити назву для файла із виведеним образом. Типовою є \f(CW\*(C`image\*(C'\fR.
-.Sp
-Відповідно до вибраної назви, у поточному каталозі буде таке:
-.RS 4
-.IP "\fI\f(CI$NAME\fI.ext\fR" 4
-.IX Item "$NAME.ext"
-Для кожного з форматів виведення назву файла буде взято з назви образу\-результату, а суфікс назви залежатиме від формату. Приклад: \fI\f(CI$NAME\fI.qcow2\fR, \fI\f(CI$NAME\fI.raw\fR тощо.
-.Sp
-Не можна застосовувати у режимі диска у пам'яті (ramdisk), див. \*(L"ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ\*(R".
-.IP "\fI\f(CI$NAME\fI.d\fR" 4
-.IX Item "$NAME.d"
-Каталог, що містить будь\-які файли, створені елементами, наприклад каталог \fIdib-manifests\fR (створено елементом \f(CW\*(C`manifests\*(C'\fR), диски у пам'яті та ядра у режимі диску у пам'яті тощо.
-.IP "\fI\f(CI$NAME\fI.ext.checksum\fR" 4
-.IX Item "$NAME.ext.checksum"
-Якщо вказано \fI\-\-checksum\fR, буде створено файли для усіх підтримуваних типів контрольних сум; приклади: \fI\f(CI$NAME\fI.ext.md5\fR, \fI\f(CI$NAME\fI.ext.sha256\fR тощо.
-.Sp
-Не можна застосовувати у режимі диска у пам'яті (ramdisk), див. \*(L"ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ\*(R".
-.RE
-.RS 4
-.RE
-.IP "\fB\-\-no\-delete\-on\-failure\fR" 4
-.IX Item "--no-delete-on-failure"
-Не вилучати файли з виведеними даними, якщо під час збирання станеться помилка. Цими файлами можна скористатися для діагностики помилок у запущених скриптах.
-.Sp
-Типовою є поведінка, коли файли результатів буде вилучено, якщо станеться помилка у virt-dib (або, наприклад, помилка у одному зі скриптів, які запускає ця програма).
-.IP "\fB\-\-python\fR \s-1PYTHON\s0" 4
-.IX Item "--python PYTHON"
-Вказати для використання інший інтерпретатор Python. Частину \f(CW\*(C`diskimage\-builder\*(C'\fR реалізовано мовою Python, тому інтерпретатор є обов'язковим.
-.Sp
-Значенням \f(CW\*(C`PYTHON\*(C'\fR може бути або повна назва виконуваного файла (наприклад \fIpython2\fR, пошук якого буде виконано у каталогах змінної \f(CW$PATH\fR), або шлях повністю (наприклад \fI/usr/bin/python2\fR). Якщо не вказано, типовим значенням буде \fIpython\fR.
-.IP "\fB\-q\fR" 4
-.IX Item "-q"
-.PD 0
-.IP "\fB\-\-quiet\fR" 4
-.IX Item "--quiet"
-.PD
-Не виводити звичайних повідомлень щодо поступу.
-.IP "\fB\-\-qemu\-img\-options\fR параметр[,параметр,...]" 4
-.IX Item "--qemu-img-options параметр[,параметр,...]"
-Передати параметри \fI\-\-qemu\-img\-options\fR до програми \fBqemu\-img\fR\|(1) для коригування формату виведення даних. Перелік доступних параметрів залежить від формату виведення (див. \fI\-\-formats\fR) і встановленої версії програми qemu-img.
-.Sp
-Вам слід скористатися \fI\-\-qemu\-img\-options\fR не більше одного разу. Щоб передати декілька параметрів, відокремте їх комами. Приклад:
-.Sp
-.Vb 1
-\& virt\-dib ... \-\-qemu\-img\-options cluster_size=512,preallocation=metadata ...
-.Ve
-.IP "\fB\-\-ramdisk\fR" 4
-.IX Item "--ramdisk"
-Встановити режим збирання диска у пам’яті.
-.Sp
-Див. \*(L"ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ\*(R".
-.IP "\fB\-\-ramdisk\-element\fR НАЗВА" 4
-.IX Item "--ramdisk-element НАЗВА"
-Встановити назву для додаткового елемента, який буде додано у режимі збирання диска у пам'яті. Типовою є назва \f(CW\*(C`ramdisk\*(C'\fR.
-.Sp
-Див. \*(L"ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ\*(R".
-.IP "\fB\-\-root\-label\fR МІТКА" 4
-.IX Item "--root-label МІТКА"
-Встановити мітку для кореневої файлової системи у створеному образі.
-.Sp
-Будь ласка, зауважте, що у деяких файлових системах обмеження на мітки може бути іншим. Наприклад, у файлових системах \f(CW\*(C`ext2/3/4\*(C'\fR мітки не можуть бути довшими за 16 символів, а у \f(CW\*(C`xfs\*(C'\fR найбільшою довжиною мітки є 12 символів.
-.Sp
-Типове значення залежить від типу файлової системи для кореневого розділу (див. \fI\-\-fs\-type\fR): на \f(CW\*(C`xfs\*(C'\fR — це \f(CW\*(C`img\-rootfs\*(C'\fR, а на будь\-якій іншій файловій системі — \f(CW\*(C`cloudimg\-rootfs\*(C'\fR.
-.IP "\fB\-\-size\fR РОЗМІР" 4
-.IX Item "--size РОЗМІР"
-Вибір розміру диска\-результату, де розмір можна вказати за допомогою типових записів, зокрема \f(CW\*(C`32G\*(C'\fR (32 гігабайти) тощо. Типовим є розмір \f(CW\*(C`5G\*(C'\fR.
-.Sp
-Щоб вказати розмір у байтах, додайте до числа малу літеру \fIb\fR, наприклад \f(CW\*(C`\-\-size 10737418240b\*(C'\fR.
-.Sp
-Див. також \fBvirt\-resize\fR\|(1) щодо зміни розмірів розділів на наявному образі диска.
-.IP "\fB\-\-skip\-base\fR" 4
-.IX Item "--skip-base"
-Пропустити включення елемента \f(CW\*(C`base\*(C'\fR.
-.IP "\fB\-\-smp\fR N" 4
-.IX Item "--smp N"
-Увімкнути використання скриптами N ≥ 2 віртуальних процесорів.
-.IP "\fB\-u\fR" 4
-.IX Item "-u"
-Не стискати отримані образи qcow2. Типово, програма стискає такі образи.
-.IP "\fB\-v\fR" 4
-.IX Item "-v"
-.PD 0
-.IP "\fB\-\-verbose\fR" 4
-.IX Item "--verbose"
-.PD
-Увімкнути показ діагностичних повідомлень.
-.IP "\fB\-V\fR" 4
-.IX Item "-V"
-.PD 0
-.IP "\fB\-\-version\fR" 4
-.IX Item "--version"
-.PD
-Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
-.IX Item "--wrap"
-Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
-.IX Item "-x"
-Увімкнути трасування викликів програмного інтерфейсу libguestfs.
-.SH "ЗМІННІ СЕРЕДОВИЩА"
-.IX Header "ЗМІННІ СЕРЕДОВИЩА"
-На відміну від \f(CW\*(C`diskimage\-builder\*(C'\fR, середовище основної системи \fBне\fR успадковується у базовій системі під час запуску більшості елементів (тобто усіх, окрім елементів у фазі \f(CW\*(C`extra\-data.d\*(C'\fR).
-.PP
-Щоб встановити змінні середовища для виконання елементів, слід повідомити virt-dib, що слід використовувати ці змінні, за допомогою параметра \fI\-\-envvar\fR. Такий параметр надасть змогу вибірково експортувати змінні середовища під час виконання елементі. Це також пріоритетний шлях передавання змінних середовища елементам.
-.PP
-І ще раз: якщо вам потрібно, щоб змінна середовища \f(CW\*(C`MYVAR\*(C'\fR (і її вміст) були доступні елементам, вам слід або віддати команду
-.PP
-.Vb 2
-\& export MYVAR # яким би не було її значення
-\& virt\-dib ... \-\-envvar MYVAR ...
-.Ve
-.PP
-або
-.PP
-.Vb 1
-\& virt\-dib ... \-\-envvar MYVAR=її_значення ...
-.Ve
-.SH "ДОПОМІЖНИЙ ДИСК"
-.IX Header "ДОПОМІЖНИЙ ДИСК"
-Virt-dib виконує більшість елементів у власній базовій системі, отже, не на основній системі. Через це, елементи не можуть кешувати ресурси безпосередньо на основній системі.
-.PP
-Щоб усунути цю незручність, у virt-dib передбачено можливість використання допоміжного диска, на якому можна зберігати кешовані ресурси, зокрема образи дисків, пакунки дистрибутивів тощо. Хоча це означає, що для кешування буде доступним менше місця, принаймні, це надає змогу обмежити простір у основній системі для кешів без потреби у виконанні цього завдання засобами самих елементів.
-.PP
-У поточній версії або цей диск має містити лише один розділ, або має використовуватися лише перший розділ з диска. Диск із другим варіантом конфігурації доволі просто створити за допомогою \fBguestfish\fR\|(1) ось так:
-.PP
-.Vb 1
-\& guestfish \-N filename.img=fs:ext4:10G exit
-.Ve
-.PP
-У результаті виконання наведеної вище команди буде створено образ диска із назвою \fIfilename.img\fR об'ємом у 10 ГБ з одним розділом типу ext4; див. \*(L"ОБРАЗИ ПРИГОТОВАНИХ ДИСКІВ\*(R" in \fBguestfish\fR\|(1).
-.PP
-Рекомендованим розміром диска є ≥ 10 ГБ, оскільки елементи кешуватимуть образи дисків, пакунки дистрибутивів тощо. Як і розмір будь\-якого образу диска, розмір допоміжного диска можна змінити за допомогою \fBvirt\-resize\fR\|(1), якщо раптом він стане замалим.
-.PP
-Доступ до диска може здійснюватися у спосіб, який є подібним до способу доступу до будь\-яких інших образів дисків, наприклад, за допомогою інших інструментів libguestfs, зокрема \fBguestfish\fR\|(1):
-.PP
-.Vb 1
-\& guestfish \-a filename.img \-m /dev/sda1
-.Ve
-.PP
-Якщо за допомогою \fI\-\-drive\fR не вказано жодного допоміжного диска, усі ресурси, кешовані під час запуску virt-dib, буде відкинуто.
-.SS "РЕСУРСИ НА ДИСКУ"
-.IX Subsection "РЕСУРСИ НА ДИСКУ"
-У допоміжному диску можна шукати такі ресурси:
-.IP "\fI/home\fR" 4
-.IX Item "/home"
-Цей каталог задається за допомогою змінної середовища \f(CW\*(C`HOME\*(C'\fR під час збирання. У ньому, здебільшого, міститься кеш образів (збережений до \fI/home/.cache/image\-create\fR) та усі інші ресурси у домашньому каталозі користувача, який запускає різні інструменти.
-.IP "\fI/virt\-dib\-*.log\fR" 4
-.IX Item "/virt-dib-*.log"
-Це журнали елементів, які виконуються у базовій системі libguestfs, тобто усі фази, окрім \f(CW\*(C`extra\-data.d\*(C'\fR.
-.SH "ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ"
-.IX Header "ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ"
-Virt-dib може також емулювати \f(CW\*(C`ramdisk\-image\-create\*(C'\fR, вторинний режим роботи \f(CW\*(C`diskimage\-builder\*(C'\fR. Замість використання якогось інструмента із іншою назвою, virt-dib надає простий доступ до режиму за допомогою параметра \fI\-\-ramdisk\fR.
-.PP
-У цьому режимі:
-.IP "\(bu" 4
-додається елемент ramdisk (див. \fI\-\-ramdisk\-element\fR)
-.IP "\(bu" 4
-образу не створюється (отже, \fI\-\-formats\fR буде проігноровано)
-.IP "\(bu" 4
-\&\fI\f(CI$NAME\fI.d\fR (див. \fI\-\-name\fR) міститиме initrd, kernel, тощо.
-.SH "ТИМЧАСОВИЙ КАТАЛОГ"
-.IX Header "ТИМЧАСОВИЙ КАТАЛОГ"
-Virt-dib використовує стандартний каталог для тимчасових файлів, який використовується libguestfs, див. \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" in \fBguestfs\fR\|(3).
-.PP
-Типово, цим каталогом є \fI/tmp\fR (типове значення для \f(CW\*(C`TMPDIR\*(C'\fR). У деяких системах для цього каталогу може використовуватися файлова система tmpfs. Таким чином, типовим максимальним розміром для нього є \fIполовина\fR фізичного розміру оперативної пам'яті. Якщо під час роботи virt-dib перевищить це обмеження, програма може повиснути або завершити роботу передчасно із повідомленням про помилку. Усунути цю проблему можна, вказавши для \f(CW\*(C`TMPDIR\*(C'\fR тимчасовий каталог. Приклад:
-.PP
-.Vb 3
-\& mkdir local\-tmp
-\& env TMPDIR=$PWD/local\-tmp virt\-dib ...
-\& rm \-rf local\-tmp
-.Ve
-.SH "ДОДАТКОВІ ЗАЛЕЖНОСТІ"
-.IX Header "ДОДАТКОВІ ЗАЛЕЖНОСТІ"
-Оскільки virt-dib запускає більшість елементів у власній базовій системі, усі інструменти та бібліотеки, які використовуються елементами, що запускаються поза межами гостьової системи (типово \f(CW\*(C`root.d\*(C'\fR, \f(CW\*(C`block\-device.d\*(C'\fR та \f(CW\*(C`cleanup.d\*(C'\fR) мають бути і у базовій системі. Якщо їх не буде, скрипти не зможуть працювати і типово повідомлять про помилку \f(CW\*(C`команду не знайдено\*(C'\fR.
-.PP
-Для інструментів і бібліотек, які містяться у пакунках дистрибутивів, простим рішенням цієї проблеми буде віддання наказу libguestfs включити додаткові пакунки до базової системи. Зробити це можна, наприклад, створення файла із додатковими пакунками:
-.PP
-.Vb 1
-\& # echo wget > /usr/lib64/guestfs/supermin.d/dib\-my\-extra
-.Ve
-.PP
-Шлях до каталогу \fIsupermin.d\fR, звичайно ж, залежить від дистрибутива. У додаткових файлах може бути список із багатьма пакунками, кожен з яких слід вказувати окремому рядку. Докладніший опис можна знайти у підручнику з \fBsupermin\fR\|(1).
-.SH "ПОРІВНЯННЯ ІЗ DISKIMAGE-BUILDER"
-.IX Header "ПОРІВНЯННЯ ІЗ DISKIMAGE-BUILDER"
-Призначенням virt-dib є бути безпечним замінником програми \f(CW\*(C`diskimage\-builder\*(C'\fR і її режиму \f(CW\*(C`ramdisk\-image\-create\*(C'\fR. Помітні для користувача відмінності полягають ось у чому:
-.IP "\(bu" 4
-аргументи командного рядка; деякі з аргументів збігаються із аргументами \f(CW\*(C`diskimage\-builder\*(C'\fR, але деякі є іншими:
-.Sp
-.Vb 12
-\& disk\-image\-create virt\-dib
-\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-
-\& \-a ARCH \-\-arch АРХІТЕКТУРА
-\& \-\-image\-size РОЗМІР \-\-size РОЗМІР
-\& \-\-max\-online\-resize РОЗМІР doable using \-\-mkfs\-options
-\& \-n \-\-skip\-base
-\& \-o НАЗВА ОБРАЗУ \-\-name НАЗВА ОБРАЗУ
-\& \-p ПАКУНКИ \-\-extra\-packages ПАКУНКИ
-\& \-t ФОРМАТИ \-\-formats ФОРМАТИ
-\& \-x \-\-debug 1
-\& \-x \-x \-\-debug 2
-\& \-x \-x [\-x ...] \-\-debug 3/4/etc
-.Ve
-.IP "\(bu" 4
-розташування файлів\-результатів, які не є образами (зокрема дисків у пам'яті і ядер)
-.IP "\(bu" 4
-спосіб зберігання деяких кешованих ресурсів: використання допоміжного диска, а не диска, на якому запущено virt-dib
-.IP "\(bu" 4
-потреба у визначення розміру диска\-результату, тоді як програма \f(CW\*(C`diskimage\-builder\*(C'\fR автоматично обчислює оптимальний розмір
-.IP "\(bu" 4
-обробка змінних середовища, див. \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R".
-.Sp
-До того ж, окрім власних змінних середовища libguestfs (див. \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" in \fBguestfs\fR\|(3)), virt-dib не виконує читання жодних інших змінних середовища. Це означає, що зміни у параметрах і поведінці програми визначаються лише переданими їй аргументами рядка команди.
-.IP "\(bu" 4
-потрібно, щоб додаткові інструменти на деяких фазах поза chroot були доступні у базовій системі, див. \*(L"ДОДАТКОВІ ЗАЛЕЖНОСТІ\*(R".
-.PP
-Робота самих елементів не повинна зазнати змін; причиною відмінностей у поведінці можуть бути помилкові припущення у коді самих елементів або некоректна емуляція virt-dib.
-.PP
-Відомі вади:
-.IP "\(bu" 4
-(нічого)
-.SH "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ"
-.IX Header "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ"
-Для виведення даних у зручному для машинної обробки форматі можна скористатися параметром \fI\-\-machine\-readable\fR. Додавання цього параметра робить зручним використання virt-dib з інших програм, графічних інтерфейсів тощо.
-.PP
-Скористайтеся цим параметром окремо, щоб опитати систему щодо можливостей виконуваного файла virt-dib. Типово виведені дані виглядатимуть якось так:
-.PP
-.Vb 6
-\& $ virt\-dib \-\-machine\-readable
-\& virt\-dib
-\& output:qcow2
-\& output:tar
-\& output:raw
-\& output:vhd
-.Ve
-.PP
-Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.
-.PP
-\&\f(CW\*(C`output:\*(C'\fR є вказівкою на формати виведення (параметр рядка команди \fI\-\-formats\fR), підтримку яких передбачено у цьому виконуваному файлі.
-.PP
-Можна вказати рядок форматування для керування виведенням, див. \*(L"РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" in \fBguestfs\fR\|(3).
-.SH "ТЕСТУВАННЯ"
-.IX Header "ТЕСТУВАННЯ"
-Перевірку працездатності virt-dib було виконано для \f(CW\*(C`diskimage\-builder\*(C'\fR (та його елементів) ≥ 0.1.43. Час від часу виконується також перевірка для \f(CW\*(C`tripleo\-image\-elements\*(C'\fR та \f(CW\*(C`sahara\-image\-elements\*(C'\fR.
-.PP
-Попередні версії також можуть працювати, але цього не можна гарантувати.
-.SH "СТАН ВИХОДУ"
-.IX Header "СТАН ВИХОДУ"
-Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
-.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
-.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
-\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
-.IX Header "АВТОР"
-Pino Toscano (\f(CW\*(C`ptoscano at redhat dot com\*(C'\fR)
-.SH "АВТОРСЬКІ ПРАВА"
-.IX Header "АВТОРСЬКІ ПРАВА"
-© Red Hat Inc., 2015
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
+++ /dev/null
-
-=head1 НАЗВА
-
-virt-dib - виконати елементи diskimage-builder
-
-=head1 КОРОТКИЙ ОПИС
-
- virt-dib -B DIB-LIB [параметри] елементи...
-
-=head1 ОПИС
-
-Virt-dib — інструмент для використання елементів C<diskimage-builder> з метою побудови нового образу диска, створення нових дисків у пам'яті тощо.
-
-Virt-dib призначено для безпечної заміни C<diskimage-builder> і її режиму C<ramdisk-image-create>, див. L</ПОРІВНЯННЯ З DISKIMAGE-BUILDER>, щоб ознайомитися із коротким порівнянням із використанням C<diskimage-builder>.
-
-C<diskimage-builder> є частиною проєкту TripleO OpenStack: L<https://wiki.openstack.org/wiki/TripleO>.
-
-=head1 ПРИКЛАДИ
-
-=head2 Збирання простих образів дистрибутивів
-
- virt-dib \
- -B /шлях/до/diskimage-builder/lib \
- -p /шлях/до/diskimage-builder/elements \
- --envvar DIB_RELEASE=jessie \
- --name debian-jessie \
- debian vm
-
-Ця команда збирає образ диска Debian Jessie (8.x), який є придатним для запуску у форматі віртуальної машини, який буде збережено як F<debian-jessie.qcow2>.
-
-=head2 Збирання дисків у пам’яті
-
- virt-dib \
- -B /шлях/до/diskimage-builder/lib \
- -p /шлях/до/diskimage-builder/elements \
- --ramdisk \
- --name ramdisk \
- ubuntu deploy-ironic
-
-Ця команда збирає диск у пам’яті для компонента Ironic OpenStack на основі дистрибутива Ubuntu.
-
-=head1 ПАРАМЕТРИ
-
-=over 4
-
-=item B<--help>
-
-Показати довідкове повідомлення.
-
-=item B<-B> ШЛЯХ
-
-Встановити шлях до каталогу бібліотеки C<diskimage-builder>. Типово, це підкаталог F<lib> у початкових кодах, а після встановлення до F</usr> каталог F</usr/share/diskimage-builder/lib>.
-
-Цей параметр є B<обов'язковим>, оскільки virt-dib має надати його елементам (оскільки деякі з них можуть використовувати скрипти у каталозі). Сама ж програма virt-dib не використовує цей каталог бібліотеки безпосередньо.
-
-=item B<--arch> АРХІТЕКТУРА
-
-Використовувати для образу-результату вказану архітектуру. Типовим є значення, яке збігається зі значенням архітектури для основної системи, на якій запущено virt-dib.
-
-У поточній версії цей параметр виконує лише встановлення змінної середовища C<ARCH> для елементів, а елементи вже створюють образ для потрібної користувачу архітектури.
-
-=item B<--checksum>
-
-Створювати файли контрольних сум для образу. Підтримуваними є контрольні суми MD5 та SHA256.
-
-=item B<--colors>
-
-=item B<--colours>
-
-Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
-
-=item B<--debug> РІВЕНЬ
-
-Встановити значення рівня діагностики C<РІВЕНЬ>. Рівнем є невід'ємне ціле число. Типовим є рівень C<0>.
-
-Цей рівень діагностики відрізняється від рівня, який встановлюється I<-x> і I<-v>, він збільшує обсяг діагностичної інформації, яка виводиться. Зокрема, він встановлює C<DIB_DEBUG_TRACE>, усі значення рівня E<gt> C<0> уможливлюють трасування у виконуваних скриптах.
-
-=item B<--docker-target> ЦІЛЬ
-
-Встановити сховище і мітку для docker.
-
-Використовується лише тоді, коли серед форматів є C<docker>, і є обов'язковим у цьому випадку.
-
-=item B<--drive> ДИСК
-
-Додати вказаний диск як допоміжний, такий, де зберігатимуться файли кешу елементів, зокрема образи дисків, пакунки дистрибутива тощо.
-
-Див. L</ДОПОМІЖНИЙ ДИСК>.
-
-=item B<--drive-format> raw
-
-=item B<--drive-format> qcow2
-
-Вказати формат допоміжного диска. Якщо цей прапорець не вказано, його буде автоматично визначено на основі даних самого диска.
-
-Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
-
-Цей параметр використовується, лише якщо вказано I<--drive>.
-
-Див. L</ДОПОМІЖНИЙ ДИСК>.
-
-=item B<-p> ШЛЯХ
-
-=item B<--element-path> ШЛЯХ
-
-Додати новий шлях з елементами. Шляхи використовуватимуться у тому самому порядку, у якому з’являються параметри I<-p>, отже, пошук за шляхом, вказаним першим, відбуватиметься спочатку.
-
-Очевидно, варто додати шлях до власних елементів C<diskimage-builder>, оскільки більшість інших елементів покладатимуться на ці дані.
-
-=item B<--extra-packages> ПАКУНОК,...
-
-Встановити додаткові пакунки у образ, який збиратиметься.
-
-Робота цього параметра залежить від виконуваного файла C<install-packages>, який визначається елементами керування пакунками.
-
-Цей параметр може бути використано декілька разів, декілька пакунків у аргументах слід відокремлювати комами.
-
-=item B<--envvar> ЗМІННА
-
-=item B<--envvar> ЗМІННА=ЗНАЧЕННЯ
-
-Передати або встановити змінну середовища для елементів.
-
-Див. L</ЗМІННІ СЕРЕДОВИЩА> нижче, щоб дізнатися більше про взаємодію і використання змінних середовища.
-
-Цим параметром можна скористатися у декілька способів:
-
-=over 4
-
-=item B<--envvar> ЗМІННА
-
-Передати змінну середовища C<ЗМІННА>. Якщо змінну не встановлено, до елементів нічого не експортуватиметься.
-
-=item B<--envvar> ЗМІННА=ЗНАЧЕННЯ
-
-Встановити для змінної середовища C<ЗМІННА> значення C<ЗНАЧЕННЯ> для елементів, незалежно від того, чи вже існує змінна середовища із тією самою назвою.
-
-Може бути корисним для передавання змінної середовища без експортування у середовище, де запущено virt-dib.
-
-=back
-
-=item B<--exclude-element> ЕЛЕМЕНТ
-
-Ігнорувати вказаний елемент.
-
-=item B<--exclude-script> СКРИПТ
-
-Ігнорувати будь-який скрипт елемента із назвою C<СКРИПТ>, байдуже, до якого елемента він належатиме.
-
-Це може бути корисним, якщо якийсь скрипт погано працює з virt-dib, наприклад, якщо скриптові справді потрібне середовище C<diskimage-builder>.
-
-=item B<--formats> ФОРМАТ,...
-
-Встановити список форматів виведення даних, відокремлених комами.
-
-Підтримувані формати:
-
-=over 4
-
-=item C<docker>
-
-Імпортувати образ до docker за допомогою команди B<docker import>. Призначення для образу B<має> бути вказано за допомогою I<--docker-target>.
-
-Будь ласка, зауважте, що виконання цієї дії зазвичай потребує вмикання служби docker, інакше його не вдасться виконати. Крім того, B<docker> працює з використанням L<sudo(8)>, отже, переконайтеся, що користувач має право запускати принаймні B<docker>.
-
-=item C<qcow2> (типово увімкнено)
-
-qcow2 для QEMU. Для роботи з цим форматом потрібна програма C<qemu-img>.
-
-=item C<raw>
-
-Формат даних диска без обробки.
-
-=item C<squashfs>
-
-Файлова система squashfs, яку стиснуто за допомогою XZ. Для користування цим форматом виведення даних потрібна можливість C<squashfs>; див. також L<guestfs(3)/ДОСТУПНІСТЬ>.
-
-=item C<tar>
-
-Архів без стискання.
-
-=item C<tgz>
-
-Архів tar, стиснутий за допомогою gzip.
-
-=item C<vhd>
-
-Образ диска C<Virtual Hard Disk>. Виведення даних у цьому форматі вимагає наявності C<vhd-util>.
-
-Будь ласка, зверніть увагу на те, що версія C<vhd-util> повинна бути зібраною із латкою, яка вмикає підтримку підкоманди C<convert>, і бути придатною до завантаження. Латку можна знайти тут: L<https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix>.
-
-=back
-
-=item B<--fs-type> ФАЙЛОВА СИСТЕМА
-
-Встановити файлову систему, яку буде використано для кореневої теки системи. Типовою є C<ext4>.
-
-Див. також L<guestfs(3)/guestfs_filesystem_available>
-
-=item B<--image-cache> КАТАЛОГ
-
-Встановити каталог у основній системі, до якого кешуватимуться ресурси, які використовуються елементами фази C<extra-data.d>. Типовим є F<~/.cache/image-create>.
-
-Будь ласка, зауважте, що більшість ресурсів, які отримуватимуться на фазах, відмінних від C<extra-data.d>, кешуватимуться на допоміжному диску, вказаному за допомогою I<--drive>; див. також L</ДОПОМІЖНИЙ ДИСК>.
-
-=item B<--install-type> ТИП
-
-Вказати типовий тип встановлення. Стандартним є C<source>.
-
-Встановіть значення C<package>, щоб типово використовувати засноване на пакунках встановлення.
-
-=item B<--machine-readable>
-
-=item B<--machine-readable>=формат
-
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. L</ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ> нижче.
-
-=item B<-m> МБ
-
-=item B<--memsize> МБ
-
-Змінити обсяг пам'яті, який надаватиметься для базової системи. Збільште це значення, якщо для виконання virt-dib не вистачає пам'яті.
-
-Типові значення можна визначити за допомогою такої команди:
-
- guestfish get-memsize
-
-=item B<--mkfs-options> C<РЯДОК ПАРАМЕТРІВ>
-
-Додати вказані параметри до L<mkfs(1)>, щоб мати змогу скоригувати параметри створення кореневої файлової системи; параметри передаються драйверу L<mfks(1)>, а не самій L<mfks(1)>. Зауважте, що для зміни типу файлової системи використовується I<--fs-type>.
-
-Вам слід скористатися I<--mkfs-options> не більше одного разу. Щоб передати декілька параметрів, відокремте їх пробілами. Приклад:
-
- virt-dib ... --mkfs-options '-O якийсь_параметр -I щось_ще'
-
-=item B<--network>
-
-=item B<--no-network>
-
-Увімкнути чи вимкнути доступ до мережі для гостьової системи під час встановлення.
-
-Типово увімкнено. Скористайтеся параметром I<--no-network>, щоб вимкнути доступ.
-
-У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших незначних обмежень. Див. L<virt-rescue(1)/МЕРЕЖА>.
-
-Це не вплине на доступність мережі для гостьової системи після її завантаження, оскільки така доступність керується вашим гіпервізором або хмарним середовищем і не має нічого спільного з virt-dib.
-
-Якщо ви використаєте параметр I<--no-network>, змінній середовища C<DIB_OFFLINE> буде надано значення C<1>, що сигналізуватиме елементам про те, що їм слід використовувати лише кешовані ресурси, якщо вони доступні. Також слід зауважити, що, на відміну від C<diskimage-builder>, де елементи все ще можуть отримувати доступ до мережі навіть із C<DIB_OFFLINE=>, у virt-dib мережа буде зовсім недоступною.
-
-=item B<--name> НАЗВА
-
-Встановити назву для файла із виведеним образом. Типовою є C<image>.
-
-Відповідно до вибраної назви, у поточному каталозі буде таке:
-
-=over 4
-
-=item F<$NAME.ext>
-
-Для кожного з форматів виведення назву файла буде взято з назви образу-результату, а суфікс назви залежатиме від формату. Приклад: F<$NAME.qcow2>, F<$NAME.raw> тощо.
-
-Не можна застосовувати у режимі диска у пам'яті (ramdisk), див. L</ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ>.
-
-=item F<$NAME.d>
-
-Каталог, що містить будь-які файли, створені елементами, наприклад каталог F<dib-manifests> (створено елементом C<manifests>), диски у пам'яті та ядра у режимі диску у пам'яті тощо.
-
-=item F<$NAME.ext.checksum>
-
-Якщо вказано I<--checksum>, буде створено файли для усіх підтримуваних типів контрольних сум; приклади: F<$NAME.ext.md5>, F<$NAME.ext.sha256> тощо.
-
-Не можна застосовувати у режимі диска у пам'яті (ramdisk), див. L</ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ>.
-
-=back
-
-=item B<--no-delete-on-failure>
-
-Не вилучати файли з виведеними даними, якщо під час збирання станеться помилка. Цими файлами можна скористатися для діагностики помилок у запущених скриптах.
-
-Типовою є поведінка, коли файли результатів буде вилучено, якщо станеться помилка у virt-dib (або, наприклад, помилка у одному зі скриптів, які запускає ця програма).
-
-=item B<--python> PYTHON
-
-Вказати для використання інший інтерпретатор Python. Частину C<diskimage-builder> реалізовано мовою Python, тому інтерпретатор є обов'язковим.
-
-Значенням C<PYTHON> може бути або повна назва виконуваного файла (наприклад F<python2>, пошук якого буде виконано у каталогах змінної C<$PATH>), або шлях повністю (наприклад F</usr/bin/python2>). Якщо не вказано, типовим значенням буде F<python>.
-
-=item B<-q>
-
-=item B<--quiet>
-
-Не виводити звичайних повідомлень щодо поступу.
-
-=item B<--qemu-img-options> параметр[,параметр,...]
-
-Передати параметри I<--qemu-img-options> до програми L<qemu-img(1)> для коригування формату виведення даних. Перелік доступних параметрів залежить від формату виведення (див. I<--formats>) і встановленої версії програми qemu-img.
-
-Вам слід скористатися I<--qemu-img-options> не більше одного разу. Щоб передати декілька параметрів, відокремте їх комами. Приклад:
-
- virt-dib ... --qemu-img-options cluster_size=512,preallocation=metadata ...
-
-=item B<--ramdisk>
-
-Встановити режим збирання диска у пам’яті.
-
-Див. L</ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ>.
-
-=item B<--ramdisk-element> НАЗВА
-
-Встановити назву для додаткового елемента, який буде додано у режимі збирання диска у пам'яті. Типовою є назва C<ramdisk>.
-
-Див. L</ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ>.
-
-=item B<--root-label> МІТКА
-
-Встановити мітку для кореневої файлової системи у створеному образі.
-
-Будь ласка, зауважте, що у деяких файлових системах обмеження на мітки може бути іншим. Наприклад, у файлових системах C<ext2/3/4> мітки не можуть бути довшими за 16 символів, а у C<xfs> найбільшою довжиною мітки є 12 символів.
-
-Типове значення залежить від типу файлової системи для кореневого розділу (див. I<--fs-type>): на C<xfs> — це C<img-rootfs>, а на будь-якій іншій файловій системі — C<cloudimg-rootfs>.
-
-=item B<--size> РОЗМІР
-
-Вибір розміру диска-результату, де розмір можна вказати за допомогою типових записів, зокрема C<32G> (32 гігабайти) тощо. Типовим є розмір C<5G>.
-
-Щоб вказати розмір у байтах, додайте до числа малу літеру I<b>, наприклад S<C<--size 10737418240b>>.
-
-Див. також L<virt-resize(1)> щодо зміни розмірів розділів на наявному образі диска.
-
-=item B<--skip-base>
-
-Пропустити включення елемента C<base>.
-
-=item B<--smp> N
-
-Увімкнути використання скриптами N E<ge> 2 віртуальних процесорів.
-
-=item B<-u>
-
-Не стискати отримані образи qcow2. Типово, програма стискає такі образи.
-
-=item B<-v>
-
-=item B<--verbose>
-
-Увімкнути показ діагностичних повідомлень.
-
-=item B<-V>
-
-=item B<--version>
-
-Показати дані щодо версії і завершити роботу.
-
-=item B<--wrap>
-
-Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-
-=item B<-x>
-
-Увімкнути трасування викликів програмного інтерфейсу libguestfs.
-
-=back
-
-=head1 ЗМІННІ СЕРЕДОВИЩА
-
-На відміну від C<diskimage-builder>, середовище основної системи B<не> успадковується у базовій системі під час запуску більшості елементів (тобто усіх, окрім елементів у фазі C<extra-data.d>).
-
-Щоб встановити змінні середовища для виконання елементів, слід повідомити virt-dib, що слід використовувати ці змінні, за допомогою параметра I<--envvar>. Такий параметр надасть змогу вибірково експортувати змінні середовища під час виконання елементі. Це також пріоритетний шлях передавання змінних середовища елементам.
-
-І ще раз: якщо вам потрібно, щоб змінна середовища C<MYVAR> (і її вміст) були доступні елементам, вам слід або віддати команду
-
- export MYVAR # яким би не було її значення
- virt-dib ... --envvar MYVAR ...
-
-або
-
- virt-dib ... --envvar MYVAR=її_значення ...
-
-=head1 ДОПОМІЖНИЙ ДИСК
-
-Virt-dib виконує більшість елементів у власній базовій системі, отже, не на основній системі. Через це, елементи не можуть кешувати ресурси безпосередньо на основній системі.
-
-Щоб усунути цю незручність, у virt-dib передбачено можливість використання допоміжного диска, на якому можна зберігати кешовані ресурси, зокрема образи дисків, пакунки дистрибутивів тощо. Хоча це означає, що для кешування буде доступним менше місця, принаймні, це надає змогу обмежити простір у основній системі для кешів без потреби у виконанні цього завдання засобами самих елементів.
-
-У поточній версії або цей диск має містити лише один розділ, або має використовуватися лише перший розділ з диска. Диск із другим варіантом конфігурації доволі просто створити за допомогою L<guestfish(1)> ось так:
-
- guestfish -N filename.img=fs:ext4:10G exit
-
-У результаті виконання наведеної вище команди буде створено образ диска із назвою F<filename.img> об'ємом у 10 ГБ з одним розділом типу ext4; див. L<guestfish(1)/ОБРАЗИ ПРИГОТОВАНИХ ДИСКІВ>.
-
-Рекомендованим розміром диска є E<ge> 10 ГБ, оскільки елементи кешуватимуть образи дисків, пакунки дистрибутивів тощо. Як і розмір будь-якого образу диска, розмір допоміжного диска можна змінити за допомогою L<virt-resize(1)>, якщо раптом він стане замалим.
-
-Доступ до диска може здійснюватися у спосіб, який є подібним до способу доступу до будь-яких інших образів дисків, наприклад, за допомогою інших інструментів libguestfs, зокрема L<guestfish(1)>:
-
- guestfish -a filename.img -m /dev/sda1
-
-Якщо за допомогою I<--drive> не вказано жодного допоміжного диска, усі ресурси, кешовані під час запуску virt-dib, буде відкинуто.
-
-=head2 РЕСУРСИ НА ДИСКУ
-
-У допоміжному диску можна шукати такі ресурси:
-
-=over 4
-
-=item F</home>
-
-Цей каталог задається за допомогою змінної середовища C<HOME> під час збирання. У ньому, здебільшого, міститься кеш образів (збережений до F</home/.cache/image-create>) та усі інші ресурси у домашньому каталозі користувача, який запускає різні інструменти.
-
-=item F</virt-dib-*.log>
-
-Це журнали елементів, які виконуються у базовій системі libguestfs, тобто усі фази, окрім C<extra-data.d>.
-
-=back
-
-=head1 ЗБИРАННЯ ДИСКА У ПАМ'ЯТІ
-
-Virt-dib може також емулювати C<ramdisk-image-create>, вторинний режим роботи C<diskimage-builder>. Замість використання якогось інструмента із іншою назвою, virt-dib надає простий доступ до режиму за допомогою параметра I<--ramdisk>.
-
-У цьому режимі:
-
-=over 4
-
-=item
-
-додається елемент ramdisk (див. I<--ramdisk-element>)
-
-=item
-
-образу не створюється (отже, I<--formats> буде проігноровано)
-
-=item
-
-F<$NAME.d> (див. I<--name>) міститиме initrd, kernel, тощо.
-
-=back
-
-=head1 ТИМЧАСОВИЙ КАТАЛОГ
-
-Virt-dib використовує стандартний каталог для тимчасових файлів, який використовується libguestfs, див. L<guestfs(3)/ЗМІННІ СЕРЕДОВИЩА>.
-
-Типово, цим каталогом є F</tmp> (типове значення для C<TMPDIR>). У деяких системах для цього каталогу може використовуватися файлова система tmpfs. Таким чином, типовим максимальним розміром для нього є I<половина> фізичного розміру оперативної пам'яті. Якщо під час роботи virt-dib перевищить це обмеження, програма може повиснути або завершити роботу передчасно із повідомленням про помилку. Усунути цю проблему можна, вказавши для C<TMPDIR> тимчасовий каталог. Приклад:
-
- mkdir local-tmp
- env TMPDIR=$PWD/local-tmp virt-dib ...
- rm -rf local-tmp
-
-=head1 ДОДАТКОВІ ЗАЛЕЖНОСТІ
-
-Оскільки virt-dib запускає більшість елементів у власній базовій системі, усі інструменти та бібліотеки, які використовуються елементами, що запускаються поза межами гостьової системи (типово C<root.d>, C<block-device.d> та C<cleanup.d>) мають бути і у базовій системі. Якщо їх не буде, скрипти не зможуть працювати і типово повідомлять про помилку C<команду не знайдено>.
-
-Для інструментів і бібліотек, які містяться у пакунках дистрибутивів, простим рішенням цієї проблеми буде віддання наказу libguestfs включити додаткові пакунки до базової системи. Зробити це можна, наприклад, створення файла із додатковими пакунками:
-
- # echo wget > /usr/lib64/guestfs/supermin.d/dib-my-extra
-
-Шлях до каталогу F<supermin.d>, звичайно ж, залежить від дистрибутива. У додаткових файлах може бути список із багатьма пакунками, кожен з яких слід вказувати окремому рядку. Докладніший опис можна знайти у підручнику з L<supermin(1)>.
-
-=head1 ПОРІВНЯННЯ ІЗ DISKIMAGE-BUILDER
-
-Призначенням virt-dib є бути безпечним замінником програми C<diskimage-builder> і її режиму C<ramdisk-image-create>. Помітні для користувача відмінності полягають ось у чому:
-
-=over 4
-
-=item
-
-аргументи командного рядка; деякі з аргументів збігаються із аргументами C<diskimage-builder>, але деякі є іншими:
-
- disk-image-create virt-dib
- ----------------- --------
- -a ARCH --arch АРХІТЕКТУРА
- --image-size РОЗМІР --size РОЗМІР
- --max-online-resize РОЗМІР doable using --mkfs-options
- -n --skip-base
- -o НАЗВА ОБРАЗУ --name НАЗВА ОБРАЗУ
- -p ПАКУНКИ --extra-packages ПАКУНКИ
- -t ФОРМАТИ --formats ФОРМАТИ
- -x --debug 1
- -x -x --debug 2
- -x -x [-x ...] --debug 3/4/etc
-
-=item
-
-розташування файлів-результатів, які не є образами (зокрема дисків у пам'яті і ядер)
-
-=item
-
-спосіб зберігання деяких кешованих ресурсів: використання допоміжного диска, а не диска, на якому запущено virt-dib
-
-=item
-
-потреба у визначення розміру диска-результату, тоді як програма C<diskimage-builder> автоматично обчислює оптимальний розмір
-
-=item
-
-обробка змінних середовища, див. L</ЗМІННІ СЕРЕДОВИЩА>.
-
-До того ж, окрім власних змінних середовища libguestfs (див. L<guestfs(3)/ЗМІННІ СЕРЕДОВИЩА>), virt-dib не виконує читання жодних інших змінних середовища. Це означає, що зміни у параметрах і поведінці програми визначаються лише переданими їй аргументами рядка команди.
-
-=item
-
-потрібно, щоб додаткові інструменти на деяких фазах поза chroot були доступні у базовій системі, див. L</ДОДАТКОВІ ЗАЛЕЖНОСТІ>.
-
-=back
-
-Робота самих елементів не повинна зазнати змін; причиною відмінностей у поведінці можуть бути помилкові припущення у коді самих елементів або некоректна емуляція virt-dib.
-
-Відомі вади:
-
-=over 4
-
-=item
-
-(нічого)
-
-=back
-
-=head1 ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ
-
-Для виведення даних у зручному для машинної обробки форматі можна скористатися параметром I<--machine-readable>. Додавання цього параметра робить зручним використання virt-dib з інших програм, графічних інтерфейсів тощо.
-
-Скористайтеся цим параметром окремо, щоб опитати систему щодо можливостей виконуваного файла virt-dib. Типово виведені дані виглядатимуть якось так:
-
- $ virt-dib --machine-readable
- virt-dib
- output:qcow2
- output:tar
- output:raw
- output:vhd
-
-Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.
-
-C<output:> є вказівкою на формати виведення (параметр рядка команди I<--formats>), підтримку яких передбачено у цьому виконуваному файлі.
-
-Можна вказати рядок форматування для керування виведенням, див. L<guestfs(3)/РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ>.
-
-=head1 ТЕСТУВАННЯ
-
-Перевірку працездатності virt-dib було виконано для C<diskimage-builder> (та його елементів) E<ge> 0.1.43. Час від часу виконується також перевірка для C<tripleo-image-elements> та C<sahara-image-elements>.
-
-Попередні версії також можуть працювати, але цього не можна гарантувати.
-
-=head1 СТАН ВИХОДУ
-
-Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
-
-=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ
-
-L<guestfs(3)>, L<guestfish(1)>, L<virt-resize(1)>, L<http://libguestfs.org/>.
-
-=head1 АВТОР
-
-Pino Toscano (C<ptoscano at redhat dot com>)
-
-=head1 АВТОРСЬКІ ПРАВА
-
-© Red Hat Inc., 2015
-
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-diff 1"
-.TH virt-diff 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-diff 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
-virt-diff \*(-- показ відмінностей між файлами у двох віртуальних машинах
+virt-diff \-\- показ відмінностей між файлами у двох віртуальних машинах
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 1
\&
\& virt\-diff [\-\-параметри] \-a диск1.img [\-a ...] \-A диск2.img [\-A ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-diff\*(C'\fR показує список відмінностей між файлами у двох віртуальних машинах або на двох образах дисків. Звичайним випадком застосування є показ змін у віртуальній машині після певного проміжку роботи: можна зробити знімок, запустити віртуальну машину, а потім скористатися цією програмою для перегляду змін, які відрізняють новий стан віртуальної машини і старий її знімок.
.PP
.Vb 1
\& virt\-diff \-d oldguest \-D newguest
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-all\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-all\fR 4
.IX Item "--all"
Те саме, що \fI\-\-extra\-stats\fR \fI\-\-times\fR \fI\-\-uids\fR \fI\-\-xattrs\fR.
-.IP "\fB\-\-atime\fR" 4
+.IP \fB\-\-atime\fR 4
.IX Item "--atime"
Типово, зміни у часі доступу до файла ігноруватимуться, оскільки вони, зазвичай, не варті уваги. Якщо буде використано цей параметр, програма показуватиме і відмінності у значеннях часу доступу.
.IP "\fB\-A\fR файл" 4
.IX Item "-A адреса"
.PD
Додати образ диска із іншої віртуальної машини.
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-checksum\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-checksum\fR 4
.IX Item "--checksum"
.PD 0
-.IP "\fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR" 4
+.IP \fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
Використовувати контрольну суму вмісту файла для визначення випадків зміни вмісту файла.
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Вивести результати до формату \s-1CSV\s0 (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом \*(L"НОТАТКА ЩОДО ФОРМАТУ \s-1CSV\*(R"\s0, наведеним нижче.
-.IP "\fB\-\-dir\-links\fR" 4
+Вивести результати до формату CSV (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом "НОТАТКА ЩОДО ФОРМАТУ CSV", наведеним нижче.
+.IP \fB\-\-dir\-links\fR 4
.IX Item "--dir-links"
Типово, програма ігнорує зміну у кількості посилань для записів каталогів, оскільки така зміна навряд чи є цікавою для користувача. За допомогою цього прапорця ви можете наказати програмі показувати зміни у полі nlink для каталогів.
-.IP "\fB\-\-dir\-times\fR" 4
+.IP \fB\-\-dir\-times\fR 4
.IX Item "--dir-times"
Типово, програма ігнорує зміну часових параметрів для записів каталогів, оскільки така зміна навряд чи є цікавою для користувача. За допомогою цього прапорця ви можете наказати програмі показувати зміни у полях часових параметрів каталогів.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt як першої гостьової системи. \s-1UUID\s0 доменів можна використовувати замість назв.
+Додати всі диски з вказаної гостьової системи libvirt як першої гостьової системи. UUID доменів можна використовувати замість назв.
.IP "\fB\-D\fR гість" 4
.IX Item "-D гість"
-Додати всі диски з вказаної гостьової системи libvirt як другої гостьової системи. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt як другої гостьової системи. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-diff попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-extra\-stats\fR" 4
+.IP \fB\-\-extra\-stats\fR 4
.IX Item "--extra-stats"
Показати додаткові дані.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR/\fI\-A\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR/\fI\-A\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR/\fI\-A\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-h\fR" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
Показати розміри файлів у зручному для читання форматі.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-times\fR" 4
+.IP \fB\-\-times\fR 4
.IX Item "--times"
Показати поля часу.
-.IP "\fB\-\-time\-days\fR" 4
+.IP \fB\-\-time\-days\fR 4
.IX Item "--time-days"
Показувати поля часу у форматі днів до поточного (від’ємні значення для днів у майбутньому).
.Sp
Зауважте, що \f(CW0\fR у виведених даних означає «менше 1 одного дня до поточного моменту» або «вік файла — від 0 до 86399 секунд».
-.IP "\fB\-\-time\-relative\fR" 4
+.IP \fB\-\-time\-relative\fR 4
.IX Item "--time-relative"
Показувати поля часу у форматі секунд до поточного моменту (від’ємні значення для часу у майбутньому).
-.IP "\fB\-\-time\-t\fR" 4
+.IP \fB\-\-time\-t\fR 4
.IX Item "--time-t"
-Показувати поля часу у форматі секунд з моменту початку епохи \s-1UNIX.\s0
-.IP "\fB\-\-uids\fR" 4
+Показувати поля часу у форматі секунд з моменту початку епохи UNIX.
+.IP \fB\-\-uids\fR 4
.IX Item "--uids"
-Показати поля \s-1UID\s0 і \s-1GID.\s0
-.IP "\fB\-v\fR" 4
+Показати поля UID і GID.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
-.IP "\fB\-\-xattrs\fR" 4
+.IP \fB\-\-xattrs\fR 4
.IX Item "--xattrs"
Показати розширені атрибути.
.SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
.IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
-Формат значень, які відокремлено комами (\s-1CSV\s0), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
+Формат значень, які відокремлено комами (CSV), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
.PP
Міф: достатньо розділити поля за комами. Реальність: поділ комами \fIне\fR працює у надійний спосіб. Ось приклад із двома стовпчиками:
.PP
.PP
Для скриптів командної оболонки скористайтеся \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv також є серед пакунків основних дистрибутивів Linux).
.PP
-Для інших мов програмування використовуйте бібліотеку для обробки даних \s-1CSV\s0 (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
+Для інших мов програмування використовуйте бібліотеку для обробки даних CSV (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
.PP
-У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних \s-1CSV.\s0
+У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних CSV.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-ls\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-edit 1"
-.TH virt-edit 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-edit 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-edit — програма для редагування файлів у віртуальній машині
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-edit диск.img [диск.img ...] файл
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-edit\*(C'\fR — інструмент командного рядка для редагування \f(CW\*(C`файла\*(C'\fR, який зберігається у вказаній віртуальній машині (або образі диска).
.PP
.PP
Якщо ви просто хочете переглянути файл, скористайтеся \fBvirt\-cat\fR\|(1).
.PP
-Для виконання складніших дій можна скористатися програмою \fBguestfish\fR\|(1) (див. \*(L"ВИКОРИСТАННЯ \s-1GUESTFISH\*(R"\s0 нижче).
+Для виконання складніших дій можна скористатися програмою \fBguestfish\fR\|(1) (див. "ВИКОРИСТАННЯ GUESTFISH" нижче).
.PP
\&\f(CW\*(C`virt\-edit\*(C'\fR не можна використовувати для створення файлів. Для цього, та багатьох інших завдань, слід використовувати \fBguestfish\fR\|(1).
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Інтерактивне редагування іменованих файлів:
.PP
\& virt\-edit \-d mywindomain \*(Aqc:\eautoexec.bat\*(Aq
.Ve
.PP
-Якщо встановлено Perl, ви також можете редагувати файли у неінтерактивному режимі (див. \*(L"НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ\*(R" нижче). Щоб змінити типовий рівень init на 5:
+Якщо встановлено Perl, ви також можете редагувати файли у неінтерактивному режимі (див. "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ" нижче). Щоб змінити типовий рівень init на 5:
.PP
.Vb 1
\& virt\-edit \-d mydomain /etc/inittab \-e \*(Aqs/^id:.*/id:5:initdefault:/\*(Aq
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
.IP "\fB\-b\fR СУФІКС" 4
.IX Item "-b СУФІКС"
.PD 0
.Ve
.Sp
Типово файл резервної копії не створюється.
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо, libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR ГІСТЬ" 4
.IP "\fB\-\-domain\fR ГІСТЬ" 4
.IX Item "--domain ГІСТЬ"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-edit попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-e\fR вираз" 4
.IP "\fB\-\-expr\fR вираз" 4
.IX Item "--expr вираз"
.PD
-Замість запуску зовнішнього редактора, неінтерактивно застосувати вираз Perl \f(CW\*(C`ВИРАЗ\*(C'\fR до усіх рядків файла. Див. \*(L"НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ\*(R" нижче.
+Замість запуску зовнішнього редактора, неінтерактивно застосувати вираз Perl \f(CW\*(C`ВИРАЗ\*(C'\fR до усіх рядків файла. Див. "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ" нижче.
.Sp
Слід подбати про належне розставлення лапок у виразі, щоб запобігти його зміні у командній оболонці.
.Sp
Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено Perl 5.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Визначення точки монтування вимикає інспектування гостьової системи і призводить до монтування її кореневої системи та усіх її точок монтування. Тому вам слід забезпечити монтування усіх точок монтування, потрібних для роботи із файлами, назви яких вказано як аргументи.
.Sp
-Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" і \*(L"lvs\*(R"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
+Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди "list-partitions", "list-filesystems" і "lvs"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
.Sp
-Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (\s-1ACL\s0) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
+Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (ACL) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
Використання цього прапорця є еквівалентним до використання команди \f(CW\*(C`mount\-options\*(C'\fR.
.Sp
Четвертою частиною параметра є назва драйвера файлової системи, якою слід скористатися, зокрема \f(CW\*(C`ext3\*(C'\fR або \f(CW\*(C`ntfs\*(C'\fR. У визначенні цієї частини параметра рідко виникає потреба, але вона може бути корисною, якщо для файлової системи можна скористатися декількома драйверами (приклад: \f(CW\*(C`ext2\*(C'\fR і \f(CW\*(C`ext3\*(C'\fR), або libguestfs визначає файлову систему помилково.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
.PP
Значення, повернуте у результаті обробки виразу, ігнорується, але вираз може викликати \f(CW\*(C`die\*(C'\fR з метою переривання усієї програми без внесення змін до початкового файла.
.PP
-Слід пам'ятати, що відповідник кінця рядка при використанні \f(CW$_\fR може містити кінцеве \f(CW\*(C`\en\*(C'\fR або (у файлах \s-1DOS\s0) \f(CW\*(C`\er\en\*(C'\fR, або, якщо файл не закінчується символом нового рядка, жодну з цих послідовностей. Тому для пошуку або заміни певного тексту наприкінці рядка слід використовувати такий формальний вираз:
+Слід пам'ятати, що відповідник кінця рядка при використанні \f(CW$_\fR може містити кінцеве \f(CW\*(C`\en\*(C'\fR або (у файлах DOS) \f(CW\*(C`\er\en\*(C'\fR, або, якщо файл не закінчується символом нового рядка, жодну з цих послідовностей. Тому для пошуку або заміни певного тексту наприкінці рядка слід використовувати такий формальний вираз:
.PP
.Vb 1
\& /якийсь текст(\er?\en)?$/
У \f(CW\*(C`virt\-edit\*(C'\fR передбачено обмежені можливості щодо обробки літерних дисків та шляхів у Windows (наприклад \fIE:\efoo\ebar.txt\fR).
.PP
Тоді і лише тоді, коли у гостьовій системі працює Windows:
-.IP "\(bu" 4
+.IP \(bu 4
Літери дисків, наприклад \f(CW\*(C`C:\*(C'\fR, замінюються на адреси відповідних файлових систем на основі даних з регістру Windows.
-.IP "\(bu" 4
+.IP \(bu 4
Усі символи зворотної похилої риски (\f(CW\*(C`\e\*(C'\fR) у шляху замінюються символами звичайної похилої риски так, щоб libguestfs змогла обробити адресу.
-.IP "\(bu" 4
+.IP \(bu 4
Шлях до файла, вміст якого має бути редаговано, визначається без врахування регістру символів у його записі.
.PP
Відомі певні недоліки програми:
-.IP "\(bu" 4
-Перехід за деякими символічними посиланнями \s-1NTFS\s0 може здійснюватися з помилками.
-.IP "\(bu" 4
-Точки з'єднання \s-1NTFS,\s0 які виходять за межі однією файлової системи використовувати не можна.
+.IP \(bu 4
+Перехід за деякими символічними посиланнями NTFS може здійснюватися з помилками.
+.IP \(bu 4
+Точки з'єднання NTFS, які виходять за межі однією файлової системи використовувати не можна.
.SH "ВИКОРИСТАННЯ GUESTFISH"
.IX Header "ВИКОРИСТАННЯ GUESTFISH"
\&\fBguestfish\fR\|(1) є потужнішим інструментом нижчого рівня, яким можна скористатися, якщо \f(CW\*(C`virt\-edit\*(C'\fR не працює.
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
.ie n .IP """EDITOR""" 4
-.el .IP "\f(CWEDITOR\fR" 4
+.el .IP \f(CWEDITOR\fR 4
.IX Item "EDITOR"
Якщо встановлено, цей рядок використовуватиметься для виклику редактора. Рядок може містити аргументи, наприклад, \f(CW"emacs \-nw"\fR
.Sp
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-in\fR\|(1), \fBvirt\-tar\-in\fR\|(1), http://libguestfs.org/, \fBperl\fR\|(1), \fBperlre\fR\|(1).
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-filesystems 1"
-.TH virt-filesystems 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-filesystems 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
-virt-filesystems — програма для показу списку файлових систем, розділів, блокових пристроїв, \s-1LVM\s0 у віртуальних машинах або образах дисків
+virt-filesystems — програма для показу списку файлових систем, розділів, блокових пристроїв, LVM у віртуальних машинах або образах дисків
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 1
\&
\& virt\-filesystems [\-\-параметри] \-a диск.img [\-a диск.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
За допомогою цієї програми ви зможете виявляти файлові системи, розділи диска, логічні томи та визначати їхні розміри у образі диска або у віртуальній машині. Програма є замінником \fBvirt\-list\-filesystems\fR\|(1) та \fBvirt\-list\-partitions\fR\|(1).
.PP
.PP
Ви можете також скористатися цими параметрами у поєднанні (якщо вам потрібна комбінація із файловими системами, вам слід додати \fI\-\-filesystems\fR). Зауважте, що деякі з пунктів списку можуть належати одночасно декільком категоріям (наприклад, \fI/dev/sda1\fR може бути як розділом, так і файловою системою). Такі пункти буде показано відповідну кількість разів. Щоб отримати список, який міститиме абсолютно усе, про що знає virt-filesystems, скористайтеся параметром \fI\-\-all\fR.
.PP
-\&\s-1UUID\s0 (оскільки вони є доволі довгими) типово показано не буде. Додайте параметр \fI\-\-uuid\fR, щоб ознайомитися із \s-1UUID\s0 пристроїв і файлових систем у розширених даних.
+UUID (оскільки вони є доволі довгими) типово показано не буде. Додайте параметр \fI\-\-uuid\fR, щоб ознайомитися із UUID пристроїв і файлових систем у розширених даних.
.PP
\&\fI\-\-all \-\-long \-\-uuid\fR є корисною комбінацією для показу усіх доступних даних щодо усього.
.PP
.Ve
.PP
Для отримання зручних для машинної обробки даних скористайтеся параметром \fI\-\-csv\fR. Дані буде виведено у форматі значень відокремлених комами.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-all\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-all\fR 4
.IX Item "--all"
Вивести усе. У поточній версії це те саме, що вказати такі параметри: \fI\-\-filesystems\fR, \fI\-\-extra\fR, \fI\-\-partitions\fR, \fI\-\-block\-devices\fR, \fI\-\-logical\-volumes\fR, \fI\-\-volume\-groups\fR, \fI\-\-physical\-volumes\fR. (У майбутньому до цього списку може бути додано інші пункти).
.Sp
Див. також \fI\-\-long\fR.
-.IP "\fB\-\-blkdevs\fR" 4
+.IP \fB\-\-blkdevs\fR 4
.IX Item "--blkdevs"
.PD 0
-.IP "\fB\-\-block\-devices\fR" 4
+.IP \fB\-\-block\-devices\fR 4
.IX Item "--block-devices"
.PD
Показати список блокових пристроїв.
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Вивести результати до формату \s-1CSV\s0 (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом \*(L"НОТАТКА ЩОДО ФОРМАТУ \s-1CSV\*(R"\s0, наведеним нижче.
+Вивести результати до формату CSV (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом "НОТАТКА ЩОДО ФОРМАТУ CSV", наведеним нижче.
.IP "\fB\-d\fR гість" 4
.IX Item "-d гість"
.PD 0
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-filesystems попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-extra\fR" 4
+.IP \fB\-\-extra\fR 4
.IX Item "--extra"
Це спричинить показ файлових систем, які не є звичайними файловими системами, які придатні до монтування. До цієї категорії включено розділи резервної пам'яті та файлові системи, які є порожніми або містять невідомі дані.
.Sp
Цей параметр автоматично встановлює параметр \fI\-\-filesystems\fR.
-.IP "\fB\-\-filesystems\fR" 4
+.IP \fB\-\-filesystems\fR 4
.IX Item "--filesystems"
Показати список придатних до монтування систем. Якщо параметр показу не було визначено, цей параметр буде додано до команди.
.Sp
Якщо було використано параметр \fI\-\-extra\fR, буде показано і непридатні до монтування файлові системи.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-h\fR" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
У режимі \fI\-\-long\fR показувати розміри у зручному для читання форматі.
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-l\fR" 4
+.IP \fB\-l\fR 4
.IX Item "-l"
.PD 0
-.IP "\fB\-\-long\fR" 4
+.IP \fB\-\-long\fR 4
.IX Item "--long"
.PD
Показувати додаткові стовпчики даних («довгий формат»).
.Sp
Якщо дані має бути виведено у зручному для читання людиною форматі, скористайтеся параметром \fI\-h\fR. Типово, буде показано розміри у \fIбайтах\fR.
.Sp
-Скористайтеся параметром \fI\-\-uuid\fR, щоб було показано також \s-1UUID.\s0
-.IP "\fB\-\-lvs\fR" 4
+Скористайтеся параметром \fI\-\-uuid\fR, щоб було показано також UUID.
+.IP \fB\-\-lvs\fR 4
.IX Item "--lvs"
.PD 0
-.IP "\fB\-\-logvols\fR" 4
+.IP \fB\-\-logvols\fR 4
.IX Item "--logvols"
-.IP "\fB\-\-logical\-volumes\fR" 4
+.IP \fB\-\-logical\-volumes\fR 4
.IX Item "--logical-volumes"
.PD
-Показати логічні томи \s-1LVM.\s0 У цьому режимі томи буде показано незалежно від того, чи містяться на логічних томах файлові системи.
-.IP "\fB\-\-no\-title\fR" 4
+Показати логічні томи LVM. У цьому режимі томи буде показано незалежно від того, чи містяться на логічних томах файлові системи.
+.IP \fB\-\-no\-title\fR 4
.IX Item "--no-title"
У режимі \fI\-\-long\fR не додавати рядок заголовків.
.Sp
Зауважте, що порядок стовпчиків не є фіксованим і може змінитися у майбутніх версіях virt-filesystems; отже, використання цього параметра може призвести до не зовсім очікуваних наслідків.
-.IP "\fB\-\-parts\fR" 4
+.IP \fB\-\-parts\fR 4
.IX Item "--parts"
.PD 0
-.IP "\fB\-\-partitions\fR" 4
+.IP \fB\-\-partitions\fR 4
.IX Item "--partitions"
.PD
Показати розділи. У цьому режимі розділи буде показано незалежно від того, чи містяться на розділах файлові системи.
-.IP "\fB\-\-pvs\fR" 4
+.IP \fB\-\-pvs\fR 4
.IX Item "--pvs"
.PD 0
-.IP "\fB\-\-physvols\fR" 4
+.IP \fB\-\-physvols\fR 4
.IX Item "--physvols"
-.IP "\fB\-\-physical\-volumes\fR" 4
+.IP \fB\-\-physical\-volumes\fR 4
.IX Item "--physical-volumes"
.PD
-Показати фізичні томи \s-1LVM.\s0
-.IP "\fB\-\-uuid\fR" 4
+Показати фізичні томи LVM.
+.IP \fB\-\-uuid\fR 4
.IX Item "--uuid"
.PD 0
-.IP "\fB\-\-uuids\fR" 4
+.IP \fB\-\-uuids\fR 4
.IX Item "--uuids"
.PD
-У режимі \fI\-\-long\fR буде також виведено \s-1UUID.\s0
-.IP "\fB\-v\fR" 4
+У режимі \fI\-\-long\fR буде також виведено UUID.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-vgs\fR" 4
+.IP \fB\-\-vgs\fR 4
.IX Item "--vgs"
.PD 0
-.IP "\fB\-\-volgroups\fR" 4
+.IP \fB\-\-volgroups\fR 4
.IX Item "--volgroups"
-.IP "\fB\-\-volume\-groups\fR" 4
+.IP \fB\-\-volume\-groups\fR 4
.IX Item "--volume-groups"
.PD
-Показати групи томів \s-1LVM.\s0
-.IP "\fB\-x\fR" 4
+Показати групи томів LVM.
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
-.SH "СТОВПЧИКИ"
+.SH СТОВПЧИКИ
.IX Header "СТОВПЧИКИ"
Зауважте, що порядок і перелік стовпчиків у виведених даних у майбутніх версіях може бути змінено.
-.IP "\fBНазва\fR" 4
+.IP \fBНазва\fR 4
.IX Item "Назва"
-Назва файлової системи, розділу, блокового пристрою або \s-1LVM.\s0
+Назва файлової системи, розділу, блокового пристрою або LVM.
.Sp
Назви пристроїв та розділів буде показано у форматі канонічних назв libguestfs. Таким чином, наприклад, \fI/dev/sda2\fR означатиме другий розділ на першому пристрої.
.Sp
Якщо параметр \fI\-\-long\fR \fBне\fR вказано, у виведених даних буде лише стовпчик назв.
-.IP "\fBТип\fR" 4
+.IP \fBТип\fR 4
.IX Item "Тип"
Тип об'єкта. Наприклад, \f(CW\*(C`filesystem\*(C'\fR, \f(CW\*(C`lv\*(C'\fR, \f(CW\*(C`device\*(C'\fR тощо.
-.IP "\fB\s-1VFS\s0\fR" 4
+.IP \fBVFS\fR 4
.IX Item "VFS"
Якщо буде виявлено відому програмі файлову систему, у цьому стовпчику буде показано дані щодо неї, наприклад \f(CW\*(C`ext4\*(C'\fR.
-.IP "\fBМітка\fR" 4
+.IP \fBМітка\fR 4
.IX Item "Мітка"
Якщо у об'єкта є мітка (яка використовується для ідентифікації та монтування файлових систем), у цьому стовпчику міститься мітка.
-.IP "\fB\s-1MBR\s0\fR" 4
+.IP \fBMBR\fR 4
.IX Item "MBR"
Байт типу розділу, буде показано у форматі двоцифрового шістнадцяткового числа. Довідковий список типів розділів наведено тут: http://www.win.tue.nl/~aeb/partitions/partition_types\-1.html
.Sp
-Це стосується лише розділів \s-1DOS\s0 (\s-1MBR\s0).
-.IP "\fBРозмір\fR" 4
+Це стосується лише розділів DOS (MBR).
+.IP \fBРозмір\fR 4
.IX Item "Розмір"
Розмір об'єкта у байтах. Якщо використано параметр \fI\-\-human\fR, розмір буде вказано у зручному для читання форматі.
-.IP "\fBОснова\fR" 4
+.IP \fBОснова\fR 4
.IX Item "Основа"
У стовпчику батьківських об'єктів показано відношення батьківських і дочірніх об'єктів.
.Sp
Наприклад, якщо об'єкт є розділом, у цьому стовпчику міститиметься назва пристрою, на якому цей розділ розташовано. Якщо об'єкт є логічним томом, у цьому стовпчику буде наведено назву групи томів.
.Sp
Якщо батьківських об'єктів декілька, вмістом стовпчика буде список значень відокремлених комами, наприклад \f(CW\*(C`/dev/sda,/dev/sdb\*(C'\fR.
-.IP "\fB\s-1UUID\s0\fR" 4
+.IP \fBUUID\fR 4
.IX Item "UUID"
-Якщо у об'єкта є \s-1UUID\s0 (який використовується для ідентифікації та монтування файлових систем та блокових пристроїв), у цьому стовпчику міститься \s-1UUID\s0 у форматі рядка.
+Якщо у об'єкта є UUID (який використовується для ідентифікації та монтування файлових систем та блокових пристроїв), у цьому стовпчику міститься UUID у форматі рядка.
.Sp
-\&\s-1UUID\s0 буде показано, лише якщо вказано параметр \fI\-\-uuid\fR.
+UUID буде показано, лише якщо вказано параметр \fI\-\-uuid\fR.
.SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
.IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
-Формат значень, які відокремлено комами (\s-1CSV\s0), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
+Формат значень, які відокремлено комами (CSV), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
.PP
Міф: достатньо розділити поля за комами. Реальність: поділ комами \fIне\fR працює у надійний спосіб. Ось приклад із двома стовпчиками:
.PP
.PP
Для скриптів командної оболонки скористайтеся \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv також є серед пакунків основних дистрибутивів Linux).
.PP
-Для інших мов програмування використовуйте бібліотеку для обробки даних \s-1CSV\s0 (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
+Для інших мов програмування використовуйте бібліотеку для обробки даних CSV (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
.PP
-У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних \s-1CSV.\s0
+У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних CSV.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-df\fR\|(1), \fBvirt\-drivers\fR\|(1), \fBvirt\-list\-filesystems\fR\|(1), \fBvirt\-list\-partitions\fR\|(1), \fBcsvtool\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-format 1"
-.TH virt-format 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-format 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-format — витирання і створення порожнього диска
.SH "КОРОТКИЙ ОПИС"
.Vb 1
\& virt\-format [\-\-параметри] \-a диск.img [\-a диск.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Virt-format отримує назву наявного файла на диску (або розділу, логічного тому основної системи), \fBвитирає з нього усі дані\fR і форматує його як порожній диск. Якщо потрібно, програма може створити таблиці розділів, порожні файлові системи, логічні томи тощо.
.PP
\&\fIdisk.qcow\fR або \fI/dev/VG/LV\fR має вже існувати. \fBУ результаті виконання команд усі дані на вказаних дисках буде витерто\fR. Ці команди створять єдиний порожній розділ, який займатиме увесь диск, без файлових систем на ньому.
.PP
Додатковими параметрами команди можна скористатися для керування створенням розділів, файлових систем тощо. Найрозповсюдженішим є використання таких параметрів:
-.IP "\fB\-\-filesystem=[ext3|ntfs|vfat|...]\fR" 4
+.IP \fB\-\-filesystem=[ext3|ntfs|vfat|...]\fR 4
.IX Item "--filesystem=[ext3|ntfs|vfat|...]"
Створити на розділі порожню файлову систему (\f(CW\*(C`ext3\*(C'\fR, \f(CW\*(C`ntfs\*(C'\fR тощо).
-.IP "\fB\-\-lvm[=/dev/VG/LV]\fR" 4
+.IP \fB\-\-lvm[=/dev/VG/LV]\fR 4
.IX Item "--lvm[=/dev/VG/LV]"
-Створити логічний том Linux \s-1LVM2\s0 на диску. Якщо використовується разом із \fI\-\-filesystem\fR, на логічному томі створюється файлова система.
+Створити логічний том Linux LVM2 на диску. Якщо використовується разом із \fI\-\-filesystem\fR, на логічному томі створюється файлова система.
.PP
-Щоб дізнатися більше про ці та інші параметри, ознайомтеся із розділом \*(L"ПАРАМЕТРИ\*(R" нижче.
+Щоб дізнатися більше про ці та інші параметри, ознайомтеся із розділом "ПАРАМЕТРИ" нижче.
.PP
Зазвичай, формат диска визначається автоматично, але ви також можете вказати його за допомогою параметра \fI\-\-format\fR. У випадках, коли ви вважаєте ненадійним наявний вміст диска, радимо скористатися цим параметром для знищення можливого коду зловмисників.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR файл" 4
.IX Item "--add файл"
.PD
-Додати \fIфайл\fR, який має бути образом диска, розділом основної системи, логічним томом, зовнішнім диском \s-1USB\s0 тощо.
+Додати \fIфайл\fR, який має бути образом диска, розділом основної системи, логічним томом, зовнішнім диском USB тощо.
.Sp
Формат образу диска визначається автоматично. Щоб перевизначити його і примусово використати певний формат, скористайтеся параметром \fI\-\-format=..\fR.
.Sp
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-filesystem=ext3|ntfs|vfat|...\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-filesystem=ext3|ntfs|vfat|...\fR 4
.IX Item "--filesystem=ext3|ntfs|vfat|..."
Створити порожню файлову систему вказаного типу. У libguestfs передбачено підтримку багатьох файлових систем.
-.IP "\fB\-\-filesystem=none\fR" 4
+.IP \fB\-\-filesystem=none\fR 4
.IX Item "--filesystem=none"
Не створювати файлової системи. Типова поведінка.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-label=\fRМІТКА" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP \fB\-\-label=\fRМІТКА 4
.IX Item "--label=МІТКА"
Встановити мітку файлової системи.
-.IP "\fB\-\-lvm=/dev/\f(BI\s-1VG\s0\fB/\f(BI\s-1LV\s0\fB\fR" 4
+.IP \fB\-\-lvm=/dev/\fR\f(BIVG\fR\fB/\fR\f(BILV\fR 4
.IX Item "--lvm=/dev/VG/LV"
-Створити логічний том \s-1LVM2\s0 Linux із назвою \fI/dev/\fI\s-1VG\s0\fI/\fI\s-1LV\s0\fI\fR. Ви можете змінити назву групи томів і логічного тому.
-.IP "\fB\-\-lvm\fR" 4
+Створити логічний том LVM2 Linux із назвою \fI/dev/VG/LV\fR. Ви можете змінити назву групи томів і логічного тому.
+.IP \fB\-\-lvm\fR 4
.IX Item "--lvm"
-Створити логічний том Linux \s-1LVM2\s0 на із типовою назвою (\fI/dev/VG/LV\fR).
-.IP "\fB\-\-lvm=none\fR" 4
+Створити логічний том Linux LVM2 на із типовою назвою (\fI/dev/VG/LV\fR).
+.IP \fB\-\-lvm=none\fR 4
.IX Item "--lvm=none"
Не створювати логічного тому. Типове поведінка.
-.IP "\fB\-\-partition\fR" 4
+.IP \fB\-\-partition\fR 4
.IX Item "--partition"
-Створити розділ \s-1MBR\s0 або \s-1GPT\s0 для усього диска. \s-1MBR\s0 буде вибрано, якщо розмір диска < 2 ТБ, \s-1GPT\s0 — якщо ≥ 2 ТБ.
+Створити розділ MBR або GPT для усього диска. MBR буде вибрано, якщо розмір диска < 2 ТБ, GPT — якщо ≥ 2 ТБ.
.Sp
Типове значення.
-.IP "\fB\-\-partition=gpt\fR" 4
+.IP \fB\-\-partition=gpt\fR 4
.IX Item "--partition=gpt"
-Створити розділ \s-1GPT.\s0
-.IP "\fB\-\-partition=mbr\fR" 4
+Створити розділ GPT.
+.IP \fB\-\-partition=mbr\fR 4
.IX Item "--partition=mbr"
-Створити розділ \s-1MBR.\s0
-.IP "\fB\-\-partition=none\fR" 4
+Створити розділ MBR.
+.IP \fB\-\-partition=none\fR 4
.IX Item "--partition=none"
Не створювати таблиці розділів. Зауважте, що такі диски можуть бути невидимими для Windows.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wipe\fR" 4
+.IP \fB\-\-wipe\fR 4
.IX Item "--wipe"
У поточній версії virt-format не витирає дані з диска (оскільки ця дія є надто тривалою). Тому, якщо на диску є дані, їх буде лише приховано і частково перезаписано virt-format. Ймовірно, такі дані можна відновити за допомогою інструментів для редагування дисків.
.Sp
Якщо ви скористаєтеся цим параметром, virt-format перезапише нулями увесь диск, щоб попередньо записані дані не можна було відновити.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "СТАН ВИХОДУ"
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-make\-fs\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
© Red Hat Inc., 2012
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-get-kernel 1"
-.TH virt-get-kernel 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-get-kernel 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-get-kernel — видобування ядра і диска в пам'яті з гостьових систем
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-get\-kernel [\-\-параметри] \-a диск.img
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
This program extracts the kernel and initramfs from a guest.
.PP
Формат образу диска буде визначено автоматично, якщо ви не вкажете його за допомогою параметра \fI\-\-format\fR.
.PP
Якщо у гостьовій системі декілька ядер, буде вибрано ядро із найбільшим номером. Щоб видобути із образу диска ядро з певним номером версії, скористайтеся \fBguestfish\fR\|(1). Щоб видобути із гостьової системи увесь вміст каталогу \f(CW\*(C`/boot\*(C'\fR, скористайтеся \fBvirt\-copy\-out\fR\|(1).
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати довідкове повідомлення.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
+Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
.IP "\fB\-\-blocksize\fR \fB512\fR" 4
.IX Item "--blocksize 512"
.PD 0
.IP "\fB\-\-blocksize\fR \fB4096\fR" 4
.IX Item "--blocksize 4096"
.PD
-This parameter sets the sector size of the disk image added with \fI\-a\fR option and is ignored for libvirt guest added with \fI\-d\fR option. See also \*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-colors\fR" 4
+This parameter sets the sector size of the disk image added with \fI\-a\fR option and is ignored for libvirt guest added with \fI\-d\fR option. See also "guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-get-kernel попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у рядку команди.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=формат" 4
+.IP \fB\-\-machine\-readable\fR=формат 4
.IX Item "--machine-readable=формат"
.PD
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. \*(L"ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" нижче.
+За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" нижче.
.IP "\fB\-o\fR каталог" 4
.IX Item "-o каталог"
.PD 0
Якщо вказано префікс, програма додасть дефіс (\f(CW\*(C`\-\*(C'\fR) після префікса і перед рештою назви файла. Наприклад, якщо у гостьовій системі ядро називалося \f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR, його буде збережено як \f(CW\*(C`mydistro\-vmlinuz\-3.19.0\-20\-generic\*(C'\fR, якщо було вказано префікс \f(CW\*(C`mydistro\*(C'\fR.
.Sp
Див. також \fI\-\-unversioned\-names\fR.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Не виводити звичайних повідомлень щодо поступу.
-.IP "\fB\-\-unversioned\-names\fR" 4
+.IP \fB\-\-unversioned\-names\fR 4
.IX Item "--unversioned-names"
Цей параметр впливає на назву файла призначення для видобутих файлів.
.Sp
Якщо увімкнено, файли буде збережено локально лише з базовою назвою. Наприклад, якщо ядро та диск у пам'яті у гостьовій системі називалися \f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR та \f(CW\*(C`initrd.img\-3.19.0\-20\-generic\*(C'\fR, їх буде збережено, відповідно, як \f(CW\*(C`vmlinuz\*(C'\fR та \f(CW\*(C`initrd.img\*(C'\fR.
.Sp
Див. також \fI\-\-prefix\fR.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ"
.PP
Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.
.PP
-Можна вказати рядок форматування для керування виведенням, див. \*(L"РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" in \fBguestfs\fR\|(3).
+Можна вказати рядок форматування для керування виведенням, див. "РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" in \fBguestfs\fR\|(3).
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
-Опис інших змінних середовища, які стосуються усіх програм libguestfs, наведено у розділі \*(L"ЗМІННІ СЕРЕДОВИЩА\*(R" in \fBguestfs\fR\|(3).
+Опис інших змінних середовища, які стосуються усіх програм libguestfs, наведено у розділі "ЗМІННІ СЕРЕДОВИЩА" in \fBguestfs\fR\|(3).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBguestmount\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-drivers\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2013\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-index-validate 1"
-.TH virt-index-validate 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-index-validate 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-index-validate — засіб перевірки файла покажчика virt-builder
.SH "КОРОТКИЙ ОПИС"
.Vb 1
\& virt\-index\-validate index
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\fBvirt\-builder\fR\|(1) використовує файл покажчика (index) для зберігання метаданих щодо шаблонів, способи використання яких відомі програмі. Цей файл покажчика має специфічний формат, перевірку якого виконує програма virt-index-validate.
.PP
Зауважте, що virt-index-validate може перевіряти як підписані, так і непідписані файли покажчиків (тобто, як \fIindex\fR, так і \fIindex.asc\fR). Програма здатна перевіряти лише локальні файли і не може працювати із зовнішніми адресами.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-compat\-1.24.0\fR" 4
+.IP \fB\-\-compat\-1.24.0\fR 4
.IX Item "--compat-1.24.0"
Перевірити на сумісність за допомогою virt-builder 1.24.0. (Використання цього параметра автоматично додає \fI\-\-compat\-1.24.1\fR, тому немає потреби у додатковому параметрі, якщо ви вже вказали цей.)
.Sp
Зокрема:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Ця версія virt-builder не здатна обробляти \f(CW\*(C`[...]\*(C'\fR (квадратні дужки) у назвах полів (наприклад, \f(CW\*(C`checksum[sha512]=...\*(C'\fR).
-.IP "\(bu" 4
+.IP \(bu 4
Потребувало від'єднаних підписів (\f(CW\*(C`sig=...\*(C'\fR).
.RE
.RS 4
.RE
-.IP "\fB\-\-compat\-1.24.1\fR" 4
+.IP \fB\-\-compat\-1.24.1\fR 4
.IX Item "--compat-1.24.1"
Перевірити на сумісність за допомогою virt-builder ≥ 1.24.1.
.Sp
Зокрема:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
У цій версії virt-builder не було передбачено обробки \f(CW\*(C`.\*(C'\fR (крапки) у назвах полів або \f(CW\*(C`,\*(C'\fR (коми) у назвах підполів.
-.IP "\(bu" 4
+.IP \(bu 4
Вона не може обробляти коментарі, які є у цьому файлі.
.RE
.RS 4
.RE
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати довідкове повідомлення.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBvirt\-builder\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
© Red Hat Inc., 2013
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-inspector 1"
-.TH virt-inspector 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-inspector 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-inspector — показ версії операційної системи та інших даних щодо віртуальної машини
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-inspector диск.img [диск.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\fBvirt-inspector\fR виконує вивчення віртуальної машини або образу диска і намагається визначити версію операційної системи та інші дані щодо віртуальної машини.
.PP
-Virt-inspector виводить дані \s-1XML\s0 для обробки у інших програмах.
+Virt-inspector виводить дані XML для обробки у інших програмах.
.PP
У звичайному режимі користуйтеся командою \f(CW\*(C`virt\-inspector \-d назва_домену\*(C'\fR, де \f(CW\*(C`назва_домену\*(C'\fR — назва домену libvirt (див. \f(CW\*(C`virsh list \-\-all\*(C'\fR).
.PP
Ви також можете запускати virt-inspector безпосередньо для образів дисків з однієї віртуальної машини. Для цього слід використовувати команду \f(CW\*(C`virt\-inspector \-a образ.диска\*(C'\fR. У рідкісних випадках у домені може бути декілька блокових пристроїв. У цьому випадку вам слід вказати список із декількох параметрів \fI\-a\fR, один за одним. Перший має відповідати пристрою \fI/dev/sda\fR гостьової системи, другий — пристрою \fI/dev/sdb\fR гостьової системи тощо.
.PP
-Ви також можете запускати virt-inspector для дисків для встановлення системи, образів компакт\-дисків для портативних систем, призначених для завантаження образів флешок \s-1USB\s0 тощо.
+Ви також можете запускати virt-inspector для дисків для встановлення системи, образів компакт\-дисків для портативних систем, призначених для завантаження образів флешок USB тощо.
.PP
Virt-inspector може одночасно інспектувати і створювати звіт лише для \fIодного домену\fR. Для інспектування декількох віртуальних машин вам доведеться запускати virt-inspector декілька разів (наприклад, із циклу for скрипту оболонки).
.PP
Оскільки virt-inspector потрібен безпосередній доступ до образів гостьової системи, програма, зазвичай, не працюватиме, якщо використовується віддалене з'єднання із libvirt.
.PP
-Усі дані, які доступні за допомогою virt-inspector, також доступні і з основного програмного інтерфейсу інспектування libguestfs (див. \*(L"ІНСПЕКТУВАННЯ\*(R" in \fBguestfs\fR\|(3)). Ті самі дані можна також отримати за допомогою guestfish або прив'язок до libguestfs багатьма мовами програмування (див. \*(L"ОТРИМАННЯ ДАНИХ ІНСПЕКТУВАННЯ ЗА ДОПОМОГОЮ ПРОГРАМНОГО ІНТЕРФЕЙСУ \s-1LIBGUESTFS\*(R"\s0).
+Усі дані, які доступні за допомогою virt-inspector, також доступні і з основного програмного інтерфейсу інспектування libguestfs (див. "ІНСПЕКТУВАННЯ" in \fBguestfs\fR\|(3)). Ті самі дані можна також отримати за допомогою guestfish або прив'язок до libguestfs багатьма мовами програмування (див. "ОТРИМАННЯ ДАНИХ ІНСПЕКТУВАННЯ ЗА ДОПОМОГОЮ ПРОГРАМНОГО ІНТЕРФЕЙСУ LIBGUESTFS").
.PP
Additional information about bootloader, kernel and drivers inside a guest can be found using \fBvirt\-drivers\fR\|(1).
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Libvirt використовуватиметься, лише якщо ви вкажете \f(CW\*(C`назву домену\*(C'\fR у рядку команди. Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-inspector попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Визначає формат образу диска, назву якого вказано у рядку команди. Якщо формат не вказано, його буде визначено автоматично на основі вмісту образу диска.
Якщо вказаний диск походить з libvirt, ця програма надішле запит щодо даних до libvirt. У цьому випадку вказане значення параметра формату буде проігноровано.
.Sp
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-no\-applications\fR" 4
+.IP \fB\-\-no\-applications\fR 4
.IX Item "--no-applications"
Типово, виведені virt-inspector дані містять список програм, які встановлено у гостьовій системі, якщо такий список доступний.
.Sp
-Вкажіть цей параметр, щоб вимкнути частину \s-1XML\s0 результату.
-.IP "\fB\-\-no\-icon\fR" 4
+Вкажіть цей параметр, щоб вимкнути частину XML результату.
+.IP \fB\-\-no\-icon\fR 4
.IX Item "--no-icon"
-Типово, виведені virt-inspector дані містять список програм, які встановлено у гостьовій системі, якщо такий список доступний (див. \*(L"icon\*(R").
+Типово, виведені virt-inspector дані містять список програм, які встановлено у гостьовій системі, якщо такий список доступний (див. "icon").
.Sp
-Вкажіть цей параметр, щоб вимкнути частину \s-1XML\s0 результату.
-.IP "\fB\-v\fR" 4
+Вкажіть цей параметр, щоб вимкнути частину XML результату.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.IP "\fB\-\-xpath\fR запит" 4
.IX Item "--xpath запит"
-Виконати запит XPath до \s-1XML\s0 у stdin і вивести результат до stdout. У цьому режимі virt-inspector просто виконує запит XPath; усі інші функції інспектування буде вимкнено. Приклади запитів наведено у розділі \*(L"ЗАПИТИ \s-1XPATH\*(R"\s0 нижче.
+Виконати запит XPath до XML у stdin і вивести результат до stdout. У цьому режимі virt-inspector просто виконує запит XPath; усі інші функції інспектування буде вимкнено. Приклади запитів наведено у розділі "ЗАПИТИ XPATH" нижче.
.SH "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
.IX Header "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
У попередніх версіях virt-inspector можна було використовувати або
З міркувань зворотної сумісності передбачено підтримку запису параметрів у застарілому форматі.
.SH "ФОРМАТ XML"
.IX Header "ФОРМАТ XML"
-Точний опис \s-1XML\s0 virt-inspector наведено у файлі схеми \s-1RELAX NG\s0 \fIvirt\-inspector.rng\fR, який постачається разом із libguestfs. Цей розділ містить лише поверхневий огляд.
+Точний опис XML virt-inspector наведено у файлі схеми RELAX NG \fIvirt\-inspector.rng\fR, який постачається разом із libguestfs. Цей розділ містить лише поверхневий огляд.
.PP
Елементом верхнього рівня є <operatingsystems>. Він містить один або декілька елементів <operatingsystem>. Елементів <operatingsystem> буде декілька, лише якщо у віртуальній машині передбачено декілька варіантів завантаження. Такі випадки є дуже рідкісними у світі віртуальних машин.
-.SS "<operatingsystem>"
+.SS <operatingsystem>
.IX Subsection "<operatingsystem>"
Всередині теґу <operatingsystem> містяться різноманітні необов'язкові поля, які описують операційну систему, її архітектуру, містять описовий рядок «назва продукту», тип операційної системи тощо. Ось приклад:
.PP
\& <windows_systemroot>/Windows</windows_systemroot>
.Ve
.PP
-Якщо коротко, <name> — клас операційної системи (щось подібне до \f(CW\*(C`linux\*(C'\fR або \f(CW\*(C`windows\*(C'\fR), <distro> — дистрибутив (наприклад, \f(CW\*(C`fedora\*(C'\fR, але передбачено розпізнавання багатьох інших дистрибутивів), а <arch> — архітектура гостьової системи. Інші поля мають доволі зрозуміле призначення, але оскільки ці поля взято безпосередньо з програмного інтерфейсу інспектування libguestfs, їхній повний опис можна знайти у розділі \*(L"ІНСПЕКТУВАННЯ\*(R" in \fBguestfs\fR\|(3).
+Якщо коротко, <name> — клас операційної системи (щось подібне до \f(CW\*(C`linux\*(C'\fR або \f(CW\*(C`windows\*(C'\fR), <distro> — дистрибутив (наприклад, \f(CW\*(C`fedora\*(C'\fR, але передбачено розпізнавання багатьох інших дистрибутивів), а <arch> — архітектура гостьової системи. Інші поля мають доволі зрозуміле призначення, але оскільки ці поля взято безпосередньо з програмного інтерфейсу інспектування libguestfs, їхній повний опис можна знайти у розділі "ІНСПЕКТУВАННЯ" in \fBguestfs\fR\|(3).
.PP
Елемент <root> є пристроєм кореневої файлової системи, але з точки зору libguestfs (блокові пристрої можуть мати зовсім інші назви у самій віртуальній машині).
-.SS "<mountpoints>"
+.SS <mountpoints>
.IX Subsection "<mountpoints>"
У Un*x\-подібних гостьових системах типово міститься декілька файлових систем, які монтуються як різні точки монтування. Ці файлові системи описано у елементі <mountpoints>, який виглядає ось так:
.PP
.Ve
.PP
Як і з <root>, пристрої подано з точки зору libguestfs, отже вони можуть мати зовсім інші назви у гостьовій системі. У списку буде наведено лише монтовані файлові системи, а не щось подібне до пристроїв резервної пам'яті на диску.
-.SS "<filesystems>"
+.SS <filesystems>
.IX Subsection "<filesystems>"
Елемент <filesystems> подібний до <mountpoints>, але стосується файлових \fIусіх\fR файлових систем, що належать гостьовій операційній системі, зокрема розділів резервної пам'яті на диску та порожніх розділів. (У рідкісних випадках гостьової системи із варіантами завантаження, цей елемент стосується файлових систем, що належать цій операційній системі або є спільними для цієї операційної системи та інших операційних систем.)
.PP
\& </filesystem>
.Ve
.PP
-Необов'язкові елементи у <filesystem> стосуються типу, мітки та \s-1UUID\s0 файлової системи.
-.SS "<applications>"
+Необов'язкові елементи у <filesystem> стосуються типу, мітки та UUID файлової системи.
+.SS <applications>
.IX Subsection "<applications>"
Пов'язані елементи <package_format>, <package_management> та <applications> описують програми, які встановлено у віртуальній машині.
.PP
\& </application>
.Ve
.PP
-Для деяких типів гостьових системи дані полів версії і випуску можуть бути недоступними. Можлива поява інших полів, див. \*(L"guestfs_inspect_list_applications\*(R" in \fBguestfs\fR\|(3).
-.SS "<drive_mappings>"
+Для деяких типів гостьових системи дані полів версії і випуску можуть бути недоступними. Можлива поява інших полів, див. "guestfs_inspect_list_applications" in \fBguestfs\fR\|(3).
+.SS <drive_mappings>
.IX Subsection "<drive_mappings>"
Для операційних систем, подібних до Windows, де для позначення дисків використовуються літери, virt-inspector може визначати прив'язки літер дисків до файлових систем.
.PP
.PP
У наведеному вище прикладі диск C пов'язано із файловою системою на другому розділі першого диска, диск E — із файловою системою на першому розділі другого диска.
.PP
-Зауважте, що це стосується лише постійних прив'язок дисків, а не прив'язок, які подібні до прив'язок до спільних ресурсів у мережі. Крім того, до цього списку може бути не включено точки монтування томів \s-1NTFS.\s0
-.SS "<icon>"
+Зауважте, що це стосується лише постійних прив'язок дисків, а не прив'язок, які подібні до прив'язок до спільних ресурсів у мережі. Крім того, до цього списку може бути не включено точки монтування томів NTFS.
+.SS <icon>
.IX Subsection "<icon>"
-Іноді virt-inspector може видобути піктограму або логотип гостьової системи. Піктограму буде повернуто у форматі даних \s-1PNG\s0 у кодуванні base64. Зауважте, що піктограма може бути доволі великою і дуже якісною.
+Іноді virt-inspector може видобути піктограму або логотип гостьової системи. Піктограму буде повернуто у форматі даних PNG у кодуванні base64. Зауважте, що піктограма може бути доволі великою і дуже якісною.
.PP
.Vb 7
\& <operatingsystems>
\& </icon>
.Ve
.PP
-Для показу піктограми вам слід видобути ї і перетворити дані у кодуванні base64 знову у двійковий файл. Скористайтеся запитом XPath або простим редактором для видобування даних, а потім програмою \fBbase64\fR\|(1) з coreutils для перетворення цих даних на файл \s-1PNG:\s0
+Для показу піктограми вам слід видобути ї і перетворити дані у кодуванні base64 знову у двійковий файл. Скористайтеся запитом XPath або простим редактором для видобування даних, а потім програмою \fBbase64\fR\|(1) з coreutils для перетворення цих даних на файл PNG:
.PP
.Vb 1
\& base64 \-i \-d < дані.піктограми > icon.png
.IX Header "ЗАПИТИ XPATH"
У virt-inspector передбачено вбудовану підтримку виконання запитів XPath. Причиною включення підтримкиXPath безпосередньо до virt-inspector є те, що не існує добрих і широкодоступних засобів командного рядка, які можуть виконувати запити XPath. Єдиним добрим засобом є \fBxmlstarlet\fR\|(1), але ця програма недоступна у Red Hat Enterprise Linux.
.PP
-Для виконання запиту XPath скористайтеся параметром \fI\-\-xpath\fR. Зауважте, що у цьому режимі virt-inspector просто читає \s-1XML\s0 зі stdin і виводить результат запиту до stdout. Усі інші можливості інспектування у цьому режимі вимкнено.
+Для виконання запиту XPath скористайтеся параметром \fI\-\-xpath\fR. Зауважте, що у цьому режимі virt-inspector просто читає XML зі stdin і виводить результат запиту до stdout. Усі інші можливості інспектування у цьому режимі вимкнено.
.PP
Приклад:
.PP
.PP
До libguestfs 1.8 ми переписали код Perl на C і включили його до програмного інтерфейсу основи libguestfs (\fBguestfs\fR\|(3)). Тепер virt-inspector є простим тонким прошарком C над основним програмним інтерфейсом мовою C. Усі дані інспектування доступні з усіх мов програмування, підтримку яких передбачено у libguestfs, і з guestfish.
.PP
-Опис програмного інтерфейсу інспектування мовою C наведено у розділі \*(L"ІНСПЕКТУВАННЯ\*(R" in \fBguestfs\fR\|(3).
+Опис програмного інтерфейсу інспектування мовою C наведено у розділі "ІНСПЕКТУВАННЯ" in \fBguestfs\fR\|(3).
.PP
Приклад коду, де використовується програмний інтерфейс інспектування мовою C, наведено у файлі \fIinspect\-vm.c\fR, який постачається разом із libguestfs.
.PP
-Крім того, \fIinspect\-vm.c\fR трансльовано іншими мовами програмування. Наприклад, \fIinspect_vm.pl\fR є трансляцією на Perl. Також передбачено інші трансляції на OCaml, Python тощо. Див. \*(L"ВИКОРИСТАННЯ \s-1LIBGUESTFS\s0 ЗА ДОПОМОГОЮ ІНШИХ МОВ ПРОГРАМУВАННЯ\*(R" in \fBguestfs\fR\|(3), де наведено список сторінок підручника, де містяться приклади коду.
-.SS "ОТРИМАННЯ ДАНИХ ІНСПЕКТУВАННЯ ВІД \s-1GUESTFISH\s0"
+Крім того, \fIinspect\-vm.c\fR трансльовано іншими мовами програмування. Наприклад, \fIinspect_vm.pl\fR є трансляцією на Perl. Також передбачено інші трансляції на OCaml, Python тощо. Див. "ВИКОРИСТАННЯ LIBGUESTFS ЗА ДОПОМОГОЮ ІНШИХ МОВ ПРОГРАМУВАННЯ" in \fBguestfs\fR\|(3), де наведено список сторінок підручника, де містяться приклади коду.
+.SS "ОТРИМАННЯ ДАНИХ ІНСПЕКТУВАННЯ ВІД GUESTFISH"
.IX Subsection "ОТРИМАННЯ ДАНИХ ІНСПЕКТУВАННЯ ВІД GUESTFISH"
-Якщо ви використовуєте параметр guestfish \fI\-i\fR, викликається основний програмний інтерфейс інспектування \*(L"guestfs_inspect_os\*(R" in \fBguestfs\fR\|(3) мовою C. Це еквівалент команди guestfish \f(CW\*(C`inspect\-os\*(C'\fR. Ви також можете викликати цю команду guestfish вручну.
+Якщо ви використовуєте параметр guestfish \fI\-i\fR, викликається основний програмний інтерфейс інспектування "guestfs_inspect_os" in \fBguestfs\fR\|(3) мовою C. Це еквівалент команди guestfish \f(CW\*(C`inspect\-os\*(C'\fR. Ви також можете викликати цю команду guestfish вручну.
.PP
\&\f(CW\*(C`inspect\-os\*(C'\fR виконує інспектування поточного образу диска, повертаючи список знайдених операційних систем. Кожну операційну систему представлено її пристроєм кореневої файлової системи. У більшості випадків ця команда не виводить ніяких даних (не знайдено жодної операційної системи) або виводить єдиний кореневий пристрій, але ви маєте зважати на те, що ця команда може вивести декілька рядків, якщо у образі декілька операційних систем або із гостьовою системою з'єднано компакт\-диск для встановлення.
.PP
.Ve
.SH "ПОПЕРЕДНІ ВЕРСІЇ VIRT-INSPECTOR"
.IX Header "ПОПЕРЕДНІ ВЕРСІЇ VIRT-INSPECTOR"
-Як ми вже вказували вище, ранні версії libguestfs постачалися із іншою програмою virt-inspector, написаною на Perl (поточну версію написано на C). Виведені дані \s-1XML\s0 virt-inspector на Perl були іншими, програма також могла виводити дані у інших форматах, зокрема текстовому.
+Як ми вже вказували вище, ранні версії libguestfs постачалися із іншою програмою virt-inspector, написаною на Perl (поточну версію написано на C). Виведені дані XML virt-inspector на Perl були іншими, програма також могла виводити дані у інших форматах, зокрема текстовому.
.PP
Підтримку застарілої версії virt-inspector припинено, вона більше не постачається з libguestfs.
.PP
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), http://www.w3.org/TR/xpath/, \fBbase64\fR\|(1), \fBxmlstarlet\fR\|(1), \fBvirt\-drivers\fR\|(1), http://libguestfs.org/.
-.SH "АВТОРИ"
+.SH АВТОРИ
.IX Header "АВТОРИ"
-.IP "\(bu" 4
+.IP \(bu 4
Richard W.M. Jones http://people.redhat.com/~rjones/
-.IP "\(bu" 4
+.IP \(bu 4
Matthew Booth mbooth@redhat.com
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-log 1"
-.TH virt-log 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-log 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
-virt-log \*(-- програма для показу файлів журналу віртуальної машини
+virt-log \-\- програма для показу файлів журналу віртуальної машини
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 1
\&
\& virt\-log [\-\-параметри] \-a диск.img [\-a диск.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-log\*(C'\fR — інструмент командного рядка для показу файлів журналів з вказаної віртуальної машини (або образу диска).
.PP
Ця програма може працювати як зі звичайними текстовими файлами журналу (наприклад \fI/var/log/messages\fR), такі із файлами журналів у двійкових форматах, зокрема журналом systemd.
.PP
Для виведення вмісту файлів інших типів скористайтеся \fBvirt\-cat\fR\|(1). Для стеження (tail) за текстовими файлами журналу, скористайтеся \fBvirt\-tail\fR\|(1). Щоб скопіювати файли з віртуальної машини, скористайтеся \fBvirt\-copy\-out\fR\|(1). Щоб вивести вміст реєстру Windows, скористайтеся \fBvirt\-win\-reg\fR\|(1).
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Показ журналу з гостьової системи повністю:
.PP
\& virt\-log \-d mydomain | less
.Ve
.PP
-Визначення IP\-адреси \s-1DHCP,\s0 використаної віртуальною машиною:
+Визначення IP\-адреси DHCP, використаної віртуальною машиною:
.PP
.Vb 1
\& virt\-log \-d mydomain | grep \*(Aqdhclient.*bound to\*(Aq
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-log попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "СТАН ВИХОДУ"
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-tail\fR\|(1), \fBvirt\-tar\-out\fR\|(1), \fBvirt\-win\-reg\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-ls 1"
-.TH virt-ls 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-ls 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-ls — програма для показу списку файлів у віртуальній машині
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-ls [\-\-параметри] диск.img [диск.img ...] каталог
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-ls\*(C'\fR виводить списки назв файлів, розмірів файлів, контрольних сум, розширених атрибутів та інші дані з віртуальної машини або образу диска.
.PP
Щоб отримати список вмісту каталогів з гостьової системи libvirt, скористайтеся параметром \fI\-d\fR для задання назви гостьової системи. Для роботи з образом диска скористайтеся параметром \fI\-a\fR.
.PP
\&\f(CW\*(C`virt\-ls\*(C'\fR може створювати багато простих списків файлів. Складніші списки можна створити за допомогою \fBguestfish\fR\|(1) або програми, яка безпосередньо використовує програмний інтерфейс \fBguestfs\fR\|(3).
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Отримати список всіх файлів і каталогів у віртуальній машині:
.PP
\& [тощо]
.Ve
.PP
-Зауважте, що хоча такий список зручний для перегляду вмісту каталогу, не варто обробляти його за допомогою іншої програми. Для обробки іншими програмами слід скористатися варіантом \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R".
+Зауважте, що хоча такий список зручний для перегляду вмісту каталогу, не варто обробляти його за допомогою іншої програми. Для обробки іншими програмами слід скористатися варіантом "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК".
.SS "РЕКУРСИВНИЙ СПИСОК"
.IX Subsection "РЕКУРСИВНИЙ СПИСОК"
Із параметром \fI\-R\fR (\fI\-\-recursive\fR) \f(CW\*(C`virt\-ls\*(C'\fR виводить список назв файлів і каталогів рекурсивно:
.Ve
.PP
Ці основні поля буде показано завжди:
-.IP "тип" 4
+.IP тип 4
.IX Item "тип"
Тип файла, одне з таких значень: \f(CW\*(C`\-\*(C'\fR (звичайний файл), \f(CW\*(C`d\*(C'\fR (каталог), \f(CW\*(C`c\*(C'\fR (символьний пристрій), \f(CW\*(C`b\*(C'\fR (блоковий пристрій), \f(CW\*(C`p\*(C'\fR (іменований канал), \f(CW\*(C`l\*(C'\fR (символічне посилання), \f(CW\*(C`s\*(C'\fR (сокет) або \f(CW\*(C`u\*(C'\fR (невідомо).
.IP "права доступу" 4
.IX Item "права доступу"
Права доступу Unix, показані у форматі вісімкового числа із 4 цифр.
-.IP "розмір" 4
+.IP розмір 4
.IX Item "розмір"
Розмір файла. Його буде показано у байтах, якщо не використано параметр \fI\-h\fR або \fI\-\-human\-readable\fR. Якщо такий параметр використано, дані буде показано у зручному для читанні вигляді.
-.IP "шлях" 4
+.IP шлях 4
.IX Item "шлях"
Шлях до файла або каталогу повністю.
-.IP "посилання" 4
+.IP посилання 4
.IX Item "посилання"
Лише для символічних посилань, призначення посилання.
.PP
У режимі \fI\-lR\fR додаткові параметри командного рядка уможливлюють показ додаткових полів.
.PP
З прапорцем \fI\-\-uids\fR ці додаткові поля буде показано до шляху:
-.IP "uid" 4
+.IP uid 4
.IX Item "uid"
.PD 0
-.IP "gid" 4
+.IP gid 4
.IX Item "gid"
.PD
-\&\s-1UID\s0 та \s-1GID\s0 власника файла (буде показано у числовій формі). Зауважте, що ці дані мають сенс лише у контексті Unix\-подібної гостьової системи.
+UID та GID власника файла (буде показано у числовій формі). Зауважте, що ці дані мають сенс лише у контексті Unix\-подібної гостьової системи.
.PP
Із прапорцем \fI\-\-times\fR буде показано такі додаткові поля:
-.IP "atime" 4
+.IP atime 4
.IX Item "atime"
Час останнього доступу.
-.IP "mtime" 4
+.IP mtime 4
.IX Item "mtime"
Час останнього внесення змін.
-.IP "ctime" 4
+.IP ctime 4
.IX Item "ctime"
Час останньої зміни стану.
.PP
Вміст полів дат і часу буде показано у форматі рядків, якщо не вказано одного з таких параметрів: \fI\-\-time\-t\fR, \fI\-\-time\-relative\fR або \fI\-\-time\-days\fR.
.PP
Із прапорцем \fI\-\-extra\-stats\fR буде показано такі додаткові поля:
-.IP "пристрій" 4
+.IP пристрій 4
.IX Item "пристрій"
Пристрій на якому міститься файл (буде показано у форматі основний:підлеглий). Запис пристрою може не збігатися із записом пристрою, який відомий гостьовій системі.
-.IP "inode" 4
+.IP inode 4
.IX Item "inode"
Номер inode.
-.IP "nlink" 4
+.IP nlink 4
.IX Item "nlink"
Кількість жорстких посилань.
-.IP "rdev" 4
+.IP rdev 4
.IX Item "rdev"
Для блоковий і символьних спеціальних файлів пристрій (буде показано у форматі основний:підлеглий).
-.IP "блоки" 4
+.IP блоки 4
.IX Item "блоки"
Кількість 512\-байтових блоків, виділених під файл.
.PP
Якщо використано прапорець \fI\-\-checksum\fR, програма покаже контрольну суму вмісту файла (лише для звичайних файлів). Обчислення контрольної суми може бути доволі тривалою дією.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-blocksize=512\fR" 4
+Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
-.IP "\fB\-\-blocksize\fR" 4
+.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
This parameter sets the sector size of the disk image. It affects all
explicitly added subsequent disks after this parameter. Using
\&\fI\-\-blocksize\fR with no argument switches the disk sector size to the
default value which is usually 512 bytes. See also
-\&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-checksum\fR" 4
+"guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-checksum\fR 4
.IX Item "--checksum"
.PD 0
-.IP "\fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR" 4
+.IP \fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
Вивести контрольну суму вмісту звичайного файла. Без аргументу для створення контрольної суми буде використано \fImd5\fR. За допомогою аргументу ви можете визначити потрібний вам тип контрольної суми.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
-.IP "\fB\-\-csv\fR" 4
+.IP \fB\-\-csv\fR 4
.IX Item "--csv"
-Вивести результати до формату \s-1CSV\s0 (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом \*(L"НОТАТКА ЩОДО ФОРМАТУ \s-1CSV\*(R"\s0, наведеним нижче.
+Вивести результати до формату CSV (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом "НОТАТКА ЩОДО ФОРМАТУ CSV", наведеним нижче.
.IP "\fB\-d\fR гість" 4
.IX Item "-d гість"
.PD 0
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-\-echo\-keys\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-ls попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
-.IP "\fB\-\-extra\-stats\fR" 4
+.IP \fB\-\-extra\-stats\fR 4
.IX Item "--extra-stats"
Показати додаткові дані.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-format=raw|qcow2|..\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
-.IP "\fB\-\-format\fR" 4
+.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR.
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-h\fR" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
-.IP "\fB\-\-human\-readable\fR" 4
+.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
Показати розміри файлів у зручному для читання форматі.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
Визначення точки монтування вимикає інспектування гостьової системи і призводить до монтування її кореневої системи та усіх її точок монтування. Тому вам слід забезпечити монтування усіх точок монтування, потрібних для роботи із файлами, назви яких вказано як аргументи.
.Sp
-Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" і \*(L"lvs\*(R"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
+Якщо ви не знаєте, які саме файлові системи містяться у образі диска, ви можете або запустити guestfish без цього параметра і ознайомитися зі списком доступних розділів, файлових систем та логічних томів (див. команди "list-partitions", "list-filesystems" і "lvs"), або скористатися програмою \fBvirt\-filesystems\fR\|(1).
.Sp
-Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (\s-1ACL\s0) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
+Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або \f(CW\*(C`ro\*(C'\fR (другий варіант використовується, якщо використано прапорець \fI\-\-ro\fR). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (ACL) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
Використання цього прапорця є еквівалентним до використання команди \f(CW\*(C`mount\-options\*(C'\fR.
.Sp
Четвертою частиною параметра є назва драйвера файлової системи, якою слід скористатися, зокрема \f(CW\*(C`ext3\*(C'\fR або \f(CW\*(C`ntfs\*(C'\fR. У визначенні цієї частини параметра рідко виникає потреба, але вона може бути корисною, якщо для файлової системи можна скористатися декількома драйверами (приклад: \f(CW\*(C`ext2\*(C'\fR і \f(CW\*(C`ext3\*(C'\fR), або libguestfs визначає файлову систему помилково.
-.IP "\fB\-l\fR" 4
+.IP \fB\-l\fR 4
.IX Item "-l"
.PD 0
-.IP "\fB\-\-long\fR" 4
+.IP \fB\-\-long\fR 4
.IX Item "--long"
-.IP "\fB\-R\fR" 4
+.IP \fB\-R\fR 4
.IX Item "-R"
-.IP "\fB\-\-recursive\fR" 4
+.IP \fB\-\-recursive\fR 4
.IX Item "--recursive"
.PD
-Вибір режиму. Якщо не буде вказано жодного з варіантів, \f(CW\*(C`virt\-ls\*(C'\fR створює простий плоский список файлів у вказаному каталозі. Див. \*(L"ПРОСТИЙ СПИСОК\*(R".
+Вибір режиму. Якщо не буде вказано жодного з варіантів, \f(CW\*(C`virt\-ls\*(C'\fR створює простий плоский список файлів у вказаному каталозі. Див. "ПРОСТИЙ СПИСОК".
.Sp
-\&\f(CW\*(C`virt\-ls \-l\*(C'\fR створює «довгий список», у якому більше подробиць. Див. \*(L"ДОВГИЙ СПИСОК\*(R".
+\&\f(CW\*(C`virt\-ls \-l\*(C'\fR створює «довгий список», у якому більше подробиць. Див. "ДОВГИЙ СПИСОК".
.Sp
-\&\f(CW\*(C`virt\-ls \-R\*(C'\fR створює рекурсивний список файлів, починаючи з вказаного каталогу. Див. \*(L"РЕКУРСИВНИЙ СПИСОК\*(R".
+\&\f(CW\*(C`virt\-ls \-R\*(C'\fR створює рекурсивний список файлів, починаючи з вказаного каталогу. Див. "РЕКУРСИВНИЙ СПИСОК".
.Sp
-\&\f(CW\*(C`virt\-ls \-lR\*(C'\fR створює рекурсивні довгі списки, які простіше обробляти. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R".
-.IP "\fB\-\-times\fR" 4
+\&\f(CW\*(C`virt\-ls \-lR\*(C'\fR створює рекурсивні довгі списки, які простіше обробляти. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК".
+.IP \fB\-\-times\fR 4
.IX Item "--times"
Показати поля часу.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-time\-days\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-\-time\-days\fR 4
.IX Item "--time-days"
Показувати поля часу у форматі днів до поточного (від’ємні значення для днів у майбутньому).
.Sp
Зауважте, що \f(CW0\fR у виведених даних означає «менше 1 одного дня до поточного моменту» або «вік файла — від 0 до 86399 секунд».
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-time\-relative\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-\-time\-relative\fR 4
.IX Item "--time-relative"
Показувати поля часу у форматі секунд до поточного моменту (від’ємні значення для часу у майбутньому).
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-time\-t\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-\-time\-t\fR 4
.IX Item "--time-t"
-Показувати поля часу у форматі секунд з моменту початку епохи \s-1UNIX.\s0
+Показувати поля часу у форматі секунд з моменту початку епохи UNIX.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-\-uids\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-\-uids\fR 4
.IX Item "--uids"
-Показати поля \s-1UID\s0 і \s-1GID.\s0
+Показати поля UID і GID.
.Sp
-Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. \*(L"РЕКУРСИВНИЙ ДОВГИЙ СПИСОК\*(R" вище.
-.IP "\fB\-v\fR" 4
+Цей параметр працюватиме лише у режимі виведення \fI\-lR\fR. Див. "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" вище.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
З міркувань зворотної сумісності передбачено підтримку запису параметрів у застарілому форматі.
.SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
.IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
-Формат значень, які відокремлено комами (\s-1CSV\s0), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
+Формат значень, які відокремлено комами (CSV), є оманливо простим. Може \fIздатися\fR, що його просто обробляти, але насправді це зовсім не так.
.PP
Міф: достатньо розділити поля за комами. Реальність: поділ комами \fIне\fR працює у надійний спосіб. Ось приклад із двома стовпчиками:
.PP
.PP
Для скриптів командної оболонки скористайтеся \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv також є серед пакунків основних дистрибутивів Linux).
.PP
-Для інших мов програмування використовуйте бібліотеку для обробки даних \s-1CSV\s0 (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
+Для інших мов програмування використовуйте бібліотеку для обробки даних CSV (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python).
.PP
-У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних \s-1CSV.\s0
+У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних CSV.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-copy\-out\fR\|(1), \fBvirt\-diff\fR\|(1), \fBvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-make-fs 1"
-.TH virt-make-fs 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-make-fs 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-make-fs —створення файлової системи на основі архіву tar або файлів
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-make\-fs [\-\-параметри] каталог вихідний.img
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
-Virt-make-fs — інструмент командного рядка для створення файлової системи на основі архіву tar або якихось файлів у каталозі. Подібний для інструментів \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1) та \fBmksquashfs\fR\|(1). На відміну від цих інструментів він може створювати файлові системи стандартних типів, зокрема ext2/3 або \s-1NTFS,\s0 що може бути корисним, якщо ви хочете долучити ці файлові системи до наявних віртуальних машин (наприклад, щоб імпортувати великі обсяги доступних лише для читання даних до віртуальної машини).
+Virt-make-fs — інструмент командного рядка для створення файлової системи на основі архіву tar або якихось файлів у каталозі. Подібний для інструментів \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1) та \fBmksquashfs\fR\|(1). На відміну від цих інструментів він може створювати файлові системи стандартних типів, зокрема ext2/3 або NTFS, що може бути корисним, якщо ви хочете долучити ці файлові системи до наявних віртуальних машин (наприклад, щоб імпортувати великі обсяги доступних лише для читання даних до віртуальної машини).
.PP
Для створення порожніх дисків скористайтеся \fBvirt\-format\fR\|(1). Для створення складних компонувань скористайтеся \fBguestfish\fR\|(1).
.PP
\& virt\-make\-fs вхідні_дані вихідний.образ
.Ve
.PP
-де \f(CW\*(C`вхідні_дані\*(C'\fR є або каталогом, де зберігаються файли, які ви хочете додати, або архів tar (нестиснений або стиснений за допомогою gzip); а \fIвиведений.образ\fR є образом диска. Тип виведених даних визначається автоматично. Типовим виведеним образом диска є простий (raw) розріджений образ ext2, якщо ви не вкажете додаткових прапорців (див. розділ \*(L"ПАРАМЕТРИ\*(R" нижче).
+де \f(CW\*(C`вхідні_дані\*(C'\fR є або каталогом, де зберігаються файли, які ви хочете додати, або архів tar (нестиснений або стиснений за допомогою gzip); а \fIвиведений.образ\fR є образом диска. Тип виведених даних визначається автоматично. Типовим виведеним образом диска є простий (raw) розріджений образ ext2, якщо ви не вкажете додаткових прапорців (див. розділ "ПАРАМЕТРИ" нижче).
.SS "ТИП ФАЙЛОВОЇ СИСТЕМИ"
.IX Subsection "ТИП ФАЙЛОВОЇ СИСТЕМИ"
-Типовим типом файлової системи є \f(CW\*(C`ext2\*(C'\fR. Можна використовувати майже будь\-який тип файлової системи, підтримку якого передбачено у libguestfs (але \fIне\fR придатний лише для читання формат, зокрема \s-1ISO9660\s0). Ось декілька із найпоширеніших варіантів:
-.IP "\fIext3\fR" 4
+Типовим типом файлової системи є \f(CW\*(C`ext2\*(C'\fR. Можна використовувати майже будь\-який тип файлової системи, підтримку якого передбачено у libguestfs (але \fIне\fR придатний лише для читання формат, зокрема ISO9660). Ось декілька із найпоширеніших варіантів:
+.IP \fIext3\fR 4
.IX Item "ext3"
Зауважте, що у файлових системах ext3 міститься журнал із типовим розміром 1\-32 МБ. Якщо ви не збираєтеся використовувати файлову систему у спосіб, який потребує журналу, цей журнал є лише непотрібним доповненням файлової системи.
.IP "\fIntfs\fR або \fIvfat\fR" 4
.IX Item "ntfs або vfat"
Корисно, якщо дані експортуються до гостьової системи Windows.
-.IP "\fIminix\fR" 4
+.IP \fIminix\fR 4
.IX Item "minix"
Менша зайва витрата місця за \f(CW\*(C`ext2\*(C'\fR, але є певні обмеження щодо довжини назви файла і загального розміру файлової системи.
.PP
\fIПРИКЛАД\fR
.IX Subsection "ПРИКЛАД"
.PP
-Додавання розділу \s-1MBR:\s0
+Додавання розділу MBR:
.PP
.Vb 1
\& virt\-make\-fs \-\-partition \-\- input образ.img
.Ve
.PP
-Якщо виведений образ диска може бути розміром у терабайт або більше, краще скористатися сумісною із \s-1EFI/GPT\s0 таблицею розділів:
+Якщо виведений образ диска може бути розміром у терабайт або більше, краще скористатися сумісною із EFI/GPT таблицею розділів:
.PP
.Vb 1
\& virt\-make\-fs \-\-partition=gpt \-\-size=+4T \-\-format=qcow2 input диск.img
.Vb 1
\& virt\-make\-fs \-\-format=qcow2 \-\-size=+200M input output.img
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
-.IP "\fB\-\-blocksize=512\fR" 4
+.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
-.IP "\fB\-\-blocksize=4096\fR" 4
+.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
.PD
This parameter sets the sector size of the output disk image.
.Sp
The default is \f(CW512\fR bytes.
.Sp
-See also \*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3).
-.IP "\fB\-\-floppy\fR" 4
+See also "guestfs_add_drive_opts" in \fBguestfs\fR\|(3).
+.IP \fB\-\-floppy\fR 4
.IX Item "--floppy"
Створити віртуальну дискету.
.Sp
-У поточній версії буде попередньо вибрано розмір (1440 кБ), тип розділу (\s-1MBR\s0) і тип файлової системи (\s-1VFAT\s0). У майбутньому також може бути вибрано геометрію.
-.IP "\fB\-\-size=\fRN" 4
+У поточній версії буде попередньо вибрано розмір (1440 кБ), тип розділу (MBR) і тип файлової системи (VFAT). У майбутньому також може бути вибрано геометрію.
+.IP \fB\-\-size=\fRN 4
.IX Item "--size=N"
.PD 0
-.IP "\fB\-\-size=+\fRN" 4
+.IP \fB\-\-size=+\fRN 4
.IX Item "--size=+N"
.IP "\fB\-s\fR N" 4
.IX Item "-s N"
Щоб лишити на диску зайве місце, вкажіть \f(CW\*(C`+\*(C'\fR (символ «плюс») із числовим значенням та суфіксом b/K/M/G/T/P/E , який позначає байти, кілобайти, мегабайти, гігабайти, терабайти, петабайти або ексабайти. Наприклад, \fI\-\-size=+200M\fR означає «достатньо місця для вхідних файлів та (приблизно) зайві 200 МБ вільного місця».
.Sp
Зауважте, що virt-make-fs estimates використовує оцінки вільного місця на диску, тому створені програмою файлові системи не міститимуть рівно стільки вільного місця, скільки ви вкажете. (Створення файлової системи, яка міститиме рівно стільки місця, скільки було вказано користувачем, є доволі складним і тривалим завданням.)
-.IP "\fB\-\-format=\fRФОРМАТ" 4
+.IP \fB\-\-format=\fRФОРМАТ 4
.IX Item "--format=ФОРМАТ"
.PD 0
.IP "\fB\-F\fR ФОРМАТ" 4
Вибрати формат образу диска\-результату.
.Sp
Типовимт є \f(CW\*(C`raw\*(C'\fR (простий розріджений образ диска).
-.IP "\fB\-\-type=\fRФС" 4
+.IP \fB\-\-type=\fRФС 4
.IX Item "--type=ФС"
.PD 0
.IP "\fB\-t\fR ФС" 4
Типовим значенням є \f(CW\*(C`ext2\*(C'\fR.
.Sp
Тут можна скористатися будь\-якою файловою системою, підтримку читання і запису для якої передбачено у libguestfs.
-.IP "\fB\-\-label=\fRМІТКА" 4
+.IP \fB\-\-label=\fRМІТКА 4
.IX Item "--label=МІТКА"
Встановити мітку файлової системи.
-.IP "\fB\-\-partition\fR" 4
+.IP \fB\-\-partition\fR 4
.IX Item "--partition"
.PD 0
.IP "\fB\-\-partition=\fRТИП РОЗДІЛУ" 4
.IX Item "--partition=ТИП РОЗДІЛУ"
.PD
-Якщо його вказано, цей прапорець додає таблицю розділів \s-1MBR\s0 на виведений програмою образ диска.
+Якщо його вказано, цей прапорець додає таблицю розділів MBR на виведений програмою образ диска.
.Sp
Ви можете змінити тип таблиці розділів, наприклад, вказати \fI\-\-partition=gpt\fR для великих дисків.
.Sp
-Для \s-1MBR\s0 virt-make-fs встановлює значення байта типу розділу автоматично.
-.IP "\fB\-v\fR" 4
+Для MBR virt-make-fs встановлює значення байта типу розділу автоматично.
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути виведення діагностичних даних.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування libguestfs.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfish\fR\|(1), \fBvirt\-format\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-tar\-in\fR\|(1), \fBmkisofs\fR\|(1), \fBgenisoimage\fR\|(1), \fBmksquashfs\fR\|(1), \fBmke2fs\fR\|(8), \fBresize2fs\fR\|(8), \fBguestfs\fR\|(3), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-resize 1"
-.TH virt-resize 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-resize 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-resize — програма для зміни розмірів дисків віртуальної машини
.SH "КОРОТКИЙ ОПИС"
\& [\-\-expand /dev/sdaN] [\-\-shrink /dev/sdaN]
\& [\-\-ignore /dev/sdaN] [\-\-delete /dev/sdaN] [...] вхідний_диск вихідний_диск
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Virt-resize — програма, за допомогою якої можна змінити розміри диска віртуальної машини, зробивши його більшим або меншим чи змінивши розміри розділів, які містяться на диску, або вилучивши їх.
.PP
Virt-resize \fBне може\fR змінювати розмір образів дисків «на місці». Virt-resize \fBне слід\fR використовувати для активних віртуальних машин — щоб отримати належний результат, перш ніж змінювати розміри дисків, зупиніть роботу віртуальної машини.
.PP
Якщо ви ще не знайомі з принципами роботи пов'язаних інструментів, \fBvirt\-filesystems\fR\|(1) і \fBvirt\-df\fR\|(1), рекомендуємо вам спершу ознайомитися із документацією щодо цих інструментів.
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
-.IP "1." 4
+.IP 1. 4
У цьому прикладі ми візьмемо \f(CW\*(C`старий_диск\*(C'\fR, змінимо його розміри і запишемо як \f(CW\*(C`новий_диск\*(C'\fR, розширивши один із розділів гостьової системи на додаткові 5 ГБ:
.Sp
.Vb 1
\& # Зауважте, що «/dev/sda2» є розділом у у файлі «старий_диск».
\& virt\-resize \-\-expand /dev/sda2 старий_диск новий_диск
.Ve
-.IP "2." 4
+.IP 2. 4
Те саме, що і вище, але зі збільшенням розділу /boot на 200 МБ, з наданням решти місця для /dev/sda2:
.Sp
.Vb 2
\& virt\-resize \-\-resize /dev/sda1=+200M \-\-expand /dev/sda2 \e
\& старий_диск новий_диск
.Ve
-.IP "3." 4
-Як у першому прикладі, але із розширенням логічного тому на останньому кроці. Саме цю команду типово використовують для гостьових систем Linux, де використовується \s-1LVM:\s0
+.IP 3. 4
+Як у першому прикладі, але із розширенням логічного тому на останньому кроці. Саме цю команду типово використовують для гостьових систем Linux, де використовується LVM:
.Sp
.Vb 2
\& virt\-resize \-\-expand /dev/sda2 \-\-LV\-expand /dev/vg_guest/lv_root \e
\& старий_диск новий_диск
.Ve
-.IP "4." 4
+.IP 4. 4
Як у першому прикладі, але дані буде виведено у форматі qcow2, а не у простому (raw) форматі:
.Sp
.Vb 2
.Sp
Ця команда просто копіює образ диска \f(CW\*(C`indisk\*(C'\fR до образу диска \f(CW\*(C`outdisk\*(C'\fR \fIбез\fR зміни розмірів або будь\-яких змін у наявних розділах. Якщо диск \f(CW\*(C`outdisk\*(C'\fR є завеликим для даних, створюється додатковий порожній розділ наприкінці диска, розмір якого відповідатиме зайвому місцю. Якщо диск \f(CW\*(C`outdisk\*(C'\fR виявиться замалим, програма повідомить про помилку.
.Sp
-Реалістичнішим буде варіант, коли вам потрібно розширити наявні розділи на образі диска передаванням додаткових параметрів (повний список параметрів наведено у розділі \*(L"ПАРАМЕТРИ\*(R" нижче).
+Реалістичнішим буде варіант, коли вам потрібно розширити наявні розділи на образі диска передаванням додаткових параметрів (повний список параметрів наведено у розділі "ПАРАМЕТРИ" нижче).
.Sp
-\&\*(L"\-\-expand\*(R" є найкориснішим параметром. За його допомогою можна розширити вказаний за назвою розділ на диску так, щоб він зайняв усе зайве місце:
+"\-\-expand" є найкориснішим параметром. За його допомогою можна розширити вказаний за назвою розділ на диску так, щоб він зайняв усе зайве місце:
.Sp
.Vb 1
\& # virt\-resize \-\-expand /dev/sda2 indisk outdisk
.Sp
(У цьому випадку наприкінці диска \fIне\fR створюватиметься додаткових розділів, оскільки невикористаного місця просто не буде).
.Sp
-\&\*(L"\-\-resize\*(R" — ще один широковживаний параметр. Наступна команда збільшить розмір /dev/sda1 на 200 МБ і розширить /dev/sda2 так, щоб той заповнив решту доступного місця:
+"\-\-resize" — ще один широковживаний параметр. Наступна команда збільшить розмір /dev/sda1 на 200 МБ і розширить /dev/sda2 так, щоб той заповнив решту доступного місця:
.Sp
.Vb 2
\& # virt\-resize \-\-resize /dev/sda1=+200M \-\-expand /dev/sda2 \e
\& indisk outdisk
.Ve
.Sp
-Якщо на розширюваному розділі у образі міститься файлова система або фізичний том \s-1LVM,\s0 тоді, якщо virt-resize відомий спосіб, програма змінить розміри вмісту так, як це роблять виклики команд \fBpvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8) або \fBresize.f2fs\fR\|(8). Втім, virt-resize не відомі способи зміни розмірів деяких файлових систем, тому вам доведеться якось змінювати їхні розміри після завантаження гостьової системи.
+Якщо на розширюваному розділі у образі міститься файлова система або фізичний том LVM, тоді, якщо virt-resize відомий спосіб, програма змінить розміри вмісту так, як це роблять виклики команд \fBpvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8) або \fBresize.f2fs\fR\|(8). Втім, virt-resize не відомі способи зміни розмірів деяких файлових систем, тому вам доведеться якось змінювати їхні розміри після завантаження гостьової системи.
.Sp
.Vb 1
\& # virt\-resize \-\-expand /dev/sda2 nbd://example.com outdisk
.Ve
.Sp
-Диском із вхідними даними може бути адреса, якщо як джерело слід використати віддалений диск. Формат адреси є сумісним із guestfish. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
+Диском із вхідними даними може бути адреса, якщо як джерело слід використати віддалений диск. Формат адреси є сумісним із guestfish. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
.Sp
Інші параметри описано нижче.
.IP "6. Перевірка" 4
.IX Item "6. Перевірка"
Виконайте належне тестування нового образу диска, \fIперш ніж\fR витирати старий.
.Sp
-Якщо ви користуєтеся libvirt, внесіть зміни до \s-1XML\s0 так, щоб він вказував на новий диск:
+Якщо ви користуєтеся libvirt, внесіть зміни до XML так, щоб він вказував на новий диск:
.Sp
.Vb 1
\& # virsh edit назва_гостьової_системи
\& # virsh start назва_гостьової_системи
.Ve
.Sp
-і перевірте, чи все лишається працездатним. Див. також додаткові зауваження у розділі \*(L"ПРИМІТКИ\*(R" нижче.
+і перевірте, чи все лишається працездатним. Див. також додаткові зауваження у розділі "ПРИМІТКИ" нижче.
.IP "7. Зміна розмірів логічних томів та інших сховищ у гостьовій системі" 4
.IX Item "7. Зміна розмірів логічних томів та інших сховищ у гостьовій системі"
(Це завдання можна виконати без завантаження гостьової системи за допомогою \fBguestfish\fR\|(1))
.SS "ІГНОРУВАННЯ І ВИЛУЧЕННЯ РОЗДІЛІВ"
.IX Subsection "ІГНОРУВАННЯ І ВИЛУЧЕННЯ РОЗДІЛІВ"
Крім того, virt-resize надає вам зручний спосіб ігнорувати або вилучати розділи при копіюванні з диска вхідних даних на диск вихідних даних. Ігнорування розділу пришвидшує копіювання там, де вам все одно що станеться із наявним вмістом розділу. Вилучення розділу вилучає його повністю, але зауважте, що це також призводить до перенумерування усіх розділів після вилучено, що може призвести до неможливості завантаження деяких гостьових систем.
-.SS "\s-1QCOW2\s0 І НЕРОЗРІДЖЕНІ ФОРМАТИ \s-1RAW\s0"
+.SS "QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW"
.IX Subsection "QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW"
Якщо дисх вхідних даних записано у форматі qcow2, ймовірно, варто записати вихідні дані теж у форматі qcow2. Крім того, virt-resize може перетворювати дані з одного формату на інший «на льоту». Формат виведених даних просто визначається форматом порожнього контейнера для виведення даних, який ви надасте. Таким чином, щоб записати виведені дані у форматі qcow2, скористайтеся такою командою:
.PP
(у застарілих системах, де немає команди \fBfallocate\fR\|(1), скористайтеся командою \f(CW\*(C`dd if=/dev/zero of=outdisk bs=1M count=..\*(C'\fR)
.SS "ЛОГІЧНІ РОЗДІЛИ"
.IX Subsection "ЛОГІЧНІ РОЗДІЛИ"
-Розміри логічних розділів (тобто \fI/dev/sda5+\fR на дисках із таблицею розділів \s-1DOS\s0) не може бути змінено.
+Розміри логічних розділів (тобто \fI/dev/sda5+\fR на дисках із таблицею розділів DOS) не може бути змінено.
.PP
-Щоб розібратися у тому, що відбувається, по\-перше, слід пам'ятати, що один із чотирьох розділів \fI/dev/sda1\-4\fR матиме тип розділу \s-1MBR\s0 \f(CW05\fR або \f(CW\*(C`0f\*(C'\fR. Такий розділ називається \fBрозширеним розділом\fR. Для перегляду типу розділу \s-1MBR\s0 скористайтеся \fBvirt\-filesystems\fR\|(1).
+Щоб розібратися у тому, що відбувається, по\-перше, слід пам'ятати, що один із чотирьох розділів \fI/dev/sda1\-4\fR матиме тип розділу MBR \f(CW05\fR або \f(CW\*(C`0f\*(C'\fR. Такий розділ називається \fBрозширеним розділом\fR. Для перегляду типу розділу MBR скористайтеся \fBvirt\-filesystems\fR\|(1).
.PP
Логічні розділи містяться у розширеному розділі.
.PP
Розширений розділ може бути збільшено, але не може бути зменшено (це можна зробити у примусовому режимі, але ми не радимо так робити). При копіюванні розширеного розділу неявним чином копіюються усі логічні розділи, які на ньому містяться. Virt-resize не зазирає до розширеного розділу, отже сліпо копіює логічні розділи.
.PP
Вказати логічний розділ (\fI/dev/sda5+\fR) у рядку команди не можна. Якщо ви це зробите, програма повідомить про помилку.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати довідкове повідомлення.
.IP "\fB\-\-align\-first\fR \fBauto\fR" 4
.RE
.RS 4
.RE
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
-.IP "\fB\-d\fR" 4
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
+.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
-.IP "\fB\-\-debug\fR" 4
+.IP \fB\-\-debug\fR 4
.IX Item "--debug"
.PD
(Застарілий: використовуйте замість нього \fI\-v\fR)
.IX Item "--expand РОЗДІЛ"
Розширити вказаний за назвою розділ так, щоб він зайняв усе вільне місце (місце, яке лишатиметься вільним після усіх інших вказаних вами змін у розмірах).
.Sp
-Якщо virt-resize відомий спосіб, програма розширить безпосередній вміст розділу. Наприклад, якщо розділ є фізичним томом \s-1LVM,\s0 програма розширить фізичний том так, щоб він зайняв усе місце (подібно до виклику \fBpvresize\fR\|(8)). Якщо спосіб розширення виявиться невідомим virt-resize, програма не чіпатиме вмісту розділу.
+Якщо virt-resize відомий спосіб, програма розширить безпосередній вміст розділу. Наприклад, якщо розділ є фізичним томом LVM, програма розширить фізичний том так, щоб він зайняв усе місце (подібно до виклику \fBpvresize\fR\|(8)). Якщо спосіб розширення виявиться невідомим virt-resize, програма не чіпатиме вмісту розділу.
.Sp
У поточній версії virt-resize може змінювати розміри таких файлових систем:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Файлових систем ext2, ext3 і ext4.
-.IP "\(bu" 4
-Файлових систем \s-1NTFS,\s0 якщо libguestfs було зібрано з підтримкою \s-1NTFS.\s0
+.IP \(bu 4
+Файлових систем NTFS, якщо libguestfs було зібрано з підтримкою NTFS.
.Sp
Роботу файлової системи під час її останнього використання має бути завершено у штатному режимі. Крім того, \fBntfsresize\fR\|(8) позначає файлові системи зі зміненими розмірами як такі, що потребують перевірки, отже під час першого наступного запуску Windows на розділі зі зміненим розміром буде виконано перевірку диска.
-.IP "\(bu" 4
-Фізичні томи \s-1LVM.\s0 Зазвичай, virt-resize не змінює розміри вмісту фізичних томів, втім, див. параметр \fI\-\-LV\-expand\fR. Користувач також може змінити розміри логічних томів бажаним чином після завантаження системи.
-.IP "\(bu" 4
+.IP \(bu 4
+Фізичні томи LVM. Зазвичай, virt-resize не змінює розміри вмісту фізичних томів, втім, див. параметр \fI\-\-LV\-expand\fR. Користувач також може змінити розміри логічних томів бажаним чином після завантаження системи.
+.IP \(bu 4
Файлові системи btrfs, якщо libguestfs було зібрано із підтримкою btrfs.
-.IP "\(bu" 4
-Файлові системи \s-1XFS,\s0 якщо libguestfs було зібрано із підтримкою \s-1XFS.\s0
-.IP "\(bu" 4
+.IP \(bu 4
+Файлові системи XFS, якщо libguestfs було зібрано із підтримкою XFS.
+.IP \(bu 4
Розділи резервної пам'яті на диску Linux.
.Sp
Будь ласка, зауважте, що libguestfs \fIзнищує\fR наявний вміст розділу резервної пам'яті на диску, відтворюючи його за допомогою \f(CW\*(C`mkswap\*(C'\fR, тому такі розділи не слід використовувати, якщо гостьова система присипляється.
-.IP "\(bu" 4
+.IP \(bu 4
Файлові системи f2fs, якщо libguestfs було зібрано із підтримкою f2fs.
.RE
.RS 4
.Sp
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
.Sp
-Зауважте, що цей параметр \fIне\fR впливає на формат виведених даних. Див. \*(L"\s-1QCOW2\s0 І НЕРОЗРІДЖЕНІ ФОРМАТИ \s-1RAW\*(R"\s0.
+Зауважте, що цей параметр \fIне\fR впливає на формат виведених даних. Див. "QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW".
.IP "\fB\-\-ignore\fR РОЗДІЛ" 4
.IX Item "--ignore РОЗДІЛ"
Ігнорувати вказаний за назвою розділ. По суті, це означає, що розділ розміщується на диску призначення, але його вміст з початкового диска не копіюється. Розділ лишатиметься порожнім (заповненим нулями).
Цей параметр можна вказувати декілька разів.
.IP "\fB\-\-LV\-expand\fR ЛОГІЧНИЙ_ТОМ" 4
.IX Item "--LV-expand ЛОГІЧНИЙ_ТОМ"
-Цій команді передається логічний том і, як останній крок, вона розширює цей том так, щоб він зайняв усе вільне місце, яке доступне у групі томів. Типовим використанням, якщо припускати, що ви працюєте із гостьовою системою Linux із єдиним фізичним томом \s-1PV\s0 \fI/dev/sda2\fR і кореневим пристроєм із назвою \fI/dev/vg_guest/lv_root\fR, є:
+Цій команді передається логічний том і, як останній крок, вона розширює цей том так, щоб він зайняв усе вільне місце, яке доступне у групі томів. Типовим використанням, якщо припускати, що ви працюєте із гостьовою системою Linux із єдиним фізичним томом PV \fI/dev/sda2\fR і кореневим пристроєм із назвою \fI/dev/vg_guest/lv_root\fR, є:
.Sp
.Vb 2
\& virt\-resize indisk outdisk \e
Скористайтеся \fBvirt\-filesystems\fR\|(1) для отримання списку файлових систем у гостьовій системі.
.Sp
Ви можете вказати у одній команді цей параметр декілька разів, \fIале\fR сенсу у цьому небагато, хіба що вказані вами логічні томи належать до різних груп томів.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=формат" 4
+.IP \fB\-\-machine\-readable\fR=формат 4
.IX Item "--machine-readable=формат"
.PD
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. \*(L"ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" нижче.
-.IP "\fB\-n\fR" 4
+За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" нижче.
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
Вивести резюме щодо дій, але не виконувати ці дії.
-.IP "\fB\-\-no\-copy\-boot\-loader\fR" 4
+.IP \fB\-\-no\-copy\-boot\-loader\fR 4
.IX Item "--no-copy-boot-loader"
-Типово, virt-resize копіює деякі сектори на початку диска (аж до початку першого розділу). Найчастіше, у цих секторах міститься Master Boot Record (\s-1MBR\s0) та завантажувач. Вони потрібні для того, щоб гостьова система завантажувалася належним чином.
+Типово, virt-resize копіює деякі сектори на початку диска (аж до початку першого розділу). Найчастіше, у цих секторах міститься Master Boot Record (MBR) та завантажувач. Вони потрібні для того, щоб гостьова система завантажувалася належним чином.
.Sp
Якщо ви вкажете цей прапорець, це початкове копіювання не виконуватиметься. У цьому випадку може виникнути потреба у перевстановленні завантажувача.
-.IP "\fB\-\-no\-extra\-partition\fR" 4
+.IP \fB\-\-no\-extra\-partition\fR 4
.IX Item "--no-extra-partition"
Типово, virt-resize створює додатковий розділ, якщо буде виявлено зайве невикористане місце після усіх змін розмірів. Скористайтеся цим параметром для того, щоб запобігти створенню цього додаткового розділу. Якщо ви так зробите, зайве місце буде недоступним, аж доки ви не запустите fdisk, parted або якийсь інший інструмент поділу на розділи у гостьовій системі.
.Sp
Зауважте, що якщо зайвого місця виявиться менше за 10 МБ, додатковий розділ не створюватиметься.
-.IP "\fB\-\-no\-expand\-content\fR" 4
+.IP \fB\-\-no\-expand\-content\fR 4
.IX Item "--no-expand-content"
Типово, virt-resize намагатиметься розширити безпосередній вміст розділів, якщо програмі відомий спосіб виконати таке розширення (див. параметр \fI\-\-expand\fR вище).
.Sp
Якщо ви вкажете параметр \fI\-\-no\-expand\-content\fR, virt-resize не виконуватиме таких спроб.
-.IP "\fB\-\-no\-sparse\fR" 4
+.IP \fB\-\-no\-sparse\fR 4
.IX Item "--no-sparse"
-Вимкнути розріджене копіювання. Див. \*(L"РОЗРІДЖЕНЕ КОПІЮВАННЯ\*(R" нижче.
-.IP "\fB\-\-ntfsresize\-force\fR" 4
+Вимкнути розріджене копіювання. Див. "РОЗРІДЖЕНЕ КОПІЮВАННЯ" нижче.
+.IP \fB\-\-ntfsresize\-force\fR 4
.IX Item "--ntfsresize-force"
-Передавання параметра \fI\-\-force\fR до \fBntfsresize\fR\|(8) уможливить зміну розмірів, навіть якщо диск \s-1NTFS\s0 буде позначено як такий, що потребує перевірки коректності. Вам доведеться скористатися цим параметром, якщо ви хочете змінити розміри гостьової системи Windows без потреби у завантаженні Windows кожного разу між командами зміни розмірів.
+Передавання параметра \fI\-\-force\fR до \fBntfsresize\fR\|(8) уможливить зміну розмірів, навіть якщо диск NTFS буде позначено як такий, що потребує перевірки коректності. Вам доведеться скористатися цим параметром, якщо ви хочете змінити розміри гостьової системи Windows без потреби у завантаженні Windows кожного разу між командами зміни розмірів.
.IP "\fB\-\-output\-format\fR \fBraw\fR" 4
.IX Item "--output-format raw"
Визначає формат виведеного образу диска. Якщо цей прапорець не вказано, формат буде автоматично визначено на основі даних щодо образу диска.
.Sp
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
.Sp
-Зауважте, що цей параметр \fIне створює\fR образ диска у визначеному форматі. Цей параметр призначено лише для того, щоб libguestfs не намагалася вгадати формат. Створити диск у належному форматі маєте ви самі. Див. \*(L"\s-1QCOW2\s0 І НЕРОЗРІДЖЕНІ ФОРМАТИ \s-1RAW\*(R"\s0.
-.IP "\fB\-q\fR" 4
+Зауважте, що цей параметр \fIне створює\fR образ диска у визначеному форматі. Цей параметр призначено лише для того, щоб libguestfs не намагалася вгадати формат. Створити диск у належному форматі маєте ви самі. Див. "QCOW2 І НЕРОЗРІДЖЕНІ ФОРМАТИ RAW".
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Не виводити резюме.
.Sp
Використання параметра \fI\-\-unknown\-filesystems error\fR призведе до того, що virt-resize повідомлятиме про помилку, якщо виявить файлову систему, розміри якої не можна збільшити.
.Sp
-Див. також \*(L"unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV\*(R"\s0.
-.IP "\fB\-v\fR" 4
+Див. також "unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV".
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути показ діагностичних повідомлень.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ"
По\-друге, можна скористатися цим параметром у поєднанні із іншими параметрами для того, щоб зробити звичайні виведені програмою дані придатнішими для подальшої машинної обробки.
.PP
У поточній версії це означає таке:
-.IP "1." 4
+.IP 1. 4
Повідомлення смужки поступу можна обробляти зі стандартного виведення, шукаючи їх за таким формальним виразом:
.Sp
.Vb 1
\& ^[0\-9]+/[0\-9]+$
.Ve
-.IP "2." 4
+.IP 2. 4
Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до стандартного виведення, (окрім повідомлень смужки поступу) як повідомлення щодо стану. Ці повідомлення може бути записано до журналу і/або показано користувачеві.
-.IP "3." 4
+.IP 3. 4
Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до stderr як повідомлення про помилки. Крім того, virt-resize завершує роботу із ненульовим кодом стану, якщо станеться критична помилка.
.PP
У версіях програми до 1.13.9 не передбачено використання параметра \fI\-\-machine\-readable\fR. Якщо цей параметр буде використано для такої версії, програма поверне повідомлення про помилку.
.PP
-Можна вказати рядок форматування для керування виведенням, див. \*(L"РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" in \fBguestfs\fR\|(3).
-.SH "ПРИМІТКИ"
+Можна вказати рядок форматування для керування виведенням, див. "РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" in \fBguestfs\fR\|(3).
+.SH ПРИМІТКИ
.IX Header "ПРИМІТКИ"
.SS "«Розділ 1 не закінчується на межі циліндра.»"
.IX Subsection "«Розділ 1 не закінчується на межі циліндра.»"
-Virt-resize вирівнює розділи на позиції, кратні до 128 секторів (див. параметр \fI\-\-alignment\fR). Зазвичай, це означає, що розділи не буде вирівняно за давньою геометрією \s-1CHS\s0 (циліндр\-голівка\-сектор). Втім, геометрія \s-1CHS\s0 не має сенсу для дисків, які вироблено після ранніх 1990\-х, і зовсім не має сенсу для віртуальних жорстких дисків. Вирівнювання розділів за циліндрами не є вимогою жодної сучасної операційної системи.
+Virt-resize вирівнює розділи на позиції, кратні до 128 секторів (див. параметр \fI\-\-alignment\fR). Зазвичай, це означає, що розділи не буде вирівняно за давньою геометрією CHS (циліндр\-голівка\-сектор). Втім, геометрія CHS не має сенсу для дисків, які вироблено після ранніх 1990\-х, і зовсім не має сенсу для віртуальних жорстких дисків. Вирівнювання розділів за циліндрами не є вимогою жодної сучасної операційної системи.
.SS "ЗАВАНТАЖЕННЯ ГОСТЬОВОЇ СИСТЕМИ ЗУПИНЯЄТЬСЯ НА «GRUB»"
.IX Subsection "ЗАВАНТАЖЕННЯ ГОСТЬОВОЇ СИСТЕМИ ЗУПИНЯЄТЬСЯ НА «GRUB»"
Якщо гостьова система Linux не завантажується після зміни розміру, і завантаження зупиняється після виведення слова \f(CW\*(C`GRUB\*(C'\fR до консолі, спробуйте перевстановити grub.
.Ve
.PP
Для гнучкішого переналаштовування гостьової системи, зокрема випадків, коли вам потрібно вказати інші параметри grub-install, скористайтеся \fBvirt\-rescue\fR\|(1).
-.SS "ЗМІНА РОЗМІРІВ ЗАВАНТАЖУВАЛЬНИХ РОЗДІЛІВ \s-1WINDOWS\s0"
+.SS "ЗМІНА РОЗМІРІВ ЗАВАНТАЖУВАЛЬНИХ РОЗДІЛІВ WINDOWS"
.IX Subsection "ЗМІНА РОЗМІРІВ ЗАВАНТАЖУВАЛЬНИХ РОЗДІЛІВ WINDOWS"
У Windows Vista і новіших версіях компанія Microsoft перейшла до використання окремого розділу завантаження. У віртуальних машинах із цими операційними системами, типово, \fI/dev/sda1\fR є розділом завантаження, а \fI/dev/sda2\fR є основним диском (C:). Зміна розмірів першого розділу (розділу завантаження) спричиняє помилку завантажувача \f(CW0xC0000225\fR. Зміна розмірів другого розділу (тобто диска C:) має працювати.
-.SS "\s-1WINDOWS CHKDSK\s0"
+.SS "WINDOWS CHKDSK"
.IX Subsection "WINDOWS CHKDSK"
-Диск Windows, на якому використовується \s-1NTFS,\s0 має бути коректним, перш ніж virt-resize зможе ним скористатися. Якщо спроба виконати дію ntfsresize завершиться повідомленням про помилку, спробуйте завантажити початкову віртуальну машину і запустіть \f(CW\*(C`chkdsk /f\*(C'\fR для усіх розділів \s-1NTFS,\s0 потім завершіть роботу віртуальної машини у штатний спосіб. Докладнішу інформацію наведено тут: https://bugzilla.redhat.com/show_bug.cgi?id=975753
+Диск Windows, на якому використовується NTFS, має бути коректним, перш ніж virt-resize зможе ним скористатися. Якщо спроба виконати дію ntfsresize завершиться повідомленням про помилку, спробуйте завантажити початкову віртуальну машину і запустіть \f(CW\*(C`chkdsk /f\*(C'\fR для усіх розділів NTFS, потім завершіть роботу віртуальної машини у штатний спосіб. Докладнішу інформацію наведено тут: https://bugzilla.redhat.com/show_bug.cgi?id=975753
.PP
-\&\fIПісля зміни розмірів\fR Windows може ініціювати тривалу обробку chkdsk при першому завантаженні, якщо було розширено розділи \s-1NTFS.\s0 Це усього лише для забезпечення надійного зберігання даних, і (якщо не буде знайдено помилок) ви можете бути спокійні.
-.SS "СИНІЙ ЕКРАН СМЕРТІ \s-1UNMOUNTABLE_BOOT_VOLUME\s0 У \s-1WINDOWS\s0"
+\&\fIПісля зміни розмірів\fR Windows може ініціювати тривалу обробку chkdsk при першому завантаженні, якщо було розширено розділи NTFS. Це усього лише для забезпечення надійного зберігання даних, і (якщо не буде знайдено помилок) ви можете бути спокійні.
+.SS "СИНІЙ ЕКРАН СМЕРТІ UNMOUNTABLE_BOOT_VOLUME У WINDOWS"
.IX Subsection "СИНІЙ ЕКРАН СМЕРТІ UNMOUNTABLE_BOOT_VOLUME У WINDOWS"
Після приготування системи гостьової операційної системи Windows із наступною зміною її розміру за допомогою virt-resize ви можете отримати непридатну до завантаження систему, яка показуватиме синій екран смерті із помилкою \f(CW\*(C`UNMOUNTABLE_BOOT_VOLUME\*(C'\fR. Цю помилку спричинено наявністю рядка \f(CW\*(C`ExtendOemPartition=1\*(C'\fR у файлі sysprep.inf. Якщо вилучити цей рядок до обробки sysprep, проблема зникає.
-.SS "\s-1WINDOWS 8\s0"
+.SS "WINDOWS 8"
.IX Subsection "WINDOWS 8"
-«Швидкий запуск» Windows 8 може заважати virt-resize змінювати розмір розділів \s-1NTFS.\s0 Див. \*(L"ПРИСИПЛЯННЯ \s-1WINDOWS\s0 ТА ШВИДКИЙ ЗАПУСК \s-1WINDOWS 8\*(R"\s0 in \fBguestfs\fR\|(3).
+«Швидкий запуск» Windows 8 може заважати virt-resize змінювати розмір розділів NTFS. Див. "ПРИСИПЛЯННЯ WINDOWS ТА ШВИДКИЙ ЗАПУСК WINDOWS 8" in \fBguestfs\fR\|(3).
.SS "РОЗРІДЖЕНЕ КОПІЮВАННЯ"
.IX Subsection "РОЗРІДЖЕНЕ КОПІЮВАННЯ"
Вам слід створити новий, заповнений нулями образ диска призначення, який використовуватиме virt-resize.
.PP
Virt-resize типово виконує розріджене копіювання. Це означає, що програма не копіює ті блоки з початкового диска, які заповнено лише нулями. Це підвищує швидкість та ефективність роботи, але може призвести до некоректних результатів, якщо на образі диска призначення є незанулені дані.
.PP
-В основному, така проблема виникає, якщо образом призначення є розділ основної системи (наприклад, \f(CW\*(C`virt\-resize source.img /dev/sda4\*(C'\fR), оскільки звичайні інструменти поділу диска на розділи лишають недоторканними усі дані, які раніше зберігалися на диску.
+В основному, така проблема виникає, якщо образом призначення є розділ основної системи (наприклад, \f(CW\*(C`virt\-resize\ source.img\ /dev/sda4\*(C'\fR), оскільки звичайні інструменти поділу диска на розділи лишають недоторканними усі дані, які раніше зберігалися на диску.
.PP
Якщо ви змушені використатися образ призначення, на якому вже зберігалися дані, вам слід скористатися параметром \fI\-\-no\-sparse\fR. Зауважте, що це значно уповільнить роботу програми.
-.ie n .SS """unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV""\s0"
-.el .SS "``unknown/unavailable method for expanding the \s-1TYPE\s0 filesystem on \s-1DEVICE/LV''\s0"
-.IX Subsection "unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"
+.SS """unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"""
+.IX Subsection """unknown/unavailable method for expanding the TYPE filesystem on DEVICE/LV"""
Virt-resize було наказано розширити розділ або логічний том, на якому міститься файлова система типу \f(CW\*(C`TYPE\*(C'\fR, але програмі недоступний або невідомий спосіб розширення цієї файлової системи.
.PP
Причиною може бути будь\-що із наведеного нижче:
-.IP "1." 4
+.IP 1. 4
Відповідна файлова система недоступна у libguestfs, оскільки у основній системі немає належного пакунка із інструментами для роботи з цією файловою системою. Таке, зазвичай, трапляється із файловими системами \f(CW\*(C`btrfs\*(C'\fR, \f(CW\*(C`ntfs\*(C'\fR, \f(CW\*(C`xfs\*(C'\fR та \f(CW\*(C`f2fs\*(C'\fR.
.Sp
Спробуйте такі команди:
.Ve
.Sp
У цьому випадку достатньо встановити належні пакунки із підтримкою файлових систем. Наприклад, достатньо встановити \f(CW\*(C`libguestfs\-xfs\*(C'\fR у Red Hat Enterprise Linux, CentOS, Debian, Ubuntu та дистрибутивах, які від них походять, щоб можна було працювати із файловою системою \f(CW\*(C`xfs\*(C'\fR.
-.IP "2." 4
+.IP 2. 4
У virt-resize не передбачено підтримки розширення цього типу файлових систем.
.Sp
У цьому випадку нічого не поробиш: virt-resize не зможе розширити файлову систему цього типу.
.IX Header "АЛЬТЕРНАТИВНІ ІНСТРУМЕНТИ"
Існує декілька пропрієтарних інструментів для зміни розмірів розділів. Тут ми не будемо згадувати назви жодного з таких інструментів.
.PP
-\&\fBparted\fR\|(8) і її графічний інтерфейс, gparted, можуть виконувати певні типи дій із зміни розміру образів дисків. Ці програми можуть змінювати розмір і пересувати розділи, але не слід вважати, що вони можуть виконувати будь\-які дії із вмістом розділів, і, звичайно ж, вони не можуть працювати з \s-1LVM.\s0
+\&\fBparted\fR\|(8) і її графічний інтерфейс, gparted, можуть виконувати певні типи дій із зміни розміру образів дисків. Ці програми можуть змінювати розмір і пересувати розділи, але не слід вважати, що вони можуть виконувати будь\-які дії із вмістом розділів, і, звичайно ж, вони не можуть працювати з LVM.
.PP
\&\fBguestfish\fR\|(1) може виконувати усі ті дії, які може виконувати virt-resize, і набагато більше, але на суттєво нижчому рівні. Ймовірно, вам доведеться вручну обчислювати відступи у секторах, робити те, що за означенням має робити virt-resize. Якщо хочете дізнатися, які команди у guestfish запускає virt-resize, скористайтеся параметром \fI\-\-debug\fR.
.PP
-До складу \fBdracut\fR\|(8) включено модуль із назвою \f(CW\*(C`dracut\-modules\-growroot\*(C'\fR, яким можна скористатися для збільшення розмірів кореневого розділу під час першого завантаження гостьової системи. Документацію з цього модуля наведено у пов'язаному із ним файлі \s-1README.\s0
+До складу \fBdracut\fR\|(8) включено модуль із назвою \f(CW\*(C`dracut\-modules\-growroot\*(C'\fR, яким можна скористатися для збільшення розмірів кореневого розділу під час першого завантаження гостьової системи. Документацію з цього модуля наведено у пов'язаному із ним файлі README.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBvirt\-filesystems\fR\|(1), \fBvirt\-df\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBlvm\fR\|(8), \fBpvresize\fR\|(8), \fBlvresize\fR\|(8), \fBresize2fs\fR\|(8), \fBntfsresize\fR\|(8), \fBbtrfs\fR\|(8), \fBxfs_growfs\fR\|(8), \fBresize.f2fs\fR\|(8), \fBvirsh\fR\|(1), \fBparted\fR\|(8), \fBtruncate\fR\|(1), \fBfallocate\fR\|(1), \fBgrub\fR\|(8), \fBgrub\-install\fR\|(8), \fBvirt\-rescue\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirt\-alignment\-scan\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2010\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-sparsify 1"
-.TH virt-sparsify 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-sparsify 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-sparsify — зробити диск віртуальної машини розрідженим
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-sparsify [\-\-параметри] \-\-in\-place диск
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Virt-sparsify — інструмент, який може зробити диск віртуальної машини (або будь\-який образ диска) розрідженим, тобто спеціально зменшеним. Це означає, що вільне місце в образі диска можна буде перетворити на вільне місце в основній системі.
.PP
-Virt-sparsify може знаходити і розріджувати вільне місце у більшості файлових систем (наприклад у ext2/3/4, btrfs, \s-1NTFS\s0 тощо), а також у фізичних томах \s-1LVM.\s0
+Virt-sparsify може знаходити і розріджувати вільне місце у більшості файлових систем (наприклад у ext2/3/4, btrfs, NTFS тощо), а також у фізичних томах LVM.
.PP
Крім того, програма virt-sparsify може перетворювати диски з одного формату на інший, наприклад, перетворити образ диска у простому форматі (raw) на розріджений образ у форматі qcow2.
.PP
(Порівняйте видимий розмір у \fB100 МБ\fR зі справжнім розміром у \fB3,6 МБ\fR)
.SS "ВАЖЛИВІ ОБМЕЖЕННЯ"
.IX Subsection "ВАЖЛИВІ ОБМЕЖЕННЯ"
-.IP "\(bu" 4
+.IP \(bu 4
До використання цього інструмента віртуальну машину \fIслід зупинити\fR.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify може потребувати для роботи удвічі більшого місця на диску, ніж розмір початкового образу диска (1 тимчасова копія + 1 образ призначення). Ця оцінка є максимальною, і зазвичай потрібно набагато менше місця.
.Sp
Якщо ви використовуєте параметр \fI\-\-in\-place\fR, значні обсяги місця на диску для тимчасового зберігання даних \fBне\fR знадобляться.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify не може змінювати розміри образів дисків. Для зміни розмірів дисків скористайтеся \fBvirt\-resize\fR\|(1).
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify не може працювати із зашифрованими дисками. У libguestfs передбачено підтримку самих зашифрованих дисків, але зашифровані диски не може бути розріджено.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify ще не може розріджувати місце між розділами. Зауважте, що це місце часто використовується для критичних даних, зокрема завантажувачів, тому, насправді, воно може бути зовсім не таким зайвим, як може здатися.
-.IP "\(bu" 4
+.IP \(bu 4
У режимі копіювання внутрішні знімки qcow2 не копіюються на образ призначення.
.PP
Перш ніж розпочати користування цією програмою, вам також варто ознайомитися зі сторінками підручника щодо пов'язаних із нею інструментів, \fBvirt\-filesystems\fR\|(1) та \fBvirt\-df\fR\|(1).
-.SH "ПРИКЛАДИ"
+.SH ПРИКЛАДИ
.IX Header "ПРИКЛАДИ"
Типовий приклад використання:
.PP
.Vb 1
\& virt\-sparsify \-\-in\-place disk.img
.Ve
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати довідкове повідомлення.
.IP "\fB\-\-check\-tmpdir\fR \fBignore\fR" 4
.IP "\fB\-\-check\-tmpdir\fR \fBfail\fR" 4
.IX Item "--check-tmpdir fail"
.PD
-Переконайтеся, чи достатньо вільного місця у каталозі, вказаному за допомогою змінної середовища \*(L"\s-1TMPDIR\*(R"\s0 або параметра \fI\-\-tmp\fR, для завершення дії. Це лише оцінка.
+Переконайтеся, чи достатньо вільного місця у каталозі, вказаному за допомогою змінної середовища "TMPDIR" або параметра \fI\-\-tmp\fR, для завершення дії. Це лише оцінка.
.Sp
Якщо під час перевірки буде виявлено проблему, ви можете піти одним з таких шляхів:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBігнорувати\fR її,
-.IP "\(bu" 4
+.IP \(bu 4
вивести попередження і \fBпродовжити\fR,
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBпопередити\fR і почекати, доки користувач натисне клавішу Enter (типова поведінка) або
-.IP "\(bu" 4
+.IP \(bu 4
\&\fBвивести попередження про помилку\fR і завершити роботу.
.RE
.RS 4
.Sp
Цей параметр не можна поєднувати із параметром \fI\-\-in\-place\fR.
.RE
-.IP "\fB\-\-colors\fR" 4
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
-.IP "\fB\-\-compress\fR" 4
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
+.IP \fB\-\-compress\fR 4
.IX Item "--compress"
Стиснути файл виведених даних. Це працює, \fIлише\fR якщо форматом виведення даних є \f(CW\*(C`qcow2\*(C'\fR.
.Sp
Скоригувати формат виведення даних можна за допомогою параметрів \fI\-\-compress\fR, \fI\-o\fR.
.Sp
Цей параметр не можна поєднувати із параметром \fI\-\-in\-place\fR.
-.IP "\fB\-\-echo\-keys\fR" 4
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-sparcify попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-\-format\fR raw" 4
У другій формі команда призведе до ігнорування вказаної за назвою групи томів. Використовуйте назву групи томів без префікса \fI/dev/\fR, наприклад \fI\-\-ignore vg_foo\fR
.Sp
Цей параметр можна вказувати декілька разів.
-.IP "\fB\-\-in\-place\fR" 4
+.IP \fB\-\-in\-place\fR 4
.IX Item "--in-place"
-Виконати розрідження на місці замість розрідження копіюванням. Див. розділ \*(L"РОЗРІДЖЕННЯ НА МІСЦІ\*(R" нижче.
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Виконати розрідження на місці замість розрідження копіюванням. Див. розділ "РОЗРІДЖЕННЯ НА МІСЦІ" нижче.
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-machine\-readable\fR" 4
+.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
-.IP "\fB\-\-machine\-readable\fR=формат" 4
+.IP \fB\-\-machine\-readable\fR=формат 4
.IX Item "--machine-readable=формат"
.PD
-За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. \*(L"ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" нижче.
+За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. "ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" нижче.
.IP "\fB\-o\fR параметр[,параметр,...]" 4
.IX Item "-o параметр[,параметр,...]"
Передати параметри \fI\-o\fR до програми \fBqemu\-img\fR\|(1) для коригування формату виведення даних. Перелік доступних параметрів залежить від формату виведення (див. \fI\-\-convert\fR) і встановленої версії програми qemu-img.
.Ve
.Sp
Цей параметр не можна поєднувати із параметром \fI\-\-in\-place\fR.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Цей параметр вимикає смужки поступу та інші необов'язкові до виведення дані.
.IP "\fB\-\-tmp\fR каталог" 4
.IX Item "--tmp каталог"
.PD
-Лише у режимі копіювання, використати вказаний за назвою пристрій або каталог як місце для тимчасової накладки (див. також \*(L"\s-1TMPDIR\*(R"\s0 нижче).
+Лише у режимі копіювання, використати вказаний за назвою пристрій або каталог як місце для тимчасової накладки (див. також "TMPDIR" нижче).
.Sp
Якщо як параметр вказано блоковий пристрій, блоковий пристрій буде записано безпосередньо. \fBЗауважте, що при цьому з блокового пристрою буде повністю витерто наявні дані\fR.
.Sp
-Якщо як параметр вказано каталог, визначення параметра буде рівнозначним заданню значення змінної середовища \*(L"\s-1TMPDIR\*(R"\s0.
+Якщо як параметр вказано каталог, визначення параметра буде рівнозначним заданню значення змінної середовища "TMPDIR".
.Sp
Цей параметр не можна поєднувати із параметром \fI\-\-in\-place\fR.
.IP "\fB\-\-tmp\fR prebuilt:файл" 4
.IX Item "--tmp prebuilt:файл"
Лише у режимі копіювання, спеціалізований параметр \fI\-\-tmp prebuilt:файл\fR (де \f(CW\*(C`prebuilt:\*(C'\fR слід записувати буквально) наказує virt-sparsify використовувати як місце зберігання тимчасових даних файл qcow2 \f(CW\*(C`файл\*(C'\fR.
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Файл \fBмає\fR бути наново форматовано як qcow2, а вхідний диск буде резервним файлом.
-.IP "\(bu" 4
+.IP \(bu 4
Якщо ви повторно запускатимете virt-sparsify, вам \fBслід\fR повторно створювати файл перед кожним запуском.
-.IP "\(bu" 4
+.IP \(bu 4
Virt-sparsify не вилучає цей файл.
.RE
.RS 4
.Sp
Цей параметр використовується oVirt, де потрібен спеціальним чином форматований тимчасовий файл.
.RE
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.IP "\fB\-\-zero\fR розділ" 4
По\-друге, можна скористатися цим параметром у поєднанні із іншими параметрами для того, щоб зробити звичайні виведені програмою дані придатнішими для подальшої машинної обробки.
.PP
У поточній версії це означає таке:
-.IP "1." 4
+.IP 1. 4
Повідомлення смужки поступу можна обробляти зі стандартного виведення, шукаючи їх за таким формальним виразом:
.Sp
.Vb 1
\& ^[0\-9]+/[0\-9]+$
.Ve
-.IP "2." 4
+.IP 2. 4
Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до стандартного виведення, (окрім повідомлень смужки поступу) як повідомлення щодо стану. Ці повідомлення може бути записано до журналу і/або показано користувачеві.
-.IP "3." 4
+.IP 3. 4
Програма, яка надсилає виклик, має обробляти повідомлення, надіслані до stderr як повідомлення про помилки. Крім того, virt-sparcify завершує роботу із ненульовим кодом стану, якщо станеться критична помилка.
.PP
Підтримку параметра \fI\-\-machine\-readable\fR передбачено у всіх версіях virt-sparsify.
.PP
-Можна вказати рядок форматування для керування виведенням, див. \*(L"РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ\*(R" in \fBguestfs\fR\|(3).
+Можна вказати рядок форматування для керування виведенням, див. "РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ" in \fBguestfs\fR\|(3).
.SH "WINDOWS 8"
.IX Header "WINDOWS 8"
-«Швидкий запуск» Windows 8 може заважати роботі virt-sparsify. Див. \*(L"ПРИСИПЛЯННЯ \s-1WINDOWS\s0 ТА ШВИДКИЙ ЗАПУСК \s-1WINDOWS 8\*(R"\s0 in \fBguestfs\fR\|(3).
+«Швидкий запуск» Windows 8 може заважати роботі virt-sparsify. Див. "ПРИСИПЛЯННЯ WINDOWS ТА ШВИДКИЙ ЗАПУСК WINDOWS 8" in \fBguestfs\fR\|(3).
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
.IP "ТИМЧАСОВИЙ КАТАЛОГ" 4
.Sp
Якщо ви використовуєте параметр \fI\-\-in\-place\fR, значні обсяги місця на диску для тимчасового зберігання даних \fBне\fR знадобляться.
.PP
-Опис інших змінних середовища наведено у розділі \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
+Опис інших змінних середовища наведено у розділі "ENVIRONMENT VARIABLES" in \fBguestfs\fR\|(3).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає 0, якщо дію виконано без жодної помилки (це не обов'язково означає, що місце на диску звільнилося).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBvirt\-df\fR\|(1), \fBvirt\-filesystems\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBtruncate\fR\|(1), \fBfallocate\fR\|(1), \fBqemu\-img\fR\|(1), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2011\-2023 Red Hat Inc.
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-sysprep 1"
-.TH virt-sysprep 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-sysprep 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-sysprep — скидання налаштувань віртуальної машини до початкових, так, щоб з неї можна було роботи клони
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-sysprep [\-\-параметри] \-a disk.img [\-a disk.img ...]
.Ve
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
-Virt-sysprep може відновити початковий стан або зняти налаштовування з віртуальної машини, щоб з неї можна було робити клони. Кроками цієї процедури є вилучення ключів вузла \s-1SSH,\s0 вилучення сталих налаштувань мережі щодо \s-1MAC\s0 та вилучення облікових записів користувачів. Крім того, virt-sysprep може налаштовувати віртуальну машину, наприклад, додаванням ключів \s-1SSH,\s0 користувачів чи логотипів. Ви можете вмикати або вимикати кожен з цих кроків.
+Virt-sysprep може відновити початковий стан або зняти налаштовування з віртуальної машини, щоб з неї можна було робити клони. Кроками цієї процедури є вилучення ключів вузла SSH, вилучення сталих налаштувань мережі щодо MAC та вилучення облікових записів користувачів. Крім того, virt-sysprep може налаштовувати віртуальну машину, наприклад, додаванням ключів SSH, користувачів чи логотипів. Ви можете вмикати або вимикати кожен з цих кроків.
.PP
-Virt-sysprep вносить зміни до гостьової системи або образу диска \fIна місці\fR. Гостьова система має бути вимкненою. Якщо ви хочете зберегти наявний вміст гостьової системи, \fIвам слід спочатку зробити її знімок, скопіювати або клонувати її диск\fR. Див. \*(L"КОПІЮВАННЯ І КЛОНУВАННЯ\*(R" нижче.
+Virt-sysprep вносить зміни до гостьової системи або образу диска \fIна місці\fR. Гостьова система має бути вимкненою. Якщо ви хочете зберегти наявний вміст гостьової системи, \fIвам слід спочатку зробити її знімок, скопіювати або клонувати її диск\fR. Див. "КОПІЮВАННЯ І КЛОНУВАННЯ" нижче.
.PP
Вам \fIне потрібно\fR запускати virt-sysprep від імені користувача root. Фактично, запуск у такому режимі є нерекомендованим. Єдиною причиною запускати програму від імені root може бути потреба у доступі до образу диска, але навіть у цьому випадку, доцільніше змінити права доступу до образу диска так, щоб запис до нього став доступним від імені користувача, який запускає virt-sysprep.
.PP
«Sysprep» — скорочення від «system preparation» («приготування системи»). Назва походить від програми Microsoft \fIsysprep.exe\fR, яка використовується для вилучення налаштувань з Windows у приготуваннях до клонування системи. Маємо зауважити, що у поточній версії virt-sysprep \fIне\fR може працювати із гостьовими системами Microsoft Windows. Ми плануємо впровадити підтримку приготування Windows у майбутніх версіях і вже маємо певні напрацювання щодо цього.
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
-Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
-.IP "\fB\-\-colors\fR" 4
+Додати віддалений диск. Формат адреси є сумісним із guestfish. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in \fBguestfish\fR\|(1).
+.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
-.IP "\fB\-\-colours\fR" 4
+.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
-Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до команди цей параметр.
+Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
-Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв.
-.IP "\fB\-n\fR" 4
+Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.
+.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
-.IP "\fB\-\-dry\-run\fR" 4
+.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
Виконати тестову обробку гостьової системи у режимі «лише читання». Буде виконано дію sysprep, але наприкінці усі зміни до диска буде відкинуто.
.Sp
Скористайтеся параметром \fI\-\-list\-operations\fR, щоб переглянути список дій, підтримку яких передбачено у вашій версії virt-sysprep.
.Sp
-Список дій із поясненнями щодо них наведено у розділі \*(L"ДІЇ\*(R" нижче.
+Список дій із поясненнями щодо них наведено у розділі "ДІЇ" нижче.
.IP "\fB\-\-operation\fR дії" 4
.IX Item "--operation дії"
.PD 0
.Sp
Скористайтеся параметром \fI\-\-list\-operations\fR, щоб переглянути список дій, підтримку яких передбачено у вашій версії virt-sysprep.
.Sp
-Список дій із поясненнями щодо них наведено у розділі \*(L"ДІЇ\*(R" нижче.
-.IP "\fB\-\-echo\-keys\fR" 4
+Список дій із поясненнями щодо них наведено у розділі "ДІЇ" нижче.
+.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
Типово, якщо virt-sysprep попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.Sp
примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
-Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
-.IP "\fB\-\-key\fR \s-1SELECTOR\s0" 4
+Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE\-2010\-3851).
+.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
-Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using
-the inspection. \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or
-the \s-1UUID\s0 of the \s-1LUKS\s0 device.
+Specify a key for LUKS, to automatically open a LUKS device when using
+the inspection.
.RS 4
-.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
-.IX Item "--key ID:key:KEY_STRING"
+.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
+.IX Item "--key NAME:key:KEY_STRING"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
+.IX Item "--key UUID:key:KEY_STRING"
+.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
+.IX Item "--key all:key:KEY_STRING"
+.PD
+\&\f(CW\*(C`NAME\*(C'\fR is the libguestfs device name (eg. \f(CW\*(C`/dev/sda1\*(C'\fR). \f(CW\*(C`UUID\*(C'\fR is
+the device UUID. \f(CW\*(C`all\*(C'\fR means try the key against any encrypted
+device.
+.Sp
Use the specified \f(CW\*(C`KEY_STRING\*(C'\fR as passphrase.
-.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
-.IX Item "--key ID:file:FILENAME"
-Read the passphrase from \fI\s-1FILENAME\s0\fR.
-.ie n .IP "\fB\-\-key\fR ""ID"":clevis" 4
-.el .IP "\fB\-\-key\fR \f(CWID\fR:clevis" 4
-.IX Item "--key ID:clevis"
-Attempt passphrase-less unlocking for \f(CW\*(C`ID\*(C'\fR with Clevis, over the
-network. Please refer to \*(L"\s-1ENCRYPTED DISKS\*(R"\s0 in \fBguestfs\fR\|(3) for more
-information on network-bound disk encryption (\s-1NBDE\s0).
-.Sp
-Note that if any such option is present on the command line, \s-1QEMU\s0 user
+.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
+.IX Item "--key NAME:file:FILENAME"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
+.IX Item "--key UUID:file:FILENAME"
+.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
+.IX Item "--key all:file:FILENAME"
+.PD
+Read the passphrase from \fIFILENAME\fR.
+.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
+.IX Item "--key NAME:clevis"
+.PD 0
+.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
+.IX Item "--key UUID:clevis"
+.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
+.IX Item "--key all:clevis"
+.PD
+Attempt passphrase-less unlocking for the device with Clevis, over the
+network. Please refer to "ENCRYPTED DISKS" in \fBguestfs\fR\|(3) for more
+information on network-bound disk encryption (NBDE).
+.Sp
+Note that if any such option is present on the command line, QEMU user
networking will be automatically enabled for the libguestfs appliance.
.RE
.RS 4
.RE
-.IP "\fB\-\-keys\-from\-stdin\fR" 4
+.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply
multiple keys on stdin, one per line.
-.IP "\fB\-\-list\-operations\fR" 4
+.IP \fB\-\-list\-operations\fR 4
.IX Item "--list-operations"
Список дій, підтримку яких передбачено у програмі virt-sysprep.
.Sp
До libguestfs 1.17.33 показувалося лише перше поле (назва дії) і усі дії було типово увімкнено.
.IP "\fB\-\-mount\-options\fR точка_монтування:параметри[;точка_монтування:параметри;...]" 4
.IX Item "--mount-options точка_монтування:параметри[;точка_монтування:параметри;...]"
-Встановлює параметри монтування, які використовуються, коли libguestfs відкриває образ диска. Зауважте, що це не впливає на гостьову систему. Ці дані використовуються при відкритті певних гостьових систем, зокрема тих, де використовується файлова система \s-1UFS\s0 (\s-1BSD\s0).
+Встановлює параметри монтування, які використовуються, коли libguestfs відкриває образ диска. Зауважте, що це не впливає на гостьову систему. Ці дані використовуються при відкритті певних гостьових систем, зокрема тих, де використовується файлова система UFS (BSD).
.Sp
Слід використовувати список відокремлених крапкою з комою пар \f(CW\*(C`точка_монтування:параметри\*(C'\fR. Ймовірно, список слід взяти у лапки, щоб захистити його від обробки командною оболонкою.
.Sp
.Ve
.Sp
зробить те саме, але ще і змонтує \fI/var\fR з параметрами \f(CW\*(C`rw,nodiratime\*(C'\fR.
-.IP "\fB\-q\fR" 4
+.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
-.IP "\fB\-\-quiet\fR" 4
+.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
Не виводити повідомлення до журналу.
.Sp
Для вмикання ведення докладного журналу окремих дій з файлами скористайтеся \fI\-x\fR.
-.IP "\fB\-\-network\fR" 4
+.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
-.IP "\fB\-\-no\-network\fR" 4
+.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
Увімкнути чи вимкнути доступ до мережі для гостьової системи під час встановлення.
У virt-sysprep роботу у мережі типово \fIвимкнено\fR. Вам слід скористатися параметром \fI\-\-network\fR, щоб увімкнути її та мати змогу скористатися параметрами, подібними до \fI\-\-install\fR або \fI\-\-update\fR.
.Sp
На сторінці підручника \fBvirt\-builder\fR\|(1) можна знайти додаткові дані щодо переваг у захисті від вимикання мережі.
-.IP "\fB\-v\fR" 4
+.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
-.IP "\fB\-\-verbose\fR" 4
+.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
-.IP "\fB\-V\fR" 4
+.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-wrap\fR" 4
+.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
Wrap error, warning, and informative messages. This is the default when the output is a tty. If the output of the program is redirected to a file, wrapping is disabled unless you use this option.
-.IP "\fB\-x\fR" 4
+.IP \fB\-x\fR 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.ie n .IP "\fB\-\-append\-line\fR ФАЙЛ:РЯДОК (див. ""customize"" нижче)" 4
Змінити права доступу до файла \f(CW\*(C`ФАЙЛ\*(C'\fR на \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR.
.Sp
\&\fIЗауваження\fR: типово \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR записуються у десятковому форматі, якщо ви не додасте початковий \f(CW0\fR , щоб вказати вісімкове число, тобто скористаєтеся \f(CW0700\fR, а не \f(CW700\fR.
+.ie n .IP "\fB\-\-chown\fR UID:GID:PATH (see ""customize"" below)" 4
+.el .IP "\fB\-\-chown\fR UID:GID:PATH (see \f(CWcustomize\fR below)" 4
+.IX Item "--chown UID:GID:PATH (see customize below)"
+Change the owner user and group ID of a file or directory in the guest. Note:
+.RS 4
+.IP \(bu 4
+Only numeric UIDs and GIDs will work, and these may not be the same inside the guest as on the host.
+.IP \(bu 4
+This will not work with Windows guests.
+.RE
+.RS 4
+.Sp
+Приклад:
+.Sp
+.Vb 1
+\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
+.Ve
+.Sp
+See also: \fI\-\-upload\fR.
+.RE
.ie n .IP "\fB\-\-commands\-from\-file\fR НАЗВА_ФАЙЛА (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-commands\-from\-file\fR НАЗВА_ФАЙЛА (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--commands-from-file НАЗВА_ФАЙЛА (див. customize нижче)"
.Sp
Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено Perl 5.
.Sp
-Див. \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
+Див. "NON-INTERACTIVE EDITING" in \fBvirt\-edit\fR\|(1).
.ie n .IP "\fB\-\-firstboot\fR СКРИПТ (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-firstboot\fR СКРИПТ (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--firstboot СКРИПТ (див. customize нижче)"
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.ie n .IP "\fB\-\-firstboot\-command\fR 'КОМАНДА+ПАРАМЕТРИ' (див. ""customize"" нижче)" 4
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
-Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
+Будь ласка, зверніться до розділу "СКРИПТИ ПЕРШОГО ЗАВАНТАЖЕННЯ" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.ie n .IP "\fB\-\-firstboot\-install\fR ПАКУНОК,ПАКУНОК... (див. ""customize"" нижче)" 4
.IX Item "--firstboot-install ПАКУНОК,ПАКУНОК... (див. customize нижче)"
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час першого завантаження гостьової системи за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею гостьової системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ" in \fBvirt\-builder\fR\|(1).
.ie n .IP "\fB\-\-hostname\fR НАЗВА_ВУЗЛА (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-hostname\fR НАЗВА_ВУЗЛА (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--hostname НАЗВА_ВУЗЛА (див. customize нижче)"
-Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (\s-1FQDN\s0).
-.ie n .IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-inject\-qemu\-ga\fR \s-1METHOD\s0 (see \f(CWcustomize\fR below)" 4
+Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (FQDN).
+.ie n .IP "\fB\-\-inject\-qemu\-ga\fR METHOD (see ""customize"" below)" 4
+.el .IP "\fB\-\-inject\-qemu\-ga\fR METHOD (see \f(CWcustomize\fR below)" 4
.IX Item "--inject-qemu-ga METHOD (see customize below)"
-Inject the \s-1QEMU\s0 Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
+Inject the QEMU Guest Agent into a Windows guest. The guest agent communicates with qemu through a socket in order to provide enhanced features (see \fBqemu\-ga\fR\|(8)). This operation also injects a firstboot script so that the Guest Agent is installed when the guest boots.
.Sp
The parameter is the same as used by the \fI\-\-inject\-virtio\-win\fR operation.
.Sp
Note that to do a full conversion of a Windows guest from a foreign hypervisor like VMware (which involves many other operations) you should use the \fBvirt\-v2v\fR\|(1) tool instead of this.
-.ie n .IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0 (see ""customize"" below)" 4
-.el .IP "\fB\-\-inject\-virtio\-win\fR \s-1METHOD\s0 (see \f(CWcustomize\fR below)" 4
+.ie n .IP "\fB\-\-inject\-virtio\-win\fR METHOD (see ""customize"" below)" 4
+.el .IP "\fB\-\-inject\-virtio\-win\fR METHOD (see \f(CWcustomize\fR below)" 4
.IX Item "--inject-virtio-win METHOD (see customize below)"
Inject virtio-win drivers into a Windows guest. These drivers add virtio accelerated drivers suitable when running on top of a hypervisor that supports virtio (such as qemu/KVM). The operation also adjusts the Windows Registry so that the drivers are installed when the guest boots.
.Sp
The parameter can be one of:
.RS 4
-.IP "\s-1ISO\s0" 4
+.IP ISO 4
.IX Item "ISO"
-The path to the \s-1ISO\s0 image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
-.IP "\s-1DIR\s0" 4
+The path to the ISO image containing the virtio-win drivers (eg. \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
+.IP DIR 4
.IX Item "DIR"
The directory containing the unpacked virtio-win drivers (eg. \fI/usr/share/virtio\-win\fR).
-.ie n .IP "\fB""osinfo""\fR" 4
-.el .IP "\fB``osinfo''\fR" 4
-.IX Item "osinfo"
+.IP "\fB""osinfo""\fR" 4
+.IX Item """osinfo"""
The literal string \f(CW"osinfo"\fR means to use the libosinfo database to locate the drivers. (See \fBosinfo\-query\fR\|(1).
.RE
.RS 4
.IX Item "--install ПАКУНОК,ПАКУНОК... (див. customize нижче)"
Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею основної системи.
.Sp
-Огляд різних способів встановлення пакунків наведено у розділі \*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
+Огляд різних способів встановлення пакунків наведено у розділі "ВСТАНОВЛЕННЯ ПАКУНКІВ" in \fBvirt\-builder\fR\|(1).
.Sp
Див. також \fI\-\-update\fR, \fI\-\-uninstall\fR.
.ie n .IP "\fB\-\-keep\-user\-accounts\fR КОРИСТУВАЧІ (див. ""user\-account"" нижче)" 4
.IX Item "--mkdir КАТАЛОГ (див. customize нижче)"
Створити каталог у гостьовій системі.
.Sp
-Використовується \f(CW\*(C`mkdir \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
+Використовується \f(CW\*(C`mkdir\ \-p\*(C'\fR, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.
.ie n .IP "\fB\-\-move\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-move\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--move ДЖЕРЕЛО:ПРИЗНАЧЕННЯ (див. customize нижче)"
.IX Item "--no-logfile (див. customize нижче)"
Витерти \f(CW\*(C`builder.log\*(C'\fR (файл журналу із командами збирання) з образу після завершення збирання. Якщо ви не хочете явним чином показувати, як було зібрано образ, скористайтеся цим параметром.
.Sp
-Див. також \*(L"\s-1LOG FILE\*(R"\s0.
+Див. також "LOG FILE".
.ie n .IP "\fB\-\-no\-selinux\-relabel\fR (see ""customize"" below)" 4
.el .IP "\fB\-\-no\-selinux\-relabel\fR (see \f(CWcustomize\fR below)" 4
.IX Item "--no-selinux-relabel (see customize below)"
.IX Item "--password КОРИСТУВАЧ:ВАРІАНТ (див. customize нижче)"
Встановити пароль для користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR. (Зауважте, що за допомогою цього параметра \fIне можна\fR створювати облікові записи користувачів.)
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ" in \fBvirt\-builder\fR\|(1).
.ie n .IP "\fB\-\-password\-crypto\fR md5|sha256|sha512 (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-password\-crypto\fR md5|sha256|sha512 (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--password-crypto md5|sha256|sha512 (див. customize нижче)"
.Sp
\&\f(CW\*(C`md5\*(C'\fR працюватиме з відносно давніми гостьовими системами Linux (наприкладRHEL 3), але є незахищеним щодо новітніх способів атак.
.Sp
-Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку \s-1SHA\-512.\s0 Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
+Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку SHA\-512. Якщо такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.
.Sp
-Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, \s-1RHEL\s0) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
+Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (Fedora, RHEL) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
.ie n .IP "\fB\-\-remove\-user\-accounts\fR КОРИСТУВАЧІ (див. ""user\-account"" нижче)" 4
.el .IP "\fB\-\-remove\-user\-accounts\fR КОРИСТУВАЧІ (див. \f(CWuser\-account\fR нижче)" 4
.IX Item "--remove-user-accounts КОРИСТУВАЧІ (див. user-account нижче)"
.IX Item "--root-password ВАРІАНТ (див. customize нижче)"
Встановити пароль користувача root.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів користувачів описано у розділі "КОРИСТУВАЧІ І ПАРОЛІ" in \fBvirt\-builder\fR\|(1).
.Sp
Зауваження: якщо у virt-builder ви \fIне встановите\fR \fI\-\-root\-password\fR, для гостьової системи буде використано \fIвипадковий\fR пароль root.
.ie n .IP "\fB\-\-run\fR СКРИПТ (див. ""customize"" нижче)" 4
.Sp
Для скрипту буде автоматично використано команду chmod +x.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--run-command 'КОМАНДА+ПАРАМЕТРИ' (див. customize нижче)"
Виконати команду із аргументами у образі диска. Команду буде виконано у віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової файлової системи.
.Sp
-Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
+Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\-command\fR. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.
.Sp
.IX Item "--scrub ФАЙЛ (див. customize нижче)"
Витерти файл з гостьової системи. Подібне до \fI\-\-delete\fR, окрім того, що:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
Витирає дані так, що їх не можна буде відновити з гостьової системи.
-.IP "\(bu" 4
+.IP \(bu 4
Не може вилучати каталоги, лише звичайні файли.
.RE
.RS 4
.IX Item "--sm-attach ВАРІАНТ (див. customize нижче)"
Долучити систему до буфера передплати за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1).
.ie n .IP "\fB\-\-sm\-credentials\fR ВАРІАНТ (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-sm\-credentials\fR ВАРІАНТ (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--sm-credentials ВАРІАНТ (див. customize нижче)"
Встановити реєстраційні дані для \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "SUBSCRIPTION-MANAGER" in \fBvirt\-builder\fR\|(1).
.ie n .IP "\fB\-\-sm\-register\fR (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-sm\-register\fR (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--sm-register (див. customize нижче)"
.IX Item "--ssh-inject КОРИСТУВАЧ[:ВАРІАНТ] (див. customize нижче)"
Вставити ключ ssh так, щоб вказаний \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR зміг увійти до системи з використанням ssh без потреби у визначенні пароля. Запис користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR має вже існувати у гостьовій системі.
.Sp
-Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"КЛЮЧІ \s-1SSH\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі "КЛЮЧІ SSH" in \fBvirt\-builder\fR\|(1).
.Sp
Ви можете додати декілька параметрів \fI\-\-ssh\-inject\fR для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.
+.ie n .IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR (see ""customize"" below)" 4
+.el .IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR (see \f(CWcustomize\fR below)" 4
+.IX Item "--tar-in TARFILE:REMOTEDIR (see customize below)"
+Copy local files or directories from a local tar file called \f(CW\*(C`TARFILE\*(C'\fR into the disk image, placing them in the directory \f(CW\*(C`REMOTEDIR\*(C'\fR (which must exist). Note that the tar file must be uncompressed (\fI.tar.gz\fR files will not work here)
.ie n .IP "\fB\-\-timezone\fR ЧАСОВИЙ_ПОЯС (див. ""customize"" нижче)" 4
.el .IP "\fB\-\-timezone\fR ЧАСОВИЙ_ПОЯС (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--timezone ЧАСОВИЙ_ПОЯС (див. customize нижче)"
.el .IP "\fB\-\-write\fR ФАЙЛ:ВМІСТ (див. \f(CWcustomize\fR нижче)" 4
.IX Item "--write ФАЙЛ:ВМІСТ (див. customize нижче)"
Записати \f(CW\*(C`ДАНІ\*(C'\fR до файла \f(CW\*(C`ФАЙЛ\*(C'\fR.
-.SH "ДІЇ"
+.SH ДІЇ
.IX Header "ДІЇ"
Якщо параметр \fI\-\-enable\fR/\fI\-\-operations\fR \fIне\fR вказано, більшу частину дій з приготування системи буде увімкнено.
.PP
\&\f(CW\*(C`*\*(C'\fR = типово увімкнено, якщо не вказано параметрів \fI\-\-enable\fR/\fI\-\-operations\fR.
.SS "\fBabrt-data\fP *"
.IX Subsection "abrt-data *"
-Вилучити дані щодо аварії, створені \s-1ABRT.\s0
+Вилучити дані щодо аварії, створені ABRT.
.PP
-Вилучити автоматично створені \s-1ABRT\s0 дані щодо аварії у \f(CW\*(C`/var/spool/abrt/\*(C'\fR.
+Вилучити автоматично створені ABRT дані щодо аварії у \f(CW\*(C`/var/spool/abrt/\*(C'\fR.
.SS "\fBbackup-files\fP *"
.IX Subsection "backup-files *"
Вилучити файли резервних копій редактора з гостьової системи.
.PP
Вказані нижче файли буде вилучено з усіх каталогів файлової системи гостьової операційної системи:
-.IP "·" 4
+.IP · 4
*.bak
-.IP "·" 4
+.IP · 4
*~
.PP
У операційних системах Linux та Unix оброблятимуться лише такі файлові системи:
-.IP "·" 4
+.IP · 4
/etc
-.IP "·" 4
+.IP · 4
/root
-.IP "·" 4
+.IP · 4
/srv
-.IP "·" 4
+.IP · 4
/tmp
-.IP "·" 4
+.IP · 4
/var
.SS "\fBbash-history\fP *"
.IX Subsection "bash-history *"
.SS "\fBblkid-tab\fP *"
.IX Subsection "blkid-tab *"
Вилучити вкладку ідентифікаторів блоків у гостьовій системі.
-.SS "\fBca-certificates\fP"
+.SS \fBca-certificates\fP
.IX Subsection "ca-certificates"
-Вилучити сертифікати \s-1CA\s0 у гостьовій системі.
+Вилучити сертифікати CA у гостьовій системі.
.PP
-In case any certificate is removed, the system \s-1CA\s0 store is updated.
+In case any certificate is removed, the system CA store is updated.
.SS "\fBcrash-data\fP *"
.IX Subsection "crash-data *"
Вилучити дані щодо аварії, створені kexec-tools.
Налаштувати гостьову систему визначенням параметрів \fBvirt\-customize\fR\|(1) для встановлення пакунків, редагування файлів тощо.
.SS "\fBdhcp-client-state\fP *"
.IX Subsection "dhcp-client-state *"
-Вилучити надані клієнтські адреси \s-1DHCP.\s0
+Вилучити надані клієнтські адреси DHCP.
.SS "\fBdhcp-server-state\fP *"
.IX Subsection "dhcp-server-state *"
-Вилучити надані серверні адреси \s-1DHCP.\s0
+Вилучити надані серверні адреси DHCP.
.SS "\fBdovecot-data\fP *"
.IX Subsection "dovecot-data *"
Вилучити дані Dovecot (поштового сервера).
-.SS "\fBfirewall-rules\fP"
+.SS \fBfirewall-rules\fP
.IX Subsection "firewall-rules"
Вилучити правила брандмауера.
.PP
Вилучає нетипові правила брандмауера вилученням \f(CW\*(C`/etc/sysconfig/iptables\*(C'\fR або нетипових налаштувань firewalld з \f(CW\*(C`/etc/firewalld/*/*\*(C'\fR.
.PP
Зауважте, що цю можливість типово \fIне\fR увімкнено, оскільки може відкрити гостьову систему для вразливостей. Користуйтеся обережно.
-.SS "\fBflag-reconfiguration\fP"
+.SS \fBflag-reconfiguration\fP
.IX Subsection "flag-reconfiguration"
Позначити систему для зміни налаштувань.
.PP
Для гостьових систем Linux оновлює часову позначку \f(CW\*(C`/.unconfigured\*(C'\fR, отже, під час першого завантаження користувачеві буде надіслано запит щодо параметрів, зокрема пароля root та часового поясу.
-.SS "\fBfs-uuids\fP"
+.SS \fBfs-uuids\fP
.IX Subsection "fs-uuids"
-Змінити \s-1UUID\s0 файлових систем.
+Змінити UUID файлових систем.
.PP
-У гостьових системах та типах файлових систем, де передбачено таку підтримку, буде створено нові випадкові \s-1UUID,\s0 які буде пов’язано з файловими системами.
+У гостьових системах та типах файлових систем, де передбачено таку підтримку, буде створено нові випадкові UUID, які буде пов’язано з файловими системами.
.PP
\fIЗауваження щодо fs-uuids\fR
.IX Subsection "Зауваження щодо fs-uuids"
.PP
-Типово, дію fs-uuids вимкнено, оскільки у поточній версії програма ще не здатна знайти і оновити усі записи у гостьовій системі, які використовують \s-1UUID,\s0 наприклад \f(CW\*(C`/etc/fstab\*(C'\fR або завантажувач. Вмикання цієї дії може з високою ймовірністю зробити вашу гостьову систему непридатною до завантаження.
+Типово, дію fs-uuids вимкнено, оскільки у поточній версії програма ще не здатна знайти і оновити усі записи у гостьовій системі, які використовують UUID, наприклад \f(CW\*(C`/etc/fstab\*(C'\fR або завантажувач. Вмикання цієї дії може з високою ймовірністю зробити вашу гостьову систему непридатною до завантаження.
.PP
Див. https://bugzilla.redhat.com/show_bug.cgi?id=991641
.SS "\fBipa-client\fP *"
.IX Subsection "ipa-client *"
-Remove the \s-1IPA\s0 files.
+Remove the IPA files.
.PP
-Remove all the files related to an \s-1IPA\s0 (Identity, Policy, Audit) system. This effectively unenrolls the guest from an \s-1IPA\s0 server without interacting with it.
+Remove all the files related to an IPA (Identity, Policy, Audit) system. This effectively unenrolls the guest from an IPA server without interacting with it.
.PP
This operation does not run \f(CW\*(C`ipa\-client\*(C'\fR.
-.SS "\fBдані\-kerberos\fP"
+.SS \fBдані\-kerberos\fP
.IX Subsection "дані-kerberos"
Вилучити дані Kerberos у гостьовій системі.
.SS "\fBkerberos-hostkeytab\fP *"
Вилучити з гостьової системи багато файлів журналів.
.PP
У Linux вилучено такі файли:
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.cnf
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.crt
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.csr
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.pem
-.IP "·" 4
+.IP · 4
/etc/Pegasus/*.srl
-.IP "·" 4
+.IP · 4
/root/anaconda\-ks.cfg
-.IP "·" 4
+.IP · 4
/root/anaconda\-post.log
-.IP "·" 4
+.IP · 4
/root/initial\-setup\-ks.cfg
-.IP "·" 4
+.IP · 4
/root/install.log
-.IP "·" 4
+.IP · 4
/root/install.log.syslog
-.IP "·" 4
+.IP · 4
/root/original\-ks.cfg
-.IP "·" 4
+.IP · 4
/var/cache/fontconfig/*
-.IP "·" 4
+.IP · 4
/var/cache/gdm/*
-.IP "·" 4
+.IP · 4
/var/cache/man/*
-.IP "·" 4
+.IP · 4
/var/lib/AccountService/users/*
-.IP "·" 4
+.IP · 4
/var/lib/fprint/*
-.IP "·" 4
+.IP · 4
/var/lib/logrotate.status
-.IP "·" 4
+.IP · 4
/var/log/*.log*
-.IP "·" 4
+.IP · 4
/var/log/BackupPC/LOG
-.IP "·" 4
+.IP · 4
/var/log/ConsoleKit/*
-.IP "·" 4
+.IP · 4
/var/log/anaconda.syslog
-.IP "·" 4
+.IP · 4
/var/log/anaconda/*
-.IP "·" 4
+.IP · 4
/var/log/apache2/*_log
-.IP "·" 4
+.IP · 4
/var/log/apache2/*_log\-*
-.IP "·" 4
+.IP · 4
/var/log/apt/*
-.IP "·" 4
+.IP · 4
/var/log/aptitude*
-.IP "·" 4
+.IP · 4
/var/log/audit/*
-.IP "·" 4
+.IP · 4
/var/log/btmp*
-.IP "·" 4
+.IP · 4
/var/log/ceph/*.log
-.IP "·" 4
+.IP · 4
/var/log/chrony/*.log
-.IP "·" 4
+.IP · 4
/var/log/cron*
-.IP "·" 4
+.IP · 4
/var/log/cups/*_log*
-.IP "·" 4
+.IP · 4
/var/log/debug*
-.IP "·" 4
+.IP · 4
/var/log/dmesg*
-.IP "·" 4
+.IP · 4
/var/log/exim4/*
-.IP "·" 4
+.IP · 4
/var/log/faillog*
-.IP "·" 4
+.IP · 4
/var/log/firewalld*
-.IP "·" 4
+.IP · 4
/var/log/gdm/*
-.IP "·" 4
+.IP · 4
/var/log/glusterfs/*glusterd.vol.log
-.IP "·" 4
+.IP · 4
/var/log/glusterfs/glusterfs.log
-.IP "·" 4
+.IP · 4
/var/log/grubby*
-.IP "·" 4
+.IP · 4
/var/log/httpd/*log
-.IP "·" 4
+.IP · 4
/var/log/installer/*
-.IP "·" 4
+.IP · 4
/var/log/jetty/jetty\-console.log
-.IP "·" 4
+.IP · 4
/var/log/journal/*
-.IP "·" 4
+.IP · 4
/var/log/lastlog*
-.IP "·" 4
+.IP · 4
/var/log/libvirt/libvirtd.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/libxl/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/lxc/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/qemu/*.log
-.IP "·" 4
+.IP · 4
/var/log/libvirt/uml/*.log
-.IP "·" 4
+.IP · 4
/var/log/lightdm/*
-.IP "·" 4
+.IP · 4
/var/log/mail/*
-.IP "·" 4
+.IP · 4
/var/log/maillog*
-.IP "·" 4
+.IP · 4
/var/log/messages*
-.IP "·" 4
+.IP · 4
/var/log/ntp
-.IP "·" 4
+.IP · 4
/var/log/ntpstats/*
-.IP "·" 4
+.IP · 4
/var/log/ppp/connect\-errors
-.IP "·" 4
+.IP · 4
/var/log/rhsm/*
-.IP "·" 4
+.IP · 4
/var/log/sa/*
-.IP "·" 4
+.IP · 4
/var/log/secure*
-.IP "·" 4
+.IP · 4
/var/log/setroubleshoot/*.log
-.IP "·" 4
+.IP · 4
/var/log/spooler*
-.IP "·" 4
+.IP · 4
/var/log/squid/*.log
-.IP "·" 4
+.IP · 4
/var/log/syslog*
-.IP "·" 4
+.IP · 4
/var/log/tallylog*
-.IP "·" 4
+.IP · 4
/var/log/tuned/tuned.log
-.IP "·" 4
+.IP · 4
/var/log/wtmp*
-.IP "·" 4
+.IP · 4
/var/log/xferlog*
-.IP "·" 4
+.IP · 4
/var/named/data/named.run
.SS "\fBlvm-system-devices\fP *"
.IX Subsection "lvm-system-devices *"
-Remove \s-1LVM2\s0 system.devices file.
+Remove LVM2 system.devices file.
.PP
-On Linux guests, \s-1LVM2\s0's scanning for physical volumes (PVs) may be restricted to those block devices whose WWIDs are listed in \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR. When cloning VMs, WWIDs may change, breaking \f(CW\*(C`lvm pvscan\*(C'\fR. Remove \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR.
+On Linux guests, LVM2's scanning for physical volumes (PVs) may be restricted to those block devices whose WWIDs are listed in \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR. When cloning VMs, WWIDs may change, breaking \f(CW\*(C`lvm pvscan\*(C'\fR. Remove \f(CW\*(C`/etc/lvm/devices/system.devices\*(C'\fR.
.SS "\fBlvm-uuids\fP *"
.IX Subsection "lvm-uuids *"
-Змінити \s-1UUID\s0 ФТ і ГТ \s-1LVM2.\s0
+Змінити UUID ФТ і ГТ LVM2.
.PP
-Для гостьових систем Linux, які містять фізичні томи (ФТ) або групи томів (ГТ) \s-1LVM2\s0 для ФТ і ГТ буде створено і призначено випадкові \s-1UUID.\s0
+Для гостьових систем Linux, які містять фізичні томи (ФТ) або групи томів (ГТ) LVM2 для ФТ і ГТ буде створено і призначено випадкові UUID.
.SS "\fBід\-комп’ютера\fP *"
.IX Subsection "ід-комп’ютера *"
Вилучити ідентифікатор локального комп’ютера.
Вилучити поштове повідомлення з локального каталогу поштового буфера.
.SS "\fBnet-hostname\fP *"
.IX Subsection "net-hostname *"
-Вилучити \s-1HOSTNAME\s0 та \s-1DHCP_HOSTNAME\s0 у налаштуваннях інтерфейсу мережі.
+Вилучити HOSTNAME та DHCP_HOSTNAME у налаштуваннях інтерфейсу мережі.
.PP
Для Fedora і Red Hat Enterprise Linux це вилучається з файлів \f(CW\*(C`ifcfg\-*\*(C'\fR.
.SS "\fBnet-hwaddr\fP *"
.IX Subsection "net-hwaddr *"
-Вилучити налаштування \s-1HWADDR\s0 (апаратної адреси \s-1MAC\s0).
+Вилучити налаштування HWADDR (апаратної адреси MAC).
.PP
Для Fedora і Red Hat Enterprise Linux це вилучається з файлів \f(CW\*(C`ifcfg\-*\*(C'\fR.
.SS "\fBnet-nmconn\fP *"
Вилучити кеш керування пакунками.
.SS "\fBpam-data\fP *"
.IX Subsection "pam-data *"
-Вилучити дані \s-1PAM\s0 у гостьовій системі.
+Вилучити дані PAM у гостьовій системі.
.SS "\fBpasswd-backups\fP *"
.IX Subsection "passwd-backups *"
Вилучити /etc/passwd\- та подібні файли резервних копій.
.PP
У Linux вилучено такі файли:
-.IP "·" 4
+.IP · 4
/etc/group\-
-.IP "·" 4
+.IP · 4
/etc/gshadow\-
-.IP "·" 4
+.IP · 4
/etc/passwd\-
-.IP "·" 4
+.IP · 4
/etc/shadow\-
-.IP "·" 4
+.IP · 4
/etc/subgid\-
-.IP "·" 4
+.IP · 4
/etc/subuid\-
.SS "\fBpuppet-data-log\fP *"
.IX Subsection "puppet-data-log *"
Вилучити дані та файли журналів puppet.
.SS "\fBrh-subscription-manager\fP *"
.IX Subsection "rh-subscription-manager *"
-Вилучити файли керування передплатою \s-1RH.\s0
+Вилучити файли керування передплатою RH.
.SS "\fBrhn-systemid\fP *"
.IX Subsection "rhn-systemid *"
-Вилучити ідентифікатор системи у \s-1RHN.\s0
+Вилучити ідентифікатор системи у RHN.
.SS "\fBrpm-db\fP *"
.IX Subsection "rpm-db *"
-Вилучити специфічні для системи файли баз даних \s-1RPM.\s0
+Вилучити специфічні для системи файли баз даних RPM.
.PP
-Вилучити специфічні для системи файли баз даних \s-1RPM. RPM\s0 буде повторно створено ці файли, якщо це потрібно.
+Вилучити специфічні для системи файли баз даних RPM. RPM буде повторно створено ці файли, якщо це потрібно.
.SS "\fBsamba-db-log\fP *"
.IX Subsection "samba-db-log *"
Вилучити бази даних та файли журналів Samba.
.PP
Модуль \f(CW\*(C`script\*(C'\fR надає вам змогу запускати довільні скрипти оболонки або програми для обробки гостьових систем.
.PP
-Зауважте, що використання цієї можливості потребує підтримки \s-1FUSE.\s0 Вам варто увімкнути цю підтримку у вашій основній системі, наприклад, додаванням поточного користувача до групи \f(CW\*(C`fuse\*(C'\fR або завантаженням модуля ядра.
+Зауважте, що використання цієї можливості потребує підтримки FUSE. Вам варто увімкнути цю підтримку у вашій основній системі, наприклад, додаванням поточного користувача до групи \f(CW\*(C`fuse\*(C'\fR або завантаженням модуля ядра.
.PP
Скористайтеся одним або декількома параметрами \fI\-\-script\fR для визначення скриптів або програм, які слід запустити для обробки гостьової системи.
.PP
-Скрипт або програма виконується з поточним каталогом, який є кореневим каталогом гостьової системи, отже слід використовувати відносні шляхи. Приклад: \f(CW\*(C`rm etc/resolv.conf\*(C'\fR у скрипті призведе до вилучення файла налаштувань \s-1DNS\s0 у гостьовій системі Linux, а \f(CW\*(C`rm /etc/resolv.conf\*(C'\fR (спробує) вилучити відповідний файл у основній системі.
+Скрипт або програма виконується з поточним каталогом, який є кореневим каталогом гостьової системи, отже слід використовувати відносні шляхи. Приклад: \f(CW\*(C`rm etc/resolv.conf\*(C'\fR у скрипті призведе до вилучення файла налаштувань DNS у гостьовій системі Linux, а \f(CW\*(C`rm /etc/resolv.conf\*(C'\fR (спробує) вилучити відповідний файл у основній системі.
.PP
Зазвичай, використовується тимчасова точка монтування гостьової системи, але ви можете вибрати якусь іншу за допомогою параметра \fI\-\-scriptdir\fR.
.PP
\&\fBЗауваження:\fR описані тут скрипти відрізняються від скриптів \fI\-\-firstboot\fR (скриптів, які виконуються у контексті гостьової системи під час першого завантаження цієї системи). Скрипти \fI\-\-script\fR запускаються у основній системі, а не у гостьовій.
.SS "\fBsmolt-uuid\fP *"
.IX Subsection "smolt-uuid *"
-Вилучити \s-1UUID\s0 обладнання Smolt.
+Вилучити UUID обладнання Smolt.
.SS "\fBssh-hostkeys\fP *"
.IX Subsection "ssh-hostkeys *"
-Вилучити ключі вузла \s-1SSH\s0 у гостьовій системі.
+Вилучити ключі вузла SSH у гостьовій системі.
.PP
-Ключі вузла \s-1SSH\s0 повторно створюються (незалежно) під час наступного завантаження гостьової системи.
+Ключі вузла SSH повторно створюються (незалежно) під час наступного завантаження гостьової системи.
.PP
Якщо після клонування гостьова система отримати ту саму IP\-адресу, ssh надасть вам додаткове попередження щодо зміни ключа вузла:
.PP
Вилучити постійні правила мережі udev, які відображають вже створену MAC\-адресу гостьової системи на фіксований пристрій ethernet (наприклад eth0).
.PP
Після клонування гостьової системи MAC\-адреса зазвичай змінюється. Оскільки стару MAC\-адресу вже пов’язано зі старою назвою (наприклад eth0), це означає, що нову MAC\-адресу буде пов’язано з новою назвою (наприклад eth1), а це зазвичай є небажаним. За допомогою вилучення постійних правил мережі udev цьому можна запобігти.
-.SS "\fBuser-account\fP"
+.SS \fBuser-account\fP
.IX Subsection "user-account"
Вилучити облікові записи користувачів у гостьовій системі.
.PP
У цьому файлі зберігаються записи щодо входу користувачів до машини. У сучасних дистрибутивах Linux ці записи зберігаються на диску у пам’яті, тому не є частиною віртуальної машини на диску, але ці дані зберігаються на диску у старіших версіях дистрибутивів.
.SS "\fByum-uuid\fP *"
.IX Subsection "yum-uuid *"
-Вилучити \s-1UUID\s0 yum.
+Вилучити UUID yum.
.PP
-Yum створить новий \s-1UUID\s0 під час наступного запуску, коли виявить, що початковий \s-1UUID\s0 було вилучено.
+Yum створить новий UUID під час наступного запуску, коли виявить, що початковий UUID було вилучено.
.SH "КОПІЮВАННЯ ТА КЛОНУВАННЯ"
.IX Header "КОПІЮВАННЯ ТА КЛОНУВАННЯ"
Virt-sysprep можна скористатися як частиною процедури клонування гостьових систем або приготування шаблона, з якого можна буде клонувати гостьові системи. Існує багато різних способів досягти цього за допомогою засобів віртуалізації, — цей розділ є лише вступом.
.PP
Віртуальна машина (коли її вимкнено) складається з двох частин:
-.IP "\fIналаштування\fR" 4
+.IP \fIналаштування\fR 4
.IX Item "налаштування"
-Налаштування або опис гостьової системи. Приклади: \s-1XML\s0 libvirt (див. \f(CW\*(C`virsh dumpxml\*(C'\fR), поточні налаштування гостьової системи або інший зовнішній формат, наприклад \s-1OVF.\s0
+Налаштування або опис гостьової системи. Приклади: XML libvirt (див. \f(CW\*(C`virsh dumpxml\*(C'\fR), поточні налаштування гостьової системи або інший зовнішній формат, наприклад OVF.
.Sp
Деякі пункти налаштувань, які варто було б змінити:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
назва
-.IP "\(bu" 4
-\&\s-1UUID\s0
-.IP "\(bu" 4
+.IP \(bu 4
+UUID
+.IP \(bu 4
шлях до блокових пристроїв
-.IP "\(bu" 4
+.IP \(bu 4
MAC\-адреса мережевої картки
.RE
.RS 4
.Sp
Ось деякі параметри всередині блокових пристроїв, які, можливо, доведеться змінити:
.RS 4
-.IP "\(bu" 4
+.IP \(bu 4
назва вузла та інші налаштування мережі
-.IP "\(bu" 4
-\&\s-1UUID\s0
-.IP "\(bu" 4
-ключі \s-1SSH\s0 вузла
-.IP "\(bu" 4
-Унікальний ідентифікатор безпеки Windows (\s-1SID\s0)
-.IP "\(bu" 4
+.IP \(bu 4
+UUID
+.IP \(bu 4
+ключі SSH вузла
+.IP \(bu 4
+Унікальний ідентифікатор безпеки Windows (SID)
+.IP \(bu 4
Реєстрація маріонетки
.RE
.RS 4
\& початкова система \-\-\-\-> шаблон \-\-\-\-\-\-\-\-\-> копійований \-\-\-\-\-\-> нетипова
\& шаблон гостьова система
.Ve
-.IP "\(bu" 4
+.IP \(bu 4
Створити знімок за допомогою qemu-img:
.Sp
.Vb 1
Перевагою є те, що вам не потрібно буде копіювати оригінал (дуже швидко), і те, що зберігатимуться лише зміни (менше вживання місця у сховищі даних).
.Sp
Зауважте, що запис резервного файла після створення на його основі гостьових систем неможливий: такий запис призведе до пошкодження гостьових систем.
-.IP "\(bu" 4
+.IP \(bu 4
Створити знімок за допомогою \f(CW\*(C`lvcreate \-\-snapshot\*(C'\fR.
-.IP "\(bu" 4
+.IP \(bu 4
До інших способів створення знімків належить використання засобів файлової системи (для файлових систем, які подібні до btrfs).
.Sp
-На більшості пристроїв Network Attached Storage (\s-1NAS\s0) передбачено можливість простого створення знімків на основі файлів та \s-1LUN.\s0
-.IP "\(bu" 4
-Накажіть вашому \s-1NAS\s0 здублювати \s-1LUN.\s0 На більшості пристроїв \s-1NAS\s0 також передбачено дуже просте дублювання \s-1LUN\s0 (копіювання відбувається у фоновому режимі за запитом).
-.IP "\(bu" 4
+На більшості пристроїв Network Attached Storage (NAS) передбачено можливість простого створення знімків на основі файлів та LUN.
+.IP \(bu 4
+Накажіть вашому NAS здублювати LUN. На більшості пристроїв NAS також передбачено дуже просте дублювання LUN (копіювання відбувається у фоновому режимі за запитом).
+.IP \(bu 4
Приготуйте ваш шаблон за допомогою \fBvirt\-sparsify\fR\|(1). Див. нижче.
-.SS "VIRT-CLONE"
+.SS VIRT-CLONE
.IX Subsection "VIRT-CLONE"
-Для дублювання блокового пристрою і/або внесення змін до зовнішніх налаштувань libvirt гостьової системи можна скористатися окремим інструментом, \fBvirt\-clone\fR\|(1). Ця програма відновить початкові значення назви, \s-1UUID\s0 та адреси \s-1MAC\s0 гостьової системи в \s-1XML\s0 libvirt.
+Для дублювання блокового пристрою і/або внесення змін до зовнішніх налаштувань libvirt гостьової системи можна скористатися окремим інструментом, \fBvirt\-clone\fR\|(1). Ця програма відновить початкові значення назви, UUID та адреси MAC гостьової системи в XML libvirt.
.PP
\&\fBvirt\-clone\fR\|(1) не використовує libguestfs і не може «зазирнути» у образ диска. Це і було причиною для написання virt-sysprep.
-.SS "РОЗРІДЖЕННЯ"
+.SS РОЗРІДЖЕННЯ
.IX Subsection "РОЗРІДЖЕННЯ"
.Vb 2
\& virt\-sparsify
З іншого боку, якщо вам потрібно щось скоригувати у файловій системі гостьової операційної системи (наприклад, копіюванням даних до файлів), тоді ідеально буде використатися \fI\-\-script\fR, оскільки (a) так скрипт матиме доступ до файлової системи основної операційної системи і (b) ви одразу отримаєте повідомлення про помилки.
.PP
Кожен з параметрів або обидва параметри можна використовувати у рядку команди довільну кількість разів.
-.SH "БЕЗПЕКА"
+.SH БЕЗПЕКА
.IX Header "БЕЗПЕКА"
-Virtual machines that employ full disk encryption \fIinternally to the guest\fR should not be considered for cloning and distribution, as it provides multiple parties with the same internal volume key, enabling any one such party to decrypt all the other clones. Refer to the \s-1LUKS FAQ\s0 for details.
+Virtual machines that employ full disk encryption \fIinternally to the guest\fR should not be considered for cloning and distribution, as it provides multiple parties with the same internal volume key, enabling any one such party to decrypt all the other clones. Refer to the LUKS FAQ for details.
.PP
-Хоча virt-sysprep вилучає певні конфіденційні дані з гостьової системи, програма не претендує на вилучення усіх цих даних. Вам слід ознайомитися із розділом \*(L"ДІЇ\*(R" вище і вивчити саму гостьову систему після виконання дій.
+Хоча virt-sysprep вилучає певні конфіденційні дані з гостьової системи, програма не претендує на вилучення усіх цих даних. Вам слід ознайомитися із розділом "ДІЇ" вище і вивчити саму гостьову систему після виконання дій.
.PP
Файли з конфіденційними даними просто вилучаються. Дані, які у них містяться, можуть залишатися на диску. Такі дані доволі просто відновити за допомогою шістнадцяткового редактора або засобів для відновлення файлів. Ви можете скористатися параметром \fI\-\-scrub\fR для витирання вмісту файлів замість простого їх вилучення. Ще одним способом вилучити конфіденційні дані є використання \fBvirt\-sparsify\fR\|(1). Крім того, витерти вміст вилучених каталогів та inode можна за допомогою команди \fBscrub\fR\|(1).
.SS "БАЗА ВИПАДКОВОСТІ"
.PP
У підтримуваних гостьових системах virt-sysprep записує декілька випадкових байтів з основної системи до файла породжувача псевдовипадкової послідовності гостьової системи.
.PP
-Якщо ця процедура виконується один раз, а гостьова система клонується з того самого шаблона, кожна гостьова система починатиме з того самого значення ентропії, отже дані, подібні до ключів \s-1SSH\s0 вузла і послідовностей чисел \s-1TCP,\s0 можуть бути передбачуваними.
+Якщо ця процедура виконується один раз, а гостьова система клонується з того самого шаблона, кожна гостьова система починатиме з того самого значення ентропії, отже дані, подібні до ключів SSH вузла і послідовностей чисел TCP, можуть бути передбачуваними.
.PP
Тому вам слід забезпечити додавання певного рівня випадковості \fIпісля\fR клонування з шаблона. Зробити це можна за допомогою простого вмикання модуля customize:
.PP
\& cp шаблон.img нова_гостьова_система.img
\& virt\-sysprep \-\-enable customize \-a нова_гостьова_система.img
.Ve
-.SH "SELINUX"
+.SH SELINUX
.IX Header "SELINUX"
Для гостьових систем, у яких використовується SELinux, може знадобитися спеціальна обробка, якщо використовуються дії, які створюють нові файли або вносять зміни до наявних файлів.
.PP
-Докладніший опис наведено у розділі \*(L"\s-1SELINUX\*(R"\s0 in \fBvirt\-builder\fR\|(1).
+Докладніший опис наведено у розділі "SELINUX" in \fBvirt\-builder\fR\|(1).
.SH "WINDOWS 8"
.IX Header "WINDOWS 8"
-«Швидкий запуск» Windows 8 може заважати роботі virt-sysprep. Див. \*(L"ПРИСИПЛЯННЯ \s-1WINDOWS\s0 ТА ШВИДКИЙ ЗАПУСК \s-1WINDOWS 8\*(R"\s0 in \fBguestfs\fR\|(3).
+«Швидкий запуск» Windows 8 може заважати роботі virt-sysprep. Див. "ПРИСИПЛЯННЯ WINDOWS ТА ШВИДКИЙ ЗАПУСК WINDOWS 8" in \fBguestfs\fR\|(3).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає 0, якщо роботу виконано успішно, і 1, якщо сталися помилки.
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
-.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
+.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
Ця змінна визначає каталог, у якому містяться файли даних, які використовуються для встановлення Windows з першим завантаженням.
.Sp
.Sp
Цей каталог може містити такі файли:
.RS 4
-.IP "\fIrhsrvany.exe\fR" 4
+.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
Це виконуваний файл для Windows RHSrvAny, який використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.Sp
Див. також \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
-.IP "\fIpvvxsvc.exe\fR" 4
+.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
-Це виконуваний файл Windows, що постачається разом із \s-1VMDP SUSE,\s0 використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
+Це виконуваний файл Windows, що постачається разом із VMDP SUSE, використовується для встановлення скрипту «firstboot» у гостьові системи Windows. Він знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.RE
.RS 4
.RE
.PP
-Опис інших змінних середовища наведено у розділі \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
+Опис інших змінних середовища наведено у розділі "ENVIRONMENT VARIABLES" in \fBguestfs\fR\|(3).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-builder\fR\|(1), \fBvirt\-clone\fR\|(1), \fBvirt\-customize\fR\|(1), \fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sparsify\fR\|(1), \fBvirsh\fR\|(1), \fBlvcreate\fR\|(8), \fBqemu\-img\fR\|(1), \fBscrub\fR\|(1), http://libguestfs.org/, http://libvirt.org/.
-.SH "АВТОРИ"
+.SH АВТОРИ
.IX Header "АВТОРИ"
Richard W.M. Jones http://people.redhat.com/~rjones/
.PP
Copyright (C) 2011\-2023 Red Hat Inc.
.PP
Авторські права належать Fujitsu Ltd., 2012
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
-under the terms of the \s-1GNU\s0 General Public License as published by the
+under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
-\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
.PP
-You should have received a copy of the \s-1GNU\s0 General Public License along
+You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
-.SH "BUGS"
+51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
-.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Podwrapper::Man 1.52.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
.\" ========================================================================
.\"
.IX Title "virt-win-reg 1"
-.TH virt-win-reg 1 "2023-04-06" "guestfs-tools-1.50.1" "Virtualization Support"
+.TH virt-win-reg 1 2024-01-04 guestfs-tools-1.52.0 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "НАЗВА"
+.SH НАЗВА
.IX Header "НАЗВА"
virt-win-reg — програма для експортування та дописування записів реєстру Windows з гостьової системи Windows
.SH "КОРОТКИЙ ОПИС"
\&
\& virt\-win\-reg [\-\-параметри] диск.img ... # замість назва_домену
.Ve
-.SH "ПОПЕРЕДЖЕННЯ"
+.SH ПОПЕРЕДЖЕННЯ
.IX Header "ПОПЕРЕДЖЕННЯ"
\&\fIНе\fR використовуйте \f(CW\*(C`virt\-win\-reg\*(C'\fR з параметром \fI\-\-merge\fR для активних віртуальних машин. Якщо ви зробите це, ви \fIневиправно\fR ушкодите диск у віртуальній машині. \f(CW\*(C`virt\-win\-reg\*(C'\fR намагатиметься запобігти подібним діям, але програма не завжди може визначити усі можливі випадки.
.PP
Внесення змін до реєстру Windows є ризикованою дією. Формат реєстру доволі неясний і недокументований, а зміни у реєстрі можуть призвести до неможливості завантажити систему. Тому, якщо ви користуєтеся параметром \fI\-\-merge\fR, не забувайте спочатку створити надійну резервну копію.
-.SH "ОПИС"
+.SH ОПИС
.IX Header "ОПИС"
Ця програма може експортувати і дописувати записи реєстру Windows з гостьової системи Windows.
.PP
.Vb 1
\& $ virt\-win\-reg \-\-merge Windows7 changes.reg
.Ve
-.SS "ПРИМІТКА"
+.SS ПРИМІТКА
.IX Subsection "ПРИМІТКА"
Цю програму призначено лише для спрощення доступу до реєстру. Якщо вам потрібні якісь складні дії з реєстром, рекомендуємо вам отримати файли роїв реєстру з гостьової системи за допомогою \fBlibguestfs\fR\|(3) або \fBguestfish\fR\|(1) і обробити їх локально, наприклад за допомогою \fBhivex\fR\|(3), \fBhivexsh\fR\|(1) або \fBhivexregedit\fR\|(1).
-.SH "ПАРАМЕТРИ"
+.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку.
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
Показати дані щодо версії і завершити роботу.
-.IP "\fB\-\-debug\fR" 4
+.IP \fB\-\-debug\fR 4
.IX Item "--debug"
Увімкнути показ діагностичних повідомлень.
.IP "\fB\-c адреса\fR" 4
.IP "\fB\-\-connect адреса\fR" 4
.IX Item "--connect адреса"
.PD
-Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
+Якщо використовується libvirt, встановити з’єднання з вказаним \fIURI\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо, libvirt не буде використовуватися взагалі.
.IP "\fB\-\-format\fR raw" 4
Якщо вказаний диск походить з libvirt, ця програма надішле запит щодо даних до libvirt. У цьому випадку вказане значення параметра формату буде проігноровано.
.Sp
Якщо ви працюєте із образами дисків гостьових систем у форматі raw із ненадійних джерел, вам слід завжди вказувати назву формату.
-.IP "\fB\-\-merge\fR" 4
+.IP \fB\-\-merge\fR 4
.IX Item "--merge"
У режимі об'єднання програма дописує текстовий файл regedit до реєстру Windows віртуальної машини. Якщо цей параметр \fIне\fR вказано, virt-win-reg показує або експортує записи реєстру.
.Sp
Зауважте, що \fI\-\-merge\fR \fIне безпечно\fR використовувати для активних віртуальних машин. Використання цього параметра команди для активних віртуальних машин призводить до пошкодження вмісту диска. Втім, експортування (виконання команди без цього параметра) є завжди безпечним.
.IP "\fB\-\-encoding\fR UTF\-16LE|ASCII" 4
.IX Item "--encoding UTF-16LE|ASCII"
-При об'єднанні (і лише при ньому) у вас може виникнути потреба у визначення кодування рядків, які використовуються у файлі рою. Докладніший опис можна знайти у розділі \*(L"\s-1ENCODING STRINGS\*(R"\s0 in \fBWin::Hivex::Regedit\fR\|(3).
+При об'єднанні (і лише при ньому) у вас може виникнути потреба у визначення кодування рядків, які використовуються у файлі рою. Докладніший опис можна знайти у розділі "ENCODING STRINGS" in \fBWin::Hivex::Regedit\fR\|(3).
.Sp
-Типово буде використано кодування \s-1UTF\-16LE,\s0 яке має працювати у свіжих версіях Windows.
-.IP "\fB\-\-unsafe\-printable\-strings\fR" 4
+Типово буде використано кодування UTF\-16LE, яке має працювати у свіжих версіях Windows.
+.IP \fB\-\-unsafe\-printable\-strings\fR 4
.IX Item "--unsafe-printable-strings"
-Під час експортування (і лише під час нього) припускати, що рядки записано у кодуванні \s-1UTF\-16LE\s0 і виводити їх у форматі текстових рядків, а не послідовностей шістнадцяткових чисел. Вилучити завершальний нуль\-символ з рядків, якщо такий буде виявлено.
+Під час експортування (і лише під час нього) припускати, що рядки записано у кодуванні UTF\-16LE і виводити їх у форматі текстових рядків, а не послідовностей шістнадцяткових чисел. Вилучити завершальний нуль\-символ з рядків, якщо такий буде виявлено.
.Sp
Така дія не є безпечною і не надає можливості зберегти точність запису початкових рядків реєстру з різних причин:
.RS 4
-.IP "\(bu" 4
-Припускається, що початковим кодуванням є \s-1UTF\-16LE.\s0 Рядки \s-1ASCII\s0 і рядки у інших кодуваннях буде пошкоджено під час цього перетворення.
-.IP "\(bu" 4
+.IP \(bu 4
+Припускається, що початковим кодуванням є UTF\-16LE. Рядки ASCII і рядки у інших кодуваннях буде пошкоджено під час цього перетворення.
+.IP \(bu 4
Припускається, що усі дані, які належать до типу 1 чи типу 2, є насправді рядками і що усі інші дані не є рядками, але визначений тип поля у реєстрах, зазвичай, не є надійним джерелом даних.
-.IP "\(bu" 4
+.IP \(bu 4
Втрачаються дані щодо того, чи завершувався рядок у реєстрі нуль\-символом.
.RE
.RS 4
.Sp
-Усе це є наслідком того, що сам реєстр не містить даних щодо кодування рядків у ньому (див. \*(L"\s-1ENCODING STRINGS\*(R"\s0 in \fBWin::Hivex::Regedit\fR\|(3)).
+Усе це є наслідком того, що сам реєстр не містить даних щодо кодування рядків у ньому (див. "ENCODING STRINGS" in \fBWin::Hivex::Regedit\fR\|(3)).
.Sp
Цим параметром слід користуватися лише для найпростіших рішень та діагностування вмісту реєстру. \fIНіколи\fR не користуйтеся ним, якщо виведені дані має бути передано іншій програмі або збережено у іншому реєстрі.
.RE
.SH "ПІДТРИМУВАНІ СИСТЕМИ"
.IX Header "ПІДТРИМУВАНІ СИСТЕМИ"
-У поточній версії цієї програми передбачено підтримку гостьових систем, які походять від Windows \s-1NT,\s0 починаючи з Windows \s-1XP\s0 і до, принаймні, Windows 8.
+У поточній версії цієї програми передбачено підтримку гостьових систем, які походять від Windows NT, починаючи з Windows XP і до, принаймні, Windows 8.
.PP
Передбачено підтримку таких ключів реєстру:
.ie n .IP """HKEY_LOCAL_MACHINE\eSAM""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSAM\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSAM\fR 4
.IX Item "HKEY_LOCAL_MACHINESAM"
.PD 0
.ie n .IP """HKEY_LOCAL_MACHINE\eSECURITY""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSECURITY\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSECURITY\fR 4
.IX Item "HKEY_LOCAL_MACHINESECURITY"
.ie n .IP """HKEY_LOCAL_MACHINE\eSOFTWARE""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSOFTWARE\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSOFTWARE\fR 4
.IX Item "HKEY_LOCAL_MACHINESOFTWARE"
.ie n .IP """HKEY_LOCAL_MACHINE\eSYSTEM""" 4
-.el .IP "\f(CWHKEY_LOCAL_MACHINE\eSYSTEM\fR" 4
+.el .IP \f(CWHKEY_LOCAL_MACHINE\eSYSTEM\fR 4
.IX Item "HKEY_LOCAL_MACHINESYSTEM"
.ie n .IP """HKEY_USERS\e.DEFAULT""" 4
-.el .IP "\f(CWHKEY_USERS\e.DEFAULT\fR" 4
+.el .IP \f(CWHKEY_USERS\e.DEFAULT\fR 4
.IX Item "HKEY_USERS.DEFAULT"
-.ie n .IP """HKEY_USERS\e\fISID\fP""" 4
-.el .IP "\f(CWHKEY_USERS\e\f(CISID\f(CW\fR" 4
+.ie n .IP """HKEY_USERS\e\fISID\fR""" 4
+.el .IP \f(CWHKEY_USERS\e\fR\f(CISID\fR\f(CW\fR 4
.IX Item "HKEY_USERSSID"
.PD
-де \fI\s-1SID\s0\fR — \s-1SID\s0 користувача Windows (наприклад \f(CW\*(C`S\-1\-5\-18\*(C'\fR).
-.ie n .IP """HKEY_USERS\e\fIкористувач\fP""" 4
-.el .IP "\f(CWHKEY_USERS\e\f(CIкористувач\f(CW\fR" 4
+де \fISID\fR — SID користувача Windows (наприклад \f(CW\*(C`S\-1\-5\-18\*(C'\fR).
+.ie n .IP """HKEY_USERS\e\fIкористувач\fR""" 4
+.el .IP \f(CWHKEY_USERS\e\fR\f(CIкористувач\fR\f(CW\fR 4
.IX Item "HKEY_USERSкористувач"
де \fIкористувач\fR — назва облікового запису локального користувача (це розширення libguestfs).
.PP
Ви можете використовувати \f(CW\*(C`HKLM\*(C'\fR як скорочення від \f(CW\*(C`HKEY_LOCAL_MACHINE\*(C'\fR, та \f(CW\*(C`HKU\*(C'\fR як скорочення від \f(CW\*(C`HKEY_USERS\*(C'\fR.
.PP
Підтримки буквальних ключів \f(CW\*(C`HKEY_USERS\e$SID\*(C'\fR і \f(CW\*(C`HKEY_CURRENT_USER\*(C'\fR не передбачено (немає «поточного користувача»).
-.SS "\s-1WINDOWS 8\s0"
+.SS "WINDOWS 8"
.IX Subsection "WINDOWS 8"
-«Швидкий запуск» Windows 8 може заважати virt-win-reg редагувати реєстр. Див. \*(L"ПРИСИПЛЯННЯ \s-1WINDOWS\s0 ТА ШВИДКИЙ ЗАПУСК \s-1WINDOWS 8\*(R"\s0 in \fBguestfs\fR\|(3).
-.SH "КОДУВАННЯ"
+«Швидкий запуск» Windows 8 може заважати virt-win-reg редагувати реєстр. Див. "ПРИСИПЛЯННЯ WINDOWS ТА ШВИДКИЙ ЗАПУСК WINDOWS 8" in \fBguestfs\fR\|(3).
+.SH КОДУВАННЯ
.IX Header "КОДУВАННЯ"
-\&\f(CW\*(C`virt\-win\-reg\*(C'\fR вважає, що вміст файлів regedit вже перекодовано до локального кодування. Зазвичай, у основних системах Linux це означає, що використано \s-1UTF\-8\s0 із символами завершення рядків у стилі Unix. Оскільки файли regedit Windows часто записуються у кодуванні \s-1UTF\-16LE\s0 із символами завершення рядків у стилі Windows, ймовірно, вам доведеться виконати перекодування усього файла до або після обробки.
+\&\f(CW\*(C`virt\-win\-reg\*(C'\fR вважає, що вміст файлів regedit вже перекодовано до локального кодування. Зазвичай, у основних системах Linux це означає, що використано UTF\-8 із символами завершення рядків у стилі Unix. Оскільки файли regedit Windows часто записуються у кодуванні UTF\-16LE із символами завершення рядків у стилі Windows, ймовірно, вам доведеться виконати перекодування усього файла до або після обробки.
.PP
Для перекодування файла з формату Windows до формату Linux (до обробки його за допомогою команди з параметром \fI\-\-merge\fR) вам слід зробити щось таке:
.PP
.PP
Щоб дізнатися більше про кодування, ознайомтеся зі сторінкою підручника щодо \fBWin::Hivex::Regedit\fR\|(3).
.PP
-Якщо ви не певні щодо поточного кодування, скористайтеся командою \fBfile\fR\|(1). У свіжих версіях Windows regedit.exe створює файли кодування \s-1UTF\-16LE\s0 із символами завершення рядків у стилі Windows (\s-1CRLF\s0), ось такі:
+Якщо ви не певні щодо поточного кодування, скористайтеся командою \fBfile\fR\|(1). У свіжих версіях Windows regedit.exe створює файли кодування UTF\-16LE із символами завершення рядків у стилі Windows (CRLF), ось такі:
.PP
.Vb 3
\& $ file software.reg
Зауважте, що у результаті деяких із команд у підказках буде змінено образ диска гостьової системи. Гостьову систему \fIмає\fR бути вимкнено, щоб запобігти пошкодженню даних на диску.
.SS "ЗАПУСК ПАКЕТНОГО СКРИПТУ ПІД ЧАС ВХОДУ КОРИСТУВАЧА ДО СИСТЕМИ"
.IX Subsection "ЗАПУСК ПАКЕТНОГО СКРИПТУ ПІД ЧАС ВХОДУ КОРИСТУВАЧА ДО СИСТЕМИ"
-Приготуйте пакетний скрипт \s-1DOS\s0 (.bat), скрипт VBScript або виконуваний файл. Вивантажте його до гостьової системи за допомогою \fBguestfish\fR\|(1). У цьому прикладі скрипт називається \f(CW\*(C`test.bat\*(C'\fR і його вивантажено до \f(CW\*(C`C:\e\*(C'\fR:
+Приготуйте пакетний скрипт DOS (.bat), скрипт VBScript або виконуваний файл. Вивантажте його до гостьової системи за допомогою \fBguestfish\fR\|(1). У цьому прикладі скрипт називається \f(CW\*(C`test.bat\*(C'\fR і його вивантажено до \f(CW\*(C`C:\e\*(C'\fR:
.PP
.Vb 1
\& guestfish \-i \-d WindowsGuest upload test.bat /test.bat
.Ve
.PP
Нотатки:
-.IP "\(bu" 4
+.IP \(bu 4
Щодо використання \f(CW\*(C`ControlSet001\*(C'\fR див. розділ вище на цій сторінці підручника. Ймовірно, вам слід скоригувати цей запис відповідно до керівного набору, який використовується вашою гостьовою системою.
-.IP "\(bu" 4
+.IP \(bu 4
\&\f(CW"ObjectName"\fR керує правами доступу, які матиме служба. Альтернативою є \f(CW"ObjectName"="LocalSystem"\fR, яка надає права доступу найпривілейованішого облікового запису.
-.IP "\(bu" 4
+.IP \(bu 4
Щодо значення «магічних чисел» ознайомтеся із цією статтею бази даних знань Microsoft: http://support.microsoft.com/kb/103000.
.PP
Оновіть регістр:
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBhivex\fR\|(3), \fBhivexsh\fR\|(1), \fBhivexregedit\fR\|(1), \fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-tail\fR\|(1), \fBSys::Guestfs\fR\|(3), \fBWin::Hivex\fR\|(3), \fBWin::Hivex::Regedit\fR\|(3), \fBSys::Virt\fR\|(3), http://libguestfs.org/.
-.SH "АВТОР"
+.SH АВТОР
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
©Red Hat Inc., 2010
-.SH "LICENSE"
+.SH LICENSE
.IX Header "LICENSE"
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
-.IP "\(bu" 4
+.IP \(bu 4
The version of libguestfs.
-.IP "\(bu" 4
+.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
-.IP "\(bu" 4
+.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
-.IP "\(bu" 4
+.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.39.12\n"
-"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
+"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2020-07-06 15:46+0100\n"
"PO-Revision-Date: 2017-07-24 08:04+0000\n"
"Last-Translator: cheng ye <18969068329@163.com>\n"
#: ../docs/guestfs-faq.pod:1297
msgid ""
"Large new features that you intend to contribute should be discussed on the "
-"mailing list first (L<https://www.redhat.com/mailman/listinfo/libguestfs>). "
+"mailing list first (L<https://lists.libguestfs.org>). "
"This avoids disappointment and wasted work if we don't think the feature "
"would fit into the libguestfs project."
msgstr ""
#. type: textblock
#: ../docs/guestfs-testing.pod:24
-msgid "L<https://www.redhat.com/mailman/listinfo/libguestfs>"
+msgid "L<https://lists.libguestfs.org>"
msgstr ""
#. type: =head1
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
customize/ssh_key.ml
customize/subscription_manager.ml
customize/timezone.ml
-dib/cmdline.ml
-dib/dib.ml
-dib/elements.ml
-dib/output_format.ml
-dib/output_format_docker.ml
-dib/output_format_qcow2.ml
-dib/output_format_raw.ml
-dib/output_format_squashfs.ml
-dib/output_format_tar.ml
-dib/output_format_tgz.ml
-dib/output_format_vhd.ml
-dib/utils.ml
drivers/drivers.ml
+drivers/hwdata.ml
+drivers/hwdata_config.ml
get-kernel/get_kernel.ml
resize/resize.ml
sparsify/cmdline.ml
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: guestfs-tools 1.50.1\n"
+"Project-Id-Version: guestfs-tools 1.52.0\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2023-04-06 12:44+0100\n"
+"POT-Creation-Date: 2024-01-04 17:06+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
-#: dib/elements.ml:155
-msgid " %s: already provided by %s"
-msgstr ""
-
#: resize/resize.ml:1029
msgid " An extra partition will be created for the surplus."
msgstr ""
"Options:\n"
msgstr ""
-#: customize/customize_run.ml:412 common/mltools/tools_utils.ml:686
+#: customize/customize_run.ml:426 common/mltools/tools_utils.ml:695
msgid "%s (ignored)"
msgstr ""
msgid "%s did not return any output"
msgstr ""
-#: customize/customize_run.ml:181
+#: customize/customize_run.ml:191
msgid "%s does not exist in the guest"
msgstr ""
msgid "%s is not a Simple Streams (products) v1.0 JSON file (format: %s)"
msgstr ""
-#: customize/customize_run.ml:184
+#: customize/customize_run.ml:194
msgid "%s is not a regular file in the guest"
msgstr ""
-#: dib/utils.ml:97
-msgid "%s needed but not found"
-msgstr ""
-
#: common/mltools/tools_utils.ml:231 common/mltools/tools_utils.ml:202
msgid "%s: %s"
msgstr ""
msgid "%s: no ‘uri’ entry for ‘%s’ in %s, skipping it\n"
msgstr ""
-#: common/mltools/tools_utils.ml:717
+#: common/mltools/tools_utils.ml:726
msgid "%s: operation timed out"
msgstr ""
"read the man page virt-resize(1).\n"
msgstr ""
-#: dib/cmdline.ml:63
-msgid ""
-"%s: run diskimage-builder elements to generate images\n"
-"\n"
-" virt-dib -B DIB-LIB -p ELEMENTS-PATH elements...\n"
-"\n"
-"A short summary of the options is given below. For detailed help please\n"
-"read the man page virt-dib(1).\n"
-msgstr ""
-
#: sparsify/cmdline.ml:81
msgid ""
"%s: sparsify a virtual machine disk\n"
msgid "%s: zero length path in the index file\n"
msgstr ""
-#. common/mlcustomize/customize_cmdline.ml:351
-#. common/mlcustomize/customize_cmdline.ml:248
-#: customize/customize_cmdline.ml:351 customize/customize_cmdline.ml:248
+#. common/mlcustomize/customize_cmdline.ml:371
+#. common/mlcustomize/customize_cmdline.ml:268
+#: customize/customize_cmdline.ml:371 customize/customize_cmdline.ml:268
msgid "'CMD+ARGS'"
msgstr ""
msgid "--check-tmpdir: unknown argument ‘%s’"
msgstr ""
+#: customize/customize_run.ml:160
+msgid "--chown: could not parse numeric UID:GID from %s:%s"
+msgstr ""
+
#: sparsify/copying.ml:74
msgid ""
"--compress cannot be used for raw output. Remove this option or use --"
"convert qcow2."
msgstr ""
-#: dib/cmdline.ml:88
-msgid "--debug parameter must be >= 0"
-msgstr ""
-
#. customize/customize_main.ml:74
#: sysprep/main.ml:68 get-kernel/get_kernel.ml:49 drivers/drivers.ml:45
msgid "--domain option can only be given once"
msgid "--get-kernel: too many parameters"
msgstr ""
-#: customize/customize_run.ml:214
+#: customize/customize_run.ml:224
msgid ""
"--inject-qemu-ga: QEMU Guest Agent MSI not found in virtio-win source that "
"you specified"
msgstr ""
-#: customize/customize_run.ml:230
+#: customize/customize_run.ml:240
msgid ""
"--inject-virtio-win: virtio drivers were not found for this Windows version "
"in the virtio-win source that you specified"
msgid "--tmp prebuilt:file: %s: file format is not qcow2"
msgstr ""
-#: dib/cmdline.ml:241
-msgid "-B must be specified"
-msgstr ""
-
#. customize/customize_main.ml:79
#: sysprep/main.ml:126 get-kernel/get_kernel.ml:57 drivers/drivers.ml:50
msgid "Add disk image file"
msgstr ""
-#: dib/cmdline.ml:171
-msgid "Add extra packages to install"
-msgstr ""
-
-#: dib/cmdline.ml:169
-msgid "Add mkfs options"
-msgstr ""
-
-#: dib/cmdline.ml:158
-msgid "Add new a elements location"
-msgstr ""
-
-#: customize/customize_cmdline.ml:289
-#: common/mlcustomize/customize_cmdline.ml:289
+#: customize/customize_cmdline.ml:309
+#: common/mlcustomize/customize_cmdline.ml:309
msgid "Add package(s) to install"
msgstr ""
-#: customize/customize_cmdline.ml:260
-#: common/mlcustomize/customize_cmdline.ml:260
+#: customize/customize_cmdline.ml:280
+#: common/mlcustomize/customize_cmdline.ml:280
msgid "Add package(s) to install at first boot"
msgstr ""
-#: sparsify/cmdline.ml:74 dib/output_format_qcow2.ml:50
+#: sparsify/cmdline.ml:74
msgid "Add qemu-img options"
msgstr ""
msgid "Already existing image with id %s and architecture %s"
msgstr ""
-#: customize/customize_cmdline.ml:176
-#: common/mlcustomize/customize_cmdline.ml:176
+#: customize/customize_cmdline.ml:185
+#: common/mlcustomize/customize_cmdline.ml:185
msgid "Append line(s) to the file"
msgstr ""
msgid "Attach data disk/ISO during install"
msgstr ""
-#: customize/customize_cmdline.ml:369
-#: common/mlcustomize/customize_cmdline.ml:369
+#: customize/customize_cmdline.ml:389
+#: common/mlcustomize/customize_cmdline.ml:389
msgid "Attach to a subscription-manager pool"
msgstr ""
-#: customize/customize_run.ml:274
+#: customize/customize_run.ml:284
msgid "Attaching to compatible subscriptions"
msgstr ""
-#: customize/customize_run.ml:278
+#: customize/customize_run.ml:288
msgid "Attaching to the pool %s"
msgstr ""
-#: dib/cmdline.ml:194
-msgid "Base path of diskimage-builder library"
-msgstr ""
-
#: sparsify/copying.ml:348
msgid ""
"Before deleting the old disk, carefully check that the target disk boots and "
msgid "Cannot get the home directory for %s"
msgstr ""
-#: dib/dib.ml:592
-msgid "Carried environment variables: %s"
-msgstr ""
-
-#: dib/cmdline.ml:163
-msgid "Carry/set this environment variable"
-msgstr ""
-
#: sysprep/sysprep_operation_lvm_uuids.ml:84
msgid "Change LVM2 PV and VG UUIDs"
msgstr ""
msgid "Change filesystem UUIDs"
msgstr ""
-#: customize/customize_cmdline.ml:187
-#: common/mlcustomize/customize_cmdline.ml:187
+#: customize/customize_cmdline.ml:207
+#: common/mlcustomize/customize_cmdline.ml:207
+msgid "Change the owner user and group ID of a file or directory"
+msgstr ""
+
+#: customize/customize_cmdline.ml:196
+#: common/mlcustomize/customize_cmdline.ml:196
msgid "Change the permissions of a file"
msgstr ""
+#: customize/customize_run.ml:163
+msgid "Changing owner of %s to %d:%d"
+msgstr ""
+
#: customize/customize_run.ml:149
msgid "Changing permissions of %s to %s"
msgstr ""
msgid "Clearing Linux swap on %s"
msgstr ""
-#: customize/customize_cmdline.ml:490
-#: common/mlcustomize/customize_cmdline.ml:490
+#: customize/customize_cmdline.ml:521
+#: common/mlcustomize/customize_cmdline.ml:521
msgid "Compatibility option doing nothing"
msgstr ""
msgid "Compressed output format"
msgstr ""
-#: dib/output_format_squashfs.ml:28
-msgid "Compressing the image as squashfs"
-msgstr ""
-
-#: dib/output_format_tar.ml:25
-msgid "Compressing the image as tar"
-msgstr ""
-
-#: dib/output_format_tgz.ml:25
-msgid "Compressing the image as tar.gz"
-msgstr ""
-
#: builder/builder.ml:710
msgid "Converting %s to %s"
msgstr ""
msgid "Converting to %s"
msgstr ""
-#: dib/output_format_vhd.ml:29
-msgid "Converting to VHD"
-msgstr ""
-
-#: dib/output_format_qcow2.ml:35
-msgid "Converting to qcow2"
+#: customize/customize_cmdline.ml:229
+#: common/mlcustomize/customize_cmdline.ml:229
+msgid "Copy files in disk image"
msgstr ""
-#: customize/customize_cmdline.ml:209
-#: common/mlcustomize/customize_cmdline.ml:209
-msgid "Copy files in disk image"
+#: customize/customize_cmdline.ml:430
+#: common/mlcustomize/customize_cmdline.ml:430
+msgid "Copy local files or directories from a tarball into image"
msgstr ""
-#: customize/customize_cmdline.ml:220
-#: common/mlcustomize/customize_cmdline.ml:220
+#: customize/customize_cmdline.ml:240
+#: common/mlcustomize/customize_cmdline.ml:240
msgid "Copy local files or directories into image"
msgstr ""
msgid "Copying %s"
msgstr ""
-#: customize/customize_run.ml:166
+#: customize/customize_run.ml:176
msgid "Copying (in image): %s to %s"
msgstr ""
-#: customize/customize_run.ml:170
+#: customize/customize_run.ml:180
msgid "Copying: %s to %s"
msgstr ""
-#: customize/customize_cmdline.ml:306
-#: common/mlcustomize/customize_cmdline.ml:306
+#: customize/customize_cmdline.ml:326
+#: common/mlcustomize/customize_cmdline.ml:326
msgid "Create a directory"
msgstr ""
msgid "Create overlay file in %s to protect source disk"
msgstr ""
-#: customize/customize_cmdline.ml:300
-#: common/mlcustomize/customize_cmdline.ml:300
+#: customize/customize_cmdline.ml:320
+#: common/mlcustomize/customize_cmdline.ml:320
msgid "Create symbolic links"
msgstr ""
msgid "Creating index backup copy"
msgstr ""
-#: customize/customize_cmdline.ml:500
-#: common/mlcustomize/customize_cmdline.ml:500
+#: customize/customize_cmdline.ml:531
+#: common/mlcustomize/customize_cmdline.ml:531
msgid "Credentials for subscription-manager"
msgstr ""
"for installing packages, editing files and so on."
msgstr ""
-#: customize/customize_cmdline.ml:305
-#: common/mlcustomize/customize_cmdline.ml:305
+#: customize/customize_cmdline.ml:325
+#: common/mlcustomize/customize_cmdline.ml:325
msgid "DIR"
msgstr ""
-#: customize/customize_cmdline.ml:226
-#: common/mlcustomize/customize_cmdline.ml:226
+#: customize/customize_cmdline.ml:246
+#: common/mlcustomize/customize_cmdline.ml:246
msgid "Delete a file or directory"
msgstr ""
msgid "Delete the template cache"
msgstr ""
-#: customize/customize_run.ml:174 builder/builder.ml:139
+#: customize/customize_run.ml:184 builder/builder.ml:139
msgid "Deleting: %s"
msgstr ""
-#: dib/cmdline.ml:188 customize/customize_main.ml:89 builder/cmdline.ml:158
+#: customize/customize_main.ml:89 builder/cmdline.ml:158
msgid "Disable appliance network"
msgstr ""
msgid "Display version and exit"
msgstr ""
-#: dib/output_format_qcow2.ml:49
-msgid "Do not compress the qcow2 image"
-msgstr ""
-
#: builder/cmdline.ml:166
msgid "Do not fsync output file on exit"
msgstr ""
-#: customize/customize_cmdline.ml:484
-#: common/mlcustomize/customize_cmdline.ml:484
+#: customize/customize_cmdline.ml:515
+#: common/mlcustomize/customize_cmdline.ml:515
msgid "Do not relabel files with correct SELinux labels"
msgstr ""
msgid "Do not warn if writing to a partition"
msgstr ""
-#: dib/dib.ml:1005
-msgid "Done"
-msgstr ""
-
#: builder/repository_main.ml:56
msgid "Don’t compress the new images in the index"
msgstr ""
msgid "Don’t create extra partition"
msgstr ""
-#: dib/cmdline.ml:191 builder/cmdline.ml:145
+#: builder/cmdline.ml:145
msgid "Don’t delete output file on failure"
msgstr ""
msgid "Downloading: %s"
msgstr ""
-#: customize/customize_cmdline.ml:237
-#: common/mlcustomize/customize_cmdline.ml:237
+#: customize/customize_cmdline.ml:257
+#: common/mlcustomize/customize_cmdline.ml:257
msgid "Edit file using Perl expression"
msgstr ""
-#: customize/customize_run.ml:178
+#: customize/customize_run.ml:188
msgid "Editing: %s"
msgstr ""
-#: dib/dib.ml:565
-msgid "Elements: %s"
-msgstr ""
-
#: sysprep/main.ml:136
msgid "Enable appliance network"
msgstr ""
-#: dib/cmdline.ml:187 customize/customize_main.ml:88 builder/cmdline.ml:157
+#: customize/customize_main.ml:88 builder/cmdline.ml:157
msgid "Enable appliance network (default)"
msgstr ""
msgid "Examining the guest ..."
msgstr ""
-#: dib/cmdline.ml:160
-msgid "Exclude the specified element"
-msgstr ""
-
-#: dib/cmdline.ml:162
-msgid "Exclude the specified script"
-msgstr ""
-
#: resize/resize.ml:207
msgid "Expand logical volume"
msgstr ""
msgid "Expandable volume: "
msgstr ""
-#: dib/dib.ml:588
-msgid "Expanded elements: %s"
-msgstr ""
-
#: resize/resize.ml:1469
msgid "Expanding %s using the ‘%s’ method"
msgstr ""
msgid "Extracting data from the image..."
msgstr ""
-#: dib/dib.ml:936
-msgid "Extracting data out of the image"
-msgstr ""
-
-#. customize/customize_cmdline.ml:357
-#. common/mlcustomize/customize_cmdline.ml:422
-#. common/mlcustomize/customize_cmdline.ml:404
-#. common/mlcustomize/customize_cmdline.ml:357
-#: customize/customize_cmdline.ml:422 customize/customize_cmdline.ml:404
+#. customize/customize_cmdline.ml:377
+#. common/mlcustomize/customize_cmdline.ml:447
+#. common/mlcustomize/customize_cmdline.ml:441
+#. common/mlcustomize/customize_cmdline.ml:377
+#: customize/customize_cmdline.ml:447 customize/customize_cmdline.ml:441
msgid "FILE"
msgstr ""
-#: customize/customize_cmdline.ml:457
-#: common/mlcustomize/customize_cmdline.ml:457
+#: customize/customize_cmdline.ml:488
+#: common/mlcustomize/customize_cmdline.ml:488
msgid "FILE:CONTENT"
msgstr ""
-#: customize/customize_cmdline.ml:446
-#: common/mlcustomize/customize_cmdline.ml:446
+#: customize/customize_cmdline.ml:477
+#: common/mlcustomize/customize_cmdline.ml:477
msgid "FILE:DEST"
msgstr ""
-#: customize/customize_cmdline.ml:232
-#: common/mlcustomize/customize_cmdline.ml:232
+#: customize/customize_cmdline.ml:252
+#: common/mlcustomize/customize_cmdline.ml:252
msgid "FILE:EXPR"
msgstr ""
-#: customize/customize_cmdline.ml:171
-#: common/mlcustomize/customize_cmdline.ml:171
+#: customize/customize_cmdline.ml:180
+#: common/mlcustomize/customize_cmdline.ml:180
msgid "FILE:LINE"
msgstr ""
-#: customize/customize_cmdline.ml:193
-#: common/mlcustomize/customize_cmdline.ml:193
+#: customize/customize_cmdline.ml:213
+#: common/mlcustomize/customize_cmdline.ml:213
msgid "FILENAME"
msgstr ""
"The underlying error was: %s"
msgstr ""
-#: dib/cmdline.ml:179
-msgid "Filesystem for the image"
-msgstr ""
-
#: sparsify/copying.ml:264
msgid "Fill free space in %s with zero"
msgstr ""
msgid "Format of input disk"
msgstr ""
-#: dib/cmdline.ml:184
-msgid "Format of optional drive"
-msgstr ""
-
#: resize/resize.ml:210
msgid "Format of output disk"
msgstr ""
"- Check no one has tampered with the website or your network!"
msgstr ""
-#: dib/cmdline.ml:172
-msgid "Generate MD5 and SHA256 checksum files"
-msgstr ""
-
-#: dib/dib.ml:984
-msgid "Generating checksums for %s"
-msgstr ""
-
#: builder/cmdline.ml:150
msgid "Get kernel from image"
msgstr ""
-#: customize/customize_cmdline.ml:265
-#: common/mlcustomize/customize_cmdline.ml:265
+#: customize/customize_cmdline.ml:285
+#: common/mlcustomize/customize_cmdline.ml:285
msgid "HOSTNAME"
msgstr ""
msgid "Ignore partition"
msgstr ""
-#: dib/output_format_docker.ml:39
-msgid "Importing the image to docker as ‘%s’"
-msgstr ""
-
#: sysprep/sysprep_operation_ca_certificates.ml:56
msgid "In case any certificate is removed, the system CA store is updated."
msgstr ""
-#: customize/customize_cmdline.ml:399
-#: common/mlcustomize/customize_cmdline.ml:399
+#: customize/customize_cmdline.ml:419
+#: common/mlcustomize/customize_cmdline.ml:419
msgid "Inject a public key into the guest"
msgstr ""
-#: customize/customize_cmdline.ml:272
-#: common/mlcustomize/customize_cmdline.ml:272
+#: customize/customize_cmdline.ml:292
+#: common/mlcustomize/customize_cmdline.ml:292
msgid "Inject the QEMU Guest Agent into a Windows guest"
msgstr ""
-#: customize/customize_cmdline.ml:278
-#: common/mlcustomize/customize_cmdline.ml:278
+#: customize/customize_cmdline.ml:298
+#: common/mlcustomize/customize_cmdline.ml:298
msgid "Inject virtio-win drivers into a Windows guest"
msgstr ""
-#: dib/cmdline.ml:166
-msgid "Installation type"
-msgstr ""
-
-#: customize/customize_run.ml:189
+#: customize/customize_run.ml:199
msgid "Installing firstboot command: %s"
msgstr ""
-#: customize/customize_run.ml:193
+#: customize/customize_run.ml:203
msgid "Installing firstboot packages: %s"
msgstr ""
-#: customize/customize_run.ml:200
+#: customize/customize_run.ml:210
msgid "Installing firstboot script: %s"
msgstr ""
-#: customize/customize_run.ml:237
+#: customize/customize_run.ml:247
msgid "Installing packages: %s"
msgstr ""
-#: dib/dib.ml:514
-msgid "Installing: %s"
-msgstr ""
-
#: builder/list_entries.ml:66
msgid "Key: %s\n"
msgstr ""
-#: customize/customize_cmdline.ml:215
-#: common/mlcustomize/customize_cmdline.ml:215
+#: customize/customize_cmdline.ml:235
+#: common/mlcustomize/customize_cmdline.ml:235
msgid "LOCALPATH:REMOTEDIR"
msgstr ""
-#: dib/cmdline.ml:165
-msgid "Label for the root fs"
-msgstr ""
-
-#: customize/customize_run.ml:244
+#: customize/customize_run.ml:254
msgid "Linking: %s -> %s"
msgstr ""
msgid "List supported operations"
msgstr ""
-#: dib/cmdline.ml:167
-msgid "Location for cached images"
-msgstr ""
-
-#. common/mlcustomize/customize_cmdline.ml:277
-#. common/mlcustomize/customize_cmdline.ml:271
-#: customize/customize_cmdline.ml:277 customize/customize_cmdline.ml:271
+#. common/mlcustomize/customize_cmdline.ml:297
+#. common/mlcustomize/customize_cmdline.ml:291
+#: customize/customize_cmdline.ml:297 customize/customize_cmdline.ml:291
msgid "METHOD"
msgstr ""
-#: dib/cmdline.ml:176
-msgid "Main element for building ramdisks"
-msgstr ""
-
#: common/mltools/tools_utils.ml:426
msgid "Make output machine readable"
msgstr ""
-#: customize/customize_run.ml:249
+#: customize/customize_run.ml:259
msgid "Making directory: %s"
msgstr ""
msgid "Mount point on host"
msgstr ""
-#: customize/customize_cmdline.ml:317
-#: common/mlcustomize/customize_cmdline.ml:317
+#: customize/customize_cmdline.ml:337
+#: common/mlcustomize/customize_cmdline.ml:337
msgid "Move files in disk image"
msgstr ""
msgid "Moving files to final destination"
msgstr ""
-#: customize/customize_run.ml:253
+#: customize/customize_run.ml:263
msgid "Moving: %s -> %s"
msgstr ""
-#: dib/cmdline.ml:178
-msgid "Name of the image"
-msgstr ""
-
#: builder/repository_main.ml:497
msgid "No new image found"
msgstr ""
"building rhsrvany (https://github.com/rwmjones/rhsrvany)"
msgstr ""
-#: dib/dib.ml:717
-msgid "Opening the disks"
-msgstr ""
-
#: builder/builder.ml:722
msgid "Opening the new disk"
msgstr ""
-#: dib/cmdline.ml:183
-msgid "Optional drive for caches"
-msgstr ""
-
-#: dib/cmdline.ml:182
-msgid "Output architecture"
-msgstr ""
-
#: get-kernel/get_kernel.ml:62
msgid "Output directory"
msgstr ""
msgid "Output format (default: raw)"
msgstr ""
-#: dib/cmdline.ml:181
-msgid "Output formats"
-msgstr ""
-
#: builder/builder.ml:783
msgid "Output size"
msgstr ""
-#. common/mlcustomize/customize_cmdline.ml:410
-#. common/mlcustomize/customize_cmdline.ml:225
-#: customize/customize_cmdline.ml:410 customize/customize_cmdline.ml:225
+#. common/mlcustomize/customize_cmdline.ml:453
+#. common/mlcustomize/customize_cmdline.ml:245
+#: customize/customize_cmdline.ml:453 customize/customize_cmdline.ml:245
msgid "PATH"
msgstr ""
-#: customize/customize_cmdline.ml:182
-#: common/mlcustomize/customize_cmdline.ml:182
+#: customize/customize_cmdline.ml:191
+#: common/mlcustomize/customize_cmdline.ml:191
msgid "PERMISSIONS:FILE"
msgstr ""
-#. customize/customize_cmdline.ml:255
-#. common/mlcustomize/customize_cmdline.ml:429
-#. common/mlcustomize/customize_cmdline.ml:284
-#. common/mlcustomize/customize_cmdline.ml:255
-#: customize/customize_cmdline.ml:429 customize/customize_cmdline.ml:284
+#. customize/customize_cmdline.ml:275
+#. common/mlcustomize/customize_cmdline.ml:460
+#. common/mlcustomize/customize_cmdline.ml:304
+#. common/mlcustomize/customize_cmdline.ml:275
+#: customize/customize_cmdline.ml:460 customize/customize_cmdline.ml:304
msgid "PKG,PKG.."
msgstr ""
msgid "Preparing %s"
msgstr ""
-#: dib/dib.ml:612
-msgid "Preparing auxiliary data"
-msgstr ""
-
#: builder/cmdline.ml:162
msgid "Print info about template cache"
msgstr ""
-#: customize/customize_cmdline.ml:198
-#: common/mlcustomize/customize_cmdline.ml:198
+#: customize/customize_cmdline.ml:218
+#: common/mlcustomize/customize_cmdline.ml:218
msgid "Read customize commands from file"
msgstr ""
msgid "Read passphrases from stdin"
msgstr ""
-#: customize/customize_cmdline.ml:411
-#: common/mlcustomize/customize_cmdline.ml:411
+#: customize/customize_cmdline.ml:454
+#: common/mlcustomize/customize_cmdline.ml:454
msgid "Recursively truncate all files in directory"
msgstr ""
-#: customize/customize_run.ml:320
+#: customize/customize_run.ml:334
msgid "Recursively truncating: %s"
msgstr ""
-#: customize/customize_cmdline.ml:375
-#: common/mlcustomize/customize_cmdline.ml:375
+#: customize/customize_cmdline.ml:395
+#: common/mlcustomize/customize_cmdline.ml:395
msgid "Register using subscription-manager"
msgstr ""
-#: customize/customize_run.ml:284
+#: customize/customize_run.ml:294
msgid "Registering with subscription-manager"
msgstr ""
"This operation does not run C<ipa-client>."
msgstr ""
-#: customize/customize_cmdline.ml:381
-#: common/mlcustomize/customize_cmdline.ml:381
+#: customize/customize_cmdline.ml:401
+#: common/mlcustomize/customize_cmdline.ml:401
msgid "Remove all the subscriptions"
msgstr ""
msgid "Remove user at-jobs and cron-jobs"
msgstr ""
-#: customize/customize_run.ml:299
+#: customize/customize_run.ml:309
msgid "Removing all the subscriptions"
msgstr ""
-#: dib/output_format_docker.ml:51
-msgid "Repo and tag for docker"
-msgstr ""
-
#: resize/resize.ml:1499
msgid ""
"Resize operation completed with no errors. Before deleting the old disk, "
msgid "Run arbitrary scripts against the guest"
msgstr ""
-#: customize/customize_cmdline.ml:249
-#: common/mlcustomize/customize_cmdline.ml:249
+#: customize/customize_cmdline.ml:269
+#: common/mlcustomize/customize_cmdline.ml:269
msgid "Run command at first guest boot"
msgstr ""
-#: customize/customize_cmdline.ml:352
-#: common/mlcustomize/customize_cmdline.ml:352
+#: customize/customize_cmdline.ml:372
+#: common/mlcustomize/customize_cmdline.ml:372
msgid "Run command in disk image"
msgstr ""
-#: customize/customize_cmdline.ml:243
-#: common/mlcustomize/customize_cmdline.ml:243
+#: customize/customize_cmdline.ml:263
+#: common/mlcustomize/customize_cmdline.ml:263
msgid "Run script at first guest boot"
msgstr ""
-#: customize/customize_cmdline.ml:346
-#: common/mlcustomize/customize_cmdline.ml:346
+#: customize/customize_cmdline.ml:366
+#: common/mlcustomize/customize_cmdline.ml:366
msgid "Run script in disk image"
msgstr ""
"the full absolute path to the script."
msgstr ""
-#: customize/customize_cmdline.ml:423
-#: common/mlcustomize/customize_cmdline.ml:423
+#: customize/customize_cmdline.ml:442
+#: common/mlcustomize/customize_cmdline.ml:442
msgid "Run touch on a file"
msgstr ""
-#: customize/customize_run.ml:329
+#: customize/customize_run.ml:343
msgid "Running touch: %s"
msgstr ""
-#: customize/customize_run.ml:263 customize/customize_run.ml:157
+#: customize/customize_run.ml:273 customize/customize_run.ml:167
msgid "Running: %s"
msgstr ""
-#: dib/dib.ml:474 dib/dib.ml:423
-msgid "Running: %s/%s"
-msgstr ""
-
-#. common/mlcustomize/customize_cmdline.ml:345
-#. common/mlcustomize/customize_cmdline.ml:242
-#: customize/customize_cmdline.ml:345 customize/customize_cmdline.ml:242
+#. common/mlcustomize/customize_cmdline.ml:365
+#. common/mlcustomize/customize_cmdline.ml:262
+#: customize/customize_cmdline.ml:365 customize/customize_cmdline.ml:262
msgid "SCRIPT"
msgstr ""
-#. customize/customize_cmdline.ml:335
+#. customize/customize_cmdline.ml:355
#. common/mltools/tools_utils.ml:422
-#. common/mlcustomize/customize_cmdline.ml:496
-#. common/mlcustomize/customize_cmdline.ml:364
-#. common/mlcustomize/customize_cmdline.ml:335
-#: customize/customize_cmdline.ml:496 customize/customize_cmdline.ml:364
+#. common/mlcustomize/customize_cmdline.ml:527
+#. common/mlcustomize/customize_cmdline.ml:384
+#. common/mlcustomize/customize_cmdline.ml:355
+#: customize/customize_cmdline.ml:527 customize/customize_cmdline.ml:384
msgid "SELECTOR"
msgstr ""
-#: customize/customize_run.ml:385
+#: customize/customize_run.ml:399
msgid "SELinux relabelling"
msgstr ""
-#. common/mlcustomize/customize_cmdline.ml:312
-#. common/mlcustomize/customize_cmdline.ml:204
-#: customize/customize_cmdline.ml:312 customize/customize_cmdline.ml:204
+#. common/mlcustomize/customize_cmdline.ml:332
+#. common/mlcustomize/customize_cmdline.ml:224
+#: customize/customize_cmdline.ml:332 customize/customize_cmdline.ml:224
msgid "SOURCE:DEST"
msgstr ""
-#: customize/customize_run.ml:313
+#: customize/customize_run.ml:323
msgid "SSH key could not be injected for this type of guest"
msgstr ""
-#: customize/customize_run.ml:310
+#: customize/customize_run.ml:320
msgid "SSH key inject: %s"
msgstr ""
msgid "Script or program to run on guest"
msgstr ""
-#: customize/customize_cmdline.ml:358
-#: common/mlcustomize/customize_cmdline.ml:358
+#: customize/customize_cmdline.ml:378
+#: common/mlcustomize/customize_cmdline.ml:378
msgid "Scrub a file"
msgstr ""
-#: customize/customize_cmdline.ml:468
-#: common/mlcustomize/customize_cmdline.ml:468
+#: customize/customize_cmdline.ml:499
+#: common/mlcustomize/customize_cmdline.ml:499
msgid "Scrub build log file"
msgstr ""
-#: customize/customize_run.ml:396
+#: customize/customize_run.ml:410
msgid "Scrubbing the log file"
msgstr ""
-#: customize/customize_run.ml:268
+#: customize/customize_run.ml:278
msgid "Scrubbing: %s"
msgstr ""
msgid "Set GPG binary/command"
msgstr ""
-#: dib/cmdline.ml:173
-msgid "Set Python interpreter"
-msgstr ""
-
#: customize/customize_main.ml:82 builder/cmdline.ml:132
msgid "Set attach disk format"
msgstr ""
msgid "Set curl binary/command"
msgstr ""
-#: dib/cmdline.ml:193
-msgid "Set debug level"
-msgstr ""
-
#: get-kernel/get_kernel.ml:58 drivers/drivers.ml:51
msgid "Set disk sector size"
msgstr ""
msgid "Set libvirt guest name"
msgstr ""
-#: dib/cmdline.ml:186 customize/customize_main.ml:87 builder/cmdline.ml:156
+#: customize/customize_main.ml:87 builder/cmdline.ml:156
msgid "Set memory size"
msgstr ""
msgid "Set mount options (eg /:noatime;/var:rw,noatime)"
msgstr ""
-#: dib/cmdline.ml:189 customize/customize_main.ml:90 builder/cmdline.ml:164
+#: customize/customize_main.ml:90 builder/cmdline.ml:164
msgid "Set number of vCPUs"
msgstr ""
-#: dib/cmdline.ml:180 builder/cmdline.ml:163
+#: builder/cmdline.ml:163
msgid "Set output disk size"
msgstr ""
msgid "Set partition alignment (default: 128 sectors)"
msgstr ""
-#: customize/customize_cmdline.ml:478
-#: common/mlcustomize/customize_cmdline.ml:478
+#: customize/customize_cmdline.ml:509
+#: common/mlcustomize/customize_cmdline.ml:509
msgid "Set password crypto"
msgstr ""
msgid "Set program name"
msgstr ""
-#: customize/customize_cmdline.ml:340
-#: common/mlcustomize/customize_cmdline.ml:340
+#: customize/customize_cmdline.ml:360
+#: common/mlcustomize/customize_cmdline.ml:360
msgid "Set root password"
msgstr ""
msgid "Set temporary block device, directory or prebuilt file"
msgstr ""
-#: customize/customize_cmdline.ml:417
-#: common/mlcustomize/customize_cmdline.ml:417
+#: customize/customize_cmdline.ml:436
+#: common/mlcustomize/customize_cmdline.ml:436
msgid "Set the default timezone"
msgstr ""
msgid "Set the format for --list (default: short)"
msgstr ""
-#: customize/customize_cmdline.ml:266
-#: common/mlcustomize/customize_cmdline.ml:266
+#: customize/customize_cmdline.ml:286
+#: common/mlcustomize/customize_cmdline.ml:286
msgid "Set the hostname"
msgstr ""
msgid "Set the output architecture"
msgstr ""
-#: customize/customize_cmdline.ml:329
-#: common/mlcustomize/customize_cmdline.ml:329
+#: customize/customize_cmdline.ml:349
+#: common/mlcustomize/customize_cmdline.ml:349
msgid "Set user password"
msgstr ""
msgid "Setting a random seed"
msgstr ""
-#: customize/customize_run.ml:376
+#: customize/customize_run.ml:390
msgid "Setting passwords"
msgstr ""
msgid "Setting random password of %s to %s"
msgstr ""
-#: customize/customize_run.ml:205
+#: customize/customize_run.ml:215
msgid "Setting the hostname: %s"
msgstr ""
msgid "Setting the machine ID in %s"
msgstr ""
-#: customize/customize_run.ml:324
+#: customize/customize_run.ml:338
msgid "Setting the timezone: %s"
msgstr ""
msgid "Setting up initial partition table on %s"
msgstr ""
-#: dib/dib.ml:858
-msgid "Setting up the destination root"
-msgstr ""
-
#: builder/cmdline.ml:153
msgid "Shortcut for --list-format long"
msgstr ""
msgid "Signing index with the GPG key %s"
msgstr ""
-#: dib/cmdline.ml:164
-msgid "Skip the inclusion of the ‘base’ element"
-msgstr ""
-
#: sparsify/copying.ml:260
msgid "Skipping %s, as it is a read-only btrfs snapshot."
msgstr ""
msgid "Specify a LUKS key"
msgstr ""
-#: customize/customize_cmdline.ml:295
-#: common/mlcustomize/customize_cmdline.ml:295
+#: customize/customize_cmdline.ml:425
+#: common/mlcustomize/customize_cmdline.ml:425
+msgid "TARFILE:REMOTEDIR"
+msgstr ""
+
+#: customize/customize_cmdline.ml:315
+#: common/mlcustomize/customize_cmdline.ml:315
msgid "TARGET:LINK[:LINK..]"
msgstr ""
-#: customize/customize_cmdline.ml:416
-#: common/mlcustomize/customize_cmdline.ml:416
+#: customize/customize_cmdline.ml:435
+#: common/mlcustomize/customize_cmdline.ml:435
msgid "TIMEZONE"
msgstr ""
"larger by at least this amount or adjust your resizing requests."
msgstr ""
-#: dib/elements.ml:205
-msgid ""
-"There is a duplicated script in your elements:\n"
-"%s/%s in: %s"
-msgstr ""
-
#: resize/resize.ml:1026
msgid "There is a surplus of %s."
msgstr ""
msgid "Trimming %s"
msgstr ""
-#: customize/customize_cmdline.ml:405
-#: common/mlcustomize/customize_cmdline.ml:405
+#: customize/customize_cmdline.ml:448
+#: common/mlcustomize/customize_cmdline.ml:448
msgid "Truncate a file to zero size"
msgstr ""
-#: customize/customize_run.ml:316
+#: customize/customize_run.ml:330
msgid "Truncating: %s"
msgstr ""
msgid "Turn off sparse copying"
msgstr ""
-#: customize/customize_cmdline.ml:323
-#: common/mlcustomize/customize_cmdline.ml:323
+#: customize/customize_cmdline.ml:202
+#: common/mlcustomize/customize_cmdline.ml:202
+msgid "UID:GID:PATH"
+msgstr ""
+
+#: customize/customize_cmdline.ml:343
+#: common/mlcustomize/customize_cmdline.ml:343
msgid "USER:SELECTOR"
msgstr ""
-#: customize/customize_cmdline.ml:393
-#: common/mlcustomize/customize_cmdline.ml:393
+#: customize/customize_cmdline.ml:413
+#: common/mlcustomize/customize_cmdline.ml:413
msgid "USER[:SELECTOR]"
msgstr ""
msgid "UUID in swap partition %s changed from ‘%s’ to ‘%s’"
msgstr ""
-#: dib/dib.ml:961
-msgid "Umounting the disks"
-msgstr ""
-
#: builder/builder.ml:656
msgid "Uncompressing"
msgstr ""
-#: customize/customize_cmdline.ml:434
-#: common/mlcustomize/customize_cmdline.ml:434
+#: customize/customize_cmdline.ml:465
+#: common/mlcustomize/customize_cmdline.ml:465
msgid "Uninstall package(s)"
msgstr ""
-#: customize/customize_run.ml:333
+#: customize/customize_run.ml:347
msgid "Uninstalling packages: %s"
msgstr ""
-#: customize/customize_cmdline.ml:387
-#: common/mlcustomize/customize_cmdline.ml:387
+#: customize/customize_run.ml:326
+msgid "Unpack tar file: %s to %s"
+msgstr ""
+
+#: customize/customize_cmdline.ml:407
+#: common/mlcustomize/customize_cmdline.ml:407
msgid "Unregister using subscription-manager"
msgstr ""
-#: customize/customize_run.ml:304
+#: customize/customize_run.ml:314
msgid "Unregistering with subscription-manager"
msgstr ""
-#: customize/customize_cmdline.ml:440
-#: common/mlcustomize/customize_cmdline.ml:440
+#: customize/customize_cmdline.ml:471
+#: common/mlcustomize/customize_cmdline.ml:471
msgid "Update packages"
msgstr ""
-#: customize/customize_run.ml:338
+#: customize/customize_run.ml:352
msgid "Updating packages"
msgstr ""
-#: customize/customize_cmdline.ml:451
-#: common/mlcustomize/customize_cmdline.ml:451
+#: customize/customize_cmdline.ml:482
+#: common/mlcustomize/customize_cmdline.ml:482
msgid "Upload local file to destination"
msgstr ""
-#: customize/customize_run.ml:343
+#: customize/customize_run.ml:357
msgid "Uploading: %s to %s"
msgstr ""
msgid "Using prebuilt file %s as overlay"
msgstr ""
-#: dib/output_format_vhd.ml:38
-msgid ""
-"VHD output not produced, most probably vhd-util is old or not patched for "
-"‘convert’"
-msgstr ""
-
#: common/mltools/tools_utils.ml:392
msgid "Wrap log messages even if not tty"
msgstr ""
-#: customize/customize_cmdline.ml:462
-#: common/mlcustomize/customize_cmdline.ml:462
+#: customize/customize_cmdline.ml:493
+#: common/mlcustomize/customize_cmdline.ml:493
msgid "Write file"
msgstr ""
-#: customize/customize_run.ml:368
+#: customize/customize_run.ml:382
msgid "Writing: %s"
msgstr ""
msgid "append_line: %s is not a file"
msgstr ""
-#: dib/cmdline.ml:252
-msgid "at least one distribution root element must be specified"
-msgstr ""
-
#: sparsify/cmdline.ml:75
msgid "block|dir|prebuilt:file"
msgstr ""
"the virt-customize(1) manual)."
msgstr ""
-#: customize/customize_cmdline.ml:520
-#: common/mlcustomize/customize_cmdline.ml:520
+#: customize/customize_cmdline.ml:551
+#: common/mlcustomize/customize_cmdline.ml:551
msgid "command '%s' cannot be used in command files, see the man page"
msgstr ""
-#: customize/customize_cmdline.ml:537
-#: common/mlcustomize/customize_cmdline.ml:537
+#: customize/customize_cmdline.ml:568
+#: common/mlcustomize/customize_cmdline.ml:568
msgid "command '%s' not valid, see the man page"
msgstr ""
msgid "disabling the cache"
msgstr ""
-#: dib/output_format.ml:102
-msgid "disallowed character (%c) in format name"
-msgstr ""
-
#: sysprep/sysprep_operation.ml:148
msgid "disallowed character (%c) in operation name"
msgstr ""
msgid "discard/trim is not supported"
msgstr ""
-#: dib/output_format_docker.ml:32
-msgid "docker: a target was not specified, use ‘--docker-target’"
-msgstr ""
-
#. customize/customize_main.ml:84
#: sysprep/main.ml:128 get-kernel/get_kernel.ml:60 drivers/drivers.ml:53
msgid "domain"
msgid "don’t know how to remove packages using %s: packages: %s"
msgstr ""
-#: get-kernel/get_kernel.ml:192
-msgid "dual/multi-boot images are not supported by this tool"
+#: common/mltools/curl.ml:82
+msgid "downloading %s"
msgstr ""
-#: dib/output_format.ml:90
-msgid "duplicate format name (%s)"
+#: get-kernel/get_kernel.ml:192
+msgid "dual/multi-boot images are not supported by this tool"
msgstr ""
#: sysprep/sysprep_operation.ml:136
msgid "duplicate operation name (%s)"
msgstr ""
-#: dib/elements.ml:125
-msgid "element %s not found"
-msgstr ""
-
#: resize/resize.ml:172
msgid "empty --expand option"
msgstr ""
msgid "exception: %s"
msgstr ""
+#: common/mltools/tools_utils.ml:455
+msgid "exited with error %d"
+msgstr ""
+
#: common/mltools/xpath_helpers.ml:36
msgid ""
"expecting XML expression to return an integer (expression: %s, matching "
"string: %s)"
msgstr ""
-#: sparsify/copying.ml:343
-msgid "external command failed: %s"
-msgstr ""
-
-#: dib/dib.ml:998 common/mltools/tools_utils.ml:451
-msgid "external command ‘%s’ exited with error %d"
-msgstr ""
-
-#: common/mltools/tools_utils.ml:532 common/mltools/tools_utils.ml:453
-msgid "external command ‘%s’ killed by signal %d"
+#: common/mltools/tools_utils.ml:440
+msgid "external command"
msgstr ""
-#: common/mltools/tools_utils.ml:534 common/mltools/tools_utils.ml:455
-msgid "external command ‘%s’ stopped by signal %d"
+#: sparsify/copying.ml:343
+msgid "external command failed: %s"
msgstr ""
-#: builder/downloader.ml:127
+#: builder/downloader.ml:126
msgid "failed to download %s: HTTP status code %s"
msgstr ""
"will not be removed"
msgstr ""
-#: dib/elements.ml:159
-msgid ""
-"following elements are already provided by another element:\n"
-"%s"
-msgstr ""
-
#. resize/resize.ml:210
#. resize/resize.ml:205
#. get-kernel/get_kernel.ml:61
#. drivers/drivers.ml:54
-#. dib/cmdline.ml:184
#. customize/customize_main.ml:86
#: sysprep/main.ml:133 sparsify/cmdline.ml:71 sparsify/cmdline.ml:70
msgid "format"
msgstr ""
-#: dib/output_format.ml:97
-msgid "format name is an empty string"
-msgstr ""
-
#: sparsify/cmdline.ml:76 sparsify/cmdline.ml:72
msgid "fs"
msgstr ""
"firstboot scripts instead."
msgstr ""
-#: customize/customize_run.ml:207
+#: customize/customize_run.ml:217
msgid "hostname could not be set for this type of guest"
msgstr ""
+#: drivers/hwdata.ml:138
+msgid "hwdata: %s: %s"
+msgstr ""
+
#: resize/resize.ml:215
msgid "ignore|warn|error"
msgstr ""
msgid "internal error: regular expression did not match ‘%s’"
msgstr ""
-#. common/mlcustomize/customize_cmdline.ml:162
-#. common/mlcustomize/customize_cmdline.ml:151
-#: customize/customize_cmdline.ml:162 customize/customize_cmdline.ml:151
+#. customize/customize_cmdline.ml:155
+#. common/mlcustomize/customize_cmdline.ml:171
+#. common/mlcustomize/customize_cmdline.ml:163
+#. common/mlcustomize/customize_cmdline.ml:155
+#: customize/customize_cmdline.ml:171 customize/customize_cmdline.ml:163
msgid "invalid format for '--%s' parameter, see the man page"
msgstr ""
msgid "invalid format string for --machine-readable: %s"
msgstr ""
-#: dib/cmdline.ml:116
-msgid "invalid format ‘%s’ in --formats"
-msgstr ""
-
#: common/mltools/tools_utils.ml:374
msgid "invalid output fd for --machine-readable: %s"
msgstr ""
msgid "kernel %s is not under grub tree %s"
msgstr ""
+#: common/mltools/tools_utils.ml:539 common/mltools/tools_utils.ml:458
+msgid "killed by signal %d"
+msgstr ""
+
#: common/mltools/tools_utils.ml:237
msgid "libguestfs error: %s"
msgstr ""
msgid "lv"
msgstr ""
-#: customize/customize_cmdline.ml:474
-#: common/mlcustomize/customize_cmdline.ml:474
+#: customize/customize_cmdline.ml:505
+#: common/mlcustomize/customize_cmdline.ml:505
msgid "md5|sha256|sha512"
msgstr ""
"vulnerable to Man-In-The-Middle attacks."
msgstr ""
-#: common/mldrivers/linux_bootloaders.ml:391
+#: common/mldrivers/linux_bootloaders.ml:403
msgid "no bootloader detected"
msgstr ""
msgid "no operating systems were found in the guest image"
msgstr ""
-#: dib/dib.ml:778
-msgid "no partitions found in the helper drive"
-msgstr ""
-
#: builder/builder.ml:583
msgid ""
"no plan could be found for making a disk image with\n"
"If this is incorrect, use --password-crypto option and file a bug."
msgstr ""
-#: customize/customize_run.ml:381
+#: customize/customize_run.ml:395
msgid "passwords could not be set for this type of guest"
msgstr ""
-#: dib/elements.ml:163
-msgid "please include an operating system element"
-msgstr ""
-
#: resize/resize.ml:1131 resize/resize.ml:1107
msgid "pread-device: short read"
msgstr ""
msgid "sectors"
msgstr ""
-#: common/mltools/tools_utils.ml:417 common/options/keys.c:258
+#: common/mltools/tools_utils.ml:417 common/options/keys.c:263
#, c-format
msgid "selector '%s': invalid TYPE"
msgstr ""
-#: common/mltools/tools_utils.ml:409 common/options/keys.c:248
+#: common/mltools/tools_utils.ml:409 common/options/keys.c:253
#, c-format
msgid "selector '%s': missing FILENAME, or too many fields"
msgstr ""
-#: common/mltools/tools_utils.ml:399 common/options/keys.c:226
+#: common/mltools/tools_utils.ml:399 common/options/keys.c:231
#, c-format
msgid "selector '%s': missing ID"
msgstr ""
-#: common/mltools/tools_utils.ml:404 common/options/keys.c:239
+#: common/mltools/tools_utils.ml:404 common/options/keys.c:244
#, c-format
msgid "selector '%s': missing KEY_STRING, or too many fields"
msgstr ""
-#: common/mltools/tools_utils.ml:401 common/options/keys.c:233
+#: common/mltools/tools_utils.ml:401 common/options/keys.c:238
#, c-format
msgid "selector '%s': missing TYPE"
msgstr ""
-#: common/mltools/tools_utils.ml:413 common/options/keys.c:256
+#: common/mltools/tools_utils.ml:413 common/options/keys.c:261
#, c-format
msgid "selector '%s': too many fields"
msgstr ""
msgid "ssh-inject: the user %s does not exist on the guest"
msgstr ""
-#: dib/dib.ml:506
-msgid "sub-process killed by signal (%d)"
+#: common/mltools/tools_utils.ml:542 common/mltools/tools_utils.ml:461
+msgid "stopped by signal %d"
msgstr ""
-#: customize/customize_run.ml:288
+#: customize/customize_run.ml:298
msgid "subscription-manager credentials required for --sm-register"
msgstr ""
msgid "the key ‘%s’ was not found in a list of objects"
msgstr ""
-#: dib/cmdline.ml:248
-msgid "the list of output formats cannot be empty"
-msgstr ""
-
#: builder/repository_main.ml:460
msgid ""
"the repository must contain an index file when running in automated mode"
msgid "the source disk has no partitions"
msgstr ""
-#: dib/dib.ml:537
-msgid "the specified base path is not the diskimage-builder library"
-msgstr ""
-
#: common/mltools/JSON_parser.ml:75
msgid "the value for key ‘%s’ is not a string as expected"
msgstr ""
msgid "timezone '%s' does not exist, use a location like 'Europe/London'"
msgstr ""
-#: customize/customize_run.ml:326
+#: customize/customize_run.ml:340
msgid "timezone could not be set for this type of guest"
msgstr ""
msgid "unexpected end of file while reading /dev/urandom"
msgstr ""
-#: builder/downloader.ml:117
+#: builder/downloader.ml:116
msgid ""
"unexpected output from curl command, enable debug and look at previous "
"messages"
msgid "users"
msgstr ""
-#: dib/utils.ml:55
-msgid ""
-"variable ‘%s’ has more than one occurrency in lines:\n"
-"%s"
-msgstr ""
-
-#: dib/utils.ml:51
-msgid ""
-"variable ‘%s’ not found in lines:\n"
-"%s"
-msgstr ""
-
#: builder/cmdline.ml:277
msgid ""
"virt-builder --get-kernel image\n"
msgid "%s mounted on %s\n"
msgstr ""
-#: common/options/keys.c:62
+#: common/options/keys.c:63
#, c-format
msgid "Enter key or passphrase (\"%s\"): "
msgstr ""
-#: common/options/keys.c:144
+#: common/options/keys.c:145
#, c-format
msgid "size_t overflow"
msgstr ""
-#: common/options/keys.c:187
+#: common/options/keys.c:192
#, c-format
msgid "could not read key from user"
msgstr ""
"format=%s'.\n"
msgstr ""
-#: diff/diff.c:775
+#: diff/diff.c:787
#, c-format
msgid "%s: external diff command failed\n"
msgstr ""
-#: diff/diff.c:779
+#: diff/diff.c:791
msgid "End of diff"
msgstr ""
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
prepend PATH "$b/cat"
prepend PATH "$b/customize"
prepend PATH "$b/df"
-prepend PATH "$b/dib"
prepend PATH "$b/diff"
prepend PATH "$b/drivers"
prepend PATH "$b/edit"
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
# Create the Volume Group on /dev/sda2.
$g->pvcreate ('/dev/sda2');
- $g->vgcreate ('VG', ['/dev/sda2']);
- $g->lvcreate ('Root', 'VG', 256);
- $g->lvcreate ('LV1', 'VG', 32);
- $g->lvcreate ('LV2', 'VG', 32);
- $g->lvcreate ('LV3', 'VG', 64);
+ $g->vgcreate ('Volume-Group', ['/dev/sda2']);
+ $g->lvcreate ('Root', 'Volume-Group', 256);
+ $g->lvcreate ('Logical-Volume-1', 'Volume-Group', 32);
+ $g->lvcreate ('Logical-Volume-2', 'Volume-Group', 32);
+ $g->lvcreate ('Logical-Volume-3', 'Volume-Group', 64);
# Format each Logical Group as a LUKS device, with a different password.
- $g->luks_format ('/dev/VG/Root', 'FEDORA-Root', 0);
- $g->luks_format ('/dev/VG/LV1', 'FEDORA-LV1', 0);
- $g->luks_format ('/dev/VG/LV2', 'FEDORA-LV2', 0);
- $g->luks_format ('/dev/VG/LV3', 'FEDORA-LV3', 0);
+ $g->luks_format ('/dev/Volume-Group/Root', 'FEDORA-Root', 0);
+ $g->luks_format ('/dev/Volume-Group/Logical-Volume-1', 'FEDORA-LV1', 0);
+ $g->luks_format ('/dev/Volume-Group/Logical-Volume-2', 'FEDORA-LV2', 0);
+ $g->luks_format ('/dev/Volume-Group/Logical-Volume-3', 'FEDORA-LV3', 0);
# Open the LUKS devices. This creates nodes like /dev/mapper/*-luks.
- $g->cryptsetup_open ('/dev/VG/Root', 'FEDORA-Root', 'Root-luks');
- $g->cryptsetup_open ('/dev/VG/LV1', 'FEDORA-LV1', 'LV1-luks');
- $g->cryptsetup_open ('/dev/VG/LV2', 'FEDORA-LV2', 'LV2-luks');
- $g->cryptsetup_open ('/dev/VG/LV3', 'FEDORA-LV3', 'LV3-luks');
+ $g->cryptsetup_open ('/dev/Volume-Group/Root',
+ 'FEDORA-Root', 'Root-luks');
+ $g->cryptsetup_open ('/dev/Volume-Group/Logical-Volume-1',
+ 'FEDORA-LV1', 'LV1-luks');
+ $g->cryptsetup_open ('/dev/Volume-Group/Logical-Volume-2',
+ 'FEDORA-LV2', 'LV2-luks');
+ $g->cryptsetup_open ('/dev/Volume-Group/Logical-Volume-3',
+ 'FEDORA-LV3', 'LV3-luks');
# Phony root filesystem.
$g->mkfs ('ext2', '/dev/mapper/Root-luks', blocksize => 4096, label => 'ROOT');
GMSGFMT = @GMSGFMT@
GMSGFMT_015 = @GMSGFMT_015@
GREP = @GREP@
+HWDATA_PKGDATADIR = @HWDATA_PKGDATADIR@
INSTALL = @INSTALL@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
libexecdir = @libexecdir@
libvirt_ro_uri = @libvirt_ro_uri@
localedir = @localedir@
+localedir_c = @localedir_c@
+localedir_c_make = @localedir_c_make@
localstatedir = @localstatedir@
mandir = @mandir@
mkdir_p = @mkdir_p@
projects / guestfs-tools.git / commitdiff