# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Red Hat Inc.
# This file is distributed under the same license as the guestfs-tools package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: guestfs-tools 1.53.5\n"
"Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n"
"POT-Creation-Date: 2025-01-08 12:25+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"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: =head1
#: align/virt-alignment-scan.pod:1 builder/virt-builder-repository.pod:8
#: builder/virt-builder.pod:8 builder/virt-index-validate.pod:1
#: cat/virt-cat.pod:1 cat/virt-filesystems.pod:1 cat/virt-log.pod:1
#: cat/virt-ls.pod:1 cat/virt-tail.pod:1 customize/virt-customize.pod:1
#: df/virt-df.pod:1 diff/virt-diff.pod:1
#: docs/guestfs-tools-release-notes-1.48.pod:1
#: docs/guestfs-tools-release-notes-1.50.pod:1
#: docs/guestfs-tools-release-notes-1.52.pod:1 drivers/virt-drivers.pod:1
#: edit/virt-edit.pod:1 format/virt-format.pod:1
#: get-kernel/virt-get-kernel.pod:1 inspector/virt-inspector.pod:1
#: make-fs/virt-make-fs.pod:1 resize/virt-resize.pod:1
#: sparsify/virt-sparsify.pod:1 sysprep/virt-sysprep.pod:1
#: win-reg/virt-win-reg.in:32
msgid "NAME"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:3
msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:5 builder/virt-builder-repository.pod:12
#: builder/virt-builder.pod:12 builder/virt-index-validate.pod:5
#: cat/virt-cat.pod:5 cat/virt-filesystems.pod:5 cat/virt-log.pod:5
#: cat/virt-ls.pod:5 cat/virt-tail.pod:5 customize/virt-customize.pod:5
#: df/virt-df.pod:5 diff/virt-diff.pod:5 drivers/virt-drivers.pod:5
#: edit/virt-edit.pod:5 format/virt-format.pod:5
#: get-kernel/virt-get-kernel.pod:5 inspector/virt-inspector.pod:5
#: make-fs/virt-make-fs.pod:5 resize/virt-resize.pod:5
#: sparsify/virt-sparsify.pod:5 sysprep/virt-sysprep.pod:5
#: win-reg/virt-win-reg.in:36
msgid "SYNOPSIS"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:7
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:9
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:11
#, no-wrap
msgid ""
" virt-alignment-scan [--options]\n"
"\n"
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:13 builder/virt-builder-repository.pod:17
#: builder/virt-builder.pod:32 builder/virt-index-validate.pod:9
#: cat/virt-cat.pod:17 cat/virt-filesystems.pod:11 cat/virt-log.pod:11
#: cat/virt-ls.pod:17 cat/virt-tail.pod:11 customize/virt-customize.pod:18
#: df/virt-df.pod:23 diff/virt-diff.pod:11 drivers/virt-drivers.pod:11
#: edit/virt-edit.pod:19 format/virt-format.pod:9
#: get-kernel/virt-get-kernel.pod:11 inspector/virt-inspector.pod:17
#: make-fs/virt-make-fs.pod:13 resize/virt-resize.pod:11
#: sparsify/virt-sparsify.pod:11 sysprep/virt-sysprep.pod:11
#: win-reg/virt-win-reg.in:60
msgid "DESCRIPTION"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:15
msgid ""
"When older operating systems install themselves, the partitioning tools "
"place partitions at a sector misaligned with the underlying storage "
"(commonly the first partition starts on sector C<63>).  Misaligned "
"partitions can result in an operating system issuing more I/O than should be "
"necessary."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:21
msgid ""
"The virt-alignment-scan tool checks the alignment of partitions in virtual "
"machines and disk images and warns you if there are alignment problems."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:25
msgid ""
"Currently there is no virt tool for fixing alignment problems.  You can only "
"reinstall the guest operating system.  The following NetApp document "
"summarises the problem and possible solutions: "
"L<http://media.netapp.com/documents/tr-3747.pdf>"
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:30
msgid "OUTPUT"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:32
msgid "To run this tool on a disk image directly, use the I<-a> option:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:34
#, no-wrap
msgid ""
" $ virt-alignment-scan -a winxp.img\n"
" /dev/sda1        32256          512    bad (alignment < 4K)\n"
"\n"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:37
#, no-wrap
msgid ""
" $ virt-alignment-scan -a fedora16.img\n"
" /dev/sda1      1048576         1024K   ok\n"
" /dev/sda2      2097152         2048K   ok\n"
" /dev/sda3    526385152         2048K   ok\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:42
msgid ""
"To run the tool on a guest known to libvirt, use the I<-d> option and "
"possibly the I<-c> option:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:45
#, no-wrap
msgid ""
" # virt-alignment-scan -d RHEL5\n"
" /dev/sda1        32256          512    bad (alignment < 4K)\n"
" /dev/sda2    106928640          512    bad (alignment < 4K)\n"
"\n"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:49
#, no-wrap
msgid ""
" $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
" /dev/sda1      1048576         1024K   ok\n"
" /dev/sda2    105906176         1024K   ok\n"
" /dev/sdb1        65536           64K   ok\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:54
msgid ""
"Run virt-alignment-scan without any I<-a> or I<-d> options to scan all "
"libvirt domains."
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:57
#, no-wrap
msgid ""
" # virt-alignment-scan\n"
" F16x64:/dev/sda1      1048576         1024K   ok\n"
" F16x64:/dev/sda2      2097152         2048K   ok\n"
" F16x64:/dev/sda3    526385152         2048K   ok\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:62
msgid ""
"The output consists of 4 or more whitespace-separated columns.  Only the "
"first 4 columns are significant if you want to parse this from a program.  "
"The columns are:"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:68
msgid "col 1"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:70
msgid ""
"The device and partition name (eg. F</dev/sda1> meaning the first partition "
"on the first block device)."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:73
msgid ""
"When listing all libvirt domains (no I<-a> or I<-d> option given) this "
"column is prefixed by the libvirt name or UUID (if I<--uuid> is given).  eg: "
"C<WinXP:/dev/sda1>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:77
msgid "col 2"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:79
msgid "the start of the partition in bytes"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:81
msgid "col 3"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:83
msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:85
msgid "col 4"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:87
msgid ""
"C<ok> if the alignment is best for performance, or C<bad> if the alignment "
"can cause performance problems"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:90
msgid "cols 5+"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:92
msgid "optional free-text explanation."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:96
msgid ""
"The exit code from the program changes depending on whether poorly aligned "
"partitions were found.  See L</EXIT STATUS> below."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:99
msgid "If you just want the exit code with no output, use the I<-q> option."
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:101 builder/virt-builder-repository.pod:87
#: builder/virt-builder.pod:170 builder/virt-index-validate.pod:19
#: cat/virt-cat.pod:51 cat/virt-filesystems.pod:89 cat/virt-log.pod:35
#: cat/virt-ls.pod:249 cat/virt-tail.pod:46 customize/virt-customize.pod:32
#: df/virt-df.pod:71 diff/virt-diff.pod:35 drivers/virt-drivers.pod:113
#: edit/virt-edit.pod:54 format/virt-format.pod:57
#: get-kernel/virt-get-kernel.pod:23 inspector/virt-inspector.pod:55
#: make-fs/virt-make-fs.pod:117 resize/virt-resize.pod:268
#: sparsify/virt-sparsify.pod:114 sysprep/virt-sysprep.pod:36
#: win-reg/virt-win-reg.in:93
msgid "OPTIONS"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:105 builder/virt-builder-repository.pod:91
#: builder/virt-builder.pod:174 builder/virt-index-validate.pod:62
#: cat/virt-cat.pod:55 cat/virt-filesystems.pod:93 cat/virt-log.pod:39
#: cat/virt-ls.pod:253 cat/virt-tail.pod:50 customize/virt-customize.pod:36
#: df/virt-df.pod:75 diff/virt-diff.pod:39 drivers/virt-drivers.pod:117
#: edit/virt-edit.pod:58 format/virt-format.pod:61
#: get-kernel/virt-get-kernel.pod:27 inspector/virt-inspector.pod:59
#: make-fs/virt-make-fs.pod:121 resize/virt-resize.pod:272
#: sparsify/virt-sparsify.pod:118 sysprep/virt-sysprep.pod:40
#: win-reg/virt-win-reg.in:101
msgid "B<--help>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:107 cat/virt-cat.pod:57
#: cat/virt-filesystems.pod:95 cat/virt-log.pod:41 cat/virt-ls.pod:255
#: cat/virt-tail.pod:52 customize/virt-customize.pod:38 df/virt-df.pod:77
#: diff/virt-diff.pod:41 edit/virt-edit.pod:60 format/virt-format.pod:63
#: inspector/virt-inspector.pod:61 make-fs/virt-make-fs.pod:123
#: sysprep/virt-sysprep.pod:42 win-reg/virt-win-reg.in:103
msgid "Display brief help."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:109 cat/virt-cat.pod:59
#: cat/virt-filesystems.pod:97 cat/virt-log.pod:43 cat/virt-ls.pod:257
#: cat/virt-tail.pod:54 customize/virt-customize.pod:40 diff/virt-diff.pod:43
#: drivers/virt-drivers.pod:121 edit/virt-edit.pod:62 format/virt-format.pod:65
#: get-kernel/virt-get-kernel.pod:31 inspector/virt-inspector.pod:63
#: sysprep/virt-sysprep.pod:44
msgid "B<-a> file"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:111 cat/virt-cat.pod:61
#: cat/virt-filesystems.pod:99 cat/virt-log.pod:45 cat/virt-ls.pod:259
#: cat/virt-tail.pod:56 customize/virt-customize.pod:42 diff/virt-diff.pod:45
#: drivers/virt-drivers.pod:123 edit/virt-edit.pod:64 format/virt-format.pod:67
#: get-kernel/virt-get-kernel.pod:33 inspector/virt-inspector.pod:65
#: sysprep/virt-sysprep.pod:46
msgid "B<--add> file"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:113 customize/virt-customize.pod:44
#: drivers/virt-drivers.pod:125 get-kernel/virt-get-kernel.pod:35
#: sysprep/virt-sysprep.pod:48
msgid "Add I<file> which should be a disk image from a virtual machine."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:115 cat/virt-cat.pod:67
#: cat/virt-filesystems.pod:105 cat/virt-log.pod:51 cat/virt-ls.pod:265
#: cat/virt-tail.pod:62 df/virt-df.pod:87 diff/virt-diff.pod:51
#: edit/virt-edit.pod:70 format/virt-format.pod:71
#: inspector/virt-inspector.pod:71
msgid ""
"The format of the disk image is auto-detected.  To override this and force a "
"particular format use the I<--format=..> option."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:118 cat/virt-cat.pod:70
#: cat/virt-filesystems.pod:108 cat/virt-log.pod:54 cat/virt-ls.pod:268
#: cat/virt-tail.pod:65
msgid "B<-a URI>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:120 cat/virt-cat.pod:72
#: cat/virt-filesystems.pod:110 cat/virt-log.pod:56 cat/virt-ls.pod:270
#: cat/virt-tail.pod:67
msgid "B<--add URI>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:122 cat/virt-cat.pod:74
#: cat/virt-filesystems.pod:112 cat/virt-log.pod:58 cat/virt-ls.pod:272
#: cat/virt-tail.pod:69 df/virt-df.pod:94 diff/virt-diff.pod:58
#: edit/virt-edit.pod:77 format/virt-format.pod:80
#: inspector/virt-inspector.pod:78
msgid "Add a remote disk.  See L<guestfish(1)/ADDING REMOTE STORAGE>."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:124 cat/virt-cat.pod:76
#: cat/virt-filesystems.pod:129 cat/virt-log.pod:60 cat/virt-ls.pod:274
#: cat/virt-tail.pod:71 df/virt-df.pod:96 diff/virt-diff.pod:76
#: edit/virt-edit.pod:93 format/virt-format.pod:82
#: inspector/virt-inspector.pod:80
msgid "__INCLUDE:blocksize-option.pod__"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:126 cat/virt-cat.pod:78
#: cat/virt-filesystems.pod:131 cat/virt-log.pod:62 cat/virt-ls.pod:287
#: cat/virt-tail.pod:73 customize/virt-customize.pod:86 df/virt-df.pod:98
#: diff/virt-diff.pod:89 drivers/virt-drivers.pod:154 edit/virt-edit.pod:95
#: get-kernel/virt-get-kernel.pod:64 inspector/virt-inspector.pod:82
#: sysprep/virt-sysprep.pod:69
msgid "B<-c> URI"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:128 cat/virt-cat.pod:80
#: cat/virt-filesystems.pod:133 cat/virt-log.pod:64 cat/virt-ls.pod:289
#: cat/virt-tail.pod:75 customize/virt-customize.pod:88 df/virt-df.pod:100
#: diff/virt-diff.pod:91 drivers/virt-drivers.pod:156 edit/virt-edit.pod:97
#: get-kernel/virt-get-kernel.pod:66 inspector/virt-inspector.pod:84
#: sysprep/virt-sysprep.pod:71
msgid "B<--connect> URI"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:130 cat/virt-cat.pod:82
#: cat/virt-filesystems.pod:135 cat/virt-log.pod:66 cat/virt-ls.pod:291
#: cat/virt-tail.pod:77 customize/virt-customize.pod:90 df/virt-df.pod:102
#: diff/virt-diff.pod:93 drivers/virt-drivers.pod:158 edit/virt-edit.pod:99
#: get-kernel/virt-get-kernel.pod:68 inspector/virt-inspector.pod:86
#: sysprep/virt-sysprep.pod:73 win-reg/virt-win-reg.in:129
msgid ""
"If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
"to the default libvirt hypervisor."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:133 cat/virt-cat.pod:85
#: cat/virt-filesystems.pod:138 cat/virt-log.pod:69 cat/virt-ls.pod:294
#: cat/virt-tail.pod:80 customize/virt-customize.pod:93 df/virt-df.pod:105
#: diff/virt-diff.pod:96 drivers/virt-drivers.pod:161
#: get-kernel/virt-get-kernel.pod:71 sysprep/virt-sysprep.pod:76
msgid ""
"If you specify guest block devices directly (I<-a>), then libvirt is not "
"used at all."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:136 cat/virt-cat.pod:88
#: cat/virt-filesystems.pod:147 cat/virt-log.pod:72 cat/virt-ls.pod:303
#: cat/virt-tail.pod:83 customize/virt-customize.pod:96 df/virt-df.pod:114
#: diff/virt-diff.pod:117 drivers/virt-drivers.pod:164
#: get-kernel/virt-get-kernel.pod:74 inspector/virt-inspector.pod:93
#: sysprep/virt-sysprep.pod:79
msgid "B<-d> guest"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:138 cat/virt-cat.pod:90
#: cat/virt-filesystems.pod:149 cat/virt-log.pod:74 cat/virt-ls.pod:305
#: cat/virt-tail.pod:85 customize/virt-customize.pod:98 df/virt-df.pod:116
#: diff/virt-diff.pod:119 drivers/virt-drivers.pod:166
#: get-kernel/virt-get-kernel.pod:76 inspector/virt-inspector.pod:95
#: sysprep/virt-sysprep.pod:81
msgid "B<--domain> guest"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:140 cat/virt-cat.pod:92
#: cat/virt-filesystems.pod:151 cat/virt-log.pod:76 cat/virt-ls.pod:307
#: cat/virt-tail.pod:87 customize/virt-customize.pod:100 df/virt-df.pod:118
#: drivers/virt-drivers.pod:168 edit/virt-edit.pod:109
#: get-kernel/virt-get-kernel.pod:78 inspector/virt-inspector.pod:97
#: sysprep/virt-sysprep.pod:83
msgid ""
"Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
"instead of names."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:143 cat/virt-cat.pod:102
#: cat/virt-filesystems.pod:176 cat/virt-log.pod:86 cat/virt-ls.pod:324
#: cat/virt-tail.pod:104 df/virt-df.pod:121 diff/virt-diff.pod:140
#: edit/virt-edit.pod:134 format/virt-format.pod:93
#: inspector/virt-inspector.pod:107
msgid "B<--format=raw|qcow2|..>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:145 cat/virt-cat.pod:104
#: cat/virt-filesystems.pod:178 cat/virt-log.pod:88 cat/virt-ls.pod:326
#: cat/virt-tail.pod:106 df/virt-df.pod:123 diff/virt-diff.pod:142
#: edit/virt-edit.pod:136 format/virt-format.pod:95
#: inspector/virt-inspector.pod:109
msgid "B<--format>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:147 cat/virt-cat.pod:106
#: cat/virt-filesystems.pod:180 cat/virt-log.pod:90 cat/virt-ls.pod:328
#: cat/virt-tail.pod:108 df/virt-df.pod:125 edit/virt-edit.pod:138
#: format/virt-format.pod:97
msgid ""
"The default for the I<-a> option is to auto-detect the format of the disk "
"image.  Using this forces the disk format for I<-a> options which follow on "
"the command line.  Using I<--format> with no argument switches back to "
"auto-detection for subsequent I<-a> options."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:152 builder/virt-builder.pod:144
#: cat/virt-cat.pod:111 cat/virt-filesystems.pod:185 cat/virt-log.pod:95
#: cat/virt-ls.pod:333 cat/virt-tail.pod:113
#: common/mlcustomize/customize-options.pod:84
#: common/mlcustomize/v2v-customize-options.pod:84
#: customize/virt-customize.pod:126 df/virt-df.pod:130 diff/virt-diff.pod:150
#: edit/virt-edit.pod:143 format/virt-format.pod:102
#: inspector/virt-inspector.pod:350 sysprep/sysprep-extra-options.pod:59
#: sysprep/virt-sysprep.pod:172 sysprep/virt-sysprep.pod:222
msgid "For example:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:154
#, no-wrap
msgid ""
" virt-alignment-scan --format=raw -a disk.img\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:156 cat/virt-cat.pod:115
#: cat/virt-filesystems.pod:189 cat/virt-log.pod:99 cat/virt-ls.pod:337
#: cat/virt-tail.pod:117 customize/virt-customize.pod:130 df/virt-df.pod:134
#: diff/virt-diff.pod:154 edit/virt-edit.pod:147 format/virt-format.pod:106
#: sysprep/virt-sysprep.pod:176
msgid "forces raw format (no auto-detection) for F<disk.img>."
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:158
#, no-wrap
msgid ""
" virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:160 cat/virt-cat.pod:119
#: cat/virt-filesystems.pod:193 cat/virt-log.pod:103 cat/virt-ls.pod:341
#: cat/virt-tail.pod:121 customize/virt-customize.pod:134 df/virt-df.pod:138
#: diff/virt-diff.pod:158 edit/virt-edit.pod:151 format/virt-format.pod:110
#: sysprep/virt-sysprep.pod:180
msgid ""
"forces raw format (no auto-detection) for F<disk.img> and reverts to "
"auto-detection for F<another.img>."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:163 cat/virt-cat.pod:122
#: cat/virt-filesystems.pod:196 cat/virt-log.pod:106 cat/virt-ls.pod:344
#: cat/virt-tail.pod:124 customize/virt-customize.pod:137 df/virt-df.pod:141
#: diff/virt-diff.pod:161 drivers/virt-drivers.pod:186 edit/virt-edit.pod:154
#: format/virt-format.pod:113 get-kernel/virt-get-kernel.pod:96
#: sysprep/virt-sysprep.pod:183
msgid ""
"If you have untrusted raw-format guest disk images, you should use this "
"option to specify the disk format.  This avoids a possible security problem "
"with malicious guests (CVE-2010-3851)."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:167 df/virt-df.pod:164
msgid "B<-P> nr_threads"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:169
msgid ""
"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 C<nr_threads> "
"by using the I<-P> option."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:176 df/virt-df.pod:172
msgid ""
"Note that I<-P 0> means to autodetect, and I<-P 1> means to use a single "
"thread."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:179 builder/virt-builder-repository.pod:151
#: builder/virt-builder.pod:471 customize/virt-customize.pod:203
#: drivers/virt-drivers.pod:194 get-kernel/virt-get-kernel.pod:132
#: resize/virt-resize.pod:530 sparsify/virt-sparsify.pod:259
#: sysprep/virt-sysprep.pod:232
msgid "B<-q>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:181 builder/virt-builder-repository.pod:153
#: builder/virt-builder.pod:473 customize/virt-customize.pod:205
#: drivers/virt-drivers.pod:196 get-kernel/virt-get-kernel.pod:134
#: resize/virt-resize.pod:532 sparsify/virt-sparsify.pod:261
#: sysprep/virt-sysprep.pod:234
msgid "B<--quiet>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:183
msgid ""
"Don’t produce any output.  Just set the exit code (see L</EXIT STATUS> "
"below)."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:186 cat/virt-filesystems.pod:258
#: df/virt-df.pod:175
msgid "B<--uuid>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:188 df/virt-df.pod:177
msgid ""
"Print UUIDs instead of names.  This is useful for following a guest even "
"when the guest is migrated or renamed, or when two guests happen to have the "
"same name."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:192
msgid ""
"This option only applies when listing all libvirt domains (when no I<-a> or "
"I<-d> options are specified)."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:195 builder/virt-builder-repository.pod:157
#: builder/virt-builder.pod:518 cat/virt-cat.pod:166
#: cat/virt-filesystems.pod:264 cat/virt-log.pod:114 cat/virt-ls.pod:456
#: cat/virt-tail.pod:168 customize/virt-customize.pod:215 df/virt-df.pod:185
#: diff/virt-diff.pod:198 drivers/virt-drivers.pod:200 edit/virt-edit.pod:198
#: format/virt-format.pod:155 get-kernel/virt-get-kernel.pod:149
#: inspector/virt-inspector.pod:140 make-fs/virt-make-fs.pod:207
#: resize/virt-resize.pod:622 sparsify/virt-sparsify.pod:308
#: sysprep/virt-sysprep.pod:253
msgid "B<-v>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:197 builder/virt-builder-repository.pod:159
#: builder/virt-builder.pod:520 cat/virt-cat.pod:168
#: cat/virt-filesystems.pod:266 cat/virt-log.pod:116 cat/virt-ls.pod:458
#: cat/virt-tail.pod:170 customize/virt-customize.pod:217 df/virt-df.pod:187
#: diff/virt-diff.pod:200 drivers/virt-drivers.pod:202 edit/virt-edit.pod:200
#: format/virt-format.pod:157 get-kernel/virt-get-kernel.pod:151
#: inspector/virt-inspector.pod:142 make-fs/virt-make-fs.pod:209
#: resize/virt-resize.pod:624 sparsify/virt-sparsify.pod:310
#: sysprep/virt-sysprep.pod:255
msgid "B<--verbose>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:199 cat/virt-cat.pod:170
#: cat/virt-filesystems.pod:268 cat/virt-log.pod:118 cat/virt-ls.pod:460
#: cat/virt-tail.pod:172 customize/virt-customize.pod:219 df/virt-df.pod:189
#: diff/virt-diff.pod:202 drivers/virt-drivers.pod:204 edit/virt-edit.pod:202
#: format/virt-format.pod:159 get-kernel/virt-get-kernel.pod:153
#: inspector/virt-inspector.pod:144 sparsify/virt-sparsify.pod:312
#: sysprep/virt-sysprep.pod:257
msgid "Enable verbose messages for debugging."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:201 builder/virt-builder-repository.pod:166
#: builder/virt-builder.pod:527 builder/virt-index-validate.pod:66
#: cat/virt-cat.pod:172 cat/virt-filesystems.pod:270 cat/virt-log.pod:120
#: cat/virt-ls.pod:462 cat/virt-tail.pod:174 customize/virt-customize.pod:221
#: df/virt-df.pod:191 diff/virt-diff.pod:204 drivers/virt-drivers.pod:206
#: edit/virt-edit.pod:204 format/virt-format.pod:161
#: get-kernel/virt-get-kernel.pod:155 inspector/virt-inspector.pod:146
#: make-fs/virt-make-fs.pod:213 resize/virt-resize.pod:628
#: sparsify/virt-sparsify.pod:314 sysprep/virt-sysprep.pod:259
msgid "B<-V>"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:203 builder/virt-builder-repository.pod:168
#: builder/virt-builder.pod:529 builder/virt-index-validate.pod:68
#: cat/virt-cat.pod:174 cat/virt-filesystems.pod:272 cat/virt-log.pod:122
#: cat/virt-ls.pod:464 cat/virt-tail.pod:176 customize/virt-customize.pod:223
#: df/virt-df.pod:193 diff/virt-diff.pod:206 drivers/virt-drivers.pod:208
#: edit/virt-edit.pod:206 format/virt-format.pod:163
#: get-kernel/virt-get-kernel.pod:157 inspector/virt-inspector.pod:148
#: make-fs/virt-make-fs.pod:215 resize/virt-resize.pod:630
#: sparsify/virt-sparsify.pod:316 sysprep/virt-sysprep.pod:261
#: win-reg/virt-win-reg.in:109
msgid "B<--version>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:205 builder/virt-builder-repository.pod:170
#: builder/virt-builder.pod:531 builder/virt-index-validate.pod:70
#: cat/virt-cat.pod:176 cat/virt-filesystems.pod:274 cat/virt-log.pod:124
#: cat/virt-ls.pod:466 cat/virt-tail.pod:178 customize/virt-customize.pod:225
#: df/virt-df.pod:195 diff/virt-diff.pod:208 drivers/virt-drivers.pod:210
#: edit/virt-edit.pod:208 format/virt-format.pod:165
#: get-kernel/virt-get-kernel.pod:159 inspector/virt-inspector.pod:150
#: make-fs/virt-make-fs.pod:217 resize/virt-resize.pod:632
#: sparsify/virt-sparsify.pod:318 sysprep/virt-sysprep.pod:263
#: win-reg/virt-win-reg.in:111
msgid "Display version number and exit."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:207 builder/virt-builder-repository.pod:178
#: builder/virt-builder.pod:539 cat/virt-cat.pod:178
#: cat/virt-filesystems.pod:284 cat/virt-log.pod:126 cat/virt-ls.pod:468
#: cat/virt-tail.pod:180 customize/virt-customize.pod:233 df/virt-df.pod:197
#: diff/virt-diff.pod:210 drivers/virt-drivers.pod:218 edit/virt-edit.pod:210
#: format/virt-format.pod:177 get-kernel/virt-get-kernel.pod:167
#: inspector/virt-inspector.pod:152 make-fs/virt-make-fs.pod:219
#: resize/virt-resize.pod:640 sparsify/virt-sparsify.pod:326
#: sysprep/virt-sysprep.pod:271
msgid "B<-x>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:209 builder/virt-builder-repository.pod:180
#: builder/virt-builder.pod:541 cat/virt-cat.pod:180
#: cat/virt-filesystems.pod:286 cat/virt-log.pod:128 cat/virt-ls.pod:470
#: cat/virt-tail.pod:182 customize/virt-customize.pod:235 df/virt-df.pod:199
#: diff/virt-diff.pod:212 drivers/virt-drivers.pod:220 edit/virt-edit.pod:212
#: format/virt-format.pod:179 get-kernel/virt-get-kernel.pod:169
#: inspector/virt-inspector.pod:154 resize/virt-resize.pod:642
#: sparsify/virt-sparsify.pod:328 sysprep/virt-sysprep.pod:273
msgid "Enable tracing of libguestfs API calls."
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:213
msgid "RECOMMENDED ALIGNMENT"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:215
msgid ""
"Operating systems older than Windows 2008 and Linux before ca.2010 place the "
"first sector of the first partition at sector 63, with a 512 byte sector "
"size.  This happens because of a historical accident.  Drives have to report "
"a cylinder / head / sector (CHS) geometry to the BIOS.  The geometry is "
"completely meaningless on modern drives, but it happens that the geometry "
"reported always has 63 sectors per track.  The operating system therefore "
"places the first partition at the start of the second \"track\", at sector "
"63."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:224
msgid ""
"When the guest OS is virtualized, the host operating system and hypervisor "
"may prefer accesses aligned to one of:"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:229
msgid "* 512 bytes"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:231
msgid ""
"if the host OS uses local storage directly on hard drive partitions, and the "
"hard drive has 512 byte physical sectors."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:234
msgid "* 4 Kbytes"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:236
msgid ""
"for local storage on new hard drives with 4Kbyte physical sectors; for "
"file-backed storage on filesystems with 4Kbyte block size; or for some types "
"of network-attached storage."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:240
msgid "* 64 Kbytes"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:242
msgid ""
"for high-end network-attached storage.  This is the optimal block size for "
"some NetApp hardware."
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:245
msgid "* 1 Mbyte"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:247
msgid "see L</1 MB PARTITION ALIGNMENT> below."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:251
msgid ""
"Partitions which are not aligned correctly to the underlying storage cause "
"extra I/O.  For example:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:254
#, no-wrap
msgid ""
"                       sect#63\n"
"                       ┌──────────────────────────┬ ─ ─ ─ ─\n"
"                       │         guest            │\n"
"                       │    filesystem block      │\n"
"  ─ ┬──────────────────┴──────┬───────────────────┴─────┬ ─ ─\n"
"    │  host block             │  host block             │\n"
"    │                         │                         │\n"
"  ─ ┴─────────────────────────┴─────────────────────────┴ ─ ─\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:263
msgid ""
"In this example, each time a 4K guest block is read, two blocks on the host "
"must be accessed (so twice as much I/O is done).  When a 4K guest block is "
"written, two host blocks must first be read, the old and new data combined, "
"and the two blocks written back (4x I/O)."
msgstr ""

#. type: =head2
#: align/virt-alignment-scan.pod:268
msgid "LINUX HOST BLOCK AND I/O SIZE"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:270
msgid ""
"New versions of the Linux kernel expose the physical and logical block size, "
"and minimum and recommended I/O size."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:273
msgid "For a typical consumer hard drive with 512 byte sectors:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:275
#, no-wrap
msgid ""
" $ cat /sys/block/sda/queue/hw_sector_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/physical_block_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/logical_block_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/minimum_io_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/optimal_io_size\n"
" 0\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:286
msgid "For a new consumer hard drive with 4Kbyte sectors:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:288
#, no-wrap
msgid ""
" $ cat /sys/block/sda/queue/hw_sector_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/physical_block_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/logical_block_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/minimum_io_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/optimal_io_size\n"
" 0\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:299
msgid "For a NetApp LUN:"
msgstr ""

#. type: verbatim
#: align/virt-alignment-scan.pod:301
#, no-wrap
msgid ""
" $ cat /sys/block/sdc/queue/logical_block_size\n"
" 512\n"
" $ cat /sys/block/sdc/queue/physical_block_size\n"
" 512\n"
" $ cat /sys/block/sdc/queue/minimum_io_size\n"
" 4096\n"
" $ cat /sys/block/sdc/queue/optimal_io_size\n"
" 65536\n"
"\n"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:310
msgid ""
"The NetApp allows 512 byte accesses (but they will be very inefficient), "
"prefers a minimum 4K I/O size, but the optimal I/O size is 64K."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:314
msgid ""
"For detailed information about what these numbers mean, see "
"L<http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/newstorage-iolimits.html>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:317
msgid ""
"[Thanks to Matt Booth for providing 4K drive data.  Thanks to Mike Snitzer "
"for providing NetApp data and additional information.]"
msgstr ""

#. type: =head2
#: align/virt-alignment-scan.pod:320
msgid "1 MB PARTITION ALIGNMENT"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:322
msgid ""
"Microsoft picked 1 MB as the default alignment for all partitions starting "
"with Windows 2008 Server, and Linux has followed this."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:325
msgid ""
"Assuming 512 byte sectors in the guest, you will now see the first partition "
"starting at sector 2048, and subsequent partitions (if any)  will start at a "
"multiple of 2048 sectors."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:329
msgid ""
"1 MB alignment is compatible with all current alignment requirements (4K, "
"64K) and provides room for future growth in physical block sizes."
msgstr ""

#. type: =head2
#: align/virt-alignment-scan.pod:332
msgid "SETTING ALIGNMENT"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:334
msgid ""
"L<virt-resize(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."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:340
msgid ""
"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."
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:344
msgid ""
"For older versions of Windows, the following NetApp document contains useful "
"information: L<http://media.netapp.com/documents/tr-3747.pdf>"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:347
msgid ""
"For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
"an explicit C<%pre> section that creates aligned partitions using "
"L<parted(8)>.  Do not use the Kickstart C<part> command.  The NetApp "
"document above contains an example."
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:352 builder/virt-builder-repository.pod:202
#: builder/virt-builder.pod:1855 builder/virt-index-validate.pod:74
#: cat/virt-cat.pod:271 cat/virt-filesystems.pod:380 cat/virt-log.pod:132
#: cat/virt-ls.pod:514 cat/virt-tail.pod:232 customize/virt-customize.pod:251
#: df/virt-df.pod:253 diff/virt-diff.pod:244 drivers/virt-drivers.pod:229
#: edit/virt-edit.pod:379 format/virt-format.pod:183
#: get-kernel/virt-get-kernel.pod:196 inspector/virt-inspector.pod:489
#: resize/virt-resize.pod:843 sparsify/virt-sparsify.pod:451
#: sysprep/virt-sysprep.pod:569
msgid "EXIT STATUS"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:354
msgid "This program returns:"
msgstr ""

#. type: =item
#: align/virt-alignment-scan.pod:358 align/virt-alignment-scan.pod:364
#: align/virt-alignment-scan.pod:370 align/virt-alignment-scan.pod:377
#: builder/virt-builder.pod:934 builder/virt-builder.pod:941
#: builder/virt-builder.pod:945 builder/virt-builder.pod:949
#: builder/virt-builder.pod:954 builder/virt-builder.pod:958
#: builder/virt-builder.pod:962 builder/virt-builder.pod:967
#: builder/virt-builder.pod:1141 builder/virt-builder.pod:1146
#: builder/virt-builder.pod:1719 builder/virt-builder.pod:1723
#: builder/virt-builder.pod:1727 builder/virt-index-validate.pod:32
#: builder/virt-index-validate.pod:37 builder/virt-index-validate.pod:51
#: builder/virt-index-validate.pod:56 cat/virt-cat.pod:217 cat/virt-cat.pod:222
#: cat/virt-cat.pod:227 cat/virt-cat.pod:238 cat/virt-cat.pod:242
#: cat/virt-tail.pod:25 cat/virt-tail.pod:29 cat/virt-tail.pod:34
#: cat/virt-tail.pod:201 cat/virt-tail.pod:206 cat/virt-tail.pod:211
#: cat/virt-tail.pod:222 cat/virt-tail.pod:226
#: common/mlcustomize/customize-options.pod:73
#: common/mlcustomize/customize-options.pod:78
#: common/mlcustomize/customize-options.pod:387
#: common/mlcustomize/customize-options.pod:391
#: common/mlcustomize/v2v-customize-options.pod:73
#: common/mlcustomize/v2v-customize-options.pod:78
#: common/mlcustomize/v2v-customize-options.pod:327
#: common/mlcustomize/v2v-customize-options.pod:331
#: docs/guestfs-tools-release-notes-1.50.pod:32
#: docs/guestfs-tools-release-notes-1.50.pod:36
#: docs/guestfs-tools-release-notes-1.50.pod:40
#: docs/guestfs-tools-release-notes-1.50.pod:44 edit/virt-edit.pod:303
#: edit/virt-edit.pod:308 edit/virt-edit.pod:313 edit/virt-edit.pod:324
#: edit/virt-edit.pod:328 inspector/virt-inspector.pod:508
#: inspector/virt-inspector.pod:512 resize/virt-resize.pod:376
#: resize/virt-resize.pod:380 resize/virt-resize.pod:389
#: resize/virt-resize.pod:395 resize/virt-resize.pod:399
#: resize/virt-resize.pod:403 resize/virt-resize.pod:411
#: sparsify/virt-sparsify.pod:46 sparsify/virt-sparsify.pod:50
#: sparsify/virt-sparsify.pod:59 sparsify/virt-sparsify.pod:64
#: sparsify/virt-sparsify.pod:69 sparsify/virt-sparsify.pod:75
#: sparsify/virt-sparsify.pod:137 sparsify/virt-sparsify.pod:141
#: sparsify/virt-sparsify.pod:145 sparsify/virt-sparsify.pod:150
#: sparsify/virt-sparsify.pod:289 sparsify/virt-sparsify.pod:294
#: sparsify/virt-sparsify.pod:299 sysprep/sysprep-extra-options.pod:48
#: sysprep/sysprep-extra-options.pod:53 sysprep/sysprep-extra-options.pod:436
#: sysprep/sysprep-extra-options.pod:440 sysprep/virt-sysprep.pod:325
#: sysprep/virt-sysprep.pod:329 sysprep/virt-sysprep.pod:333
#: sysprep/virt-sysprep.pod:337 sysprep/virt-sysprep.pod:352
#: sysprep/virt-sysprep.pod:356 sysprep/virt-sysprep.pod:360
#: sysprep/virt-sysprep.pod:364 sysprep/virt-sysprep.pod:368
#: sysprep/virt-sysprep.pod:421 sysprep/virt-sysprep.pod:433
#: sysprep/virt-sysprep.pod:437 sysprep/virt-sysprep.pod:445
#: sysprep/virt-sysprep.pod:451 win-reg/virt-win-reg.in:194
#: win-reg/virt-win-reg.in:199 win-reg/virt-win-reg.in:205
#: win-reg/virt-win-reg.in:774 win-reg/virt-win-reg.in:780
#: win-reg/virt-win-reg.in:786
msgid "*"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:360
msgid "0"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:362
msgid "successful exit, all partitions are aligned E<ge> 64K for best performance"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:366
msgid "1"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:368
msgid "an error scanning the disk image or guest"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:372
msgid "2"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:374
msgid ""
"successful exit, some partitions have alignment E<lt> 64K which can result "
"in poor performance on high end network storage"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:379
msgid "3"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:381
msgid ""
"successful exit, some partitions have alignment E<lt> 4K which can result in "
"poor performance on most hypervisors"
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:386 builder/virt-builder-repository.pod:207
#: builder/virt-builder.pod:1860 builder/virt-index-validate.pod:79
#: cat/virt-cat.pod:276 cat/virt-filesystems.pod:385 cat/virt-log.pod:137
#: cat/virt-ls.pod:519 cat/virt-tail.pod:237 customize/virt-customize.pod:291
#: df/virt-df.pod:258 diff/virt-diff.pod:249
#: docs/guestfs-tools-release-notes-1.48.pod:102
#: docs/guestfs-tools-release-notes-1.50.pod:160
#: docs/guestfs-tools-release-notes-1.52.pod:99 drivers/virt-drivers.pod:234
#: edit/virt-edit.pod:384 format/virt-format.pod:187
#: get-kernel/virt-get-kernel.pod:201 inspector/virt-inspector.pod:494
#: make-fs/virt-make-fs.pod:225 resize/virt-resize.pod:848
#: sparsify/virt-sparsify.pod:462 sysprep/virt-sysprep.pod:609
#: win-reg/virt-win-reg.in:805
msgid "SEE ALSO"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:388
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
"L<virt-resize(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:395 builder/virt-builder-repository.pod:212
#: builder/virt-builder.pod:1881 builder/virt-index-validate.pod:84
#: cat/virt-cat.pod:287 cat/virt-filesystems.pod:397 cat/virt-log.pod:148
#: cat/virt-ls.pod:529 cat/virt-tail.pod:248 df/virt-df.pod:267
#: diff/virt-diff.pod:259 drivers/virt-drivers.pod:244 edit/virt-edit.pod:395
#: format/virt-format.pod:197 get-kernel/virt-get-kernel.pod:210
#: make-fs/virt-make-fs.pod:239 resize/virt-resize.pod:873
#: sparsify/virt-sparsify.pod:475 win-reg/virt-win-reg.in:820
msgid "AUTHOR"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:397 builder/virt-builder.pod:1883
#: builder/virt-index-validate.pod:86 cat/virt-cat.pod:289
#: cat/virt-filesystems.pod:399 cat/virt-log.pod:150 cat/virt-ls.pod:531
#: cat/virt-tail.pod:250 customize/virt-customize.pod:310 df/virt-df.pod:269
#: diff/virt-diff.pod:261 drivers/virt-drivers.pod:246 edit/virt-edit.pod:397
#: format/virt-format.pod:199 get-kernel/virt-get-kernel.pod:212
#: inspector/virt-inspector.pod:510 make-fs/virt-make-fs.pod:241
#: resize/virt-resize.pod:875 sparsify/virt-sparsify.pod:477
#: sysprep/virt-sysprep.pod:628 win-reg/virt-win-reg.in:822
msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
msgstr ""

#. type: =head1
#: align/virt-alignment-scan.pod:399 builder/virt-builder-repository.pod:216
#: builder/virt-builder.pod:1885 builder/virt-index-validate.pod:88
#: cat/virt-cat.pod:291 cat/virt-filesystems.pod:401 cat/virt-log.pod:152
#: cat/virt-ls.pod:533 cat/virt-tail.pod:252 customize/virt-customize.pod:312
#: df/virt-df.pod:271 diff/virt-diff.pod:263
#: docs/guestfs-tools-release-notes-1.48.pod:128
#: docs/guestfs-tools-release-notes-1.50.pod:180
#: docs/guestfs-tools-release-notes-1.52.pod:121 drivers/virt-drivers.pod:248
#: edit/virt-edit.pod:399 format/virt-format.pod:201
#: get-kernel/virt-get-kernel.pod:214 inspector/virt-inspector.pod:518
#: make-fs/virt-make-fs.pod:243 resize/virt-resize.pod:877
#: sparsify/virt-sparsify.pod:479 sysprep/virt-sysprep.pod:632
#: win-reg/virt-win-reg.in:824
msgid "COPYRIGHT"
msgstr ""

#. type: textblock
#: align/virt-alignment-scan.pod:401
msgid "Copyright (C) 2011 Red Hat Inc."
msgstr ""

#. type: =end
#: builder/virt-builder-repository.pod:1 builder/virt-builder-repository.pod:6
#: builder/virt-builder.pod:1 builder/virt-builder.pod:6
msgid "html"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:3 builder/virt-builder.pod:3
#, no-wrap
msgid ""
"<img src=\"virt-builder.svg\" width=\"250\"\n"
"  style=\"float: right; clear: right;\" />\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:10
msgid "virt-builder-repository - Build virt-builder source repository easily"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:14
#, no-wrap
msgid ""
" virt-builder-repository /path/to/repository\n"
"    [-i|--interactive] [--gpg-key KEYID]\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:19
msgid ""
"Virt-builder is a tool for quickly building new virtual machines. It can be "
"configured to use template repositories. However creating and maintaining a "
"repository involves many tasks which can be automated.  "
"virt-builder-repository is a tool helping to manage these repositories."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:24
msgid ""
"Virt-builder-repository loops over the files in the directory specified as "
"argument, compresses the files with a name ending by C<qcow2>, C<raw>, "
"C<img> or without extension, extracts data from them and creates or updates "
"the C<index> file."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:29
msgid ""
"Some of the image-related data needed for the index file can’t be computed "
"from the image file. virt-builder-repository first tries to find them in the "
"existing index file. If data are still missing after this, they are prompted "
"in interactive mode, otherwise an error will be triggered."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:35
msgid ""
"If a C<KEYID> is provided, the generated index file will be signed with this "
"GPG key."
msgstr ""

#. type: =head1
#: builder/virt-builder-repository.pod:38 builder/virt-builder.pod:49
#: cat/virt-cat.pod:30 cat/virt-log.pod:25 cat/virt-ls.pod:33 df/virt-df.pod:45
#: edit/virt-edit.pod:36 resize/virt-resize.pod:25
#: sparsify/virt-sparsify.pod:85
msgid "EXAMPLES"
msgstr ""

#. type: =head2
#: builder/virt-builder-repository.pod:40
msgid "Create the initial repository"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:42
msgid ""
"Create a folder and copy the disk image template files in it. Then run a "
"command like the following one:"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:45
#: builder/virt-builder-repository.pod:81
#, no-wrap
msgid ""
" virt-builder-repository --gpg-key \"joe@hacker.org\" -i /path/to/folder\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:47
msgid ""
"Note that this example command runs in interactive mode. To run in automated "
"mode, a minimal index file needs to be created before running the command "
"containing sections like this one:"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:51
#, no-wrap
msgid ""
" [template_id]\n"
" file=template_filename.qcow.xz\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:54
msgid ""
"The file value needs to match the image name extended with the C<.xz> suffix "
"if the I<--no-compression> parameter is not provided or the image name if no "
"compression is involved. Other optional data can be prefilled. Default "
"values are computed by inspecting the disk image.  For more informations, "
"see L<virt-builder(1)/Creating and signing the index file>."
msgstr ""

#. type: =head2
#: builder/virt-builder-repository.pod:61
msgid "Update images in an existing repository"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:63
msgid ""
"In this use case, a new image or a new revision of an existing image needs "
"to be added to the repository. Place the corresponding image template files "
"in the repository folder."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:67
msgid ""
"To update the revision of an image, the file needs to have the same name "
"than the existing one (without the C<xz> extension)."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:70
msgid ""
"As in the repository creation use case, a minimal fragment can be added to "
"the index file for the automated mode. This can be done on the signed index "
"even if it may sound a strange idea: the index will be signed again by the "
"tool."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:75
msgid ""
"To remove an image from the repository, just remove the corresponding image "
"file before running virt-builder-repository."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:78
msgid "Then running the following command will complete and update the index file:"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:83
msgid ""
"virt-builder-repository works in a temporary folder inside the repository "
"one. If anything wrong happens when running the tool, the repository is left "
"untouched."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:93 builder/virt-builder.pod:176
#: builder/virt-index-validate.pod:64 drivers/virt-drivers.pod:119
#: get-kernel/virt-get-kernel.pod:29 resize/virt-resize.pod:274
#: sparsify/virt-sparsify.pod:120
msgid "Display help."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:95 builder/virt-builder.pod:312
msgid "B<--gpg> GPG"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:97
msgid ""
"Specify an alternate L<gpg(1)> (GNU Privacy Guard) binary.  You can also use "
"this to add gpg parameters, for example to specify an alternate home "
"directory:"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:101
#, no-wrap
msgid ""
" virt-builder-repository --gpg \"gpg --homedir /tmp\" [...]\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:103
msgid "This can also be used to avoid gpg asking for the key passphrase:"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:105
#, no-wrap
msgid ""
" virt-builder-repository --gpg \"gpg --passphrase-file /tmp/pass --batch\" "
"[...]\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:107
msgid "B<-K> KEYID"
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:109
msgid "B<--gpg-key> KEYID"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:111
msgid ""
"Specify the GPG key to be used to sign the repository index file.  If not "
"provided, the index will left unsigned. C<KEYID> is used to identify the GPG "
"key to use. This value is passed to gpg’s I<--default-key> option and can "
"thus be an email address or a fingerprint."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:117
msgid ""
"B<NOTE>: by default, virt-builder-repository searches for the key in the "
"user’s GPG keyring."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:120 df/virt-df.pod:153
msgid "B<-i>"
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:122
msgid "B<--interactive>"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:124
msgid "Prompt for missing data. Default values are computed from the disk image."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:127
msgid ""
"When prompted for data, inputting C<-> corresponds to leaving the value "
"empty. This can be used to avoid setting the default computed value."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:130
msgid "B<--no-compression>"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:132
msgid "Don’t compress the template images."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:134 builder/virt-builder.pod:364
#: get-kernel/virt-get-kernel.pod:104 resize/virt-resize.pod:462
#: sparsify/virt-sparsify.pod:237
msgid "B<--machine-readable>"
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:136 builder/virt-builder.pod:366
#: get-kernel/virt-get-kernel.pod:106 resize/virt-resize.pod:464
#: sparsify/virt-sparsify.pod:239
msgid "B<--machine-readable>=format"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:138 builder/virt-builder.pod:368
#: get-kernel/virt-get-kernel.pod:108 resize/virt-resize.pod:466
#: sparsify/virt-sparsify.pod:241
msgid ""
"This option is used to make the output more machine friendly when being "
"parsed by other programs.  See L</MACHINE READABLE OUTPUT> below."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:142 builder/virt-builder.pod:238
#: customize/virt-customize.pod:77 drivers/virt-drivers.pod:145
#: get-kernel/virt-get-kernel.pod:55 resize/virt-resize.pod:332
#: sparsify/virt-sparsify.pod:158 sysprep/virt-sysprep.pod:60
msgid "B<--colors>"
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:144 builder/virt-builder.pod:240
#: customize/virt-customize.pod:79 drivers/virt-drivers.pod:147
#: get-kernel/virt-get-kernel.pod:57 resize/virt-resize.pod:334
#: sparsify/virt-sparsify.pod:160 sysprep/virt-sysprep.pod:62
msgid "B<--colours>"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:146 builder/virt-builder.pod:242
#: customize/virt-customize.pod:81 drivers/virt-drivers.pod:149
#: get-kernel/virt-get-kernel.pod:59 resize/virt-resize.pod:336
#: sparsify/virt-sparsify.pod:162 sysprep/virt-sysprep.pod:64
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:155 builder/virt-builder.pod:475
#: drivers/virt-drivers.pod:198 get-kernel/virt-get-kernel.pod:136
msgid "Don’t print ordinary progress messages."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:161 builder/virt-builder.pod:522
msgid "Enable debug messages and/or produce verbose output."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:163 builder/virt-builder.pod:524
msgid ""
"When reporting bugs, use this option and attach the complete output to your "
"bug report."
msgstr ""

#. type: =item
#: builder/virt-builder-repository.pod:172 builder/virt-builder.pod:533
#: customize/virt-customize.pod:227 drivers/virt-drivers.pod:212
#: get-kernel/virt-get-kernel.pod:161 resize/virt-resize.pod:634
#: sparsify/virt-sparsify.pod:320 sysprep/virt-sysprep.pod:265
msgid "B<--wrap>"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:174 builder/virt-builder.pod:535
#: customize/virt-customize.pod:229 drivers/virt-drivers.pod:214
#: get-kernel/virt-get-kernel.pod:163 resize/virt-resize.pod:636
#: sparsify/virt-sparsify.pod:322 sysprep/virt-sysprep.pod:267
msgid ""
"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."
msgstr ""

#. type: =head1
#: builder/virt-builder-repository.pod:184 builder/virt-builder.pod:1767
#: get-kernel/virt-get-kernel.pod:173 resize/virt-resize.pod:646
#: sparsify/virt-sparsify.pod:360
msgid "MACHINE READABLE OUTPUT"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:186
msgid ""
"The I<--machine-readable> option can be used to make the output more machine "
"friendly, which is useful when calling virt-builder-repository from other "
"programs, GUIs etc."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:190
msgid ""
"Use the option on its own to query the capabilities of the "
"virt-builder-repository binary.  Typical output looks like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder-repository.pod:193
#, no-wrap
msgid ""
" $ virt-builder-repository --machine-readable\n"
" virt-builder-repository\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:196 builder/virt-builder.pod:1784
#: get-kernel/virt-get-kernel.pod:185 resize/virt-resize.pod:664
#: sparsify/virt-sparsify.pod:376
msgid ""
"A list of features is printed, one per line, and the program exits with "
"status 0."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:199 builder/virt-builder.pod:1787
#: get-kernel/virt-get-kernel.pod:188 resize/virt-resize.pod:698
#: sparsify/virt-sparsify.pod:410
msgid ""
"It is possible to specify a format string for controlling the output; see "
"L<guestfs(3)/ADVANCED MACHINE READABLE OUTPUT>."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:204 builder/virt-builder.pod:1857
#: cat/virt-cat.pod:273 cat/virt-filesystems.pod:382 cat/virt-log.pod:134
#: cat/virt-ls.pod:516 cat/virt-tail.pod:234 df/virt-df.pod:255
#: diff/virt-diff.pod:246 drivers/virt-drivers.pod:231 edit/virt-edit.pod:381
#: get-kernel/virt-get-kernel.pod:198 inspector/virt-inspector.pod:491
#: resize/virt-resize.pod:845
msgid "This program returns 0 if successful, or non-zero if there was an error."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:209
msgid "L<virt-builder(1)> L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:214
msgid "Cédric Bosdonnat L<mailto:cbosdonnat@suse.com>"
msgstr ""

#. type: textblock
#: builder/virt-builder-repository.pod:218
msgid "Copyright (C) 2016-2023 SUSE Inc."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:10
msgid "virt-builder - Build virtual machine images quickly"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:14
#, no-wrap
msgid ""
" virt-builder os-version\n"
"    [-o|--output DISKIMAGE] [--size SIZE] [--format raw|qcow2]\n"
"    [--arch ARCHITECTURE] [--attach ISOFILE]\n"
"__CUSTOMIZE_SYNOPSIS__\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:19
#, no-wrap
msgid ""
" virt-builder -l|--list [--long] [--list-format short|long|json] "
"[os-version]\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:21
#, no-wrap
msgid ""
" virt-builder --notes os-version\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:23 builder/virt-builder.pod:1552
#, no-wrap
msgid ""
" virt-builder --print-cache\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:25 builder/virt-builder.pod:1560
#, no-wrap
msgid ""
" virt-builder --cache-all-templates\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:27 builder/virt-builder.pod:1556
#, no-wrap
msgid ""
" virt-builder --delete-cache\n"
"\n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:29
#, no-wrap
msgid ""
" virt-builder --get-kernel DISKIMAGE\n"
"    [--format raw|qcow2] [--output OUTPUTDIR]\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:34
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:40
msgid ""
"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 L<virt-install(1)> and L<oz-install(1)>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:46
msgid ""
"The easiest way to get started is by looking at the examples in the next "
"section."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:51
msgid "List the virtual machines available"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:53
#, no-wrap
msgid ""
" virt-builder --list\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:55
msgid ""
"will list out the operating systems available to install.  A selection of "
"freely redistributable OSes is available as standard.  You can add your own "
"too (see below)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:59
msgid ""
"After choosing a guest from the list, you may want to see if there are any "
"installation notes:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:62
#, no-wrap
msgid ""
" virt-builder --notes fedora-27\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:64
msgid "Build a virtual machine"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:66
#, no-wrap
msgid ""
" virt-builder fedora-27\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:68
msgid ""
"will build a Fedora 25 image for the same architecture as virt-builder (so "
"running it from an i686 installation will try to build an i686 image, if "
"available).  This will have all default configuration (minimal size, no user "
"accounts, random root password, only the bare minimum installed software, "
"etc.)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:74
msgid "You I<do not> need to run this command as root."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:76
msgid ""
"The first time this runs it has to download the template over the network, "
"but this gets cached (see L</CACHING>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:79
msgid ""
"The name of the output file is derived from the template name, so above it "
"will be F<fedora-27.img>.  You can change the output filename using the "
"I<-o> option:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:83
#, no-wrap
msgid ""
" virt-builder fedora-27 -o mydisk.img\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:85
msgid ""
"You can also use the I<-o> option to write to existing devices or logical "
"volumes."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:88
#, no-wrap
msgid ""
" virt-builder fedora-27 --format qcow2\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:90
msgid "As above, but write the output in qcow2 format to F<fedora-27.qcow2>."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:92
#, no-wrap
msgid ""
" virt-builder fedora-27 --size 20G\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:94
msgid ""
"As above, but the output size will be 20 GB.  The guest OS is resized as it "
"is copied to the output (automatically, using L<virt-resize(1)>)."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:98
#, no-wrap
msgid ""
" virt-builder fedora-27 --arch i686\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:100
msgid "As above, but using an i686 template, if available."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:102
msgid "Setting the root password"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:104
#, no-wrap
msgid ""
" virt-builder fedora-27 --root-password file:/tmp/rootpw\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:106
msgid ""
"Create a Fedora 25 image.  The root password is taken from the file "
"F</tmp/rootpw>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:109
msgid ""
"Note if you I<don’t> set I<--root-password> then the guest is given a "
"I<random> root password which is printed on stdout."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:112
msgid "You can also create user accounts.  See L</USERS AND PASSWORDS> below."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:114
msgid "Set the hostname"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:116
#, no-wrap
msgid ""
" virt-builder fedora-27 --hostname virt.example.com\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:118
msgid "Set the hostname to C<virt.example.com>."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:120
msgid "Installing software"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:122
msgid ""
"To install packages from the ordinary (guest) software repository (eg. dnf "
"or apt):"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:125
#, no-wrap
msgid ""
" virt-builder fedora-27 --install \"inkscape,@Xfce Desktop\"\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:127
msgid ""
"(In Fedora, C<@> is used to install groups of packages.  On Debian you would "
"install a meta-package instead.)"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:130
msgid "To update the installed packages to the latest version:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:132
#, no-wrap
msgid ""
" virt-builder debian-7 --update\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:134
msgid "Customizing the installation"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:136
msgid ""
"There are many options that let you customize the installation.  These "
"include: I<--run>/I<--run-command>, which run a shell script or command "
"while the disk image is being generated and lets you add or edit files that "
"go into the disk image.  I<--firstboot>/I<--firstboot-command>, which let "
"you add scripts/commands that are run the first time the guest boots.  "
"I<--edit> to edit files.  I<--upload> to upload files."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:146
#, no-wrap
msgid ""
" cat <<'EOF' > /tmp/dnf-update.sh\n"
" dnf -y --best update\n"
" EOF\n"
" \n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:150
#, no-wrap
msgid ""
" virt-builder fedora-27 --firstboot /tmp/dnf-update.sh\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:152
msgid "or simply:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:154
#, no-wrap
msgid ""
" virt-builder fedora-27 --firstboot-command 'dnf -y --best update'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:156
msgid ""
"which makes the L<dnf(8)> C<update> command run once the first time the "
"guest boots."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:159
msgid "Or:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:161
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --edit '/etc/dnf/dnf.conf:\n"
"             s/gpgcheck=1/gpgcheck=0/'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:165
msgid ""
"which edits F</etc/dnf/dnf.conf> inside the disk image (during disk image "
"creation, long before boot)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:168
msgid "You can combine these options, and have multiple options of all types."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:178
msgid "B<--arch> ARCHITECTURE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:180
msgid ""
"Use the specified architecture for the output image.  This means there must "
"be sources providing the requested template for the requested architecture."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:184
msgid "See also L</ARCHITECTURE>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:186 customize/virt-customize.pod:56
msgid "B<--attach> ISOFILE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:188
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:192 customize/virt-customize.pod:62
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:196 customize/virt-customize.pod:66
#, no-wrap
msgid ""
" mkdir /tmp/mount\n"
" mount LABEL=EXTRA /tmp/mount\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:199 customize/virt-customize.pod:69
msgid ""
"You can have multiple I<--attach> options, and the format can be any disk "
"format (not just an ISO)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:202
msgid ""
"See also: I<--run>, L</Installing packages at build time from a side "
"repository>, L<genisoimage(1)>, L<virt-make-fs(1)>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:206 customize/virt-customize.pod:72
msgid "B<--attach-format> FORMAT"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:208 customize/virt-customize.pod:74
msgid ""
"Specify the disk format for the next I<--attach> option.  The C<FORMAT> is "
"usually C<raw> or C<qcow2>.  Use C<raw> for ISOs."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:211
msgid "B<--cache> DIR"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:213
msgid "B<--no-cache>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:215
msgid ""
"I<--cache> DIR sets the directory to use/check for cached template files.  "
"If not set, defaults to either F<$XDG_CACHE_HOME/virt-builder/> or "
"F<$HOME/.cache/virt-builder/>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:219
msgid "I<--no-cache> disables template caching."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:221
msgid "B<--cache-all-templates>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:223
msgid "Download all templates to the cache and then exit.  See L</CACHING>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:225
msgid ""
"Note this doesn't cache everything.  More templates might be uploaded.  Also "
"this doesn't cache packages (the I<--install>, I<--update> options)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:228
msgid "B<--check-signature>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:230
msgid "B<--no-check-signature>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:232
msgid ""
"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 "
"I<--no-check-signature> bypasses this check."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:236
msgid "See also I<--fingerprint>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:247
msgid "B<--curl> CURL"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:249
msgid ""
"Specify an alternate L<curl(1)> binary.  You can also use this to add curl "
"parameters, for example to disable https certificate checks:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:252
#, no-wrap
msgid ""
" virt-builder --curl \"curl --insecure\" [...]\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:254
msgid "B<--delete-cache>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:256
msgid "Delete the template cache.  See L</CACHING>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:258
msgid "B<--no-delete-on-failure>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:260
msgid ""
"Don’t delete the output file on failure to build.  You can use this to debug "
"failures to run scripts.  See L</DEBUGGING BUILDS> for ways to debug images."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:264
msgid ""
"The default is to delete the output file if virt-builder fails (or, for "
"example, some script that it runs fails)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:267
msgid "B<--fingerprint> 'AAAA BBBB ...'"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:269
msgid ""
"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)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:273
msgid ""
"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."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:278 sparsify/virt-sparsify.pod:204
msgid "B<--format> qcow2"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:280 sparsify/virt-sparsify.pod:202
#: win-reg/virt-win-reg.in:139
msgid "B<--format> raw"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:282
msgid "For ordinary builds, this selects the output format.  The default is I<raw>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:284
msgid "With I<--get-kernel> this specifies the input format."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:286
msgid ""
"To create an old-style qcow2 file (for compatibility with RHEL 6 or very old "
"qemu E<lt> 1.1), after running virt-builder, use this command:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:290
#, no-wrap
msgid ""
" qemu-img amend -f qcow2 -o compat=0.10 output.qcow2\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:292
msgid "B<--get-kernel> IMAGE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:294
msgid ""
"This option extracts the kernel and initramfs from a previously built disk "
"image called C<IMAGE> (in fact it works for any VM disk image, not just ones "
"built using virt-builder)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:298
msgid ""
"Note this method is B<deprecated>: there is a separate tool for this, "
"L<virt-get-kernel(1)>, which has more options for the file extraction."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:301
msgid ""
"The kernel and initramfs are written to the current directory, unless you "
"also specify the I<--output> C<outputdir> B<directory> name."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:304 get-kernel/virt-get-kernel.pod:15
msgid ""
"The format of the disk image is automatically detected unless you specify it "
"by using the I<--format> option."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:307
msgid ""
"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 L<guestfish(1)>.  To extract the entire F</boot> directory "
"of a guest, see L<virt-copy-out(1)>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:314
msgid ""
"Specify an alternate L<gpg(1)> (GNU Privacy Guard) binary.  By default "
"virt-builder looks for either C<gpg2> or C<gpg> in the C<$PATH>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:317
msgid ""
"You can also use this to add gpg parameters, for example to specify an "
"alternate home directory:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:320
#, no-wrap
msgid ""
" virt-builder --gpg \"gpg --homedir /tmp\" [...]\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:322
msgid "B<-l> [os-version]"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:324
msgid "B<--list> [os-version]"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:326
msgid "B<--list> B<--list-format> format [os-version]"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:328
msgid "B<--list> B<--long> [os-version]"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:330
msgid ""
"List all the available templates if no guest is specified, or only for the "
"specified one."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:333
msgid ""
"It is possible to choose with I<--list-format> the output format for the "
"list templates:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:338
msgid "B<short>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:340
msgid ""
"The default format, prints only the template identifier and, next to it, its "
"short description."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:343
msgid "B<long>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:345
msgid ""
"Prints a textual list with the details of the available sources, followed by "
"the details of the available templates."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:348
msgid "B<json>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:350
msgid ""
"Prints a JSON object with the details of the available sources and the "
"details of the available templates."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:353
msgid ""
"The C<version> 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)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:360
msgid "I<--long> is a shorthand for the C<long> format."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:362
msgid "See also: I<--source>, I<--notes>, L</SOURCES OF TEMPLATES>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:372 customize/virt-customize.pod:145
msgid "B<-m> MB"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:374 customize/virt-customize.pod:147
msgid "B<--memsize> MB"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:376 customize/virt-customize.pod:149
msgid ""
"Change the amount of memory allocated to I<--run> scripts.  Increase this if "
"you find that I<--run> scripts or the I<--install> option are running out of "
"memory."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:380 customize/virt-customize.pod:153
msgid "The default can be found with this command:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:382 customize/virt-customize.pod:155
#, no-wrap
msgid ""
" guestfish get-memsize\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:384 customize/virt-customize.pod:157
#: sysprep/virt-sysprep.pod:240
msgid "B<--network>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:386 customize/virt-customize.pod:159
#: sysprep/virt-sysprep.pod:242
msgid "B<--no-network>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:388 customize/virt-customize.pod:161
#: sysprep/virt-sysprep.pod:244
msgid "Enable or disable network access from the guest during the installation."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:390 customize/virt-customize.pod:163
msgid "Enabled is the default.  Use I<--no-network> to disable access."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:392 customize/virt-customize.pod:165
msgid ""
"The network only allows outgoing connections and has other minor "
"limitations.  See L<virt-rescue(1)/NETWORK>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:395 customize/virt-customize.pod:168
msgid ""
"If you use I<--no-network> then certain other options such as I<--install> "
"will not work."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:398
msgid ""
"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-builder."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:402 customize/virt-customize.pod:175
msgid ""
"Generally speaking you should I<not> use I<--no-network>.  But here are some "
"reasons why you might want to:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:407 builder/virt-builder.pod:988
#: customize/virt-customize.pod:180 resize/virt-resize.pod:29
#: resize/virt-resize.pod:674 resize/virt-resize.pod:790
#: sparsify/virt-sparsify.pod:386
msgid "1."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:409 customize/virt-customize.pod:182
msgid ""
"Because the libguestfs backend that you are using doesn't support the "
"network.  (See: L<guestfs(3)/BACKEND>)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:412 builder/virt-builder.pod:993
#: customize/virt-customize.pod:185 resize/virt-resize.pod:43
#: resize/virt-resize.pod:681 resize/virt-resize.pod:808
#: sparsify/virt-sparsify.pod:393
msgid "2."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:414 customize/virt-customize.pod:187
msgid ""
"Any software you need to install comes from an attached ISO, so you don't "
"need the network."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:417 builder/virt-builder.pod:1003
#: customize/virt-customize.pod:190 resize/virt-resize.pod:51
#: resize/virt-resize.pod:687 sparsify/virt-sparsify.pod:399
msgid "3."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:419
msgid ""
"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</SECURITY> below)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:424 customize/virt-customize.pod:197
#: resize/virt-resize.pod:60
msgid "4."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:426 customize/virt-customize.pod:199
msgid "You don’t have a host network (eg. in secure/restricted environments)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:430
msgid "B<--no-sync>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:432
msgid "Do not sync the output file on exit."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:434
msgid "Virt-builder C<fsync>s the output file or disk image when it exits."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:436
msgid ""
"The reason is that qemu/KVM’s default caching mode is C<none> or "
"C<directsync>, both of which bypass the host page cache.  Therefore these "
"would not work correctly if you immediately started the guest after running "
"virt-builder - they would not see the complete output file.  (Note that you "
"should not use these caching modes - they are fundamentally broken for this "
"and other reasons.)"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:443
msgid ""
"If you are not using these broken caching modes, you can use I<--no-sync> to "
"avoid this unnecessary sync and gain considerable extra performance."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:447
msgid "B<--notes> os-version"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:449
msgid ""
"List any notes associated with this guest, then exit (this does not do the "
"install)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:452
msgid "B<-o> filename"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:454
msgid "B<--output> filename"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:456
msgid ""
"Write the output to F<filename>.  If you don’t specify this option, then the "
"output filename is generated by taking the C<os-version> string and adding "
"C<.img> (for raw format) or C<.qcow2> (for qcow2 format)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:461
msgid ""
"Note that the output filename could be a device, partition or logical "
"volume."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:464
msgid "When used with I<--get-kernel>, this option specifies the output directory."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:467
msgid "B<--print-cache>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:469
msgid "Print information about the template cache.  See L</CACHING>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:477
msgid "B<--size> SIZE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:479
msgid ""
"Select the size of the output disk, where the size can be specified using "
"common names such as C<32G> (32 gigabytes) etc."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:482
msgid "Virt-builder will resize filesystems inside the disk image automatically."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:485
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:490
msgid ""
"To specify size in bytes, the number must be followed by the lowercase "
"letter I<b>, eg: S<C<--size 10737418240b>>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:493 customize/virt-customize.pod:211
msgid "B<--smp> N"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:495 customize/virt-customize.pod:213
msgid "Enable N E<ge> 2 virtual CPUs for I<--run> scripts to use."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:497
msgid "B<--source> URL"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:499
msgid "Set the source URL to look for indexes."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:501
msgid "You can give this option multiple times to specify multiple sources."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:503
msgid "See also L</SOURCES OF TEMPLATES> below."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:505
msgid ""
"Note that you should not point I<--source> to sources that you don’t trust "
"(unless the source is signed by someone you do trust).  See also the "
"I<--no-network> option."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:509
msgid "B<--no-warn-if-partition>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:511
msgid ""
"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 (S<I<--output /dev/sdX>>), not "
"to a partition on the device (S<I<--output /dev/sdX1>>).  Use this option to "
"I<suppress> this warning."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:545 customize/virt-customize.pod:239
msgid "Customization options"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:547 customize/virt-customize.pod:241
msgid "__CUSTOMIZE_OPTIONS__"
msgstr ""

#. type: =head1
#: builder/virt-builder.pod:549
msgid "REFERENCE"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:551
msgid "INSTALLING PACKAGES"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:553
msgid ""
"There are several approaches to installing packages or applications in the "
"guest which have different trade-offs."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:556
msgid "Installing packages at build time"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:558
msgid ""
"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 "
"I<--install> to install packages like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:562
#, no-wrap
msgid ""
" virt-builder fedora-27 --install inkscape\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:564
msgid "This uses the guest’s package manager and the host’s network connection."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:567
msgid "Updating packages at build time"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:569
msgid "To update the installed packages in the template at build time:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:571
#, no-wrap
msgid ""
" virt-builder fedora-27 --update\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:573
msgid ""
"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."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:579
msgid "Installing packages at first boot"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:581
msgid "Another option is to install the packages when the guest first boots:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:583
#, no-wrap
msgid ""
" virt-builder fedora-27 --firstboot-install inkscape\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:585
msgid "This uses the guest’s package manager and the guest’s network connection."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:588
msgid ""
"The downsides are that it will take the guest a lot longer to boot first "
"time, and there’s nothing much you can do if package installation fails "
"(eg. if a network problem means the guest can't reach the package "
"repositories)."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:593
msgid "Installing packages at build time from a side repository"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:595
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:600
msgid ""
"You can create the disk image using either L<genisoimage(1)> or "
"L<virt-make-fs(1)>.  For genisoimage, use a command like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:603
#, no-wrap
msgid ""
" genisoimage -o extra-packages.iso -R -J -V EXTRA cdcontents/\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:605
msgid ""
"Create a script that mounts the ISO and sets up the repository.  For dnf, "
"create /tmp/install.sh containing:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:608 builder/virt-builder.pod:622
#, no-wrap
msgid ""
" mkdir /tmp/mount\n"
" mount LABEL=EXTRA /tmp/mount\n"
" \n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:611
#, no-wrap
msgid ""
" cat <<'EOF' > /etc/yum.repos.d/extra.repo\n"
" [extra]\n"
" name=extra\n"
" baseurl=file:///tmp/mount\n"
" enabled=1\n"
" EOF\n"
" \n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:618
#, no-wrap
msgid ""
" dnf -y install famousdatabase\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:620
msgid "For apt, create /tmp/install.sh containing:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:625
#, no-wrap
msgid ""
" apt-cdrom -d=/tmp/mount add\n"
" apt-get -y install famousdatabase\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:628
msgid ""
"Use the I<--attach> option to attach the CD / disk image and the I<--run> "
"option to run the script:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:631
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --attach extra-packages.iso \\\n"
"   --run /tmp/install.sh\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:635
msgid "USERS AND PASSWORDS"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:637
msgid ""
"The I<--root-password> option is used to change the root password (otherwise "
"a random password is used).  This option takes a password C<SELECTOR> in one "
"of the following formats:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:643
msgid "B<--root-password> file:FILENAME"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:645
msgid ""
"Read the root password from C<FILENAME>.  The whole first line of this file "
"is the replacement password.  Any other lines are ignored.  You should "
"create the file with mode 0600 to ensure no one else can read it."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:650
msgid "B<--root-password> password:PASSWORD"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:652
msgid "Set the root password to the literal string C<PASSWORD>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:654
msgid ""
"B<Note: this is not secure> since any user on the same machine can see the "
"cleartext password using L<ps(1)>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:657
msgid "B<--root-password> random"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:659
msgid ""
"Choose a random password, which is printed on stdout.  The password has "
"approximately 120 bits of randomness."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:662 format/virt-format.pod:140
msgid "This is the default."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:664
msgid "B<--root-password> disabled"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:666
msgid ""
"The root account password is disabled.  This is like putting C<*> in the "
"password field."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:669
msgid "B<--root-password> locked:file:FILENAME"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:671
msgid "B<--root-password> locked:password:PASSWORD"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:673
msgid "B<--root-password> locked:random"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:675
msgid ""
"The root account is locked, but a password is placed on the account.  If "
"first unlocked (using C<passwd -u>) then logins will use the given password."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:679
msgid "B<--root-password> locked"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:681
msgid "B<--root-password> locked:disabled"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:683
msgid "The root account is locked I<and> password is disabled."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:687
msgid "Creating user accounts"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:689
msgid ""
"To create user accounts, use the L<useradd(8)> command with "
"L<--firstboot-command> like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:692
#, no-wrap
msgid ""
" virt-builder --firstboot-command \\\n"
"    'useradd -m -p \"\" rjones ; chage -d 0 rjones'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:695
msgid ""
"The above command will create an C<rjones> 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 L<useradd(8)> for details."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:699
msgid "KEYBOARD LAYOUT"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:701
msgid ""
"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."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:706
msgid "Keyboard layout with systemd"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:708
msgid "For distros that use systemd C<localectl>, use a command like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:710
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --firstboot-command 'localectl set-keymap uk'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:713
msgid ""
"See L<localectl(1)> and "
"L<https://www.happyassassin.net/2013/11/23/keyboard-layouts-in-fedora-20-and-previously/> "
"for more details."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:717
msgid "Keyboard layout using F</etc/sysconfig/keyboard>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:719
msgid ""
"For RHEL E<le> 6, Fedora E<le> 18 and similar, upload or modify the keyboard "
"configuration file using the I<--upload>, I<--write> or I<--edit> options.  "
"For example:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:723
#, no-wrap
msgid ""
" virt-builder centos-6 \\\n"
"   --edit '/etc/sysconfig/keyboard: s/^KEYTABLE=.*/KEYTABLE=\"uk\"/'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:726
msgid "The format of this file can be found documented in many places online."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:728
msgid "Keyboard layout with Debian-derived distros"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:730
msgid ""
"For Debian-derived distros using F</etc/default/keyboard>, upload or modify "
"the keyboard file using the I<--upload>, I<--write> or I<--edit> options.  "
"For example:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:734
#, no-wrap
msgid ""
" virt-builder debian-8 \\\n"
"   --edit '/etc/default/keyboard: s/^XKBLAYOUT=.*/XKBLAYOUT=\"gb\"/'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:737
msgid "See L<https://wiki.debian.org/Keyboard>."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:739
msgid "LANGUAGE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:741
msgid ""
"Most Linux distributions support multiple locale settings so that you can "
"have guest messages printed in another language such as Russian."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:744
msgid ""
"However there is no single setting which controls this, since extra packages "
"may need to be installed to support console and X fonts, and keyboard input "
"methods.  The packages required, and their configuration is highly "
"distro-specific, and it is outside the scope of virt-builder to do this."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:750
msgid "This section contains examples for some common Linux distributions."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:752
msgid "Setting Japanese in Fedora 25"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:754
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --size 20G \\\n"
"   --update \\\n"
"   --install @japanese-support \\\n"
"   --install @xfce \\\n"
"   --install xorg-x11-server-Xorg,xorg-x11-drivers,rsyslog \\\n"
"   --link "
"/usr/lib/systemd/system/graphical.target:/etc/systemd/system/default.target "
"\\\n"
"   --firstboot-command 'localectl set-locale LANG=ja_JP.utf8' \\\n"
"   --firstboot-command 'localectl set-keymap jp' \\\n"
"   --firstboot-command 'systemctl isolate graphical.target'\n"
"\n"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:765
msgid "Setting Japanese in Debian 8 (Jessie)"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:767
msgid ""
"Note that although this enables Japanese in the text console too, it is "
"unlikely that you will see properly rendered Japanese there.  However "
"Japanese is properly rendered in X applications and terminals."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:771
#, no-wrap
msgid ""
" pkgs=locales,xfce4,\\\n"
" ibus,ibus-anthy,\\\n"
" fonts-ipafont-gothic,fonts-ipafont-mincho,\\\n"
" fonts-takao-mincho,\\\n"
" xfonts-intl-japanese,xfonts-intl-japanese-big,\\\n"
" iceweasel-l10n-ja,manpages-ja\n"
" \n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:778
#, no-wrap
msgid ""
" virt-builder debian-8 \\\n"
"   --size 20G \\\n"
"   --install $pkgs \\\n"
"   --edit '/etc/locale.gen: s,^#\\s*ja,ja,' \\\n"
"   --write '/etc/default/locale:LANG=\"ja_JP.UTF-8\"' \\\n"
"   --run-command \"locale-gen\"\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:785
msgid "LOG FILE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:787
msgid ""
"Scripts and package installation that runs at build time (I<--run>, "
"I<--run-command>, I<--install>, I<--update>, but I<not> firstboot) is logged "
"in one of the following locations:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:793
msgid "F</tmp/builder.log>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:795
msgid "On Linux, BSD, and other non-Windows guests."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:797
msgid "F<C:\\Temp\\builder.log>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:799
msgid "On Windows, DOS guests."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:801
msgid "F</builder.log>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:803
msgid "If F</tmp> or F<C:\\Temp> is missing."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:807
msgid ""
"If you don’t want the log file to appear in the final image, then use the "
"I<--no-logfile> command line option."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:810
msgid "SSH KEYS"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:812
msgid ""
"The I<--ssh-inject> option is used to inject ssh keys for users in the "
"guest, so they can login without supplying a password."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:815
msgid ""
"The C<SELECTOR> part of the option value is optional; in this case, "
"I<--ssh-inject> C<USER> means that we look in the I<current> user’s "
"F<~/.ssh> directory to find the default public ID file.  That key is "
"uploaded.  \"default public ID\" is the I<default_ID_file> file described in "
"L<ssh-copy-id(1)>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:821
msgid "If specified, the C<SELECTOR> can be in one of the following formats:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:825
msgid "B<--ssh-inject> USER:file:FILENAME"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:827
msgid "Read the ssh key from F<FILENAME>.  F<FILENAME> is usually a I<.pub> file."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:830
msgid "B<--ssh-inject> USER:string:KEY_STRING"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:832
msgid ""
"Use the specified C<KEY_STRING>.  C<KEY_STRING> is usually a public string "
"like I<ssh-rsa AAAA.... user@localhost>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:837
msgid ""
"In any case, the F<~USER/.ssh> directory and the "
"F<~USER/.ssh/authorized_keys> file will be created if not existing already."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:841
msgid "FIRST BOOT SCRIPTS"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:843
msgid ""
"The I<--firstboot> and I<--firstboot-command> 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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:848
msgid "Supported operating systems are:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:852
msgid "Linux"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:854
msgid ""
"Init systems supported are: systemd, System-V init (known also as sysvinit), "
"and Upstart (using the System-V scripts)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:857
msgid ""
"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, "
"C<$HOME> may be unset or empty."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:861
msgid ""
"The output of the first boot scripts is available in the guest as "
"F<~root/virt-sysprep-firstboot.log>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:864
msgid "Windows"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:866
msgid ""
"F<rhsrvany.exe>, available from sources at "
"L<https://github.com/rwmjones/rhsrvany>, or F<pvvxsvc.exe>, 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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:872
msgid ""
"F<rhsrvany.exe> or F<pvvxsvc.exe> is copied from the location pointed to by "
"the C<VIRT_TOOLS_DATA_DIR> environment variable; if not set, a compiled-in "
"default will be used (something like F</usr/share/virt-tools>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:876
msgid ""
"The output of the first boot scripts is available in the guest as "
"F<C:\\Program Files\\Guestfs\\Firstboot\\log.txt>."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:881
msgid "SUBSCRIPTION-MANAGER"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:883
msgid ""
"It is possible to automate the registration and attaching of the system "
"using C<subscription-manager>.  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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:889
msgid ""
"I<--sm-register> starts the registration process, and requires "
"I<--sm-credentials> to be specified; the format of the C<SELECTOR> of "
"I<--sm-credentials> is one of the following formats:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:895
msgid "B<--sm-credentials> USER:file:FILENAME"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:897
msgid "Read the password for the specified C<USER> from F<FILENAME>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:899
msgid "B<--sm-credentials> USER:password:PASSWORD"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:901
msgid "Use the literal string C<PASSWORD> for the specified C<USER>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:905
msgid ""
"I<--sm-attach> attaches the system to subscriptions; the format of its "
"C<SELECTOR> is one of the following:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:910
msgid "B<--sm-attach> auto"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:912
msgid ""
"C<subscription-manager> attaches to the best-fitting subscriptions for the "
"system."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:915
msgid "B<--sm-attach> file:FILENAME"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:917
msgid "Read the pool ID from F<FILENAME>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:919
msgid "B<--sm-attach> pool:POOL"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:921
msgid "Use the literal string C<POOL> as pool ID."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:925
msgid ""
"I<--sm-remove> removes all the subscriptions from the guest, while "
"I<--sm-unregister> completely unregister the system."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:928
msgid "INSTALLATION PROCESS"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:930
msgid "When you invoke virt-builder, installation proceeds as follows:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:936
msgid "The template image is downloaded."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:938
msgid ""
"If the template image is present in the cache, the cached version is used "
"instead.  (See L</CACHING>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:943
msgid "The template signature is checked."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:947
msgid "The template is uncompressed to a tmp file."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:951
msgid "The template image is resized into the destination, using L<virt-resize(1)>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:956
msgid "Extra disks are attached (I<--attach>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:960
msgid "A new random seed is generated for the guest."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:964
msgid ""
"Guest customization is performed, in the order specified on the command "
"line."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:969
msgid "SELinux relabelling is done unless disabled with I<--no-selinux-relabel>."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:973
msgid "IMPORTING THE DISK IMAGE"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:975
msgid "Importing into libvirt"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:977
msgid ""
"Import the disk image into libvirt using L<virt-install(1)> I<--import> "
"option."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:980
#, no-wrap
msgid ""
" virt-install --import \\\n"
"   --name guest --ram 2048 \\\n"
"   --disk path=disk.img,format=raw --os-variant fedora27\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:984 win-reg/virt-win-reg.in:770
msgid "Notes:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:990
msgid ""
"You I<must> specify the correct format.  The format is C<raw> unless you "
"used virt-builder’s I<--format> option."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:995
msgid ""
"I<--os-variant> 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:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:999
#, no-wrap
msgid ""
" osinfo-query os\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1001
msgid "The above tool is provided by libosinfo package."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1005
msgid ""
"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."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1013
msgid "Importing into OpenStack"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1015
msgid "Import the image into Glance (the OpenStack image store) by doing:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1017
#, no-wrap
msgid ""
" glance image-create --name fedora-27-image --file fedora-27.img \\\n"
"   --disk-format raw --container-format bare \\\n"
"   --is-public True\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1021
msgid ""
"The I<--file> parameter is the virt-builder-generated disk image.  It should "
"match virt-builder’s I<--output> option.  The I<--disk-format> parameter "
"should match virt-builder’s I<--format> option (or C<raw> if you didn't use "
"that option).  The I<--container-format> should always be C<bare> since "
"virt-builder doesn't put images into containers."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1027
msgid ""
"You can use the S<C<glance image-show I<fedora-27-image>>> command to "
"display the properties of the image."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1030
msgid "To boot up an instance of your image on a Nova compute node, do:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1032
#, no-wrap
msgid ""
" nova boot fedora-27-server --image fedora-27-image \\\n"
"   --flavor m1.medium\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1035
msgid ""
"Use S<C<nova flavor-list>> to list possible machine flavors.  Use S<C<nova "
"list>> to list running instances."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1038
msgid "Booting directly using qemu or KVM"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1040
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1044
#, no-wrap
msgid ""
" qemu-system-x86_64 \\\n"
"   -machine accel=kvm:tcg \\\n"
"   -cpu host \\\n"
"   -m 2048 \\\n"
"   -drive file=disk.img,format=raw,if=virtio\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1050
msgid ""
"As with libvirt, it is very important that the correct format is chosen.  It "
"will be C<raw> unless the I<--format> option was used."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1053
msgid "CONFIGURATION MANAGEMENT"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1055
msgid "Puppet"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1057
msgid ""
"To enable the Puppet agent in a guest, install the package, point the "
"configuration at your Puppetmaster, and ensure the agent runs at boot."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1061
msgid "A typical virt-builder command would be:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1063
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --hostname client.example.com \\\n"
"   --update \\\n"
"   --install puppet \\\n"
"   --append-line '/etc/puppet/puppet.conf:[agent]' \\\n"
"   --append-line '/etc/puppet/puppet.conf:server = "
"puppetmaster.example.com/' \\\n"
"   --run-command 'systemctl enable puppet'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1071
msgid ""
"The precise instructions vary according to the Linux distro.  For further "
"information see: L<https://docs.puppet.com/puppet/latest/install_pre.html>"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1075
msgid "DEBUGGING BUILDS"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1077
msgid ""
"If virt-builder itself fails, then enable debugging (I<-v>) and report a bug "
"(see L</BUGS> below)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1080
msgid ""
"If virt-builder fails because some script or package it is installing fails, "
"try using I<--no-delete-on-failure> to preserve the output file, and "
"continue reading this section."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1084
msgid ""
"If virt-builder is successful but the image doesn't work, here are some "
"things to try:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1089
msgid "Use virt-rescue"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1091
msgid "Run L<virt-rescue(1)> on the disk image:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1093
#, no-wrap
msgid ""
" virt-rescue -a disk.img\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1095
msgid ""
"This gives you a rescue shell.  You can mount the filesystems from the disk "
"image on F</sysroot> and examine them using ordinary Linux commands.  You "
"can also chroot into the guest to reinstall the bootloader.  The virt-rescue "
"man page has a lot more information and examples."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1101
msgid "Use guestfish"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1103
msgid "Run L<guestfish(1)> on the disk image:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1105
#, no-wrap
msgid ""
" guestfish -a disk.img -i\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1107
msgid ""
"Use guestfish commands like C<ll /directory> and C<cat /file> to examine "
"directories and files."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1110
msgid "Use guestmount"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1112
msgid "Mount the disk image safely on the host using FUSE and L<guestmount(1)>:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1114
#, no-wrap
msgid ""
" mkdir /tmp/mp\n"
" guestmount -a disk.img -i /tmp/mp\n"
" cd /tmp/mp\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1118
msgid "To unmount the disk image do:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1120
#, no-wrap
msgid ""
" fusermount -u /tmp/mp\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1122
msgid "Add a serial console"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1124
msgid ""
"If the guest hangs during boot, it can be helpful to add a serial console to "
"the guest, and direct kernel messages to the serial console.  Adding the "
"serial console will involve looking at the documentation for your "
"hypervisor.  To direct kernel messages to the serial console, add the "
"following on the kernel command line:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1130
#, no-wrap
msgid ""
" console=tty0 console=ttyS0,115200\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1134
msgid "SOURCES OF TEMPLATES"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1136
msgid ""
"virt-builder reads the available sources from configuration files, with the "
"I<.conf> extension and located in the following paths:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1143
msgid ""
"$XDG_CONFIG_HOME/virt-builder/repos.d/ (C<$XDG_CONFIG_HOME> is "
"F<$HOME/.config> if not set)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1148
msgid ""
"$VIRT_BUILDER_DIRS/virt-builder/repos.d/ (where C<$VIRT_BUILDER_DIRS> means "
"any of the directories in that environment variable, or just F</etc> if not "
"set)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1154
msgid ""
"Each I<.conf> file in those paths has a simple text format like the "
"following:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1157
#, no-wrap
msgid ""
" [libguestfs.org]\n"
" uri=http://libguestfs.org/download/builder/index.asc\n"
" gpgkey=file:///etc/xdg/virt-builder/repos.d/libguestfs.gpg\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1161
msgid ""
"The part in square brackets is the repository identifier, which is used as "
"unique identifier."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1164 builder/virt-builder.pod:1335
msgid "The following fields can appear:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1168
msgid "C<uri=URI>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1170
msgid "The URI of the index file which this repository refers to."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1172 builder/virt-builder.pod:1424
msgid "This field is required."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1174
msgid "C<gpgkey=URI>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1176
msgid ""
"This optional field represents the URI (although only I<file://> URIs are "
"accepted) of the key used to sign the index file.  If not present, the index "
"file referred by I<uri=..> is not signed."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1180
msgid "C<proxy=MODE>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1182
msgid ""
"This optional field specifies the proxy mode, to be used when downloading "
"the index file of this repository.  The possible values are:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1187
msgid "B<no>, B<off>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1189
msgid "No proxy is being used at all, even overriding the system configuration."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1191
msgid "B<system>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1193
msgid "The proxy used is the system one."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1195
msgid "I<anything else>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1197
msgid ""
"Specifies the actual proxy configuration to be used, overriding the system "
"configuration."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1202
msgid ""
"If not present, the assumed value is to respect the proxy settings of the "
"system (i.e. as if B<system> would be specified)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1205
msgid "C<format=FORMAT>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1207
msgid ""
"This optional field specifies the format of the repository.  The possible "
"values are:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1212
msgid "B<native>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1214
msgid ""
"The native format of the C<virt-builder> repository.  See also L</Creating "
"and signing the index file> below."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1217
msgid "B<simplestreams>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1219
msgid "The URI represents the root of a Simple Streams v1.0 tree of metadata."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1221
msgid ""
"For more information about Simple Streams, see also "
"L<https://launchpad.net/simplestreams>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1226
msgid "If not present, the assumed value is C<native>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1230
msgid ""
"For serious virt-builder use, you may want to create your own repository of "
"templates."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1233
msgid "Libguestfs.org repository"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1235
msgid ""
"Out of the box, virt-builder downloads the file "
"L<http://libguestfs.org/download/builder/index.asc> which is an index of "
"available templates plus some information about each one, wrapped up in a "
"digital signature.  The command C<virt-builder --list> lists out the "
"information in this index file."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1241
msgid ""
"The templates hosted on libguestfs.org were created using shell scripts, "
"kickstart files and preseed files which can be found in the libguestfs "
"source tree, in C<builder/templates>."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1245
msgid "Setting up the repository"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1247
msgid ""
"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 I<.conf> file pointing "
"to it."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1251
msgid ""
"Note that if your index is signed, you will need to properly fill "
"I<gpgkey=..> in your I<.conf> file, making sure to deploy also the GPG key "
"file."
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1255
#, no-wrap
msgid ""
" virt-builder --source https://example.com/builder/index.asc \\\n"
"    --fingerprint 'AAAA BBBB ...' \\\n"
"    --list\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1259
msgid ""
"You can host this on any web or FTP server, or a local or network "
"filesystem."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1262
msgid "Setting up a GPG key"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1264
msgid ""
"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 I<--no-check-signature> "
"flag every time they use virt-builder.)"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1269
msgid ""
"To create a key, see the GPG manual "
"L<http://www.gnupg.org/gph/en/manual.html>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1272
msgid "Export your GPG public key:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1274
#, no-wrap
msgid ""
" gpg --export -a \"you@example.com\" > pubkey\n"
" \n"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1276
msgid "Create the templates"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1278
msgid ""
"There are many ways to create the templates.  For example you could clone "
"existing guests (see L<virt-sysprep(1)>), or you could install a guest by "
"hand (L<virt-install(1)>).  To see how the templates were created for "
"virt-builder, look at the scripts in C<builder/templates>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1283
msgid ""
"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 L<virt-sysprep(1)>) can be used as templates."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1287
msgid ""
"For best results when compressing the templates, use the following xz "
"options (see L<nbdkit-xz-plugin(1)> for further explanation):"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1290
#, no-wrap
msgid ""
" xz --best --block-size=16777216 disk\n"
"\n"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1292
msgid "Creating and signing the index file"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1294
msgid ""
"The index file has a simple text format (shown here without the digital "
"signature):"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1297
#, no-wrap
msgid ""
" [fedora-18]\n"
" name=Fedora® 18\n"
" osinfo=fedora18\n"
" arch=x86_64\n"
" file=fedora-18.xz\n"
" checksum[sha512]=...\n"
" format=raw\n"
" size=6442450944\n"
" compressed_size=148947524\n"
" expand=/dev/sda3\n"
" \n"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1308
#, no-wrap
msgid ""
" [fedora-19]\n"
" name=Fedora® 19\n"
" osinfo=fedora19\n"
" arch=x86_64\n"
" file=fedora-19.xz\n"
" checksum[sha512]=...\n"
" revision=3\n"
" format=raw\n"
" size=4294967296\n"
" compressed_size=172190964\n"
" expand=/dev/sda3\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1320
msgid ""
"The part in square brackets is the C<os-version>, which is the same string "
"that is used on the virt-builder command line to build that OS."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1323
msgid ""
"The index file creation and signature can be eased with the "
"L<virt-builder-repository(1)> tool."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1326
msgid ""
"After preparing the C<index> file in the correct format, clearsign it using "
"the following command:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1329
#, no-wrap
msgid ""
" gpg --clearsign --armor index\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1331
msgid ""
"This will create the final file called F<index.asc> which can be uploaded to "
"the server (and is the I<uri=..> URL).  As noted above, signing the index "
"file is optional, but recommended."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1339
msgid "C<name=NAME>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1341
msgid ""
"The user-friendly name of this template.  This is displayed in the I<--list> "
"output but is otherwise not significant."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1344
msgid "C<osinfo=ID>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1346
msgid ""
"This optional field maps the operating system to the associated libosinfo "
"ID.  Virt-builder does not use it (yet)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1349
msgid "C<arch=ARCH>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1351
msgid ""
"The architecture of the operating system installed within the template. This "
"field is required."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1354
msgid "C<file=PATH>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1356
msgid "The path (relative to the index) of the xz-compressed template."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1358 builder/virt-builder.pod:1369
msgid ""
"Note that absolute paths or URIs are B<not> permitted here.  This is because "
"virt-builder has a \"same origin\" policy for templates so they cannot come "
"from other servers."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1362
msgid "C<sig=PATH>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1364
msgid "B<This option is deprecated>.  Use the checksum field instead."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1366
msgid ""
"The path (relative to the index) of the GPG detached signature of the xz "
"file."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1373
msgid "The file can be created as follows:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1375
#, no-wrap
msgid ""
" gpg --detach-sign --armor -o disk.xz.sig disk.xz\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1377
msgid "C<checksum[sha512]=7b882fe9b82eb0fef...>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1379
msgid ""
"The SHA-512 checksum of the file specified in I<file=..> is checked after it "
"is downloaded.  To work out the signature, do:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1382
#, no-wrap
msgid ""
" sha512sum disk.xz\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1384
msgid ""
"Note if you use this, you don’t need to sign the file, ie. don’t use "
"C<sig>.  This option overrides C<sig>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1387
msgid "C<checksum=7b882fe9b82eb0fef...>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1389
msgid "C<checksum> is an alias for C<checksum[sha512]>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1391
msgid ""
"If you need to interoperate with virt-builder = 1.24.0 then you have to use "
"C<checksum> 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 "
"E<ge> 1.24.1."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1396
msgid "C<revision=N>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1398
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1402
msgid "The revision number is optional.  If omitted it defaults to C<1>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1404
msgid "C<format=raw>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1406
msgid "C<format=qcow2>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1408
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1413
msgid ""
"Note this is the source format, which is different from the I<--format> "
"option (requested output format).  Virt-builder does on-the-fly conversion "
"from the source format to the requested output format."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1418
msgid "C<size=NNN>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1420
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1426
msgid ""
"Virt-builder also uses this as the minimum size that users can request via "
"the I<--size> option, or as the default size if there is no I<--size> "
"option."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1430
msgid "C<compressed_size=NNN>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1432
msgid ""
"The actual size of the disk image in bytes, i.e. what was specified in "
"I<file=..>.  This is just used for information (when using C<long>, and "
"C<json> formats of I<--list>)."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1436
msgid "C<expand=/dev/sdaX>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1438
msgid ""
"When expanding the image to its final size, instruct L<virt-resize(1)> to "
"expand the named partition in the guest image to fill up all available "
"space.  This works like the virt-resize I<--expand> option."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1442
msgid "You should usually put the device name of the guest’s root filesystem here."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1444
msgid ""
"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."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1448
msgid "C<lvexpand=/dev/VolGroup/LogVol>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1450
msgid ""
"When expanding the image to its final size, instruct L<virt-resize(1)> to "
"expand the named logical volume in the guest image to fill up all available "
"space.  This works like the virt-resize I<--lv-expand> option."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1454
msgid ""
"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."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1458
msgid "C<notes=NOTES>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1460
msgid ""
"Any notes that go with this image, especially notes describing what packages "
"are in the image, how the image was prepared, and licensing information."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1464
msgid "This information is shown in the I<--notes> and I<--list> I<--long> modes."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1466
msgid ""
"You can use multi-line notes here by indenting each new line with at least "
"one character of whitespace (even on blank lines):"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1469
#, no-wrap
msgid ""
" notes=This image was prepared using\n"
"  the following kickstart script:\n"
"                                <-- one space at beginning of line\n"
"  part /boot --fstype ext3\n"
"  ...\n"
"\n"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1475
msgid "C<hidden=true>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1477
msgid ""
"Using the hidden flag prevents the template from being listed by the "
"I<--list> option (but it is still installable).  This is used for test "
"images."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1481
msgid "C<aliases=ALIAS1 ALIAS2 ...>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1483
msgid ""
"This optional field specifies a list of aliases, separated by spaces, for "
"the image.  For example, an alias could be used to always point to the "
"latest version of a certain image, leaving the old versions available in the "
"index instead of updating the same image (see the C<revision> field)."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1491
msgid "Running virt-builder against multiple sources"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1493
msgid ""
"It is possible to use multiple sources with virt-builder.  The recommended "
"way is to deploy I<.conf> files pointing to the index files. Another way is "
"to specify the sources using multiple I<--source> and/or I<--fingerprint> "
"options:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1498
#, no-wrap
msgid ""
" virt-builder \\\n"
"   --source http://example.com/s1/index.asc \\\n"
"   --source http://example.com/s2/index.asc\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1502
msgid ""
"You can provide N or 1 fingerprints.  In the case where you provide N "
"fingerprints, N = number of sources and there is a 1-1 correspondence "
"between each source and each fingerprint:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1506
#, no-wrap
msgid ""
" virt-builder \\\n"
"   --source http://example.com/s1/index.asc --fingerprint '0123 ...' \\\n"
"   --source http://example.com/s2/index.asc --fingerprint '9876 ...'\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1510
msgid ""
"In the case where you provide 1 fingerprint, the same fingerprint is used "
"for all sources."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1513
msgid "You C<must> provide at least 1 fingerprint."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1515
msgid "Licensing of templates"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1517
msgid ""
"You should be aware of the licensing of images that you distribute.  For "
"open source guests, provide a link to the source code in the C<notes> field "
"and comply with other requirements (eg. around trademarks)."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1522
msgid "Formal specification of the index file"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1524
msgid ""
"The index file format has a formal specification defined by the flex scanner "
"and bison parser used to parse the file.  This can be found in the following "
"files in the libguestfs source tree:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1528
#, no-wrap
msgid ""
" builder/index-scan.l\n"
" builder/index-parse.y\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1531
msgid ""
"A tool called L<virt-index-validate(1)> is available to validate the index "
"file to ensure it is correct."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1534
msgid ""
"Note that the parser and tool can work on either the signed or unsigned "
"index file (ie. F<index> or F<index.asc>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1537
msgid "The index is always encoded in UTF-8."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1539
msgid "CACHING"
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1541
msgid "Caching templates"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1543
msgid ""
"Since the templates are usually very large, downloaded templates are cached "
"in the user’s home directory."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1546
msgid ""
"The location of the cache is F<$XDG_CACHE_HOME/virt-builder/> or "
"F<$HOME/.cache/virt-builder>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1549
msgid ""
"You can print out information about the cache directory, including which "
"guests are currently cached, by doing:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1554
msgid "The cache can be deleted if you want to save space by doing:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1558
msgid "You can download all (current) templates to the local cache by doing:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1562
msgid "To disable the template cache, use I<--no-cache>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1564
msgid ""
"Only templates are cached.  The index and detached digital signatures are "
"not cached."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1567
msgid "Caching packages"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1569
msgid ""
"Virt-builder uses L<curl(1)> to download files and it also uses the current "
"C<http_proxy> (etc) settings when installing packages (I<--install>, "
"I<--update>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1573
msgid ""
"You may therefore want to set those environment variables in order to "
"maximize the amount of local caching that happens.  See L</ENVIRONMENT "
"VARIABLES> and L<curl(1)>."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1577
msgid "Local mirrors"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1579
msgid ""
"To increase both speed and reliability of installing packages, you can set "
"up a local mirror of the target distribution, and point the guest package "
"manager at that."
msgstr ""

#. type: =head4
#: builder/virt-builder.pod:1583
msgid "Using a local mirror with Fedora"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1585
msgid "To install a Fedora guest using a local mirror:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1587
#, no-wrap
msgid ""
" virt-builder fedora-27 \\\n"
"   --edit '/etc/yum.repos.d/fedora.repo:\n"
"       s{.*baseurl=.*}{baseurl=http://example.com/mirror/};\n"
"       s{.*metalink=.*}{};\n"
"   ' \\\n"
"   --edit '/etc/yum.repos.d/fedora-updates.repo:\n"
"       s{.*baseurl=.*}{baseurl=http://example.com/mirror-updates/};\n"
"       s{.*metalink=.*}{};\n"
"   ' \\\n"
"   --run-command 'dnf -y update' \\\n"
"   --install 'pkg1,pkg2,...'\n"
"\n"
msgstr ""

#. type: =head4
#: builder/virt-builder.pod:1599
msgid "Using a local mirror with Debian"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1601
msgid ""
"Assuming that you are using C<apt-proxy> to mirror the repository, you "
"should create a new F<sources.list> file to point to your proxy (see "
"L<https://help.ubuntu.com/community/AptProxy>) and then do:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1605
#, no-wrap
msgid ""
" virt-builder debian-8 \\\n"
"   --upload sources.list:/etc/apt/sources.list \\\n"
"   --run-command 'apt-get -y update' \\\n"
"   --install 'pkg1,pkg2,...'\n"
"\n"
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1610
msgid "DIGITAL SIGNATURES"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1612
msgid ""
"Virt-builder uses GNU Privacy Guard (GnuPG or gpg) to verify that the index "
"and templates have not been tampered with."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1615
msgid "The source points to an index file, which is optionally signed."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1617
msgid ""
"Virt-builder downloads the index and checks that the signature is valid and "
"the signer’s fingerprint matches the specified fingerprint (ie. the one "
"specified in I<gpgkey=..> in the I<.conf>, or with I<--fingerprint>, in that "
"order)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1622
msgid ""
"For checking against the built-in public key/fingerprint, this requires "
"importing the public key into the user’s local gpg keyring (that’s just the "
"way that gpg works)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1626
msgid "When a template is downloaded, its signature is checked in the same way."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1629
msgid ""
"Although the signatures are optional, if you don’t have them then "
"virt-builder users will have to use I<--no-check-signature> 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."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1636
msgid "ARCHITECTURE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1638
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1641
msgid ""
"However certain options may not work, specifically options that require "
"running commands in the guest during the build process: I<--install>, "
"I<--update>, I<--run>, I<--run-command>.  You may need to replace these with "
"their firstboot-equivalents."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1646
msgid ""
"An x86-64 host building 32 bit i686 guests should work without any special "
"steps."
msgstr ""

#. type: =head1
#: builder/virt-builder.pod:1649 sysprep/virt-sysprep.pod:518
msgid "SECURITY"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1651
msgid ""
"Virt-builder does not need to run as root (in fact, should not be run as "
"root), and doesn't use setuid, C<sudo> or any similar mechanism."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1654
msgid ""
"I<--install>, I<--update>, I<--run> and I<--run-command> are implemented "
"using an appliance (a small virtual machine) so these commands do not run on "
"the host.  If you are using the libguestfs libvirt backend and have SELinux "
"enabled then the virtual machine is additionally encapsulated in an SELinux "
"container (sVirt)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1660
msgid ""
"However these options will have access to the host’s network and since the "
"template may contain untrusted code, the code might try to access host "
"network resources which it should not.  You can use I<--no-network> to "
"prevent this."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1665
msgid ""
"Firstboot commands run in the context of the guest when it is booted, and so "
"the security of your hypervisor / cloud should be considered."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1668
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1672
msgid "You should check digital signatures and not ignore any signing errors."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1674
msgid "CLONES"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1676
msgid ""
"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 B<not> do "
"this.  You should run virt-builder once for each new guest you need."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1681
msgid ""
"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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1685
msgid ""
"Another thing you should I<not> 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."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1690
msgid "See also: L<virt-sysprep(1)>."
msgstr ""

#. type: =head2
#: builder/virt-builder.pod:1692
msgid "PERFORMANCE"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1694
msgid ""
"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 I<--cache-all-templates> option.  See L</CACHING> above for further "
"information."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1699
msgid ""
"Packages required for the I<--install> and I<--update> options are "
"downloaded using the host network connection.  Setting the C<http_proxy>, "
"C<https_proxy> and C<ftp_proxy> 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."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1707
msgid "Using I<--no-sync>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1709
msgid ""
"Use I<--no-sync>.  However read the caveats in the L</OPTIONS> section "
"above, since this can cause disk corruption if not used correctly."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1712
msgid "Skipping virt-resize"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1714
msgid ""
"Virt-builder can skip the virt-resize step under certain conditions.  This "
"makes virt-builder much faster.  The conditions are:"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1721
msgid "the output must be a regular file (not a block device), B<and>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1725
msgid "the user did B<not> use the I<--size> option, B<and>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1729
msgid "the output format is the same as the template format (usually raw)."
msgstr ""

#. type: =head3
#: builder/virt-builder.pod:1733
msgid "pxzcat"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1735
msgid ""
"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 C<xzcat> is used which is single-threaded."
msgstr ""

#. type: =head1
#: builder/virt-builder.pod:1739 customize/virt-customize.pod:243
#: sysprep/virt-sysprep.pod:556
msgid "SELINUX"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1741
msgid ""
"Guests which use SELinux (such as Fedora and Red Hat Enterprise Linux)  "
"require that each file has a correct SELinux label."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1744
msgid ""
"Virt-builder does not know how to give new files a label, so there are two "
"possible strategies it can use to ensure correct labelling:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1749
msgid "Automatic relabeling"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1751
msgid ""
"This runs L<setfiles(8)> just before finalizing the guest, which sets "
"SELinux labels correctly in the disk image."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1754
msgid "This is the recommended method."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1756
msgid "Using I<--no-selinux-relabel> I<--touch> F</.autorelabel>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1758
msgid ""
"Guest templates may already contain a file called F</.autorelabel> or you "
"may touch it."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1761
msgid ""
"For guests that use SELinux, this causes L<restorecon(8)> to run at first "
"boot.  Guests will reboot themselves once the first time you use them, which "
"is normal and harmless."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1769
msgid ""
"The I<--machine-readable> option can be used to make the output more machine "
"friendly, which is useful when calling virt-builder from other programs, "
"GUIs etc."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1773
msgid ""
"Use the option on its own to query the capabilities of the virt-builder "
"binary.  Typical output looks like this:"
msgstr ""

#. type: verbatim
#: builder/virt-builder.pod:1776
#, no-wrap
msgid ""
" $ virt-builder --machine-readable\n"
" virt-builder\n"
" arch\n"
" config-file\n"
" customize\n"
" json-list\n"
" pxzcat\n"
"\n"
msgstr ""

#. type: =head1
#: builder/virt-builder.pod:1790 customize/virt-customize.pod:255
#: drivers/virt-drivers.pod:224 edit/virt-edit.pod:366
#: get-kernel/virt-get-kernel.pod:191 sparsify/virt-sparsify.pod:418
#: sysprep/virt-sysprep.pod:573
msgid "ENVIRONMENT VARIABLES"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1792 drivers/virt-drivers.pod:226
#: get-kernel/virt-get-kernel.pod:193
msgid ""
"For other environment variables which affect all libguestfs programs, see "
"L<guestfs(3)/ENVIRONMENT VARIABLES>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1797
msgid "C<http_proxy>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1799
msgid "C<https_proxy>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1801
msgid "C<no_proxy>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1803
msgid ""
"Set the proxy for downloads.  These environment variables (and more)  are "
"actually interpreted by L<curl(1)>, not virt-builder."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1806
msgid "C<HOME>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1808
msgid ""
"Used to determine the location of the template cache, and the location of "
"the user' sources.  See L</CACHING> and L</SOURCES OF TEMPLATES>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1811 customize/virt-customize.pod:259
#: sysprep/virt-sysprep.pod:577
msgid "C<VIRT_TOOLS_DATA_DIR>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1813 customize/virt-customize.pod:261
#: sysprep/virt-sysprep.pod:579
msgid ""
"This can point to the directory containing data files used for Windows "
"firstboot installation."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1816 customize/virt-customize.pod:264
#: sysprep/virt-sysprep.pod:582
msgid ""
"Normally you do not need to set this.  If not set, a compiled-in default "
"will be used (something like F</usr/share/virt-tools>)."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1819 customize/virt-customize.pod:267
#: sysprep/virt-sysprep.pod:585
msgid "This directory may contain the following files:"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1823 customize/virt-customize.pod:271
#: sysprep/virt-sysprep.pod:589
msgid "F<rhsrvany.exe>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1825 customize/virt-customize.pod:273
#: sysprep/virt-sysprep.pod:591
msgid ""
"This is the RHSrvAny Windows binary, used to install a \"firstboot\" script "
"in Windows guests.  It is required if you intend to use the I<--firstboot> "
"or I<--firstboot-command> options with Windows guests."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1829 customize/virt-customize.pod:277
#: sysprep/virt-sysprep.pod:595
msgid "See also: C<https://github.com/rwmjones/rhsrvany>"
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1831 customize/virt-customize.pod:279
#: sysprep/virt-sysprep.pod:597
msgid "F<pvvxsvc.exe>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1833 customize/virt-customize.pod:281
#: sysprep/virt-sysprep.pod:599
msgid ""
"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 I<--firstboot> or I<--firstboot-command> options with Windows guests."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1839
msgid "C<XDG_CACHE_HOME>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1841
msgid "Used to determine the location of the template cache.  See L</CACHING>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1843
msgid "C<XDG_CONFIG_HOME>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1845
msgid ""
"Used to determine the location of the user' sources.  See L</SOURCES OF "
"TEMPLATES>."
msgstr ""

#. type: =item
#: builder/virt-builder.pod:1848
msgid "C<VIRT_BUILDER_DIRS>"
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1850
msgid ""
"Used to determine the location of the system sources.  See L</SOURCES OF "
"TEMPLATES>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1862
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<guestmount(1)>, "
"L<virt-builder-repository(1)>, L<virt-copy-out(1)>, L<virt-customize(1)>, "
"L<virt-get-kernel(1)>, L<virt-install(1)>, L<virt-rescue(1)>, "
"L<virt-resize(1)>, L<virt-sysprep(1)>, L<oz-install(1)>, L<gpg(1)>, "
"L<gpg2(1)>, L<curl(1)>, L<virt-make-fs(1)>, L<genisoimage(1)>, "
"L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: builder/virt-builder.pod:1887 builder/virt-index-validate.pod:90
msgid "Copyright (C) 2013 Red Hat Inc."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:3
msgid "virt-index-validate - Validate virt-builder index file"
msgstr ""

#. type: verbatim
#: builder/virt-index-validate.pod:7
#, no-wrap
msgid ""
" virt-index-validate index\n"
"\n"
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:11
msgid ""
"L<virt-builder(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."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:15
msgid ""
"Note that virt-index-validate can validate either the signed or unsigned "
"index file (ie. either F<index> or F<index.asc>).  It can only validate a "
"local file, not a URL."
msgstr ""

#. type: =item
#: builder/virt-index-validate.pod:23
msgid "B<--compat-1.24.0>"
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:25
msgid ""
"Check for compatibility with virt-builder 1.24.0.  (Using this option "
"implies I<--compat-1.24.1>, so you don't need to use both.)"
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:28 builder/virt-index-validate.pod:47
msgid "In particular:"
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:34
msgid ""
"This version of virt-builder could not handle C<[...]> (square brackets) in "
"field names (eg. C<checksum[sha512]=...>)."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:39
msgid "It required detached signatures (C<sig=...>)."
msgstr ""

#. type: =item
#: builder/virt-index-validate.pod:43
msgid "B<--compat-1.24.1>"
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:45
msgid "Check for compatibility with virt-builder E<ge> 1.24.1."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:53
msgid ""
"This version of virt-builder could not handle C<.> (period) in field names "
"or C<,> (comma) in subfield names."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:58
msgid "It could not handle comments appearing in the file."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:76
msgid ""
"This program returns 0 if the index file validates, or non-zero if there was "
"an error."
msgstr ""

#. type: textblock
#: builder/virt-index-validate.pod:81
msgid "L<virt-builder(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:3
msgid "virt-cat - Display files in a virtual machine"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:7
#, no-wrap
msgid ""
" virt-cat [--options] -d domname file [file ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:9
#, no-wrap
msgid ""
" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:11 edit/virt-edit.pod:13 inspector/virt-inspector.pod:11
msgid "Old-style:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:13
#, no-wrap
msgid ""
" virt-cat domname file\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:15
#, no-wrap
msgid ""
" virt-cat disk.img file\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:19
msgid ""
"C<virt-cat> is a command line tool to display the contents of C<file> where "
"C<file> exists in the named virtual machine (or disk image)."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:22
msgid ""
"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 '/')."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:26
msgid ""
"C<virt-cat> can be used to quickly view a file.  To edit a file, use "
"C<virt-edit>.  For more complex cases you should look at the L<guestfish(1)> "
"tool (see L</USING GUESTFISH> below)."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:32
msgid "Display F</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:35
#, no-wrap
msgid ""
" virt-cat -d mydomain /etc/fstab\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:37
msgid "Find out what packages were recently installed:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:39
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/log/yum.log | tail\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:41
msgid "Find out who is logged on inside a virtual machine:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:43
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
" who /tmp/utmp\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:46
msgid "or who was logged on:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:48
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
" last -f /tmp/wtmp\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:63 cat/virt-filesystems.pod:101 cat/virt-log.pod:47
#: cat/virt-ls.pod:261 cat/virt-tail.pod:58 edit/virt-edit.pod:66
#: inspector/virt-inspector.pod:67
msgid ""
"Add I<file> 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 I<-a> options."
msgstr ""

#. type: =item
#: cat/virt-cat.pod:95 cat/virt-filesystems.pod:154 cat/virt-log.pod:79
#: cat/virt-ls.pod:310 cat/virt-tail.pod:90 customize/virt-customize.pod:110
#: diff/virt-diff.pod:129 drivers/virt-drivers.pod:171 edit/virt-edit.pod:112
#: get-kernel/virt-get-kernel.pod:81 inspector/virt-inspector.pod:100
#: sparsify/virt-sparsify.pod:195 sysprep/virt-sysprep.pod:156
msgid "B<--echo-keys>"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:97
msgid ""
"When prompting for keys and passphrases, virt-cat 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."
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:113
#, no-wrap
msgid ""
" virt-cat --format=raw -a disk.img file\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:117
#, no-wrap
msgid ""
" virt-cat --format=raw -a disk.img --format -a another.img file\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:126 cat/virt-log.pod:110 cat/virt-ls.pod:357
#: cat/virt-tail.pod:128 customize/virt-customize.pod:141
#: diff/virt-diff.pod:171 drivers/virt-drivers.pod:190 edit/virt-edit.pod:158
#: get-kernel/virt-get-kernel.pod:100 inspector/virt-inspector.pod:122
#: sparsify/virt-sparsify.pod:233 sysprep/virt-sysprep.pod:187
msgid "__INCLUDE:key-option.pod__"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:128 cat/virt-filesystems.pod:206 cat/virt-log.pod:112
#: cat/virt-ls.pod:359 cat/virt-tail.pod:130 customize/virt-customize.pod:143
#: diff/virt-diff.pod:173 drivers/virt-drivers.pod:192 edit/virt-edit.pod:160
#: get-kernel/virt-get-kernel.pod:102 inspector/virt-inspector.pod:124
#: sparsify/virt-sparsify.pod:235 sysprep/virt-sysprep.pod:189
msgid "__INCLUDE:keys-from-stdin-option.pod__"
msgstr ""

#. type: =item
#: cat/virt-cat.pod:130 cat/virt-ls.pod:361 cat/virt-tail.pod:132
#: edit/virt-edit.pod:162
msgid "B<-m> dev[:mountpoint[:options[:fstype]]]"
msgstr ""

#. type: =item
#: cat/virt-cat.pod:132 cat/virt-ls.pod:363 cat/virt-tail.pod:134
#: edit/virt-edit.pod:164
msgid "B<--mount> dev[:mountpoint[:options[:fstype]]]"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:134 cat/virt-ls.pod:365 cat/virt-tail.pod:136
#: edit/virt-edit.pod:166
msgid "Mount the named partition or logical volume on the given mountpoint."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:136 cat/virt-ls.pod:367 cat/virt-tail.pod:138
#: edit/virt-edit.pod:168
msgid "If the mountpoint is omitted, it defaults to F</>."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:138 cat/virt-ls.pod:369 cat/virt-tail.pod:140
#: edit/virt-edit.pod:170
msgid ""
"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."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:143 cat/virt-ls.pod:374 cat/virt-tail.pod:145
#: edit/virt-edit.pod:175
msgid ""
"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>, L</list-filesystems> and L</lvs> "
"commands), or you can use the L<virt-filesystems(1)> program."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:149 cat/virt-ls.pod:380 cat/virt-tail.pod:151
#: edit/virt-edit.pod:181
msgid ""
"The third (and rarely used) part of the mount parameter is the list of mount "
"options used to mount the underlying filesystem.  If this is not given, then "
"the mount options are either the empty string or C<ro> (the latter if the "
"I<--ro> flag is used).  By specifying the mount options, you override this "
"default choice.  Probably the only time you would use this is to enable ACLs "
"and/or extended attributes if the filesystem can support them:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:157 cat/virt-ls.pod:388 cat/virt-tail.pod:159
#: edit/virt-edit.pod:189
#, no-wrap
msgid ""
" -m /dev/sda1:/:acl,user_xattr\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:159 cat/virt-ls.pod:390 cat/virt-tail.pod:161
#: edit/virt-edit.pod:191
msgid "Using this flag is equivalent to using the C<mount-options> command."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:161 cat/virt-ls.pod:392 cat/virt-tail.pod:163
#: edit/virt-edit.pod:193
msgid ""
"The fourth part of the parameter is the filesystem driver to use, such as "
"C<ext3> or C<ntfs>. This is rarely needed, but can be useful if multiple "
"drivers are valid for a filesystem (eg: C<ext2> and C<ext3>), or if "
"libguestfs misidentifies a filesystem."
msgstr ""

#. type: =head1
#: cat/virt-cat.pod:184 cat/virt-ls.pod:474 edit/virt-edit.pod:216
#: inspector/virt-inspector.pod:165
msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:186
msgid "Previous versions of virt-cat allowed you to write either:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:188
#, no-wrap
msgid ""
" virt-cat disk.img [disk.img ...] file\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:190 cat/virt-ls.pod:480 edit/virt-edit.pod:222
#: inspector/virt-inspector.pod:171
msgid "or"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:192
#, no-wrap
msgid ""
" virt-cat guestname file\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:194 cat/virt-ls.pod:484 edit/virt-edit.pod:226
#: inspector/virt-inspector.pod:175
msgid ""
"whereas in this version you should use I<-a> or I<-d> respectively to avoid "
"the confusing case where a disk image might have the same name as a guest."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:198 cat/virt-ls.pod:488 edit/virt-edit.pod:230
#: inspector/virt-inspector.pod:179
msgid "For compatibility the old style is still supported."
msgstr ""

#. type: =head1
#: cat/virt-cat.pod:200 cat/virt-tail.pod:186
msgid "LOG FILES"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:202 cat/virt-tail.pod:188
msgid ""
"To list out the log files from guests, see the related tool L<virt-log(1)>.  "
"It understands binary log formats such as the systemd journal."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:206
msgid "To follow (tail) text log files, use L<virt-tail(1)>."
msgstr ""

#. type: =head1
#: cat/virt-cat.pod:208 cat/virt-tail.pod:192 edit/virt-edit.pod:294
msgid "WINDOWS PATHS"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:210
msgid ""
"C<virt-cat> has a limited ability to understand Windows drive letters and "
"paths (eg. F<E:\\foo\\bar.txt>)."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:213 cat/virt-tail.pod:197 edit/virt-edit.pod:299
msgid "If and only if the guest is running Windows then:"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:219 cat/virt-tail.pod:203 edit/virt-edit.pod:305
msgid ""
"Drive letter prefixes like C<C:> are resolved against the Windows Registry "
"to the correct filesystem."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:224 cat/virt-tail.pod:208 edit/virt-edit.pod:310
msgid ""
"Any backslash (C<\\>) characters in the path are replaced with forward "
"slashes so that libguestfs can process it."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:229 cat/virt-tail.pod:213
msgid ""
"The path is resolved case insensitively to locate the file that should be "
"displayed."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:234 cat/virt-tail.pod:218 edit/virt-edit.pod:320
msgid "There are some known shortcomings:"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:240 cat/virt-tail.pod:224 edit/virt-edit.pod:326
msgid "Some NTFS symbolic links may not be followed correctly."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:244 cat/virt-tail.pod:228 edit/virt-edit.pod:330
msgid "NTFS junction points that cross filesystems are not followed."
msgstr ""

#. type: =head1
#: cat/virt-cat.pod:248 edit/virt-edit.pod:334
msgid "USING GUESTFISH"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:250
msgid ""
"L<guestfish(1)> is a more powerful, lower level tool which you can use when "
"C<virt-cat> doesn't work."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:253
msgid "Using C<virt-cat> is approximately equivalent to doing:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:255
#, no-wrap
msgid ""
" guestfish --ro -i -d domname download file -\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:257
msgid ""
"where C<domname> is the name of the libvirt guest, and C<file> is the full "
"path to the file.  Note the final C<-> (meaning \"output to stdout\")."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:261
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: cat/virt-cat.pod:266
#, no-wrap
msgid ""
" guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:268
msgid ""
"where F<disk.img> is the disk image, F</dev/sda1> is the filesystem within "
"the disk image, and C<file> is the full path to the file."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:278
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
"L<virt-log(1)>, L<virt-tail(1)>, L<virt-tar-out(1)>, "
"L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-cat.pod:293 cat/virt-filesystems.pod:403 cat/virt-log.pod:154
#: inspector/virt-inspector.pod:520 make-fs/virt-make-fs.pod:245
#: resize/virt-resize.pod:879
msgid "Copyright (C) 2010-2023 Red Hat Inc."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:3
msgid ""
"virt-filesystems - List filesystems, partitions, block devices, LVM in a "
"virtual machine or disk image"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:7
#, no-wrap
msgid ""
" virt-filesystems [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:9
#, no-wrap
msgid ""
" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:13
msgid ""
"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 "
"L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:18
msgid ""
"One use for this tool is from shell scripts to iterate over all filesystems "
"from a disk image:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:21
#, no-wrap
msgid ""
" for fs in $(virt-filesystems -a disk.img); do\n"
"   # ...\n"
" done\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:25
msgid ""
"Another use is to list partitions before using another tool to modify those "
"partitions (such as L<virt-resize(1)>).  If you are curious about what an "
"unknown disk image contains, use this tool along with L<virt-inspector(1)>."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:30
msgid ""
"Various command line options control what this program displays.  You need "
"to give either I<-a> or I<-d> options to specify the disk image or libvirt "
"guest respectively.  If you just specify that then the program shows "
"filesystems found, one per line, like this:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:35
#, no-wrap
msgid ""
" $ virt-filesystems -a disk.img\n"
" /dev/sda1\n"
" /dev/vg_guest/lv_root\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:39
msgid "If you add I<-l> or I<--long> then the output includes extra information:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:42
#, no-wrap
msgid ""
" $ virt-filesystems -a disk.img -l\n"
" Name                   Type         VFS   Label  Size\n"
" /dev/sda1              filesystem   ext4  boot   524288000\n"
" /dev/vg_guest/lv_root  filesystem   ext4  root   10212081664\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:47
msgid ""
"If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
"shown as well:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:50
#, no-wrap
msgid ""
" $ virt-filesystems -a disk.img --extra\n"
" /dev/sda1\n"
" /dev/vg_guest/lv_root\n"
" /dev/vg_guest/lv_swap\n"
" /dev/vg_guest/lv_data\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:56
msgid "If you add I<--partitions> then partitions are shown instead of filesystems:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:58
#, no-wrap
msgid ""
" $ virt-filesystems -a disk.img --partitions\n"
" /dev/sda1\n"
" /dev/sda2\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:62
msgid ""
"Similarly you can use I<--logical-volumes>, I<--volume-groups>, "
"I<--physical-volumes>, I<--block-devices> to list those items."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:65
msgid ""
"You can use these options in combination as well (if you want a combination "
"including filesystems, you have to add I<--filesystems>).  Notice that some "
"items fall into several categories (eg. F</dev/sda1> might be both a "
"partition and a filesystem).  These items are listed several times.  To get "
"a list which includes absolutely everything that virt-filesystems knows "
"about, use the I<--all> option."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:72
msgid ""
"UUIDs (because they are quite long) are not shown by default.  Add the "
"I<--uuid> option to display device and filesystem UUIDs in the long output."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:76
msgid ""
"I<--all --long --uuid> is a useful combination to display all possible "
"information about everything."
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:79
#, no-wrap
msgid ""
" $ virt-filesystems -a win.img --all --long --uuid -h\n"
" Name      Type       VFS  Label           Size Parent   UUID\n"
" /dev/sda1 filesystem ntfs System Reserved 100M -        F81C92571C92112C\n"
" /dev/sda2 filesystem ntfs -               20G  -        F2E8996AE8992E3B\n"
" /dev/sda1 partition  -    -               100M /dev/sda -\n"
" /dev/sda2 partition  -    -               20G  /dev/sda -\n"
" /dev/sda  device     -    -               20G  -        -\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:87
msgid "For machine-readable output, use I<--csv> to get Comma-Separated Values."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:114 diff/virt-diff.pod:60
msgid "B<--all>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:116
msgid ""
"Display everything.  This is currently the same as specifying these options: "
"I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, "
"I<--logical-volumes>, I<--volume-groups>, I<--physical-volumes>.  (More may "
"be added to this list in future)."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:121
msgid "See also I<--long>."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:123
msgid "B<--blkdevs>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:125
msgid "B<--block-devices>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:127
msgid "Display block devices."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:141 cat/virt-ls.pod:297 df/virt-df.pod:108
#: diff/virt-diff.pod:99
msgid "B<--csv>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:143 cat/virt-ls.pod:299 df/virt-df.pod:110
#: diff/virt-diff.pod:101
msgid ""
"Write out the results in CSV format (comma-separated values).  This format "
"can be imported easily into databases and spreadsheets, but read L</NOTE "
"ABOUT CSV FORMAT> below."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:156
msgid ""
"When prompting for keys and passphrases, virt-filesystems 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."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:161
msgid "B<--extra>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:163
msgid ""
"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."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:167
msgid "This option implies I<--filesystems>."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:169
msgid "B<--filesystems>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:171
msgid ""
"Display mountable filesystems.  If no display option was selected then this "
"option is implied."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:174
msgid "With I<--extra>, non-mountable filesystems are shown too."
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:187
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:191
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:200 cat/virt-ls.pod:348 df/virt-df.pod:145
#: diff/virt-diff.pod:165
msgid "B<-h>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:202 cat/virt-ls.pod:350 df/virt-df.pod:147
#: diff/virt-diff.pod:167
msgid "B<--human-readable>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:204
msgid "In I<--long> mode, display sizes in human-readable format."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:208 cat/virt-ls.pod:397
msgid "B<-l>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:210 cat/virt-ls.pod:399
msgid "B<--long>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:212
msgid "Display extra columns of data (\"long format\")."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:214
msgid "A title row is added unless you also specify I<--no-title>."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:216
msgid ""
"The extra columns displayed depend on what output you select, and the "
"ordering of columns may change in future versions.  Use the title row, "
"I<--csv> output and/or L<csvtool(1)> to match columns to data in external "
"programs."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:221
msgid ""
"Use I<-h> if you want sizes to be displayed in human-readable format.  The "
"default is to show raw numbers of I<bytes>."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:224
msgid "Use I<--uuid> to display UUIDs too."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:226
msgid "B<--lvs>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:228
msgid "B<--logvols>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:230
msgid "B<--logical-volumes>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:232
msgid ""
"Display LVM logical volumes.  In this mode, these are displayed irrespective "
"of whether the LVs contain filesystems."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:235
msgid "B<--no-title>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:237
msgid "In I<--long> mode, don’t add a title row."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:239
msgid ""
"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."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:243
msgid "B<--parts>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:245
msgid "B<--partitions>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:247
msgid ""
"Display partitions.  In this mode, these are displayed irrespective of "
"whether the partitions contain filesystems."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:250
msgid "B<--pvs>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:252
msgid "B<--physvols>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:254
msgid "B<--physical-volumes>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:256
msgid "Display LVM physical volumes."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:260
msgid "B<--uuids>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:262
msgid "In I<--long> mode, display UUIDs as well."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:276
msgid "B<--vgs>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:278
msgid "B<--volgroups>"
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:280
msgid "B<--volume-groups>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:282
msgid "Display LVM volume groups."
msgstr ""

#. type: =head1
#: cat/virt-filesystems.pod:290
msgid "COLUMNS"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:292
msgid ""
"Note that columns in the output are subject to reordering and change in "
"future versions of this tool."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:297
msgid "B<Name>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:299
msgid "The filesystem, partition, block device or LVM name."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:301
msgid ""
"For device and partition names these are displayed as canonical libguestfs "
"names, so that for example F</dev/sda2> is the second partition on the first "
"device."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:305
msgid ""
"If the I<--long> option is B<not> specified, then only the name column is "
"shown in the output."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:308
msgid "B<Type>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:310
msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:312
msgid "B<VFS>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:314
msgid ""
"If there is a filesystem, then this column displays the filesystem type if "
"one could be detected, eg. C<ext4>."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:317
msgid "B<Label>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:319
msgid ""
"If the object has a label (used for identifying and mounting filesystems) "
"then this column contains the label."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:322
msgid "B<MBR>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:324
msgid ""
"The partition type byte, displayed as a two digit hexadecimal number.  A "
"comprehensive list of partition types can be found here: "
"L<http://www.win.tue.nl/~aeb/partitions/partition_types-1.html>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:328
msgid "This is only applicable for DOS (MBR) partitions."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:330
msgid "B<Size>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:332
msgid ""
"The size of the object in bytes.  If the I<--human> option is used then the "
"size is displayed in a human-readable form."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:335
msgid "B<Parent>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:337
msgid "The parent column records the parent relationship between objects."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:339
msgid ""
"For example, if the object is a partition, then this column contains the "
"name of the containing device.  If the object is a logical volume, then this "
"column is the name of the volume group."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:343
msgid ""
"If there is more than one parent, then this column is (internal to the "
"column) a comma-separated list, eg. C</dev/sda,/dev/sdb>."
msgstr ""

#. type: =item
#: cat/virt-filesystems.pod:346
msgid "B<UUID>"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:348
msgid ""
"If the object has a UUID (used for identifying and mounting filesystems and "
"block devices) then this column contains the UUID as a string."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:352
msgid "The UUID is only displayed if the I<--uuid> option is given."
msgstr ""

#. type: =head1
#: cat/virt-filesystems.pod:356 cat/virt-ls.pod:490 df/virt-df.pod:229
#: diff/virt-diff.pod:220
msgid "NOTE ABOUT CSV FORMAT"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:358 cat/virt-ls.pod:492 df/virt-df.pod:231
#: diff/virt-diff.pod:222
msgid ""
"Comma-separated values (CSV) is a deceptive format.  It I<seems> like it "
"should be easy to parse, but it is definitely not easy to parse."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:361 cat/virt-ls.pod:495 df/virt-df.pod:234
#: diff/virt-diff.pod:225
msgid ""
"Myth: Just split fields at commas.  Reality: This does I<not> work "
"reliably.  This example has two columns:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:364 cat/virt-ls.pod:498 df/virt-df.pod:237
#: diff/virt-diff.pod:228
#, no-wrap
msgid ""
" \"foo,bar\",baz\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:366 cat/virt-ls.pod:500 df/virt-df.pod:239
#: diff/virt-diff.pod:230
msgid ""
"Myth: Read the file one line at a time.  Reality: This does I<not> work "
"reliably.  This example has one row:"
msgstr ""

#. type: verbatim
#: cat/virt-filesystems.pod:369 cat/virt-ls.pod:503 df/virt-df.pod:242
#: diff/virt-diff.pod:233
#, no-wrap
msgid ""
" \"foo\n"
" bar\",baz\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:372 cat/virt-ls.pod:506 df/virt-df.pod:245
#: diff/virt-diff.pod:236
msgid ""
"For shell scripts, use C<csvtool> (L<https://github.com/Chris00/ocaml-csv> "
"also packaged in major Linux distributions)."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:375 cat/virt-ls.pod:509 df/virt-df.pod:248
#: diff/virt-diff.pod:239
msgid ""
"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
"or Python’s built-in csv library)."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:378 cat/virt-ls.pod:512 df/virt-df.pod:251
#: diff/virt-diff.pod:242
msgid "Most spreadsheets and databases can import CSV directly."
msgstr ""

#. type: textblock
#: cat/virt-filesystems.pod:387
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, "
"L<virt-drivers(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, "
"L<csvtool(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-log.pod:3
msgid "virt-log - Display log files from a virtual machine"
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:7
#, no-wrap
msgid ""
" virt-log [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:9
#, no-wrap
msgid ""
" virt-log [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-log.pod:13
msgid ""
"C<virt-log> is a command line tool to display the log files from the named "
"virtual machine (or disk image)."
msgstr ""

#. type: textblock
#: cat/virt-log.pod:16
msgid ""
"This tool understands and displays both plain text log files "
"(eg. F</var/log/messages>) and binary formats such as the systemd journal."
msgstr ""

#. type: textblock
#: cat/virt-log.pod:20
msgid ""
"To display other types of files, use L<virt-cat(1)>.  To follow (tail)  text "
"log files, use L<virt-tail(1)>.  To copy files out of a virtual machine, use "
"L<virt-copy-out(1)>.  To display the contents of the Windows Registry, use "
"L<virt-win-reg(1)>."
msgstr ""

#. type: textblock
#: cat/virt-log.pod:27
msgid "Display the complete logs from a guest:"
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:29
#, no-wrap
msgid ""
" virt-log -d mydomain | less\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-log.pod:31
msgid "Find out what DHCP IP address a VM acquired:"
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:33
#, no-wrap
msgid ""
" virt-log -d mydomain | grep 'dhclient.*bound to'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-log.pod:81
msgid ""
"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."
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:97
#, no-wrap
msgid ""
" virt-log --format=raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-log.pod:101
#, no-wrap
msgid ""
" virt-log --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-log.pod:139
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, "
"L<virt-tail(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, "
"L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:3
msgid "virt-ls - List files in a virtual machine"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:7
#, no-wrap
msgid ""
" virt-ls [--options] -d domname directory [directory ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:9
#, no-wrap
msgid ""
" virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory "
"...]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:11 df/virt-df.pod:17
msgid "Old style:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:13
#, no-wrap
msgid ""
" virt-ls [--options] domname directory\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:15
#, no-wrap
msgid ""
" virt-ls [--options] disk.img [disk.img ...] directory\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:19
msgid ""
"C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
"more from a virtual machine or disk image."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:22
msgid ""
"Multiple directory names can be given, in which case the output from each is "
"concatenated."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:25
msgid ""
"To list directories from a libvirt guest use the I<-d> option to specify the "
"name of the guest.  For a disk image, use the I<-a> option."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:29
msgid ""
"C<virt-ls> can do many simple file listings.  For more complicated cases you "
"may need to use L<guestfish(1)>, or write a program directly to the "
"L<guestfs(3)> API."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:35
msgid "Get a list of all files and directories in a virtual machine:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:37
#, no-wrap
msgid ""
" virt-ls -R -d guest /\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:39
msgid "List all setuid or setgid programs in a Linux virtual machine:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:41
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^- [42]'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:43
msgid "List all public-writable directories in a Linux virtual machine:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:45
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^d ...7'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:47
msgid "List all Unix domain sockets in a Linux virtual machine:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:49
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^s'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:51
msgid "List all regular files with filenames ending in ‘.png’:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:53
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:55
msgid "To display files larger than 10MB in home directories:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:57
#, no-wrap
msgid ""
" virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:59
msgid "Find everything modified in the last 7 days:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:61
#, no-wrap
msgid ""
" virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:63
msgid "Find regular files modified in the last 24 hours:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:65
#, no-wrap
msgid ""
" virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
"\n"
msgstr ""

#. type: =head2
#: cat/virt-ls.pod:67
msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:69
msgid ""
"Although it is possible to use virt-ls to look for differences, since "
"libguestfs E<ge> 1.26 a new tool is available called L<virt-diff(1)>."
msgstr ""

#. type: =head1
#: cat/virt-ls.pod:72
msgid "OUTPUT MODES"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:74
msgid ""
"C<virt-ls> has four output modes, controlled by different combinations of "
"the I<-l> and I<-R> options."
msgstr ""

#. type: =head2
#: cat/virt-ls.pod:77
msgid "SIMPLE LISTING"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:79
msgid "A simple listing is like the ordinary L<ls(1)> command:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:81
#, no-wrap
msgid ""
" $ virt-ls -d guest /\n"
" bin\n"
" boot\n"
" [etc.]\n"
"\n"
msgstr ""

#. type: =head2
#: cat/virt-ls.pod:86
msgid "LONG LISTING"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:88
msgid ""
"With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
"(more specifically, like the C<guestfs_ll> function)."
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:91
#, no-wrap
msgid ""
" $ virt-ls -l -d guest /\n"
" total 204\n"
" dr-xr-xr-x.   2 root root   4096 2009-08-25 19:06 bin\n"
" dr-xr-xr-x.   5 root root   3072 2009-08-25 19:06 boot\n"
" [etc.]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:97
msgid ""
"Note that while this is useful for displaying a directory, do not try "
"parsing this output in another program.  Use L</RECURSIVE LONG LISTING> "
"instead."
msgstr ""

#. type: =head2
#: cat/virt-ls.pod:101
msgid "RECURSIVE LISTING"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:103
msgid ""
"With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
"and directories recursively:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:106
#, no-wrap
msgid ""
" $ virt-ls -R -d guest /tmp\n"
" foo\n"
" foo/bar\n"
" [etc.]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:111
msgid ""
"To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
"converts C<\\0> characters to C<\\n>."
msgstr ""

#. type: =head2
#: cat/virt-ls.pod:114
msgid "RECURSIVE LONG LISTING"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:116
msgid ""
"Using I<-lR> options together changes the output to display directories "
"recursively, with file stats, and optionally other features such as "
"checksums and extended attributes."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:120
msgid ""
"Most of the interesting features of C<virt-ls> are only available when using "
"I<-lR> mode."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:123
msgid ""
"The fields are normally space-separated.  Filenames are B<not> quoted, so "
"you cannot use the output in another program (because filenames can contain "
"spaces and other unsafe characters).  If the guest was untrusted and someone "
"knew you were using C<virt-ls> to analyze the guest, they could play tricks "
"on you by creating filenames with embedded newline characters.  To B<safely> "
"parse the output in another program, use the I<--csv> (Comma-Separated "
"Values) option."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:131
msgid ""
"Note that this output format is completely unrelated to the C<ls -lR> "
"command."
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:134
#, no-wrap
msgid ""
" $ virt-ls -lR -d guest /bin\n"
" d 0555       4096 /bin\n"
" - 0755        123 /bin/alsaunmute\n"
" - 0755      28328 /bin/arch\n"
" l 0777          4 /bin/awk -> gawk\n"
" - 0755      27216 /bin/basename\n"
" - 0755     943360 /bin/bash\n"
" [etc.]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:143
msgid "These basic fields are always shown:"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:147
msgid "type"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:149
msgid ""
"The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
"(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
"link), C<s> (socket) or C<u> (unknown)."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:159
msgid "permissions"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:161
msgid "The Unix permissions, displayed as a 4 digit octal number."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:163
msgid "size"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:165
msgid ""
"The size of the file.  This is shown in bytes unless I<-h> or "
"I<--human-readable> option is given, in which case this is shown as a "
"human-readable number."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:169
msgid "path"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:171
msgid "The full path of the file or directory."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:173
msgid "link"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:175
msgid "For symbolic links only, the link target."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:179
msgid ""
"In I<-lR> mode, additional command line options enable the display of more "
"fields."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:182
msgid ""
"With the I<--uids> flag, these additional fields are displayed before the "
"path:"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:187
msgid "uid"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:189
msgid "gid"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:191
msgid ""
"The UID and GID of the owner of the file (displayed numerically).  Note "
"these only make sense in the context of a Unix-like guest."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:196
msgid "With the I<--times> flag, these additional fields are displayed:"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:200
msgid "atime"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:202
msgid "The time of last access."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:204
msgid "mtime"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:206
msgid "The time of last modification."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:208
msgid "ctime"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:210
msgid "The time of last status change."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:214
msgid ""
"The time fields are displayed as string dates and times, unless one of the "
"I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:217
msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:221
msgid "device"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:223
msgid ""
"The device containing the file (displayed as major:minor).  This may not "
"match devices as known to the guest."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:226
msgid "inode"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:228
msgid "The inode number."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:230
msgid "nlink"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:232
msgid "The number of hard links."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:234
msgid "rdev"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:236
msgid "For block and char special files, the device (displayed as major:minor)."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:239
msgid "blocks"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:241
msgid "The number of 512 byte blocks allocated to the file."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:245
msgid ""
"With the I<--checksum> flag, the checksum of the file contents is shown "
"(only for regular files).  Computing file checksums can take a considerable "
"amount of time."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:276 diff/virt-diff.pod:78
msgid "B<--checksum>"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:278 diff/virt-diff.pod:80
msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:280
msgid ""
"Display checksum over file contents for regular files.  With no argument, "
"this defaults to using I<md5>.  Using an argument, you can select the "
"checksum type to use."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:284 cat/virt-ls.pod:321 cat/virt-ls.pod:354
#: cat/virt-ls.pod:422 cat/virt-ls.pod:432 cat/virt-ls.pod:439
#: cat/virt-ls.pod:446 cat/virt-ls.pod:453
msgid ""
"This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
"LISTING> above."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:312
msgid ""
"When prompting for keys and passphrases, virt-ls 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."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:317 diff/virt-diff.pod:136
msgid "B<--extra-stats>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:319 diff/virt-diff.pod:138
msgid "Display extra stats."
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:335
#, no-wrap
msgid ""
" virt-ls --format=raw -a disk.img /dir\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:339
#, no-wrap
msgid ""
" virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:352 diff/virt-diff.pod:169
msgid "Display file sizes in human-readable format."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:401
msgid "B<-R>"
msgstr ""

#. type: =item
#: cat/virt-ls.pod:403
msgid "B<--recursive>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:405
msgid ""
"Select the mode.  With neither of these options, C<virt-ls> produces a "
"simple, flat list of the files in the named directory.  See L</SIMPLE "
"LISTING>."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:409
msgid ""
"C<virt-ls -l> produces a \"long listing\", which shows more detail.  See "
"L</LONG LISTING>."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:412
msgid ""
"C<virt-ls -R> produces a recursive list of files starting at the named "
"directory.  See L</RECURSIVE LISTING>."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:415
msgid ""
"C<virt-ls -lR> produces a recursive long listing which can be more easily "
"parsed.  See L</RECURSIVE LONG LISTING>."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:418 diff/virt-diff.pod:175
msgid "B<--times>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:420 diff/virt-diff.pod:177
msgid "Display time fields."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:425 diff/virt-diff.pod:179
msgid "B<--time-days>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:427 diff/virt-diff.pod:181
msgid "Display time fields as days before now (negative if in the future)."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:429 diff/virt-diff.pod:183
msgid ""
"Note that C<0> in output means \"up to 1 day before now\", or that the age "
"of the file is between 0 and 86399 seconds."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:435 diff/virt-diff.pod:186
msgid "B<--time-relative>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:437 diff/virt-diff.pod:188
msgid "Display time fields as seconds before now (negative if in the future)."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:442 diff/virt-diff.pod:190
msgid "B<--time-t>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:444 diff/virt-diff.pod:192
msgid "Display time fields as seconds since the Unix epoch."
msgstr ""

#. type: =item
#: cat/virt-ls.pod:449 diff/virt-diff.pod:194
msgid "B<--uids>"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:451 diff/virt-diff.pod:196
msgid "Display UID and GID fields."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:476
msgid "Previous versions of virt-ls allowed you to write either:"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:478
#, no-wrap
msgid ""
" virt-ls disk.img [disk.img ...] /dir\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-ls.pod:482
#, no-wrap
msgid ""
" virt-ls guestname /dir\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:521
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, "
"L<virt-diff(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-ls.pod:535 df/virt-df.pod:273 diff/virt-diff.pod:265
#: docs/guestfs-tools-release-notes-1.48.pod:130
#: docs/guestfs-tools-release-notes-1.50.pod:182 drivers/virt-drivers.pod:250
#: edit/virt-edit.pod:401
msgid "Copyright (C) 2009-2023 Red Hat Inc."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:3
msgid "virt-tail - Follow (tail) files in a virtual machine"
msgstr ""

#. type: verbatim
#: cat/virt-tail.pod:7
#, no-wrap
msgid ""
" virt-tail [--options] -d domname file [file ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-tail.pod:9
#, no-wrap
msgid ""
" virt-tail [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:13
msgid ""
"C<virt-tail> is a command line tool to follow (tail) the contents of C<file> "
"where C<file> exists in the named virtual machine (or disk image).  It is "
"similar to the ordinary command S<C<tail -f>>."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:17
msgid ""
"Multiple filenames can be given, in which case each is followed separately.  "
"Each filename must be a full path, starting at the root directory (starting "
"with '/')."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:21
msgid "The command keeps running until:"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:27
msgid "The user presses the ^C or an interrupt signal is received."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:31
msgid "None of the listed files was found in the guest, or they all get deleted."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:36
msgid "There is an unrecoverable error."
msgstr ""

#. type: =head3
#: cat/virt-tail.pod:40 make-fs/virt-make-fs.pod:61 make-fs/virt-make-fs.pod:80
#: make-fs/virt-make-fs.pod:113
msgid "EXAMPLE"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:42
msgid "Follow F</var/log/messages> inside a virtual machine called C<mydomain>:"
msgstr ""

#. type: verbatim
#: cat/virt-tail.pod:44
#, no-wrap
msgid ""
" virt-tail -d mydomain /var/log/messages\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:92
msgid ""
"When prompting for keys and passphrases, virt-tail 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."
msgstr ""

#. type: =item
#: cat/virt-tail.pod:97
msgid "B<-f>"
msgstr ""

#. type: =item
#: cat/virt-tail.pod:99
msgid "B<--follow>"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:101
msgid ""
"This option is ignored.  virt-tail always behaves like S<L<tail(1)> I<-f>>.  "
"You don't need to specify the I<-f> option."
msgstr ""

#. type: verbatim
#: cat/virt-tail.pod:115
#, no-wrap
msgid ""
" virt-tail --format=raw -a disk.img file\n"
"\n"
msgstr ""

#. type: verbatim
#: cat/virt-tail.pod:119
#, no-wrap
msgid ""
" virt-tail --format=raw -a disk.img --format -a another.img file\n"
"\n"
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:194
msgid ""
"C<virt-tail> has a limited ability to understand Windows drive letters and "
"paths (eg. F<E:\\foo\\bar.txt>)."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:239
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-cat(1)>, "
"L<virt-log(1)>, L<virt-tar-out(1)>, L<tail(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: cat/virt-tail.pod:254
msgid "Copyright (C) 2016 Red Hat Inc."
msgstr ""

#. type: =end
#: common/mlcustomize/customize-options.pod:1
#: common/mlcustomize/customize-options.pod:25
#: common/mlcustomize/v2v-customize-options.pod:1
#: common/mlcustomize/v2v-customize-options.pod:25
#: docs/guestfs-tools-release-notes-1.48.pod:108
#: docs/guestfs-tools-release-notes-1.48.pod:112
#: docs/guestfs-tools-release-notes-1.50.pod:106
#: docs/guestfs-tools-release-notes-1.50.pod:110
#: docs/guestfs-tools-release-notes-1.50.pod:114
#: docs/guestfs-tools-release-notes-1.50.pod:118
#: docs/guestfs-tools-release-notes-1.50.pod:166
#: docs/guestfs-tools-release-notes-1.50.pod:170
#: docs/guestfs-tools-release-notes-1.52.pod:12
#: docs/guestfs-tools-release-notes-1.52.pod:16
#: docs/guestfs-tools-release-notes-1.52.pod:75
#: docs/guestfs-tools-release-notes-1.52.pod:79
#: docs/guestfs-tools-release-notes-1.52.pod:105
#: docs/guestfs-tools-release-notes-1.52.pod:109
msgid "comment"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:3
#: common/mlcustomize/v2v-customize-options.pod:3
#, no-wrap
msgid ""
"libguestfs generated file\n"
" WARNING: THIS FILE IS GENERATED FROM THE FOLLOWING FILES:\n"
"          generator/customize.ml\n"
"          and from the code in the generator/ subdirectory.\n"
" ANY CHANGES YOU MAKE TO THIS FILE WILL BE LOST.\n"
"\n"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:9
#: common/mlcustomize/v2v-customize-options.pod:9
#, no-wrap
msgid ""
" Copyright (C) 2009-2023 Red Hat Inc.\n"
"\n"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:11
#: common/mlcustomize/v2v-customize-options.pod:11
#, no-wrap
msgid ""
" This program is free software; you can redistribute it and/or modify\n"
" it under the terms of the GNU General Public License as published by\n"
" the Free Software Foundation; either version 2 of the License, or\n"
" (at your option) any later version.\n"
"\n"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:16
#: common/mlcustomize/v2v-customize-options.pod:16
#, no-wrap
msgid ""
" This program is distributed in the hope that it will be useful,\n"
" but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
" GNU General Public License for more details.\n"
"\n"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:21
#: common/mlcustomize/v2v-customize-options.pod:21
#, no-wrap
msgid ""
" You should have received a copy of the GNU General Public License along\n"
" with this program; if not, write to the Free Software Foundation, Inc.,\n"
" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.\n"
"\n"
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:29
#: common/mlcustomize/v2v-customize-options.pod:29
msgid "B<--append-line> FILE:LINE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:31
#: common/mlcustomize/v2v-customize-options.pod:31
#: sysprep/sysprep-extra-options.pod:4
msgid ""
"Append a single line of text to the C<FILE>.  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 C<LINE> string automatically."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:36
#: common/mlcustomize/v2v-customize-options.pod:36
#: sysprep/sysprep-extra-options.pod:9
msgid "For example (assuming ordinary shell quoting) this command:"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:38
#: common/mlcustomize/v2v-customize-options.pod:38
#: sysprep/sysprep-extra-options.pod:11
#, no-wrap
msgid ""
" --append-line '/etc/hosts:10.0.0.1 foo'\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:40
#: common/mlcustomize/v2v-customize-options.pod:40
#: sysprep/sysprep-extra-options.pod:13
msgid ""
"will add either C<10.0.0.1 foo⏎> or C<⏎10.0.0.1 foo⏎> to the file, the "
"latter only if the existing file does not already end with a newline."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:44
#: common/mlcustomize/v2v-customize-options.pod:44
#: sysprep/sysprep-extra-options.pod:17
msgid ""
"C<⏎> represents a newline character, which is guessed by looking at the "
"existing content of the file, so this command does the right thing for files "
"using Unix or Windows line endings.  It also works for empty or non-existent "
"files."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:49
#: common/mlcustomize/v2v-customize-options.pod:49
#: sysprep/sysprep-extra-options.pod:22
msgid "To insert several lines, use the same option several times:"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:51
#: common/mlcustomize/v2v-customize-options.pod:51
#: sysprep/sysprep-extra-options.pod:24
#, no-wrap
msgid ""
" --append-line '/etc/hosts:10.0.0.1 foo'\n"
" --append-line '/etc/hosts:10.0.0.2 bar'\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:54
#: common/mlcustomize/v2v-customize-options.pod:54
#: sysprep/sysprep-extra-options.pod:27
msgid "To insert a blank line before the appended line, do:"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:56
#: common/mlcustomize/v2v-customize-options.pod:56
#: sysprep/sysprep-extra-options.pod:29
#, no-wrap
msgid ""
" --append-line '/etc/hosts:'\n"
" --append-line '/etc/hosts:10.0.0.1 foo'\n"
"\n"
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:59
#: common/mlcustomize/v2v-customize-options.pod:59
msgid "B<--chmod> PERMISSIONS:FILE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:61
#: common/mlcustomize/v2v-customize-options.pod:61
#: sysprep/sysprep-extra-options.pod:35
msgid "Change the permissions of C<FILE> to C<PERMISSIONS>."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:63
#: common/mlcustomize/v2v-customize-options.pod:63
#: sysprep/sysprep-extra-options.pod:37
msgid ""
"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>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:66
#: common/mlcustomize/v2v-customize-options.pod:66
msgid "B<--chown> UID:GID:PATH"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:68
#: common/mlcustomize/v2v-customize-options.pod:68
#: sysprep/sysprep-extra-options.pod:43
msgid ""
"Change the owner user and group ID of a file or directory in the guest.  "
"Note:"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:75
#: common/mlcustomize/v2v-customize-options.pod:75
#: sysprep/sysprep-extra-options.pod:50
msgid ""
"Only numeric UIDs and GIDs will work, and these may not be the same inside "
"the guest as on the host."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:80
#: common/mlcustomize/v2v-customize-options.pod:80
#: sysprep/sysprep-extra-options.pod:55
msgid "This will not work with Windows guests."
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:86
#: common/mlcustomize/v2v-customize-options.pod:86
#: sysprep/sysprep-extra-options.pod:61
#, no-wrap
msgid ""
" virt-customize --chown '0:0:/var/log/audit.log'\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:88
#: common/mlcustomize/v2v-customize-options.pod:88
#: sysprep/sysprep-extra-options.pod:63
msgid "See also: I<--upload>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:90
#: common/mlcustomize/v2v-customize-options.pod:90
msgid "B<--commands-from-file> FILENAME"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:92
#: common/mlcustomize/v2v-customize-options.pod:92
#: sysprep/sysprep-extra-options.pod:68
msgid "Read the customize commands from a file, one (and its arguments)  each line."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:95
#: common/mlcustomize/v2v-customize-options.pod:95
#: sysprep/sysprep-extra-options.pod:71
msgid ""
"Each line contains a single customization command and its arguments, for "
"example:"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:98
#: common/mlcustomize/v2v-customize-options.pod:98
#: sysprep/sysprep-extra-options.pod:74
#, no-wrap
msgid ""
" delete /some/file\n"
" install some-package\n"
" password some-user:password:its-new-password\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:102
#: common/mlcustomize/v2v-customize-options.pod:102
#: sysprep/sysprep-extra-options.pod:78
msgid ""
"Empty lines are ignored, and lines starting with C<#> are comments and are "
"ignored as well.  Furthermore, arguments can be spread across multiple "
"lines, by adding a C<\\> (continuation character) at the of a line, for "
"example"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:107
#: common/mlcustomize/v2v-customize-options.pod:107
#: sysprep/sysprep-extra-options.pod:83
#, no-wrap
msgid ""
" edit /some/file:\\\n"
"   s/^OPT=.*/OPT=ok/\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:110
#: common/mlcustomize/v2v-customize-options.pod:110
#: sysprep/sysprep-extra-options.pod:86
msgid ""
"The commands are handled in the same order as they are in the file, as if "
"they were specified as I<--delete /some/file> on the command line."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:114
#: common/mlcustomize/v2v-customize-options.pod:114
msgid "B<--copy> SOURCE:DEST"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:116
#: common/mlcustomize/v2v-customize-options.pod:116
#: sysprep/sysprep-extra-options.pod:93
msgid "Copy files or directories recursively inside the guest."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:118
#: common/mlcustomize/customize-options.pod:125
#: common/mlcustomize/customize-options.pod:283
#: common/mlcustomize/v2v-customize-options.pod:118
#: common/mlcustomize/v2v-customize-options.pod:125
#: common/mlcustomize/v2v-customize-options.pod:223
#: sysprep/sysprep-extra-options.pod:95 sysprep/sysprep-extra-options.pod:103
#: sysprep/sysprep-extra-options.pod:288
msgid "Wildcards cannot be used."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:120
#: common/mlcustomize/v2v-customize-options.pod:120
msgid "B<--copy-in> LOCALPATH:REMOTEDIR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:122
#: common/mlcustomize/v2v-customize-options.pod:122
#: sysprep/sysprep-extra-options.pod:100
msgid ""
"Copy local files or directories recursively into the disk image, placing "
"them in the directory C<REMOTEDIR> (which must exist)."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:127
#: common/mlcustomize/v2v-customize-options.pod:127
msgid "B<--delete> PATH"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:129
#: common/mlcustomize/v2v-customize-options.pod:129
#: sysprep/sysprep-extra-options.pod:108
msgid ""
"Delete a file from the guest.  Or delete a directory (and all its contents, "
"recursively)."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:132
#: common/mlcustomize/v2v-customize-options.pod:132
#: sysprep/sysprep-extra-options.pod:111
msgid ""
"You can use shell glob characters in the specified path.  Be careful to "
"escape glob characters from the host shell, if that is required.  For "
"example:"
msgstr ""

#. type: verbatim
#: common/mlcustomize/customize-options.pod:136
#: common/mlcustomize/v2v-customize-options.pod:136
#: sysprep/sysprep-extra-options.pod:115
#, no-wrap
msgid ""
" virt-customize --delete '/var/log/*.log'.\n"
"\n"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:138
#: common/mlcustomize/v2v-customize-options.pod:138
#: sysprep/sysprep-extra-options.pod:117
msgid "See also: I<--upload>, I<--scrub>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:140
#: common/mlcustomize/v2v-customize-options.pod:140
msgid "B<--edit> FILE:EXPR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:142
#: common/mlcustomize/v2v-customize-options.pod:142
#: sysprep/sysprep-extra-options.pod:122
msgid "Edit C<FILE> using the Perl expression C<EXPR>."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:144
#: common/mlcustomize/v2v-customize-options.pod:144 edit/virt-edit.pod:129
#: sysprep/sysprep-extra-options.pod:124
msgid ""
"Be careful to properly quote the expression to prevent it from being altered "
"by the shell."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:147
#: common/mlcustomize/v2v-customize-options.pod:147 edit/virt-edit.pod:132
#: sysprep/sysprep-extra-options.pod:127
msgid "Note that this option is only available when Perl 5 is installed."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:149
#: common/mlcustomize/v2v-customize-options.pod:149
#: sysprep/sysprep-extra-options.pod:129
msgid "See L<virt-edit(1)/NON-INTERACTIVE EDITING>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:151
#: common/mlcustomize/v2v-customize-options.pod:151
msgid "B<--firstboot> SCRIPT"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:153
#: common/mlcustomize/v2v-customize-options.pod:153
#: sysprep/sysprep-extra-options.pod:134
msgid ""
"Install C<SCRIPT> inside the guest, so that when the guest first boots up, "
"the script runs (as root, late in the boot process)."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:156
#: common/mlcustomize/v2v-customize-options.pod:156
#: sysprep/sysprep-extra-options.pod:137
msgid "The script is automatically chmod +x after installation in the guest."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:158
#: common/mlcustomize/v2v-customize-options.pod:158
#: sysprep/sysprep-extra-options.pod:139
msgid ""
"The alternative version I<--firstboot-command> is the same, but it "
"conveniently wraps the command up in a single line script for you."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:161
#: common/mlcustomize/customize-options.pod:174
#: common/mlcustomize/v2v-customize-options.pod:161
#: common/mlcustomize/v2v-customize-options.pod:174
#: sysprep/sysprep-extra-options.pod:142 sysprep/sysprep-extra-options.pod:156
msgid ""
"You can have multiple I<--firstboot> options.  They run in the same order "
"that they appear on the command line."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:164
#: common/mlcustomize/customize-options.pod:177
#: common/mlcustomize/v2v-customize-options.pod:164
#: common/mlcustomize/v2v-customize-options.pod:177
#: sysprep/sysprep-extra-options.pod:145 sysprep/sysprep-extra-options.pod:159
msgid ""
"Please take a look at L<virt-builder(1)/FIRST BOOT SCRIPTS> for more "
"information and caveats about the first boot scripts."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:167
#: common/mlcustomize/customize-options.pod:180
#: common/mlcustomize/v2v-customize-options.pod:167
#: common/mlcustomize/v2v-customize-options.pod:180
#: sysprep/sysprep-extra-options.pod:148 sysprep/sysprep-extra-options.pod:162
msgid "See also I<--run>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:169
#: common/mlcustomize/v2v-customize-options.pod:169
msgid "B<--firstboot-command> 'CMD+ARGS'"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:171
#: common/mlcustomize/v2v-customize-options.pod:171
#: sysprep/sysprep-extra-options.pod:153
msgid ""
"Run command (and arguments) inside the guest when the guest first boots up "
"(as root, late in the boot process)."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:182
#: common/mlcustomize/v2v-customize-options.pod:182
msgid "B<--firstboot-install> PKG,PKG.."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:184
#: common/mlcustomize/v2v-customize-options.pod:184
#: sysprep/sysprep-extra-options.pod:167
msgid ""
"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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:188
#: common/mlcustomize/customize-options.pod:262
#: common/mlcustomize/v2v-customize-options.pod:188
#: common/mlcustomize/v2v-customize-options.pod:202
#: sysprep/sysprep-extra-options.pod:171 sysprep/sysprep-extra-options.pod:250
msgid ""
"For an overview on the different ways to install packages, see "
"L<virt-builder(1)/INSTALLING PACKAGES>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:191
#: common/mlcustomize/v2v-customize-options.pod:191
msgid "B<--hostname> HOSTNAME"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:193
#: common/mlcustomize/v2v-customize-options.pod:193
#: sysprep/sysprep-extra-options.pod:177
msgid ""
"Set the hostname of the guest to C<HOSTNAME>.  You can use a dotted "
"hostname.domainname (FQDN) if you want."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:196
msgid "B<--inject-blnsvr> METHOD"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:198
#: sysprep/sysprep-extra-options.pod:183
msgid ""
"Inject the Balloon Server (F<blnsvr.exe>) into a Windows guest.  This "
"operation also injects a firstboot script so that the Balloon Server is "
"installed when the guest boots."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:202
#: common/mlcustomize/customize-options.pod:216
#: sysprep/sysprep-extra-options.pod:187 sysprep/sysprep-extra-options.pod:202
msgid "The parameter is the same as used by the I<--inject-virtio-win> operation."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:204
#: common/mlcustomize/customize-options.pod:218
#: common/mlcustomize/customize-options.pod:252
#: sysprep/sysprep-extra-options.pod:189 sysprep/sysprep-extra-options.pod:204
#: sysprep/sysprep-extra-options.pod:239
msgid ""
"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 L<virt-v2v(1)> tool instead of this."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:208
msgid "B<--inject-qemu-ga> METHOD"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:210
#: sysprep/sysprep-extra-options.pod:196
msgid ""
"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 L<qemu-ga(8)>).  This operation also injects a firstboot "
"script so that the Guest Agent is installed when the guest boots."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:222
msgid "B<--inject-virtio-win> METHOD"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:224
#: sysprep/sysprep-extra-options.pod:211
msgid ""
"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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:230
#: sysprep/sysprep-extra-options.pod:217
msgid "The parameter can be one of:"
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:234
#: sysprep/sysprep-extra-options.pod:221
msgid "ISO"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:236
#: sysprep/sysprep-extra-options.pod:223
msgid ""
"The path to the ISO image containing the virtio-win drivers "
"(eg. F</usr/share/virtio-win/virtio-win.iso>)."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:239
#: sysprep/sysprep-extra-options.pod:226
msgid "DIR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:241
#: sysprep/sysprep-extra-options.pod:228
msgid ""
"The directory containing the unpacked virtio-win drivers "
"(eg. F</usr/share/virtio-win>)."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:244
#: sysprep/sysprep-extra-options.pod:231
msgid "B<\"osinfo\">"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:246
#: sysprep/sysprep-extra-options.pod:233
msgid ""
"The literal string C<\"osinfo\"> means to use the libosinfo database to "
"locate the drivers.  (See L<osinfo-query(1)>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:256
#: common/mlcustomize/v2v-customize-options.pod:196
msgid "B<--install> PKG,PKG.."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:258
#: common/mlcustomize/v2v-customize-options.pod:198
#: sysprep/sysprep-extra-options.pod:246
msgid ""
"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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:265
#: common/mlcustomize/v2v-customize-options.pod:205
#: sysprep/sysprep-extra-options.pod:253
msgid "See also I<--update>, I<--uninstall>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:267
#: common/mlcustomize/v2v-customize-options.pod:207
msgid "B<--link> TARGET:LINK[:LINK..]"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:269
#: common/mlcustomize/v2v-customize-options.pod:209
#: sysprep/sysprep-extra-options.pod:272
msgid ""
"Create symbolic link(s) in the guest, starting at C<LINK> and pointing at "
"C<TARGET>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:272
#: common/mlcustomize/v2v-customize-options.pod:212
msgid "B<--mkdir> DIR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:274
#: common/mlcustomize/v2v-customize-options.pod:214
#: sysprep/sysprep-extra-options.pod:278
msgid "Create a directory in the guest."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:276
#: common/mlcustomize/v2v-customize-options.pod:216
#: sysprep/sysprep-extra-options.pod:280
msgid ""
"This uses S<C<mkdir -p>> so any intermediate directories are created, and it "
"also works if the directory already exists."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:279
#: common/mlcustomize/v2v-customize-options.pod:219
msgid "B<--move> SOURCE:DEST"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:281
#: common/mlcustomize/v2v-customize-options.pod:221
#: sysprep/sysprep-extra-options.pod:286
msgid "Move files or directories inside the guest."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:285
#: common/mlcustomize/v2v-customize-options.pod:225
msgid "B<--no-logfile>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:287
#: common/mlcustomize/v2v-customize-options.pod:227
#: sysprep/sysprep-extra-options.pod:293
msgid ""
"Scrub C<builder.log> (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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:291
#: common/mlcustomize/v2v-customize-options.pod:231
#: sysprep/sysprep-extra-options.pod:297
msgid "See also: L</LOG FILE>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:293
#: common/mlcustomize/v2v-customize-options.pod:233
msgid "B<--no-selinux-relabel>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:295
#: common/mlcustomize/v2v-customize-options.pod:235
#: sysprep/sysprep-extra-options.pod:302
msgid "Do not attempt to correct the SELinux labels of files in the guest."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:297
#: common/mlcustomize/v2v-customize-options.pod:237
#: sysprep/sysprep-extra-options.pod:304
msgid ""
"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 F</.autorelabel> on the image to schedule a relabel operation "
"for the next time the image boots.)  This option disables the automatic "
"relabeling."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:304
#: common/mlcustomize/v2v-customize-options.pod:244
#: sysprep/sysprep-extra-options.pod:311
msgid "The option is a no-op for guests that do not support SELinux."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:306
#: common/mlcustomize/v2v-customize-options.pod:246
msgid "B<--password> USER:SELECTOR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:308
#: common/mlcustomize/v2v-customize-options.pod:248
#: sysprep/sysprep-extra-options.pod:316
msgid ""
"Set the password for C<USER>.  (Note this option does I<not> create the user "
"account)."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:311
#: common/mlcustomize/customize-options.pod:340
#: common/mlcustomize/v2v-customize-options.pod:251
#: common/mlcustomize/v2v-customize-options.pod:280
#: sysprep/sysprep-extra-options.pod:319 sysprep/sysprep-extra-options.pod:364
msgid ""
"See L<virt-builder(1)/USERS AND PASSWORDS> for the format of the C<SELECTOR> "
"field, and also how to set up user accounts."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:314
#: common/mlcustomize/v2v-customize-options.pod:254
msgid "B<--password-crypto> md5|sha256|sha512"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:316
#: common/mlcustomize/v2v-customize-options.pod:256
#: sysprep/sysprep-extra-options.pod:325
msgid ""
"When the virt tools change or set a password in the guest, this option sets "
"the password encryption of that password to C<md5>, C<sha256> or C<sha512>."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:320
#: common/mlcustomize/v2v-customize-options.pod:260
#: sysprep/sysprep-extra-options.pod:329
msgid ""
"C<sha256> and C<sha512> require glibc E<ge> 2.7 (check crypt(3) inside the "
"guest)."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:323
#: common/mlcustomize/v2v-customize-options.pod:263
#: sysprep/sysprep-extra-options.pod:332
msgid ""
"C<md5> will work with relatively old Linux guests (eg. RHEL 3), but is not "
"secure against modern attacks."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:326
#: common/mlcustomize/v2v-customize-options.pod:266
#: sysprep/sysprep-extra-options.pod:335
msgid ""
"The default is C<sha512> unless libguestfs detects an old guest that didn't "
"have support for SHA-512, in which case it will use C<md5>.  You can "
"override libguestfs by specifying this option."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:330
#: common/mlcustomize/v2v-customize-options.pod:270
#: sysprep/sysprep-extra-options.pod:339
msgid ""
"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 I<--edit> option to modify "
"C</etc/sysconfig/authconfig> (Fedora, RHEL) or C</etc/pam.d/common-password> "
"(Debian, Ubuntu)."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:336
#: common/mlcustomize/v2v-customize-options.pod:276
msgid "B<--root-password> SELECTOR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:338
#: common/mlcustomize/v2v-customize-options.pod:278
#: sysprep/sysprep-extra-options.pod:362
msgid "Set the root password."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:343
#: common/mlcustomize/v2v-customize-options.pod:283
#: sysprep/sysprep-extra-options.pod:367
msgid ""
"Note: In virt-builder, if you I<don't> set I<--root-password> then the guest "
"is given a I<random> root password."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:346
#: common/mlcustomize/v2v-customize-options.pod:286
msgid "B<--run> SCRIPT"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:348
#: common/mlcustomize/v2v-customize-options.pod:288
#: sysprep/sysprep-extra-options.pod:373
msgid ""
"Run the shell script (or any program) called C<SCRIPT> on the disk image.  "
"The script runs virtualized inside a small appliance, chrooted into the "
"guest filesystem."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:352
#: common/mlcustomize/v2v-customize-options.pod:292
#: sysprep/sysprep-extra-options.pod:377
msgid "The script is automatically chmod +x."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:354
#: common/mlcustomize/customize-options.pod:370
#: common/mlcustomize/v2v-customize-options.pod:294
#: common/mlcustomize/v2v-customize-options.pod:310
#: sysprep/sysprep-extra-options.pod:379 sysprep/sysprep-extra-options.pod:396
msgid ""
"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 (I<--attach>).  You can also "
"upload data files (I<--upload>)."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:360
#: common/mlcustomize/v2v-customize-options.pod:300
#: sysprep/sysprep-extra-options.pod:385
msgid ""
"You can have multiple I<--run> options.  They run in the same order that "
"they appear on the command line."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:363
#: common/mlcustomize/customize-options.pod:379
#: common/mlcustomize/v2v-customize-options.pod:303
#: common/mlcustomize/v2v-customize-options.pod:319
#: sysprep/sysprep-extra-options.pod:388 sysprep/sysprep-extra-options.pod:405
msgid "See also: I<--firstboot>, I<--attach>, I<--upload>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:365
#: common/mlcustomize/v2v-customize-options.pod:305
msgid "B<--run-command> 'CMD+ARGS'"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:367
#: common/mlcustomize/v2v-customize-options.pod:307
#: sysprep/sysprep-extra-options.pod:393
msgid ""
"Run the command and arguments on the disk image.  The command runs "
"virtualized inside a small appliance, chrooted into the guest filesystem."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:376
#: common/mlcustomize/v2v-customize-options.pod:316
#: sysprep/sysprep-extra-options.pod:402
msgid ""
"You can have multiple I<--run-command> options.  They run in the same order "
"that they appear on the command line."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:381
#: common/mlcustomize/v2v-customize-options.pod:321
msgid "B<--scrub> FILE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:383
#: common/mlcustomize/v2v-customize-options.pod:323
#: sysprep/sysprep-extra-options.pod:432
msgid "Scrub a file from the guest.  This is like I<--delete> except that:"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:389
#: common/mlcustomize/v2v-customize-options.pod:329
#: sysprep/sysprep-extra-options.pod:438
msgid "It scrubs the data so a guest could not recover it."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:393
#: common/mlcustomize/v2v-customize-options.pod:333
#: sysprep/sysprep-extra-options.pod:442
msgid "It cannot delete directories, only regular files."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:397
#: common/mlcustomize/v2v-customize-options.pod:337
msgid "B<--selinux-relabel>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:399
#: common/mlcustomize/v2v-customize-options.pod:339
#: sysprep/sysprep-extra-options.pod:449
msgid "This is a compatibility option that does nothing."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:401
#: common/mlcustomize/v2v-customize-options.pod:341
msgid "B<--sm-attach> SELECTOR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:403
#: common/mlcustomize/v2v-customize-options.pod:343
#: sysprep/sysprep-extra-options.pod:454
msgid "Attach to a pool using C<subscription-manager>."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:405
#: common/mlcustomize/customize-options.pod:412
#: common/mlcustomize/v2v-customize-options.pod:345
#: common/mlcustomize/v2v-customize-options.pod:352
#: sysprep/sysprep-extra-options.pod:456 sysprep/sysprep-extra-options.pod:464
msgid ""
"See L<virt-builder(1)/SUBSCRIPTION-MANAGER> for the format of the "
"C<SELECTOR> field."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:408
#: common/mlcustomize/v2v-customize-options.pod:348
msgid "B<--sm-credentials> SELECTOR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:410
#: common/mlcustomize/v2v-customize-options.pod:350
#: sysprep/sysprep-extra-options.pod:462
msgid "Set the credentials for C<subscription-manager>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:415
#: common/mlcustomize/v2v-customize-options.pod:355
msgid "B<--sm-register>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:417
#: common/mlcustomize/v2v-customize-options.pod:357
#: sysprep/sysprep-extra-options.pod:470
msgid "Register the guest using C<subscription-manager>."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:419
#: common/mlcustomize/v2v-customize-options.pod:359
#: sysprep/sysprep-extra-options.pod:472
msgid "This requires credentials being set using I<--sm-credentials>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:421
#: common/mlcustomize/v2v-customize-options.pod:361
msgid "B<--sm-remove>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:423
#: common/mlcustomize/v2v-customize-options.pod:363
#: sysprep/sysprep-extra-options.pod:477
msgid "Remove all the subscriptions from the guest using C<subscription-manager>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:426
#: common/mlcustomize/v2v-customize-options.pod:366
msgid "B<--sm-unregister>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:428
#: common/mlcustomize/v2v-customize-options.pod:368
#: sysprep/sysprep-extra-options.pod:483
msgid "Unregister the guest using C<subscription-manager>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:430
#: common/mlcustomize/v2v-customize-options.pod:370
msgid "B<--ssh-inject> USER[:SELECTOR]"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:432
#: common/mlcustomize/v2v-customize-options.pod:372
#: sysprep/sysprep-extra-options.pod:488
msgid ""
"Inject an ssh key so the given C<USER> will be able to log in over ssh "
"without supplying a password.  The C<USER> must exist already in the guest."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:436
#: common/mlcustomize/v2v-customize-options.pod:376
#: sysprep/sysprep-extra-options.pod:492
msgid "See L<virt-builder(1)/SSH KEYS> for the format of the C<SELECTOR> field."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:439
#: common/mlcustomize/v2v-customize-options.pod:379
#: sysprep/sysprep-extra-options.pod:495
msgid ""
"You can have multiple I<--ssh-inject> options, for different users and also "
"for more keys for each user."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:442
#: common/mlcustomize/v2v-customize-options.pod:382
msgid "B<--tar-in> TARFILE:REMOTEDIR"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:444
#: common/mlcustomize/v2v-customize-options.pod:384
#: sysprep/sysprep-extra-options.pod:501
msgid ""
"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)"
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:450
#: common/mlcustomize/v2v-customize-options.pod:390
msgid "B<--timezone> TIMEZONE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:452
#: common/mlcustomize/v2v-customize-options.pod:392
#: sysprep/sysprep-extra-options.pod:510
msgid ""
"Set the default timezone of the guest to C<TIMEZONE>.  Use a location string "
"like C<Europe/London>"
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:455
#: common/mlcustomize/v2v-customize-options.pod:395
msgid "B<--touch> FILE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:457
#: common/mlcustomize/v2v-customize-options.pod:397
#: sysprep/sysprep-extra-options.pod:516
msgid "This command performs a L<touch(1)>-like operation on C<FILE>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:459
#: common/mlcustomize/v2v-customize-options.pod:399
msgid "B<--truncate> FILE"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:461
#: common/mlcustomize/v2v-customize-options.pod:401
#: sysprep/sysprep-extra-options.pod:521
msgid ""
"This command truncates C<FILE> to a zero-length file. The file must exist "
"already."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:464
#: common/mlcustomize/v2v-customize-options.pod:404
msgid "B<--truncate-recursive> PATH"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:466
#: common/mlcustomize/v2v-customize-options.pod:406
#: sysprep/sysprep-extra-options.pod:527
msgid "This command recursively truncates all files under C<PATH> to zero-length."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:468
#: common/mlcustomize/v2v-customize-options.pod:408
msgid "B<--uninstall> PKG,PKG.."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:470
#: common/mlcustomize/v2v-customize-options.pod:410
#: sysprep/sysprep-extra-options.pod:532
msgid ""
"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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:475
#: common/mlcustomize/v2v-customize-options.pod:415
#: sysprep/sysprep-extra-options.pod:537
msgid "See also I<--install>, I<--update>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:477
#: common/mlcustomize/v2v-customize-options.pod:417
msgid "B<--update>"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:479
#: common/mlcustomize/v2v-customize-options.pod:419
#: sysprep/sysprep-extra-options.pod:542
msgid ""
"Do the equivalent of C<yum update>, C<apt-get upgrade>, or whatever command "
"is required to update the packages already installed in the template to "
"their latest versions."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:483
#: common/mlcustomize/v2v-customize-options.pod:423
#: sysprep/sysprep-extra-options.pod:546
msgid "See also I<--install>, I<--uninstall>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:485
#: common/mlcustomize/v2v-customize-options.pod:425
msgid "B<--upload> FILE:DEST"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:487
#: common/mlcustomize/v2v-customize-options.pod:427
#: sysprep/sysprep-extra-options.pod:551
msgid ""
"Upload local file C<FILE> to destination C<DEST> 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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:491
#: common/mlcustomize/v2v-customize-options.pod:431
#: sysprep/sysprep-extra-options.pod:555
msgid ""
"C<DEST> could be the final filename.  This can be used to rename the file on "
"upload."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:494
#: common/mlcustomize/v2v-customize-options.pod:434
#: sysprep/sysprep-extra-options.pod:558
msgid ""
"If C<DEST> 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."
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:498
#: common/mlcustomize/v2v-customize-options.pod:438
#: sysprep/sysprep-extra-options.pod:562
msgid "See also: I<--mkdir>, I<--delete>, I<--scrub>."
msgstr ""

#. type: =item
#: common/mlcustomize/customize-options.pod:500
#: common/mlcustomize/v2v-customize-options.pod:440
msgid "B<--write> FILE:CONTENT"
msgstr ""

#. type: textblock
#: common/mlcustomize/customize-options.pod:502
#: common/mlcustomize/v2v-customize-options.pod:442
#: sysprep/sysprep-extra-options.pod:567
msgid "Write C<CONTENT> to C<FILE>."
msgstr ""

#. type: =item
#: common/options/blocksize-option.pod:1 make-fs/virt-make-fs.pod:125
msgid "B<--blocksize=512>"
msgstr ""

#. type: =item
#: common/options/blocksize-option.pod:3 make-fs/virt-make-fs.pod:127
msgid "B<--blocksize=4096>"
msgstr ""

#. type: =item
#: common/options/blocksize-option.pod:5
msgid "B<--blocksize>"
msgstr ""

#. type: textblock
#: common/options/blocksize-option.pod:7
msgid ""
"This parameter sets the sector size of the disk image.  It affects all "
"explicitly added subsequent disks after this parameter.  Using "
"I<--blocksize> with no argument switches the disk sector size to the default "
"value which is usually 512 bytes.  See also "
"L<guestfs(3)/guestfs_add_drive_opts>."
msgstr ""

#. type: =item
#: common/options/key-option.pod:1
msgid "B<--key> SELECTOR"
msgstr ""

#. type: textblock
#: common/options/key-option.pod:3
msgid ""
"Specify a key for LUKS, to automatically open a LUKS device when using the "
"inspection."
msgstr ""

#. type: =item
#: common/options/key-option.pod:8
msgid "B<--key> NAMEB<:key:>KEY_STRING"
msgstr ""

#. type: =item
#: common/options/key-option.pod:10
msgid "B<--key> UUIDB<:key:>KEY_STRING"
msgstr ""

#. type: =item
#: common/options/key-option.pod:12
msgid "B<--key> B<all:key:>KEY_STRING"
msgstr ""

#. type: textblock
#: common/options/key-option.pod:14
msgid ""
"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."
msgstr ""

#. type: textblock
#: common/options/key-option.pod:18
msgid "Use the specified C<KEY_STRING> as passphrase."
msgstr ""

#. type: =item
#: common/options/key-option.pod:20
msgid "B<--key> NAMEB<:file:>FILENAME"
msgstr ""

#. type: =item
#: common/options/key-option.pod:22
msgid "B<--key> UUIDB<:file:>FILENAME"
msgstr ""

#. type: =item
#: common/options/key-option.pod:24
msgid "B<--key> B<all:file:>FILENAME"
msgstr ""

#. type: textblock
#: common/options/key-option.pod:26
msgid "Read the passphrase from F<FILENAME>."
msgstr ""

#. type: =item
#: common/options/key-option.pod:28
msgid "B<--key> NAMEB<:clevis>"
msgstr ""

#. type: =item
#: common/options/key-option.pod:30
msgid "B<--key> UUIDB<:clevis>"
msgstr ""

#. type: =item
#: common/options/key-option.pod:32
msgid "B<--key> B<all:clevis>"
msgstr ""

#. type: textblock
#: common/options/key-option.pod:34
msgid ""
"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)."
msgstr ""

#. type: textblock
#: common/options/key-option.pod:38
msgid ""
"Note that if any such option is present on the command line, QEMU user "
"networking will be automatically enabled for the libguestfs appliance."
msgstr ""

#. type: =item
#: common/options/keys-from-stdin-option.pod:1
msgid "B<--keys-from-stdin>"
msgstr ""

#. type: textblock
#: common/options/keys-from-stdin-option.pod:3
msgid ""
"Read key or passphrase parameters from stdin.  The default is to try to read "
"passphrases from the user by opening F</dev/tty>."
msgstr ""

#. type: textblock
#: common/options/keys-from-stdin-option.pod:6
msgid ""
"If there are multiple encrypted devices then you may need to supply multiple "
"keys on stdin, one per line."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:3
msgid "virt-customize - Customize a virtual machine"
msgstr ""

#. type: verbatim
#: customize/virt-customize.pod:7
#, no-wrap
msgid ""
" virt-customize\n"
"    [ -a disk.img [ -a disk.img ... ] | -d domname ]\n"
"    [--attach ISOFILE] [--attach-format FORMAT]\n"
"    [ -c URI | --connect URI ] [ -n | --dry-run ]\n"
"    [ --format FORMAT] [ -m MB | --memsize MB ]\n"
"    [ --network | --no-network ]\n"
"    [ -q | --quiet ] [--smp N] [ -v | --verbose ] [-x]\n"
"__CUSTOMIZE_SYNOPSIS__\n"
"\n"
msgstr ""

#. type: verbatim
#: customize/virt-customize.pod:16
#, no-wrap
msgid ""
" virt-customize [ -V | --version ]\n"
"\n"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:20
msgid ""
"Virt-customize can customize a virtual machine (disk image) by installing "
"packages, editing configuration files, and so on."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:23
msgid ""
"Virt-customize modifies the guest or disk image I<in place>.  The guest must "
"be shut down.  If you want to preserve the existing contents of the guest, "
"I<you must snapshot, copy or clone the disk first>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:27
msgid ""
"You do I<not> need to run virt-customize as root.  In fact we'd generally "
"recommend that you don't."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:30
msgid "Related tools include: L<virt-sysprep(1)> and L<virt-builder(1)>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:46 drivers/virt-drivers.pod:127
#: get-kernel/virt-get-kernel.pod:37 sysprep/virt-sysprep.pod:50
msgid ""
"The format of the disk image is auto-detected.  To override this and force a "
"particular format use the I<--format> option."
msgstr ""

#. type: =item
#: customize/virt-customize.pod:49 df/virt-df.pod:90 diff/virt-diff.pod:54
#: drivers/virt-drivers.pod:130 edit/virt-edit.pod:73 format/virt-format.pod:76
#: get-kernel/virt-get-kernel.pod:40 inspector/virt-inspector.pod:74
#: sysprep/virt-sysprep.pod:53
msgid "B<-a> URI"
msgstr ""

#. type: =item
#: customize/virt-customize.pod:51 df/virt-df.pod:92 diff/virt-diff.pod:56
#: drivers/virt-drivers.pod:132 edit/virt-edit.pod:75 format/virt-format.pod:78
#: get-kernel/virt-get-kernel.pod:42 inspector/virt-inspector.pod:76
#: sysprep/virt-sysprep.pod:55
msgid "B<--add> URI"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:53 drivers/virt-drivers.pod:134
#: get-kernel/virt-get-kernel.pod:44 sysprep/virt-sysprep.pod:57
msgid ""
"Add a remote disk.  The URI format is compatible with guestfish.  See "
"L<guestfish(1)/ADDING REMOTE STORAGE>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:58
msgid ""
"The given disk is attached to the libguestfs appliance.  This is used to "
"provide extra software repositories or other data for customization."
msgstr ""

#. type: =item
#: customize/virt-customize.pod:103 resize/virt-resize.pod:470
#: sysprep/virt-sysprep.pod:86
msgid "B<-n>"
msgstr ""

#. type: =item
#: customize/virt-customize.pod:105 resize/virt-resize.pod:472
#: sysprep/virt-sysprep.pod:88
msgid "B<--dry-run>"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:107 sysprep/virt-sysprep.pod:90
msgid ""
"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."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:112
msgid ""
"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."
msgstr ""

#. type: =item
#: customize/virt-customize.pod:117 drivers/virt-drivers.pod:178
#: get-kernel/virt-get-kernel.pod:88 sysprep/virt-sysprep.pod:163
msgid "B<--format> raw|qcow2|.."
msgstr ""

#. type: =item
#: customize/virt-customize.pod:119 drivers/virt-drivers.pod:180
#: get-kernel/virt-get-kernel.pod:90 sysprep/virt-sysprep.pod:165
msgid "B<--format> auto"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:121 sysprep/virt-sysprep.pod:167
msgid ""
"The default for the I<-a> option is to auto-detect the format of the disk "
"image.  Using this forces the disk format for I<-a> options which follow on "
"the command line.  Using I<--format auto> switches back to auto-detection "
"for subsequent I<-a> options."
msgstr ""

#. type: verbatim
#: customize/virt-customize.pod:128
#, no-wrap
msgid ""
" virt-customize --format raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: customize/virt-customize.pod:132
#, no-wrap
msgid ""
" virt-customize --format raw -a disk.img --format auto -a another.img\n"
"\n"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:171
msgid ""
"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-customize."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:192
msgid ""
"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</SECURITY> below)."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:207 sysprep/virt-sysprep.pod:236
msgid "Don’t print log messages."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:209 sysprep/virt-sysprep.pod:238
msgid "To enable detailed logging of individual file operations, use I<-x>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:245 sysprep/virt-sysprep.pod:558
msgid ""
"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."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:249 sysprep/virt-sysprep.pod:562
msgid "For further details, see L<virt-builder(1)/SELINUX>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:253 sysprep/virt-sysprep.pod:571
msgid "This program returns 0 on success, or 1 if there was an error."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:289 sparsify/virt-sparsify.pod:449
#: sysprep/virt-sysprep.pod:607
msgid "For other environment variables, see L<guestfs(3)/ENVIRONMENT VARIABLES>."
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:293
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-builder(1)>, L<virt-clone(1)>, "
"L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, "
"L<virt-sysprep(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)>, "
"L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>."
msgstr ""

#. type: =head1
#: customize/virt-customize.pod:308
#: docs/guestfs-tools-release-notes-1.48.pod:106
#: docs/guestfs-tools-release-notes-1.50.pod:164
#: docs/guestfs-tools-release-notes-1.52.pod:103
#: inspector/virt-inspector.pod:504 sysprep/virt-sysprep.pod:626
msgid "AUTHORS"
msgstr ""

#. type: textblock
#: customize/virt-customize.pod:314 sparsify/virt-sparsify.pod:481
#: sysprep/virt-sysprep.pod:634
msgid "Copyright (C) 2011-2023 Red Hat Inc."
msgstr ""

#. type: textblock
#: df/virt-df.pod:3
msgid "virt-df - Display free space on virtual filesystems"
msgstr ""

#. type: textblock
#: df/virt-df.pod:7
msgid "All guests:"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:9
#, no-wrap
msgid ""
" virt-df [--options]\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:11
msgid "Single guest:"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:13
#, no-wrap
msgid ""
" virt-df [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:15
#, no-wrap
msgid ""
" virt-df [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:19
#, no-wrap
msgid ""
" virt-df [--options] domname\n"
"\n"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:21
#, no-wrap
msgid ""
" virt-df [--options] disk.img [disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:25
msgid ""
"C<virt-df> 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."
msgstr ""

#. type: textblock
#: df/virt-df.pod:30
msgid ""
"If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
"to get a list of all active and inactive guests, and performs a C<df>-type "
"operation on each one in turn, printing out the results."
msgstr ""

#. type: textblock
#: df/virt-df.pod:34
msgid ""
"If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a "
"C<df>-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).  B<In this mode (with arguments), C<virt-df> will only work for a "
"single guest>.  If you want to run on multiple guests, then you have to "
"invoke C<virt-df> multiple times."
msgstr ""

#. type: textblock
#: df/virt-df.pod:41
msgid ""
"Use the I<--csv> option to get a format which can be easily parsed by other "
"programs.  Other options are similar to the standard L<df(1)> command."
msgstr ""

#. type: textblock
#: df/virt-df.pod:47
msgid ""
"Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
"output human-readable:"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:50
#, no-wrap
msgid ""
" # virt-df -d F14x64 -h\n"
" Filesystem                       Size     Used  Available  Use%\n"
" F14x64:/dev/sda1                 484M      66M       393M   14%\n"
" F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:55
msgid "Show disk usage for a disk image file called F<test.img>:"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:57
#, no-wrap
msgid ""
" $ virt-df -a test1.img\n"
" Filesystem                  1K-blocks     Used  Available  Use%\n"
" test1.img:/dev/sda1             99099     1551      92432    2%\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:61
msgid ""
"If a single guest has multiple disks, use the I<-a> option repeatedly.  A "
"plus sign (C<+>) is displayed for each additional disk.  B<Note: Do not do "
"this with unrelated guest disks.>"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:65
#, no-wrap
msgid ""
" $ virt-df -a Win7x32TwoDisks-a -a Win7x32TwoDisks-b \n"
" Filesystem                   1K-blocks    Used  Available  Use%\n"
" Win7x32TwoDisks-a+:/dev/sda1    102396   24712      77684   25%\n"
" Win7x32TwoDisks-a+:/dev/sda2  12478460 7403416    5075044   60%\n"
" Win7x32TwoDisks-a+:/dev/sdb1    521212   55728     465484   11%\n"
"\n"
msgstr ""

#. type: =item
#: df/virt-df.pod:79
msgid "B<-a> FILE"
msgstr ""

#. type: =item
#: df/virt-df.pod:81
msgid "B<--add> FILE"
msgstr ""

#. type: textblock
#: df/virt-df.pod:83
msgid ""
"Add C<FILE> 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 I<-a> options."
msgstr ""

#. type: verbatim
#: df/virt-df.pod:132
#, no-wrap
msgid ""
" virt-df --format=raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:136
#, no-wrap
msgid ""
" virt-df --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:149
msgid "Print sizes in human-readable format."
msgstr ""

#. type: textblock
#: df/virt-df.pod:151
msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
msgstr ""

#. type: =item
#: df/virt-df.pod:155
msgid "B<--inodes>"
msgstr ""

#. type: textblock
#: df/virt-df.pod:157
msgid "Print inodes instead of blocks."
msgstr ""

#. type: =item
#: df/virt-df.pod:159
msgid "B<--one-per-guest>"
msgstr ""

#. type: textblock
#: df/virt-df.pod:161
msgid ""
"Since libguestfs 1.22, this is the default.  This option does nothing and is "
"left here for backwards compatibility with older scripts."
msgstr ""

#. type: textblock
#: df/virt-df.pod:166
msgid ""
"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 C<nr_threads> by using the I<-P> option."
msgstr ""

#. type: textblock
#: df/virt-df.pod:181
msgid ""
"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."
msgstr ""

#. type: =head1
#: df/virt-df.pod:203
msgid "STATVFS NUMBERS"
msgstr ""

#. type: textblock
#: df/virt-df.pod:205
msgid ""
"C<virt-df> (and L<df(1)>) get information by issuing a L<statvfs(3)> system "
"call.  You can get the same information directly, either from the host "
"(using libguestfs) or inside the guest:"
msgstr ""

#. type: =item
#: df/virt-df.pod:211
msgid "From the host"
msgstr ""

#. type: textblock
#: df/virt-df.pod:213 df/virt-df.pod:221
msgid "Run this command:"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:215
#, no-wrap
msgid ""
" guestfish --ro -d GuestName -i statvfs /\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:217 df/virt-df.pod:225
msgid "(change F</> to see stats for other filesystems)."
msgstr ""

#. type: =item
#: df/virt-df.pod:219
msgid "From inside the guest"
msgstr ""

#. type: verbatim
#: df/virt-df.pod:223
#, no-wrap
msgid ""
" python -c 'import os; s = os.statvfs (\"/\"); print s'\n"
"\n"
msgstr ""

#. type: textblock
#: df/virt-df.pod:260
msgid ""
"L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-drivers(1)>, "
"L<virt-filesystems(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:3
msgid "virt-diff - Differences between files in two virtual machines"
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:7
#, no-wrap
msgid ""
" virt-diff [--options] -d domain1 -D domain2\n"
"\n"
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:9
#, no-wrap
msgid ""
" virt-diff [--options] -a disk1.img [-a ...] -A disk2.img [-A ...]\n"
"\n"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:13
msgid ""
"C<virt-diff> 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."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:19
msgid ""
"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 B<does not> 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."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:25
msgid ""
"To specify two guests, you have to use the I<-a> or I<-d> option(s)  for the "
"first guest, and the I<-A> or I<-D> option(s) for the second guest.  The "
"common case is:"
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:29
#, no-wrap
msgid ""
" virt-diff -a old.img -A new.img\n"
"\n"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:31
msgid "or using names known to libvirt:"
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:33
#, no-wrap
msgid ""
" virt-diff -d oldguest -D newguest\n"
"\n"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:47
msgid ""
"Add I<file> 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 I<-a> options."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:62
msgid "Same as I<--extra-stats> I<--times> I<--uids> I<--xattrs>."
msgstr ""

#. type: =item
#: diff/virt-diff.pod:64
msgid "B<--atime>"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:66
msgid ""
"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."
msgstr ""

#. type: =item
#: diff/virt-diff.pod:70
msgid "B<-A> file"
msgstr ""

#. type: =item
#: diff/virt-diff.pod:72
msgid "B<-A> URI"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:74
msgid "Add a disk image from the second virtual machine."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:82
msgid ""
"Use a checksum over file contents to detect when regular files have changed "
"content."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:85
msgid ""
"With no argument, this defaults to using I<md5>.  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."
msgstr ""

#. type: =item
#: diff/virt-diff.pod:105
msgid "B<--dir-links>"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:107
msgid ""
"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."
msgstr ""

#. type: =item
#: diff/virt-diff.pod:111
msgid "B<--dir-times>"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:113
msgid ""
"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."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:121
msgid ""
"Add all the disks from the named libvirt guest, as the first guest.  Domain "
"UUIDs can be used instead of names."
msgstr ""

#. type: =item
#: diff/virt-diff.pod:124
msgid "B<-D> guest"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:126
msgid ""
"Add all the disks from the named libvirt guest, as the second guest.  Domain "
"UUIDs can be used instead of names."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:131
msgid ""
"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."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:144
msgid ""
"The default for the I<-a>/I<-A> option is to auto-detect the format of the "
"disk image.  Using this forces the disk format for I<-a>/I<-A> options which "
"follow on the command line.  Using I<--format> with no argument switches "
"back to auto-detection for subsequent I<-a>/I<-A> options."
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:152
#, no-wrap
msgid ""
" virt-diff --format=raw -a disk.img [...]\n"
"\n"
msgstr ""

#. type: verbatim
#: diff/virt-diff.pod:156
#, no-wrap
msgid ""
" virt-diff --format=raw -a disk.img --format -a another.img [...]\n"
"\n"
msgstr ""

#. type: =item
#: diff/virt-diff.pod:214
msgid "B<--xattrs>"
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:216
msgid "Display extended attributes."
msgstr ""

#. type: textblock
#: diff/virt-diff.pod:251
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, "
"L<virt-ls(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:3
#: docs/guestfs-tools-release-notes-1.50.pod:3
#: docs/guestfs-tools-release-notes-1.52.pod:3
msgid "guestfs-tools-release-notes - guestfs tools release Notes"
msgstr ""

#. type: =head1
#: docs/guestfs-tools-release-notes-1.48.pod:5
msgid "RELEASE NOTES FOR GUESTFS TOOLS 1.48"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:7
msgid ""
"These are the release notes for guestfs tools stable release 1.48.  This "
"describes the major changes since 1.46."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:10
msgid "Guestfs tools 1.48.0 was released on B<14 March 2022>."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:12
#: docs/guestfs-tools-release-notes-1.52.pod:25
msgid "virt-builder"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:14
msgid ""
"New templates: C<alma-8.5>, C<centosstream-8>, C<debian-11>, C<fedora-34>, "
"C<fedora-34> (armv7l), C<fedora-35> C<fedora-35> (aarch64)  (Lars Kaiser, "
"Stef Walter)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:19
msgid "New fedora-34 (armv7l) template is built to use UEFI."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:21
#: docs/guestfs-tools-release-notes-1.50.pod:53
#: docs/guestfs-tools-release-notes-1.52.pod:34
msgid "virt-customize"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:23
msgid "The yescrypt password hashing method is now supported (Björn Esser)."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:26
#: docs/guestfs-tools-release-notes-1.50.pod:67
msgid "virt-inspector"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:28
msgid ""
"Recognise C<kalilinux>, C<kylin> and C<msdos> operating systems / Linux "
"distros (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:31
msgid ""
"Inspection of LUKS encrypted filesystems placed directly on logical volumes "
"is now supported, but you will need libguestfs E<ge> 1.48 (Laszlo Ersek)."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:35
#: docs/guestfs-tools-release-notes-1.50.pod:72
msgid "virt-sysprep"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:37
msgid ""
"Add a new default operation called C<net-nmconn> which removes "
"NetworkManager connection profiles (Laszlo Ersek)."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:40
msgid "virt-win-reg"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:42
msgid ""
"C<virt-win-reg --version> now prints both the version of guestfs tools and "
"the libguestfs library that it is linked with."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:45
#: docs/guestfs-tools-release-notes-1.50.pod:81
#: docs/guestfs-tools-release-notes-1.52.pod:52
msgid "Common changes"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:47
msgid ""
"All OCaml tools now suppress line wrapping when output is redirected to a "
"file (to make it easier to parse logs with external programs).  There is a "
"new I<--wrap> option which can be used to reenable line wrapping to files if "
"needed (Laszlo Ersek)."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:52
#: docs/guestfs-tools-release-notes-1.50.pod:87
#: docs/guestfs-tools-release-notes-1.52.pod:60
msgid "Build changes"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:54
msgid ""
"Multiple fixes to make it easier to build against either the system "
"installed libguestfs or a locally built libguestfs (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:57
msgid ""
"Fix multiple OCaml warnings.  Remove some deprecated OCaml features.  We now "
"require OCaml E<ge> 4.04."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:60
msgid ""
"Multiple fixes to valgrind support for glibc 2.35, OCaml 4.13 and libvirt "
"7.7.  C<make check-valgrind> should now work."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:63
#: docs/guestfs-tools-release-notes-1.50.pod:108
#: docs/guestfs-tools-release-notes-1.52.pod:68
msgid "Internals"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:65
msgid ""
"New OCaml C<On_exit> module (from libguestfs-common) is used instead of "
"custom on-exit and signal handling."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.48.pod:68
#: docs/guestfs-tools-release-notes-1.50.pod:112
#: docs/guestfs-tools-release-notes-1.52.pod:73
msgid "Bugs fixed"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:72
msgid "L<https://bugzilla.redhat.com/2003706>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:74
msgid ""
"virt-install armv7 guest on aarch64 host doesn't work, no LPAE support and "
"no PCI devices"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:76
msgid "L<https://bugzilla.redhat.com/1995391>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:78
msgid ""
"RFE: virt-inspector fails to detect the distro and applications on "
"Kylin-Desktop-V10 image"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:80
msgid "L<https://bugzilla.redhat.com/1980922>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:82
msgid "virt-sysprep doesn't cleanup NetworkManager connection files"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:84
msgid "L<https://bugzilla.redhat.com/1961160>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:86
msgid "The version is incorrect when running 'virt-win-reg --version'"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:88
msgid "L<https://bugzilla.redhat.com/1820221>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:90
msgid "Log lines wrapping make log parsing difficult"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:92
msgid "L<https://bugzilla.redhat.com/1658126>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:94
msgid "Virt-v2v can't convert guest using LUKS-on-LV"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:96
msgid "L<https://bugzilla.redhat.com/1633328>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:98
msgid "Armv7 guest fails to boot with qemu-3.0.0-1"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:104
#: docs/guestfs-tools-release-notes-1.50.pod:162
#: docs/guestfs-tools-release-notes-1.52.pod:101
msgid "L<http://libguestfs.org/>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.48.pod:110
msgid "git shortlog -s v1.46.0.."
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:116
msgid "Björn Esser"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:118
msgid "Lars Kaiser"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:120
#: docs/guestfs-tools-release-notes-1.50.pod:174
#: docs/guestfs-tools-release-notes-1.52.pod:115
msgid "Laszlo Ersek"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:122
#: docs/guestfs-tools-release-notes-1.50.pod:176
#: docs/guestfs-tools-release-notes-1.52.pod:117
msgid "Richard W.M. Jones"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.48.pod:124
msgid "Stef Walter"
msgstr ""

#. type: =head1
#: docs/guestfs-tools-release-notes-1.50.pod:5
msgid "RELEASE NOTES FOR GUESTFS TOOLS 1.50"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:7
msgid ""
"These are the release notes for guestfs tools stable release 1.50.  This "
"describes the major changes since 1.48."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:10
msgid "Guestfs tools 1.50.0 was released on B<7 February 2023>."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.50.pod:12
#: docs/guestfs-tools-release-notes-1.52.pod:14
msgid "Security"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:16
msgid "CVE-2022-2211"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:18
msgid "L<https://bugzilla.redhat.com/show_bug.cgi?id=2100862>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:20
msgid ""
"A buffer overflow was found in the I<--key> option of several guestfs "
"tools.  For more information on this low severity bug see the bug report "
"above (Laszlo Ersek)."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.50.pod:26
msgid "New virt-drivers tool"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:28
msgid "This new tool can examine a disk image to determine:"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:34
msgid "Whether it uses BIOS or UEFI for booting"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:38
msgid "What bootloader it uses (Linux only)"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:42
msgid "What kernels may be chosen at boot time (Linux only)"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:46
msgid "What device drivers (kernel modules) are installed"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:50
msgid ""
"This is useful for determining how (or if) a guest can boot on a "
"virtualization hypervisor."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:55
msgid ""
"I<--selinux-relabel> is now the default for SELinux guests.  You no longer "
"need to specify this flag.  In the rare case where you don't want to relabel "
"a guest after customizing it, you can use I<--no-selinux-relabel>.  Note "
"this is not needed for non-SELinux guests, it will do the right thing "
"automatically (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:61
msgid ""
"New I<--inject-qemu-ga> and I<--inject-virtio-win> operations which "
"respectively inject QEMU Guest Agent and virtio-win drivers into Windows "
"guests."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:65
msgid "Rocky Linux guests are now supported (thanks Harry Benson)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:69
msgid ""
"Virt-inspector now outputs the new E<lt>build_idE<gt> element containing the "
"guest build ID, if using libguestfs E<ge> 1.50."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:74
msgid ""
"New C<lvm-system-devices> operation for removing LVM2's F<system.devices> "
"file.  This avoids certain problems when cloning a VM (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:78
msgid ""
"Virt-sysprep supports guests using LUKS logical volumes on top of LVM "
"(Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:83
msgid ""
"All the tools supporting the I<--key> option can now use Clevis/Tang to "
"decrypt full disk encryption using this network-based scheme (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:89
msgid ""
"B<Note> that libguestfs now requires minimum OCaml 4.04.  It will not "
"compile on RHEL 6."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:92
msgid "B<Note> that libosinfo is a new required dependency."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:94
msgid "OCaml 4.14 is now supported."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:96
msgid ""
"C<./configure --disable-ocaml> and C<./configure --disable-perl> now disable "
"the OCaml- and Perl-based tools respectively (thanks Simon Walter)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:100
msgid "Experimental support for compiling on macOS."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:102
msgid ""
"When running C<make check-valgrind>, Valgrind logs are no longer written to "
"separate files under F<tmp/>.  Instead the output is written to the normal "
"F<I<test-name>.log> file."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:116
msgid "https_proxy= ./bugs-in-changelog.sh v1.48.0.."
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:122
msgid "L<https://bugzilla.redhat.com/2133443>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:124
msgid "RFE: Support Rocky Linux in virt-customize"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:126
msgid "L<https://bugzilla.redhat.com/2106286>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:128
msgid "virt-sysprep: make an effort to support LUKS on LV"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:130
msgid "L<https://bugzilla.redhat.com/2089748>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:132
msgid "Removal of \"--selinux-relabel\" option breaks existing scripts"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:134
msgid "L<https://bugzilla.redhat.com/2075718>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:136
msgid ""
"Having to use \"--selinux-relabel\" is not intuitive given Red Hat products "
"default to selinux enabled."
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:138
msgid "L<https://bugzilla.redhat.com/2072493>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:140
msgid "[RFE] Request to add lvm system.devices cleanup operation to virt-sysprep"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:142
msgid "L<https://bugzilla.redhat.com/2059545>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:144
msgid ""
"[RHEL 9.0][Nutanix] lvm partition \"home\" will lost with SCSI disk either "
"in the new cloned VM or restored from a snapshot"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:146
msgid "L<https://bugzilla.redhat.com/2028764>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:148
msgid "Install the qemu-guest-agent package during the conversion process"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:150
msgid "L<https://bugzilla.redhat.com/1809453>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:152
msgid "[RFE] Add support for LUKS encrypted disks with Clevis & Tang"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.50.pod:154
msgid "L<https://bugzilla.redhat.com/1554735>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:156
msgid ""
"RFE: customize --selinux-relabel should be the default, with "
"--no-selinux-relabel used to opt out"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.50.pod:168
msgid "git shortlog -s v1.48.0.."
msgstr ""

#. type: =head1
#: docs/guestfs-tools-release-notes-1.52.pod:5
msgid "RELEASE NOTES FOR GUESTFS TOOLS 1.52"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:7
msgid ""
"These are the release notes for guestfs tools stable release 1.52.  This "
"describes the major changes since 1.50."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:10
msgid "Guestfs tools 1.52.0 was released on B<5 January 2024>."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.52.pod:18
msgid "virt-dib was removed"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:20
msgid ""
"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>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:27
msgid ""
"L<virt-builder(1)> now prints better error messages when a specific URL "
"cannot be downloaded."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.52.pod:30
msgid "virt-builder-repository"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:32
msgid "Fix GPG repository signing (thanks Allard Berends)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:36
msgid ""
"New L<virt-customize(1)> I<--chown> and I<--tar-in> options.  (Also "
"available in virt-builder and virt-sysprep.)"
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.52.pod:39
msgid "virt-diff"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:41
msgid ""
"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."
msgstr ""

#. type: =head2
#: docs/guestfs-tools-release-notes-1.52.pod:46
msgid "virt-drivers"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:48
msgid ""
"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."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:54
msgid ""
"The common I<--key> option now recognizes LVM names like "
"F</dev/mapper/rhel_bootp--73--75--123-root> (Laszlo Ersek)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:57
msgid ""
"The I<--key> option also supports a new S<I<--key all:...>> selector to try "
"the same key on all devices."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:62
msgid ""
"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)."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:66
msgid "Fix compatibility issues with libxml2 2.12."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:70
msgid ""
"Fix an off-by-one error which caused very rare crashes in some of the virt "
"tools."
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:77
msgid "https_proxy= ./bugs-in-changelog.sh v1.50.0.."
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.52.pod:83
msgid "L<https://bugzilla.redhat.com/2175703>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:85
msgid ""
"virt-v2v failed to inspect RHEL9.2 guest due to kernel-core / "
"kernel-modules-core subpackage split"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.52.pod:88
msgid "L<https://bugzilla.redhat.com/2168506>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:90
msgid ""
"RFE: Virt-v2v should recognize partition names like '/dev/mapper/rhel "
"boot--73--75--123-root' in related keys option"
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.52.pod:93
msgid "L<https://bugzilla.redhat.com/1910039>"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:95
msgid "virt-dib doesn't work with newer diskimage-builder version on RHEL8"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:107
msgid "git shortlog -s v1.50.0.."
msgstr ""

#. type: =item
#: docs/guestfs-tools-release-notes-1.52.pod:113
msgid "Jürgen Hötzel"
msgstr ""

#. type: textblock
#: docs/guestfs-tools-release-notes-1.52.pod:123
msgid "Copyright (C) 2009-2024 Red Hat Inc."
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:3
msgid "virt-drivers - Detect bootloader, kernel and drivers inside guest"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:7
#, no-wrap
msgid ""
" virt-drivers [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:9
#, no-wrap
msgid ""
" virt-drivers [--options] -a disk.img\n"
"\n"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:13
msgid ""
"This tool can detect the bootloader, kernel and drivers inside some guests "
"from only the disk image.  It can detect, for example, whether a disk image "
"needs BIOS or UEFI to boot, and whether it supports virtio or requires "
"slower emulated devices."
msgstr ""

#. type: =head2
#: drivers/virt-drivers.pod:18
msgid "Notes"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:20
msgid ""
"Normally you should distribute hypervisor metadata (eg. libvirt XML or OVF) "
"alongside disk images to tell the hypervisor how to boot them.  This tool is "
"used when this metadata has not been provided.  Work with the supplier of "
"the disk image to get them to provide proper metadata."
msgstr ""

#. type: =head1
#: drivers/virt-drivers.pod:25 inspector/virt-inspector.pod:181
msgid "XML FORMAT"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:27
msgid ""
"The output is an XML document.  At the top level it lists the operating "
"systems found (the same as L<virt-inspector(1)>):"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:30
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     <root>/dev/sda2</root>\n"
"     <name>linux</name>\n"
"     <arch>x86_64</arch>\n"
"     <distro>fedora</distro>\n"
"     ...\n"
"   </operatingsystem>\n"
"   <operatingsystem>\n"
"     <root>/dev/sdb1</root>\n"
"     ...\n"
"   </operatingsystem>\n"
" </operatingsystems>\n"
"\n"
msgstr ""

#. type: =head2
#: drivers/virt-drivers.pod:44
msgid "E<lt>firmwareE<gt>"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:46
msgid ""
"The E<lt>firmwareE<gt> element lists the firmware which is required to boot "
"the guest.  For UEFI it will additionally show the EFI system partition "
"(\"ESP\").  Guests may support multiple boot firmwares.  For example this "
"guest is detected as using UEFI boot, and the UEFI ESP is the first "
"partition of the first disk:"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:52
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <firmware type='uefi'>/dev/sda1</firmware>\n"
"   <operatingsystem>\n"
"     ...\n"
"\n"
msgstr ""

#. type: =head2
#: drivers/virt-drivers.pod:57
msgid "E<lt>bootloaderE<gt> and E<lt>kernelE<gt>"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:59
msgid ""
"The E<lt>bootloaderE<gt> element shows the bootloader found in the Linux "
"guest.  If known, this may contain information about what Linux kernels are "
"provided.  For example:"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:63
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <firmware type='bios'/>\n"
"   <operatingsystem>\n"
"     <root>/dev/sda2</root>\n"
"     <name>linux</name>\n"
"     ...\n"
"     <bootloader type='grub2' config='/boot/grub2/grub.cfg'>\n"
"       <kernel>\n"
"         <name>kernel</name>\n"
"         <version>6.1.0-0.rc6.46.fc38.x86_64</version>\n"
"         <vmlinuz>/boot/vmlinuz-6.1.0-0.rc6.46.fc38.x86_64</vmlinuz>\n"
"         <modules>\n"
"           ...\n"
"         </modules>\n"
"         <supports_virtio_blk/>\n"
"         <supports_virtio_net/>\n"
"         ...\n"
"       </kernel>\n"
"     </bootloader>\n"
"\n"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:83
msgid ""
"Many more fields are usually available for Linux guests, including a "
"complete list of kernel modules and information about support for virtio.  "
"For a complete example see: "
"L<https://github.com/libguestfs/guestfs-tools/tree/master/drivers>"
msgstr ""

#. type: =head2
#: drivers/virt-drivers.pod:88
msgid "E<lt>driversE<gt>"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:90
msgid ""
"The E<lt>driversE<gt> element lists information about drivers found in "
"Windows guests:"
msgstr ""

#. type: verbatim
#: drivers/virt-drivers.pod:93
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <firmware type='bios'/>\n"
"   <operatingsystem>\n"
"     <root>/dev/sda2</root>\n"
"     <name>windows</name>\n"
"     ...\n"
"     <drivers>\n"
"       <driver>\n"
"         <name>scsidev</name>\n"
"         <pci vendor='1077' device='1216' subsystem='8471101E'/>\n"
"         <pci vendor='1077' device='1216' subsystem='8493101E'/>\n"
"       </driver>\n"
"       ...\n"
"     </drivers>\n"
"\n"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:108
msgid ""
"The driver name (eg. C<scsidev>) corresponds to the Windows driver F<.INF> "
"file (eg. F<scsidev.inf>).  The list of PCI, USB etc devices are the "
"matching devices which would cause this driver to load at boot."
msgstr ""

#. type: =item
#: drivers/virt-drivers.pod:137 get-kernel/virt-get-kernel.pod:47
msgid "B<--blocksize> B<512>"
msgstr ""

#. type: =item
#: drivers/virt-drivers.pod:139 get-kernel/virt-get-kernel.pod:49
msgid "B<--blocksize> B<4096>"
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:141 get-kernel/virt-get-kernel.pod:51
msgid ""
"This parameter sets the sector size of the disk image added with I<-a> "
"option and is ignored for libvirt guest added with I<-d> option.  See also "
"L<guestfs(3)/guestfs_add_drive_opts>."
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:173 get-kernel/virt-get-kernel.pod:83
msgid ""
"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."
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:182 get-kernel/virt-get-kernel.pod:92
msgid ""
"The default for the I<-a> option is to auto-detect the format of the disk "
"image.  Using this forces the disk format for the I<-a> option on the "
"command line."
msgstr ""

#. type: textblock
#: drivers/virt-drivers.pod:236
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-get-kernel(1)>, "
"L<virt-inspector(1)>, L<virt-v2v(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:3
msgid "virt-edit - Edit a file in a virtual machine"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:7
#, no-wrap
msgid ""
" virt-edit [--options] -d domname file [file ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:9
#, no-wrap
msgid ""
" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:11
#, no-wrap
msgid ""
" virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:15
#, no-wrap
msgid ""
" virt-edit domname file\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:17 edit/virt-edit.pod:220
#, no-wrap
msgid ""
" virt-edit disk.img [disk.img ...] file\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:21
msgid ""
"C<virt-edit> is a command line tool to edit C<file> where each C<file> "
"exists in the named virtual machine (or disk image)."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:24
msgid ""
"Multiple filenames can be given, in which case they are each edited in "
"turn.  Each filename must be a full path, starting at the root directory "
"(starting with '/')."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:28
msgid "If you want to just view a file, use L<virt-cat(1)>."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:30
msgid ""
"For more complex cases you should look at the L<guestfish(1)> tool (see "
"L</USING GUESTFISH> below)."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:33
msgid ""
"C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
"that and much more."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:38
msgid "Edit the named files interactively:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:40
#, no-wrap
msgid ""
" virt-edit -d mydomain /boot/grub/grub.conf\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:42
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/passwd\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:44
msgid "For Windows guests, some Windows paths are understood:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:46
#, no-wrap
msgid ""
" virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:48
msgid ""
"If Perl is installed, you can also edit files non-interactively (see "
"L</NON-INTERACTIVE EDITING> below).  To change the init default level to 5:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:52
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
"\n"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:79
msgid "B<-b> EXTENSION"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:81
msgid "B<--backup> EXTENSION"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:83
msgid ""
"Create a backup of the original file I<in the guest disk image>.  The backup "
"has the original filename with C<extension> added."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:86
msgid ""
"Usually the first character of C<extension> would be a dot C<.> so you would "
"write:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:89
#, no-wrap
msgid ""
" virt-edit -b .orig [etc]\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:91
msgid "By default, no backup file is made."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:102 win-reg/virt-win-reg.in:132
msgid ""
"If you specify guest block devices directly, then libvirt is not used at "
"all."
msgstr ""

#. type: =item
#: edit/virt-edit.pod:105
msgid "B<-d> GUEST"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:107
msgid "B<--domain> GUEST"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:114
msgid ""
"When prompting for keys and passphrases, virt-edit 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."
msgstr ""

#. type: =item
#: edit/virt-edit.pod:119
msgid "B<-e> EXPR"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:121
msgid "B<--edit> EXPR"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:123
msgid "B<--expr> EXPR"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:125
msgid ""
"Instead of launching the external editor, non-interactively apply the Perl "
"expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
"EDITING> below."
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:145
#, no-wrap
msgid ""
" virt-edit --format=raw -a disk.img file\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:149
#, no-wrap
msgid ""
" virt-edit --format=raw -a disk.img --format -a another.img file\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:218
msgid "Previous versions of virt-edit allowed you to write either:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:224
#, no-wrap
msgid ""
" virt-edit guestname file\n"
"\n"
msgstr ""

#. type: =head1
#: edit/virt-edit.pod:232
msgid "NON-INTERACTIVE EDITING"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:234
msgid ""
"C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
"administrator can interactively edit the file."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:237
msgid ""
"There are two ways also to use C<virt-edit> from scripts in order to make "
"automated edits to files.  (Note that although you I<can> use C<virt-edit> "
"like this, it’s less error-prone to write scripts directly using the "
"libguestfs API and Augeas for configuration file editing.)"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:243
msgid ""
"The first method is to temporarily set C<$EDITOR> to any script or program "
"you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
"update C<tmpfile> in place however it likes."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:247
msgid ""
"The second method is to use the I<-e> parameter of C<virt-edit> to run a "
"short Perl snippet in the style of L<sed(1)>.  For example to replace all "
"instances of C<foo> with C<bar> in a file:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:251
#, no-wrap
msgid ""
" virt-edit -d domname filename -e 's/foo/bar/'\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:253
msgid ""
"The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
"For example to delete root’s password you could do:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:256
#, no-wrap
msgid ""
" virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:258
msgid ""
"What really happens is that the snippet is evaluated as a Perl expression "
"for each line of the file.  The line, including the final C<\\n>, is passed "
"in C<$_> and the expression should update C<$_> or leave it unchanged."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:263
msgid ""
"To delete a line, set C<$_> to the empty string.  For example, to delete the "
"C<apache> user account from the password file you can do:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:266
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:268
msgid ""
"To insert a line, prepend or append it to C<$_>.  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 C<$EDITOR>) if you "
"want to do this."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:274
msgid ""
"The variable C<$lineno> contains the current line number.  As is "
"traditional, the first line in the file is number C<1>."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:277
msgid ""
"The return value from the expression is ignored, but the expression may call "
"C<die> in order to abort the whole program, leaving the original file "
"untouched."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:281
msgid ""
"Remember when matching the end of a line that C<$_> may contain the final "
"C<\\n>, or (for DOS files) C<\\r\\n>, 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:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:286
#, no-wrap
msgid ""
" /some text(\\r?\\n)?$/\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:288
msgid ""
"Alternately, use the perl C<chomp> function, being careful not to chomp "
"C<$_> itself (since that would remove all newlines from the file):"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:292
#, no-wrap
msgid ""
" my $m = $_; chomp $m; $m =~ /some text$/\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:296
msgid ""
"C<virt-edit> has a limited ability to understand Windows drive letters and "
"paths (eg. F<E:\\foo\\bar.txt>)."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:315
msgid ""
"The path is resolved case insensitively to locate the file that should be "
"edited."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:336
msgid ""
"L<guestfish(1)> is a more powerful, lower level tool which you can use when "
"C<virt-edit> doesn't work."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:339
msgid "Using C<virt-edit> is approximately equivalent to doing:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:341
#, no-wrap
msgid ""
" guestfish --rw -i -d domname edit /file\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:343
msgid ""
"where C<domname> is the name of the libvirt guest, and F</file> is the full "
"path to the file."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:346
msgid ""
"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 edit a file on a disk image "
"directly, use:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:351
#, no-wrap
msgid ""
" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
"\n"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:353
msgid ""
"where F<disk.img> is the disk image, F</dev/sda1> is the filesystem within "
"the disk image to edit, and F</file> is the full path to the file."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:357
msgid ""
"C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
"C<write> or C<upload> instead:"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:360
#, no-wrap
msgid ""
" guestfish --rw -i -d domname touch /newfile\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:362
#, no-wrap
msgid ""
" guestfish --rw -i -d domname write /newfile \"new content\"\n"
"\n"
msgstr ""

#. type: verbatim
#: edit/virt-edit.pod:364
#, no-wrap
msgid ""
" guestfish --rw -i -d domname upload localfile /newfile\n"
"\n"
msgstr ""

#. type: =item
#: edit/virt-edit.pod:370
msgid "C<EDITOR>"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:372
msgid ""
"If set, this string is used as the editor.  It may contain arguments, "
"eg. C<\"emacs -nw\">"
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:375
msgid "If not set, C<vi> is used."
msgstr ""

#. type: textblock
#: edit/virt-edit.pod:386
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, "
"L<virt-tar-in(1)>, L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
msgstr ""

#. type: textblock
#: format/virt-format.pod:3
msgid "virt-format - Erase and make a blank disk"
msgstr ""

#. type: verbatim
#: format/virt-format.pod:7
#, no-wrap
msgid ""
" virt-format [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: format/virt-format.pod:11
msgid ""
"Virt-format takes an existing disk file (or it can be a host partition, LV "
"etc), B<erases all data on it>, and formats it as a blank disk.  It can "
"optionally create partition tables, empty filesystems, logical volumes and "
"more."
msgstr ""

#. type: textblock
#: format/virt-format.pod:16
msgid ""
"To create a disk containing data, you may be better to use "
"L<virt-make-fs(1)>.  If you are creating a blank disk to use in "
"L<guestfish(1)>, you should instead use the guestfish I<-N> option."
msgstr ""

#. type: textblock
#: format/virt-format.pod:20
msgid "Normal usage would be something like this:"
msgstr ""

#. type: verbatim
#: format/virt-format.pod:22
#, no-wrap
msgid ""
" virt-format -a disk.qcow\n"
"\n"
msgstr ""

#. type: textblock
#: format/virt-format.pod:24
msgid "or this:"
msgstr ""

#. type: verbatim
#: format/virt-format.pod:26
#, no-wrap
msgid ""
" virt-format -a /dev/VG/LV\n"
"\n"
msgstr ""

#. type: textblock
#: format/virt-format.pod:28
msgid ""
"F<disk.qcow> or F</dev/VG/LV> must exist already.  B<Any data on these disks "
"will be erased by these commands>.  These commands will create a single "
"empty partition covering the whole disk, with no filesystem inside it."
msgstr ""

#. type: textblock
#: format/virt-format.pod:33
msgid ""
"Additional parameters can be used to control the creation of partitions, "
"filesystems, etc.  The most commonly used options are:"
msgstr ""

#. type: =item
#: format/virt-format.pod:38
msgid "B<--filesystem=[ext3|ntfs|vfat|...]>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:40
msgid "Create an empty filesystem (C<ext3>, C<ntfs> etc) inside the partition."
msgstr ""

#. type: =item
#: format/virt-format.pod:42
msgid "B<--lvm[=/dev/VG/LV]>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:44
msgid ""
"Create a Linux LVM2 logical volume on the disk.  When used with "
"I<--filesystem>, the filesystem is created inside the LV."
msgstr ""

#. type: textblock
#: format/virt-format.pod:49
msgid "For more information about these and other options, see L</OPTIONS> below."
msgstr ""

#. type: textblock
#: format/virt-format.pod:52
msgid ""
"The format of the disk is normally auto-detected, but you can also force it "
"by using the I<--format> 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."
msgstr ""

#. type: textblock
#: format/virt-format.pod:69
msgid "Add I<file>, a disk image, host partition, LV, external USB disk, etc."
msgstr ""

#. type: textblock
#: format/virt-format.pod:74
msgid "B<Any existing data on the disk is erased.>"
msgstr ""

#. type: =item
#: format/virt-format.pod:84
msgid "B<--filesystem=ext3|ntfs|vfat|...>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:86
msgid ""
"Create an empty filesystem of the specified type.  Many filesystem types are "
"supported by libguestfs."
msgstr ""

#. type: =item
#: format/virt-format.pod:89
msgid "B<--filesystem=none>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:91
msgid "Create no filesystem.  This is the default."
msgstr ""

#. type: verbatim
#: format/virt-format.pod:104
#, no-wrap
msgid ""
" virt-format --format=raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: format/virt-format.pod:108
#, no-wrap
msgid ""
" virt-format --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""

#. type: =item
#: format/virt-format.pod:117 make-fs/virt-make-fs.pod:191
msgid "B<--label=>LABEL"
msgstr ""

#. type: textblock
#: format/virt-format.pod:119 make-fs/virt-make-fs.pod:193
msgid "Set the filesystem label."
msgstr ""

#. type: =item
#: format/virt-format.pod:121
msgid "B<--lvm=/dev/I<VG>/I<LV>>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:123
msgid ""
"Create a Linux LVM2 logical volume called F</dev/I<VG>/I<LV>>.  You can "
"change the name of the volume group and logical volume."
msgstr ""

#. type: =item
#: format/virt-format.pod:126
msgid "B<--lvm>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:128
msgid "Create a Linux LVM2 logical volume with the default name (F</dev/VG/LV>)."
msgstr ""

#. type: =item
#: format/virt-format.pod:131
msgid "B<--lvm=none>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:133
msgid "Create no logical volume.  This is the default."
msgstr ""

#. type: =item
#: format/virt-format.pod:135 make-fs/virt-make-fs.pod:195
msgid "B<--partition>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:137
msgid ""
"Create either an MBR or GPT partition covering the whole disk.  MBR is "
"chosen if the disk size is E<lt> 2 TB, GPT if E<ge> 2 TB."
msgstr ""

#. type: =item
#: format/virt-format.pod:142
msgid "B<--partition=gpt>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:144
msgid "Create a GPT partition."
msgstr ""

#. type: =item
#: format/virt-format.pod:146
msgid "B<--partition=mbr>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:148
msgid "Create an MBR partition."
msgstr ""

#. type: =item
#: format/virt-format.pod:150
msgid "B<--partition=none>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:152
msgid ""
"Create no partition table.  Note that Windows may not be able to see these "
"disks."
msgstr ""

#. type: =item
#: format/virt-format.pod:167
msgid "B<--wipe>"
msgstr ""

#. type: textblock
#: format/virt-format.pod:169
msgid ""
"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."
msgstr ""

#. type: textblock
#: format/virt-format.pod:174
msgid ""
"If you use this option, virt-format writes zeroes over the whole disk so "
"that previous data is not recoverable."
msgstr ""

#. type: textblock
#: format/virt-format.pod:185
msgid "This program returns C<0> on success, or C<1> on failure."
msgstr ""

#. type: textblock
#: format/virt-format.pod:189
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-make-fs(1)>, "
"L<virt-rescue(1)>, L<virt-resize(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: format/virt-format.pod:203
msgid "Copyright (C) 2012 Red Hat Inc."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:3
msgid "virt-get-kernel - Extract kernel and ramdisk from guests"
msgstr ""

#. type: verbatim
#: get-kernel/virt-get-kernel.pod:7
#, no-wrap
msgid ""
" virt-get-kernel [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: get-kernel/virt-get-kernel.pod:9
#, no-wrap
msgid ""
" virt-get-kernel [--options] -a disk.img\n"
"\n"
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:13
msgid "This program extracts the kernel and initramfs from a guest."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:18
msgid ""
"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 L<guestfish(1)>.  To extract the entire C</boot> directory "
"of a guest, see L<virt-copy-out(1)>."
msgstr ""

#. type: =item
#: get-kernel/virt-get-kernel.pod:112
msgid "B<-o> directory"
msgstr ""

#. type: =item
#: get-kernel/virt-get-kernel.pod:114
msgid "B<--output> directory"
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:116
msgid ""
"This option specifies the output directory where kernel and initramfs from "
"the guest are written."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:119
msgid "If not specified, the default output is the current directory."
msgstr ""

#. type: =item
#: get-kernel/virt-get-kernel.pod:121
msgid "B<--prefix> prefix"
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:123
msgid "This option specifies a prefix for the extracted files."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:125
msgid ""
"If a prefix is specified, then there will be a dash (C<->) after the prefix "
"and before the rest of the file name; for example, a kernel in the guest "
"like C<vmlinuz-3.19.0-20-generic> is saved as "
"C<mydistro-vmlinuz-3.19.0-20-generic> when the prefix is C<mydistro>."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:130
msgid "See also I<--unversioned-names>."
msgstr ""

#. type: =item
#: get-kernel/virt-get-kernel.pod:138
msgid "B<--unversioned-names>"
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:140
msgid "This option affects the destination file name of extracted files."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:142
msgid ""
"If enabled, files will be saved locally just with the base name; for "
"example, kernel and ramdisk in the guest like C<vmlinuz-3.19.0-20-generic> "
"and C<initrd.img-3.19.0-20-generic> are saved respectively as C<vmlinuz> and "
"C<initrd.img>."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:147
msgid "See also I<--prefix>."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:175
msgid ""
"The I<--machine-readable> option can be used to make the output more machine "
"friendly, which is useful when calling virt-get-kernel from other programs, "
"GUIs etc."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:179
msgid ""
"Use the option on its own to query the capabilities of the virt-get-kernel "
"binary.  Typical output looks like this:"
msgstr ""

#. type: verbatim
#: get-kernel/virt-get-kernel.pod:182
#, no-wrap
msgid ""
" $ virt-get-kernel --machine-readable\n"
" virt-get-kernel\n"
"\n"
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:203
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-copy-out(1)>, "
"L<virt-drivers(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: get-kernel/virt-get-kernel.pod:216
msgid "Copyright (C) 2013-2023 Red Hat Inc."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:3
msgid ""
"virt-inspector - Display operating system version and other information "
"about a virtual machine"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:7
#, no-wrap
msgid ""
" virt-inspector [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:9
#, no-wrap
msgid ""
" virt-inspector [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:13
#, no-wrap
msgid ""
" virt-inspector domname\n"
"\n"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:15 inspector/virt-inspector.pod:169
#, no-wrap
msgid ""
" virt-inspector disk.img [disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:19
msgid ""
"B<virt-inspector> examines a virtual machine or disk image and tries to "
"determine the version of the operating system and other information about "
"the virtual machine."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:23
msgid "Virt-inspector produces XML output for feeding into other programs."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:25
msgid ""
"In the normal usage, use C<virt-inspector -d domname> where C<domname> is "
"the libvirt domain (see: C<virsh list --all>)."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:28
msgid ""
"You can also run virt-inspector directly on disk images from a single "
"virtual machine.  Use C<virt-inspector -a disk.img>.  In rare cases a domain "
"has several block devices, in which case you should list several I<-a> "
"options one after another, with the first corresponding to the guest’s "
"F</dev/sda>, the second to the guest’s F</dev/sdb> and so on."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:35
msgid ""
"You can also run virt-inspector on install disks, live CDs, bootable USB "
"keys and similar."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:38
msgid ""
"Virt-inspector can only inspect and report upon I<one domain at a time>.  To "
"inspect several virtual machines, you have to run virt-inspector several "
"times (for example, from a shell script for-loop)."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:43
msgid ""
"Because virt-inspector needs direct access to guest images, it won’t "
"normally work over remote libvirt connections."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:46
msgid ""
"All of the information available from virt-inspector is also available "
"through the core libguestfs inspection API (see L<guestfs(3)/INSPECTION>).  "
"The same information can also be fetched using guestfish or via libguestfs "
"bindings in many programming languages (see L</GETTING INSPECTION DATA FROM "
"THE LIBGUESTFS API>)."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:52
msgid ""
"Additional information about bootloader, kernel and drivers inside a guest "
"can be found using L<virt-drivers(1)>."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:89
msgid ""
"Libvirt is only used if you specify a C<domname> on the command line.  If "
"you specify guest block devices directly (I<-a>), then libvirt is not used "
"at all."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:102
msgid ""
"When prompting for keys and passphrases, virt-inspector 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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:111 win-reg/virt-win-reg.in:141
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:115 win-reg/virt-win-reg.in:145
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:119 resize/virt-resize.pod:424
#: resize/virt-resize.pod:522 sparsify/virt-sparsify.pod:209
#: win-reg/virt-win-reg.in:149
msgid ""
"If working with untrusted raw-format guest disk images, you should ensure "
"the format is always specified."
msgstr ""

#. type: =item
#: inspector/virt-inspector.pod:126
msgid "B<--no-applications>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:128
msgid ""
"By default the output of virt-inspector includes the list of all the "
"applications installed in the guest, if available."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:131 inspector/virt-inspector.pod:138
msgid "Specify this option to disable this part of the resulting XML."
msgstr ""

#. type: =item
#: inspector/virt-inspector.pod:133
msgid "B<--no-icon>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:135
msgid ""
"By default the output of virt-inspector includes the icon of the guest, if "
"available (see L</icon>)."
msgstr ""

#. type: =item
#: inspector/virt-inspector.pod:156
msgid "B<--xpath> query"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:158
msgid ""
"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 L</XPATH QUERIES> below for some examples."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:167
msgid "Previous versions of virt-inspector allowed you to write either:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:173
#, no-wrap
msgid ""
" virt-inspector guestname\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:183
msgid ""
"The virt-inspector XML is described precisely in a RELAX NG schema file "
"F<virt-inspector.rng> which is supplied with libguestfs.  This section is "
"just an overview."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:187
msgid ""
"The top-level element is E<lt>operatingsystemsE<gt>, and it contains one or "
"more E<lt>operatingsystemE<gt> elements.  You would only see more than one "
"E<lt>operatingsystemE<gt> element if the virtual machine is multi-boot, "
"which is vanishingly rare in real world VMs."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:192
msgid "E<lt>operatingsystemE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:194
msgid ""
"In the E<lt>operatingsystemE<gt> 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:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:198
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     <root>/dev/sda2</root>\n"
"     <name>windows</name>\n"
"     <arch>i386</arch>\n"
"     <distro>windows</distro>\n"
"     <product_name>Windows 7 Enterprise</product_name>\n"
"     <product_variant>Client</product_variant>\n"
"     <major_version>6</major_version>\n"
"     <minor_version>1</minor_version>\n"
"     <windows_systemroot>/Windows</windows_systemroot>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:210
msgid ""
"In brief, E<lt>nameE<gt> is the class of operating system (something like "
"C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> "
"but many other distros are recognized) and E<lt>archE<gt> 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 L<guestfs(3)/INSPECTION>."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:218
msgid ""
"The E<lt>rootE<gt> 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)."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:222
msgid "E<lt>mountpointsE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:224
msgid ""
"Un*x-like guests typically have multiple filesystems which are mounted at "
"various mountpoints, and these are described in the E<lt>mountpointsE<gt> "
"element which looks like this:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:228
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     ...\n"
"     <mountpoints>\n"
"       <mountpoint dev=\"/dev/vg_f13x64/lv_root\">/</mountpoint>\n"
"       <mountpoint dev=\"/dev/sda1\">/boot</mountpoint>\n"
"     </mountpoints>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:236
msgid ""
"As with E<lt>rootE<gt>, 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."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:241
msgid "E<lt>filesystemsE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:243
msgid ""
"E<lt>filesystemsE<gt> is like E<lt>mountpointsE<gt> but covers I<all> "
"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)."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:249
msgid "You might see something like this:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:251
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     ...\n"
"     <filesystems>\n"
"       <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
"         <type>ext4</type>\n"
"         <label>Fedora-13-x86_64</label>\n"
"         <uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>\n"
"       </filesystem>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:261
msgid ""
"The optional elements within E<lt>filesystemE<gt> are the filesystem type, "
"the label, and the UUID."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:264
msgid "E<lt>applicationsE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:266
msgid ""
"The related elements E<lt>package_formatE<gt>, E<lt>package_managementE<gt> "
"and E<lt>applicationsE<gt> describe applications installed in the virtual "
"machine."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:270
msgid ""
"E<lt>package_formatE<gt>, if present, describes the packaging system used.  "
"Typical values would be C<rpm> and C<deb>."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:273
msgid ""
"E<lt>package_managementE<gt>, if present, describes the package manager.  "
"Typical values include C<yum>, C<up2date> and C<apt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:276
msgid "E<lt>applicationsE<gt> lists the packages or applications installed."
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:279
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     ...\n"
"     <applications>\n"
"       <application>\n"
"         <name>coreutils</name>\n"
"         <version>8.5</version>\n"
"         <release>1</release>\n"
"       </application>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:289
msgid ""
"The version and release fields may not be available for some types guests.  "
"Other fields are possible, see "
"L<guestfs(3)/guestfs_inspect_list_applications>."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:293
msgid "E<lt>drive_mappingsE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:295
msgid ""
"For operating systems like Windows which use drive letters, virt-inspector "
"is able to find out how drive letters map to filesystems."
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:299
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     ...\n"
"     <drive_mappings>\n"
"       <drive_mapping name=\"C\">/dev/sda2</drive_mapping>\n"
"       <drive_mapping name=\"E\">/dev/sdb1</drive_mapping>\n"
"     </drive_mappings>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:307
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:311
msgid ""
"Note that this only covers permanent local filesystem mappings, not things "
"like network shares.  Furthermore NTFS volume mount points may not be listed "
"here."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:315
msgid "E<lt>iconE<gt>"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:317
msgid ""
"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."
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:321
#, no-wrap
msgid ""
" <operatingsystems>\n"
"   <operatingsystem>\n"
"     ...\n"
"     <icon>\n"
"       iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n"
"       [... many lines of base64 data ...]\n"
"     </icon>\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:329
msgid ""
"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 L<base64(1)> program to do the conversion back "
"to a PNG file:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:334
#, no-wrap
msgid ""
" base64 -i -d < icon.data > icon.png\n"
"\n"
msgstr ""

#. type: =head1
#: inspector/virt-inspector.pod:336
msgid "XPATH QUERIES"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:338
msgid ""
"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 L<xmlstarlet(1)> and that is not "
"available on Red Hat Enterprise Linux."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:345
msgid ""
"To perform an XPath query, use the I<--xpath> 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."
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:352
#, no-wrap
msgid ""
" $ virt-inspector -d Guest | virt-inspector --xpath '//filesystems'\n"
" <filesystems>\n"
"      <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
"        <type>ext4</type>\n"
" [...]\n"
"\n"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:358
#, no-wrap
msgid ""
" $ virt-inspector -d Guest | \\\n"
"     virt-inspector --xpath "
"\"string(//filesystem[@dev='/dev/sda1']/type)\"\n"
" ext4\n"
"\n"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:362
#, no-wrap
msgid ""
" $ virt-inspector -d Guest | \\\n"
"     virt-inspector --xpath 'string(//icon)' | base64 -i -d | display -\n"
" [displays the guest icon, if there is one]\n"
"\n"
msgstr ""

#. type: =head1
#: inspector/virt-inspector.pod:366
msgid "GETTING INSPECTION DATA FROM THE LIBGUESTFS API"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:368
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:374
msgid ""
"By libguestfs 1.8 we had rewritten the Perl code in C, and incorporated it "
"all into the core libguestfs API (L<guestfs(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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:380
msgid "For a description of the C inspection API, read L<guestfs(3)/INSPECTION>."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:383
msgid ""
"For example code using the C inspection API, look for F<inspect-vm.c> which "
"ships with libguestfs."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:386
msgid ""
"F<inspect-vm.c> has also been translated into other languages.  For example, "
"F<inspect_vm.pl> is the Perl translation, and there are other translations "
"for OCaml, Python, etc.  See L<guestfs(3)/USING LIBGUESTFS WITH OTHER "
"PROGRAMMING LANGUAGES> for a list of man pages which contain this example "
"code."
msgstr ""

#. type: =head2
#: inspector/virt-inspector.pod:392
msgid "GETTING INSPECTION DATA FROM GUESTFISH"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:394
msgid ""
"If you use the guestfish I<-i> option, then the main C inspection API "
"L<guestfs(3)/guestfs_inspect_os> is called.  This is equivalent to the "
"guestfish command C<inspect-os>.  You can also call this guestfish command "
"by hand."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:399
msgid ""
"C<inspect-os> 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."
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:406
#, no-wrap
msgid ""
" $ guestfish --ro -a F15x32.img\n"
" ><fs> run\n"
" ><fs> inspect-os\n"
" /dev/vg_f15x32/lv_root\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:411
msgid "Using the root device, you can fetch further information about the guest:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:414
#, no-wrap
msgid ""
" ><fs> inspect-get-type /dev/vg_f15x32/lv_root\n"
" linux\n"
" ><fs> inspect-get-distro /dev/vg_f15x32/lv_root\n"
" fedora\n"
" ><fs> inspect-get-major-version /dev/vg_f15x32/lv_root\n"
" 15\n"
" ><fs> inspect-get-product-name /dev/vg_f15x32/lv_root\n"
" Fedora release 15 (Lovelock)\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:423
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:428
msgid "To list applications, you have to first mount up the disks:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:430
#, no-wrap
msgid ""
" ><fs> inspect-get-mountpoints /dev/vg_f15x32/lv_root\n"
" /: /dev/vg_f15x32/lv_root\n"
" /boot: /dev/vda1\n"
" ><fs> mount-ro /dev/vg_f15x32/lv_root /\n"
" ><fs> mount-ro /dev/vda1 /boot\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:436
msgid "and then call the inspect-list-applications API:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:438
#, no-wrap
msgid ""
" ><fs> inspect-list-applications /dev/vg_f15x32/lv_root | head -28\n"
" [0] = {\n"
"   app_name: ConsoleKit\n"
"   app_display_name:\n"
"   app_epoch: 0\n"
"   app_version: 0.4.5\n"
"   app_release: 1.fc15\n"
"   app_install_path:\n"
"   app_trans_path:\n"
"   app_publisher:\n"
"   app_url:\n"
"   app_source_package:\n"
"   app_summary:\n"
"   app_description:\n"
" }\n"
" [1] = {\n"
"   app_name: ConsoleKit-libs\n"
"   app_display_name:\n"
"   app_epoch: 0\n"
"   app_version: 0.4.5\n"
"   app_release: 1.fc15\n"
"   app_install_path:\n"
"   app_trans_path:\n"
"   app_publisher:\n"
"   app_url:\n"
"   app_source_package:\n"
"   app_summary:\n"
"   app_description:\n"
" }\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:468
msgid ""
"To display an icon for the guest, note that filesystems must also be mounted "
"as above.  You can then do:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:471
#, no-wrap
msgid ""
" ><fs> inspect-get-icon /dev/vg_f15x32/lv_root | display -\n"
"\n"
msgstr ""

#. type: =head1
#: inspector/virt-inspector.pod:473
msgid "OLD VERSIONS OF VIRT-INSPECTOR"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:475
msgid ""
"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."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:480
msgid "The old virt-inspector is no longer supported or shipped with libguestfs."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:483
msgid ""
"To confuse matters further, in Red Hat Enterprise Linux 6 we ship two "
"versions of virt-inspector with different names:"
msgstr ""

#. type: verbatim
#: inspector/virt-inspector.pod:486
#, no-wrap
msgid ""
" virt-inspector     Old Perl version.\n"
" virt-inspector2    New C version.\n"
"\n"
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:496
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<http://www.w3.org/TR/xpath/>, "
"L<base64(1)>, L<xmlstarlet(1)>, L<virt-drivers(1)>, "
"L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: inspector/virt-inspector.pod:514
msgid "Matthew Booth L<mbooth@redhat.com>"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:3
msgid "virt-make-fs - Make a filesystem from a tar archive or files"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:7
#, no-wrap
msgid ""
" virt-make-fs [--options] input.tar output.img\n"
"\n"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:9
#, no-wrap
msgid ""
" virt-make-fs [--options] input.tar.gz output.img\n"
"\n"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:11
#, no-wrap
msgid ""
" virt-make-fs [--options] directory output.img\n"
"\n"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:15
msgid ""
"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 "
"L<mkisofs(1)>, L<genisoimage(1)> and L<mksquashfs(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)."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:23
msgid ""
"To create blank disks, use L<virt-format(1)>.  To create complex layouts, "
"use L<guestfish(1)>."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:26
msgid "Basic usage is:"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:28
#, no-wrap
msgid ""
" virt-make-fs input output.img\n"
"\n"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:30
msgid ""
"where C<input> is either a directory containing files that you want to add, "
"or a tar archive (either uncompressed tar or gzip-compressed tar); and "
"F<output.img> 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</OPTIONS> below)."
msgstr ""

#. type: =head2
#: make-fs/virt-make-fs.pod:36
msgid "FILESYSTEM TYPE"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:38
msgid ""
"The default filesystem type is C<ext2>.  Just about any filesystem type that "
"libguestfs supports can be used (but I<not> read-only formats like "
"ISO9660).  Here are some of the more common choices:"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:44
msgid "I<ext3>"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:46
msgid ""
"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."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:50
msgid "I<ntfs> or I<vfat>"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:52
msgid "Useful if exporting data to a Windows guest."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:54
msgid "I<minix>"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:56
msgid ""
"Lower overhead than C<ext2>, but certain limitations on filename length and "
"total filesystem size."
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:63
#, no-wrap
msgid ""
" virt-make-fs --type=minix input minixfs.img\n"
"\n"
msgstr ""

#. type: =head2
#: make-fs/virt-make-fs.pod:65
msgid "TO PARTITION OR NOT TO PARTITION"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:67
msgid "Optionally virt-make-fs can add a partition table to the output disk."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:69
msgid ""
"Adding a partition can make the disk image more compatible with certain "
"virtualized operating systems which don't expect to see a filesystem "
"directly located on a block device (Linux doesn't care and will happily "
"handle both types)."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:74
msgid ""
"On the other hand, if you have a partition table then the output image is no "
"longer a straight filesystem.  For example you cannot run L<fsck(8)> "
"directly on a partitioned disk image.  (However libguestfs tools such as "
"L<guestfish(1)> and L<virt-resize(1)> can still be used)."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:82
msgid "Add an MBR partition:"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:84
#, no-wrap
msgid ""
" virt-make-fs --partition -- input disk.img\n"
"\n"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:86
msgid ""
"If the output disk image could be terabyte-sized or larger, it's better to "
"use an EFI/GPT-compatible partition table:"
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:89
#, no-wrap
msgid ""
" virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
"\n"
msgstr ""

#. type: =head2
#: make-fs/virt-make-fs.pod:91
msgid "EXTRA SPACE"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:93
msgid ""
"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 I<--size> flag to leave space in the filesystem if you "
"want it."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:101
msgid ""
"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 I<--format=qcow2> will use the native qemu/KVM qcow2 "
"image format (check your hypervisor supports this before using it).  This "
"allows you to choose a large I<--size> but the extra space won't actually be "
"allocated in the image until you try to store something in it."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:109
msgid ""
"Don’t forget that you can also use local commands including L<resize2fs(8)> "
"and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
"to build another image from scratch."
msgstr ""

#. type: verbatim
#: make-fs/virt-make-fs.pod:115
#, no-wrap
msgid ""
" virt-make-fs --format=qcow2 --size=+200M input output.img\n"
"\n"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:129
msgid "This parameter sets the sector size of the output disk image."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:131
msgid "The default is C<512> bytes."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:133
msgid "See also L<guestfs(3)/guestfs_add_drive_opts>."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:135
msgid "B<--floppy>"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:137
msgid "Create a virtual floppy disk."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:139
msgid ""
"Currently this preselects the size (1440K), partition type (MBR) and "
"filesystem type (VFAT).  In future it may also choose the geometry."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:142
msgid "B<--size=>N"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:144
msgid "B<--size=+>N"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:146
msgid "B<-s> N"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:148
msgid "B<-s> B<+>N"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:150
msgid "Use the I<--size> (or I<-s>) option to choose the size of the output image."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:153
msgid ""
"If this option is I<not> given, then the output image will be just large "
"enough to contain all the files, with not much wasted space."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:156
msgid ""
"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."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:161
msgid ""
"To leave extra space, specify C<+> (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: I<--size=+200M> means enough space for "
"the input files, and (approximately) an extra 200 MB free space."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:167
msgid ""
"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)."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:172
msgid "B<--format=>FMT"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:174
msgid "B<-F> FMT"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:176
msgid "Choose the output disk image format."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:178
msgid "The default is C<raw> (raw sparse disk image)."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:180
msgid "B<--type=>FS"
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:182
msgid "B<-t> FS"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:184
msgid "Choose the output filesystem type."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:186
msgid "The default is C<ext2>."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:188
msgid "Any filesystem which is supported read-write by libguestfs can be used here."
msgstr ""

#. type: =item
#: make-fs/virt-make-fs.pod:197
msgid "B<--partition=>PARTTYPE"
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:199
msgid ""
"If specified, this flag adds an MBR partition table to the output disk "
"image."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:202
msgid ""
"You can change the partition table type, eg. I<--partition=gpt> for large "
"disks."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:205
msgid "For MBR, virt-make-fs sets the partition type byte automatically."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:211
msgid "Enable debugging information."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:221
msgid "Enable libguestfs trace."
msgstr ""

#. type: textblock
#: make-fs/virt-make-fs.pod:227
msgid ""
"L<guestfish(1)>, L<virt-format(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, "
"L<mkisofs(1)>, L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, "
"L<resize2fs(8)>, L<guestfs(3)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:3
msgid "virt-resize - Resize a virtual machine disk"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:7
#, no-wrap
msgid ""
" virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
"   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
"   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:13
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:17
msgid ""
"Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
"not> be used on live virtual machines - for consistent results, shut the "
"virtual machine down before resizing it."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:21
msgid ""
"If you are not familiar with the associated tools: L<virt-filesystems(1)> "
"and L<virt-df(1)>, we recommend you go and read those manual pages first."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:31
msgid ""
"This example takes C<olddisk> and resizes it into C<newdisk>, extending one "
"of the guest’s partitions to fill the extra 5GB of space:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:35
#, no-wrap
msgid ""
" virt-filesystems --long -h --all -a olddisk\n"
" \n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:37
#, no-wrap
msgid ""
" truncate -r olddisk newdisk\n"
" truncate -s +5G newdisk\n"
" \n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:40
#, no-wrap
msgid ""
" # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
" virt-resize --expand /dev/sda2 olddisk newdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:45
msgid ""
"As above, but make the /boot partition 200MB bigger, while giving the "
"remaining space to /dev/sda2:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:48
#, no-wrap
msgid ""
" virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
"   olddisk newdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:53
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:57
#, no-wrap
msgid ""
" virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \\\n"
"   olddisk newdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:62
msgid ""
"As in the first example, but the output format will be qcow2 instead of a "
"raw disk:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:65
#, no-wrap
msgid ""
" qemu-img create -f qcow2 -o preallocation=metadata newdisk.qcow2 15G\n"
" virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
"\n"
msgstr ""

#. type: =head1
#: resize/virt-resize.pod:70
msgid "DETAILED USAGE"
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:72
msgid "EXPANDING A VIRTUAL MACHINE DISK"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:76
msgid "1. Shut down the virtual machine"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:78
msgid "2. Locate input disk image"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:80
msgid ""
"Locate the input disk image (ie. the file or device on the host containing "
"the guest’s disk).  If the guest is managed by libvirt, you can use C<virsh "
"dumpxml> like this to find the disk image name:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:84
#, no-wrap
msgid ""
" # virsh dumpxml guestname | xpath -e /domain/devices/disk/source\n"
" Found 1 nodes:\n"
" -- NODE --\n"
" <source dev=\"/dev/vg/lv_guest\" />\n"
"\n"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:89
msgid "3. Look at current sizing"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:91
msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:94
#, no-wrap
msgid ""
" # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
" Name       Type       Size  Parent\n"
" /dev/sda1  partition  101M  /dev/sda\n"
" /dev/sda2  partition  7.9G  /dev/sda\n"
" /dev/sda   device     8.0G  -\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:100
msgid ""
"(This example is a virtual machine with an 8 GB disk which we would like to "
"expand up to 10 GB)."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:103
msgid "4. Create output disk"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:105
msgid ""
"Virt-resize cannot do in-place disk modifications.  You have to have space "
"to store the resized output disk."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:108
msgid "To store the resized disk image in a file, create a file of a suitable size:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:111
#, no-wrap
msgid ""
" # rm -f outdisk\n"
" # truncate -s 10G outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:114
msgid "Or use L<lvcreate(1)> to create a logical volume:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:116
#, no-wrap
msgid ""
" # lvcreate -L 10G -n lv_name vg_name\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:118
msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:120
#, no-wrap
msgid ""
" # virsh pool-list\n"
" # virsh vol-create-as poolname newvol 10G\n"
"\n"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:123
msgid "5. Resize"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:125
msgid ""
"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."
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:129
#, no-wrap
msgid ""
" # virt-resize indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:131
msgid ""
"This command just copies disk image C<indisk> to disk image C<outdisk> "
"I<without> resizing or changing any existing partitions.  If C<outdisk> is "
"larger, then an extra, empty partition is created at the end of the disk "
"covering the extra space.  If C<outdisk> is smaller, then it will give an "
"error."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:137
msgid ""
"More realistically you'd want to expand existing partitions in the disk "
"image by passing extra options (for the full list see the L</OPTIONS> "
"section below)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:141
msgid ""
"L</--expand> is the most useful option.  It expands the named partition "
"within the disk to fill any extra space:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:144
#, no-wrap
msgid ""
" # virt-resize --expand /dev/sda2 indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:146
msgid ""
"(In this case, an extra partition is I<not> created at the end of the disk, "
"because there will be no unused space)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:149
msgid ""
"L</--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:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:153
#, no-wrap
msgid ""
" # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
"     indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:156
msgid ""
"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 L<pvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
"L<btrfs(8)>, L<xfs_growfs(8)>, or L<resize.f2fs(8)>.  However virt-resize "
"does not know how to resize some filesystems, so you would have to online "
"resize them after booting the guest."
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:164
#, no-wrap
msgid ""
" # virt-resize --expand /dev/sda2 nbd://example.com outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:166
msgid ""
"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 L<guestfish(1)/ADDING "
"REMOTE STORAGE>."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:170
msgid "Other options are covered below."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:172
msgid "6. Test"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:174
msgid "Thoroughly test the new disk image I<before> discarding the old one."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:176
msgid "If you are using libvirt, edit the XML to point at the new disk:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:178
#, no-wrap
msgid ""
" # virsh edit guestname\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:180
msgid ""
"Change E<lt>source ...E<gt>, see "
"L<http://libvirt.org/formatdomain.html#elementsDisks>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:183
msgid "Then start up the domain with the new, resized disk:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:185
#, no-wrap
msgid ""
" # virsh start guestname\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:187
msgid ""
"and check that it still works.  See also the L</NOTES> section below for "
"additional information."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:190
msgid "7. Resize LVs etc inside the guest"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:192
msgid "(This can also be done offline using L<guestfish(1)>)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:194
msgid ""
"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."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:201
msgid "SHRINKING A VIRTUAL MACHINE DISK"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:203
msgid ""
"Shrinking is somewhat more complex than expanding, and only an overview is "
"given here."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:206
msgid ""
"Firstly virt-resize will not attempt to shrink any partition content (PVs, "
"filesystems).  The user has to shrink content before passing the disk image "
"to virt-resize, and virt-resize will check that the content has been shrunk "
"properly."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:211
msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:213
msgid ""
"After shrinking PVs and filesystems, shut down the guest, and proceed with "
"steps 3 and 4 above to allocate a new disk image."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:216
msgid "Then run virt-resize with any of the I<--shrink> and/or I<--resize> options."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:219
msgid "IGNORING OR DELETING PARTITIONS"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:221
msgid ""
"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."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:228
msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:230
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:236
#, no-wrap
msgid ""
" qemu-img create -f qcow2 -o preallocation=metadata outdisk [size]\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:238
msgid "instead of the truncate command."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:240
msgid "Similarly, to get non-sparse raw output use:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:242
#, no-wrap
msgid ""
" fallocate -l size outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:244
msgid ""
"(on older systems that don’t have the L<fallocate(1)> command use C<dd "
"if=/dev/zero of=outdisk bs=1M count=..>)"
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:247
msgid "LOGICAL PARTITIONS"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:249
msgid ""
"Logical partitions (a.k.a. F</dev/sda5+> on disks using DOS partition "
"tables) cannot be resized."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:252
msgid ""
"To understand what is going on, firstly one of the four partitions "
"F</dev/sda1-4> will have MBR partition type C<05> or C<0f>.  This is called "
"the B<extended partition>.  Use L<virt-filesystems(1)> to see the MBR "
"partition type."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:257
msgid "Logical partitions live inside the extended partition."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:259
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:265
msgid ""
"You cannot specify a logical partition (F</dev/sda5+>) at all on the command "
"line.  Doing so will give an error."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:276
msgid "B<--align-first> B<auto>"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:278
msgid "B<--align-first> B<never>"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:280
msgid "B<--align-first> B<always>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:282
msgid ""
"Align the first partition for improved performance (see also the "
"I<--alignment> option)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:285
msgid ""
"The default is I<--align-first auto> which only aligns the first partition "
"if it is safe to do so.  That is, only when we know how to fix the "
"bootloader automatically, and at the moment that can only be done for "
"Windows guests."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:290
msgid ""
"I<--align-first never> means we never move the first partition.  This is the "
"safest option.  Try this if the guest does not boot after resizing."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:294
msgid ""
"I<--align-first always> means we always align the first partition (if it "
"needs to be aligned).  For some guests this will break the bootloader, "
"making the guest unbootable."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:298
msgid "B<--alignment> N"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:300
msgid ""
"Set the alignment of partitions to C<N> sectors.  The default in virt-resize "
"E<lt> 1.13.19 was 64 sectors, and after that is 128 sectors."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:304
msgid ""
"Assuming 512 byte sector size inside the guest, here are some suitable "
"values for this:"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:309
msgid "I<--alignment 1> (512 bytes)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:311
msgid ""
"The partitions would be packed together as closely as possible, but would be "
"completely unaligned.  In some cases this can cause very poor performance.  "
"See L<virt-alignment-scan(1)> for further details."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:315
msgid "I<--alignment 8> (4K)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:317
msgid ""
"This would be the minimum acceptable alignment for reasonable performance on "
"modern hosts."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:320
msgid "I<--alignment 128> (64K)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:322
msgid ""
"This alignment provides good performance when the host is using high end "
"network storage."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:325
msgid "I<--alignment 2048> (1M)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:327
msgid ""
"This is the standard alignment used by all newly installed guests since "
"around 2008."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:341
msgid "B<-d>"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:343 win-reg/virt-win-reg.in:117
msgid "B<--debug>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:345
msgid "(Deprecated: use I<-v> option instead)"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:347 resize/virt-resize.pod:626
#: win-reg/virt-win-reg.in:119
msgid "Enable debugging messages."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:349
msgid "B<--delete> PART"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:351
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:355
msgid ""
"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 I<renumbered>, which can easily make your guest unbootable."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:360 resize/virt-resize.pod:437
#: resize/virt-resize.pod:570 sparsify/virt-sparsify.pod:226
msgid "You can give this option multiple times."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:362
msgid "B<--expand> PART"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:364
msgid ""
"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)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:367
msgid ""
"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 L<pvresize(8)>).  Virt-resize leaves any other "
"content it doesn't know about alone."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:372
msgid "Currently virt-resize can resize:"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:378
msgid "ext2, ext3 and ext4 filesystems."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:382
msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:384
msgid ""
"The filesystem must have been shut down consistently last time it was used.  "
"Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
"consistency check, so at the first boot after resizing Windows will check "
"the disk."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:391
msgid ""
"LVM PVs (physical volumes).  virt-resize does not usually resize anything "
"inside the PV, but see the I<--LV-expand> option.  The user could also "
"resize LVs as desired after boot."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:397
msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:401
msgid "XFS filesystems, if libguestfs was compiled with support for XFS."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:405
msgid "Linux swap partitions."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:407
msgid ""
"Please note that libguestfs I<destroys> the existing swap content by "
"recreating it with C<mkswap>, so this should not be used when the guest is "
"suspended."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:413
msgid "f2fs filesystems, if libguestfs was compiled with support for f2fs."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:417 resize/virt-resize.pod:598
msgid "Note that you cannot use I<--expand> and I<--shrink> together."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:419
msgid "B<--format> B<raw>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:421 sparsify/virt-sparsify.pod:206
msgid ""
"Specify the format of the input disk image.  If this flag is not given then "
"it is auto-detected from the image itself."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:427
msgid ""
"Note that this option I<does not> affect the output format.  See L</QCOW2 "
"AND NON-SPARSE RAW FORMATS>."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:430
msgid "B<--ignore> PART"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:432
msgid ""
"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)."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:439
msgid "B<--LV-expand> LOGVOL"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:441
msgid ""
"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 F</dev/sda2> and a root device called "
"F</dev/vg_guest/lv_root> would be:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:446
#, no-wrap
msgid ""
" virt-resize indisk outdisk \\\n"
"   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:449
msgid ""
"This would first expand the partition (and PV), and then expand the root "
"device to fill the extra space in the PV."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:452
msgid ""
"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 I<--no-expand-content>."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:456
msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:458
msgid ""
"You can give this option multiple times, I<but> it doesn't make sense to do "
"this unless the logical volumes you specify are all in different volume "
"groups."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:474
msgid "Print a summary of what would be done, but don’t do anything."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:476
msgid "B<--no-copy-boot-loader>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:478
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:483
msgid ""
"If you specify this flag, then this initial copy is not done.  You may need "
"to reinstall the boot loader in this case."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:486
msgid "B<--no-extra-partition>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:488
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:494
msgid ""
"Note that if the surplus space is smaller than 10 MB, no extra partition "
"will be created."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:497
msgid "B<--no-expand-content>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:499
msgid ""
"By default, virt-resize will try to expand the direct contents of "
"partitions, if it knows how (see I<--expand> option above)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:502
msgid ""
"If you give the I<--no-expand-content> option then virt-resize will not "
"attempt this."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:505
msgid "B<--no-sparse>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:507
msgid "Turn off sparse copying.  See L</SPARSE COPYING> below."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:509
msgid "B<--ntfsresize-force>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:511
msgid ""
"Pass the I<--force> option to L<ntfsresize(8)>, allowing resizing even if "
"the NTFS disk is marked as needing a consistency check.  You have to use "
"this option if you want to resize a Windows guest multiple times without "
"booting into Windows between each resize."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:517
msgid "B<--output-format> B<raw>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:519
msgid ""
"Specify the format of the output disk image.  If this flag is not given then "
"it is auto-detected from the image itself."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:525
msgid ""
"Note that this option I<does not create> 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</QCOW2 AND "
"NON-SPARSE RAW FORMATS>."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:534
msgid "Don’t print the summary."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:536
msgid "B<--resize> PART=SIZE"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:538
msgid ""
"Resize the named partition (expanding or shrinking it) so that it has the "
"given size."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:541
msgid ""
"C<SIZE> can be expressed as an absolute number followed by b/K/M/G to mean "
"bytes, Kilobytes, Megabytes, or Gigabytes; or as a percentage of the current "
"size; or as a relative number or percentage.  For example:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:547
#, no-wrap
msgid ""
" --resize /dev/sda2=10G\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:549
#, no-wrap
msgid ""
" --resize /dev/sda4=90%\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:551
#, no-wrap
msgid ""
" --resize /dev/sda2=+1G\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:553
#, no-wrap
msgid ""
" --resize /dev/sda2=-200M\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:555
#, no-wrap
msgid ""
" --resize /dev/sda1=+128K\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:557
#, no-wrap
msgid ""
" --resize /dev/sda1=+10%\n"
"\n"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:559
#, no-wrap
msgid ""
" --resize /dev/sda1=-10%\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:561
msgid ""
"You can increase the size of any partition.  Virt-resize will expand the "
"direct content of the partition if it knows how (see I<--expand> above)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:565
msgid ""
"You can only I<decrease> the size of partitions that contain filesystems or "
"PVs which have already been shrunk.  Virt-resize will check this has been "
"done before proceeding, or else will print an error (see also "
"I<--resize-force>)."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:572
msgid "B<--resize-force> PART=SIZE"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:574
msgid ""
"This is the same as I<--resize> 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)."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:580
msgid "See also the I<--ignore> option."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:582
msgid "B<--shrink> PART"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:584
msgid ""
"Shrink the named partition until the overall disk image fits in the "
"destination.  The named partition B<must> contain a filesystem or PV which "
"has already been shrunk using another tool (eg. L<guestfish(1)> or other "
"online tools).  Virt-resize will check this and give an error if it has not "
"been done."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:590
msgid ""
"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."
msgstr ""

#. type: =item
#: resize/virt-resize.pod:600
msgid "B<--unknown-filesystems> B<ignore>"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:602
msgid "B<--unknown-filesystems> B<warn>"
msgstr ""

#. type: =item
#: resize/virt-resize.pod:604
msgid "B<--unknown-filesystems> B<error>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:606
msgid ""
"Configure the behaviour of virt-resize when asking to expand a filesystem, "
"and neither libguestfs has the support it, nor virt-resize knows how to "
"expand the content of the filesystem."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:610
msgid ""
"I<--unknown-filesystems ignore> will cause virt-resize to silently ignore "
"such filesystems, and nothing is printed about them."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:613
msgid ""
"I<--unknown-filesystems warn> (the default behaviour) will cause virt-resize "
"to warn for each of the filesystem that cannot be expanded, but still "
"continuing to resize the disk."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:617
msgid ""
"I<--unknown-filesystems error> will cause virt-resize to error out at the "
"first filesystem that cannot be expanded."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:620
msgid ""
"See also L</\"unknown/unavailable method for expanding the TYPE filesystem "
"on DEVICE/LV\">."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:648
msgid ""
"The I<--machine-readable> option can be used to make the output more machine "
"friendly, which is useful when calling virt-resize from other programs, GUIs "
"etc."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:652 sparsify/virt-sparsify.pod:366
msgid "There are two ways to use this option."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:654
msgid ""
"Firstly use the option on its own to query the capabilities of the "
"virt-resize binary.  Typical output looks like this:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:657
#, no-wrap
msgid ""
" $ virt-resize --machine-readable\n"
" virt-resize\n"
" ntfsresize-force\n"
" 32bitok\n"
" ntfs\n"
" btrfs\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:667 sparsify/virt-sparsify.pod:379
msgid ""
"Secondly use the option in conjunction with other options to make the "
"regular program output more machine friendly."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:670 sparsify/virt-sparsify.pod:382
msgid "At the moment this means:"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:676 sparsify/virt-sparsify.pod:388
msgid ""
"Progress bar messages can be parsed from stdout by looking for this regular "
"expression:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:679 sparsify/virt-sparsify.pod:391
#, no-wrap
msgid ""
" ^[0-9]+/[0-9]+$\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:683 sparsify/virt-sparsify.pod:395
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:689
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:695
msgid ""
"Versions of the program prior to 1.13.9 did not support the "
"I<--machine-readable> option and will return an error."
msgstr ""

#. type: =head1
#: resize/virt-resize.pod:701
msgid "NOTES"
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:703
msgid "\"Partition 1 does not end on cylinder boundary.\""
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:705
msgid ""
"Virt-resize aligns partitions to multiples of 128 sectors (see the "
"I<--alignment> 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."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:712
msgid "GUEST BOOT STUCK AT \"GRUB\""
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:714
msgid ""
"If a Linux guest does not boot after resizing, and the boot is stuck after "
"printing C<GRUB> on the console, try reinstalling grub."
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:717
#, no-wrap
msgid ""
" guestfish -i -a newdisk\n"
" ><fs> cat /boot/grub/device.map\n"
" # check the contents of this file are sensible or\n"
" # edit the file if necessary\n"
" ><fs> grub-install / /dev/vda\n"
" ><fs> exit\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:724
msgid ""
"For more flexible guest reconfiguration, including if you need to specify "
"other parameters to grub-install, use L<virt-rescue(1)>."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:727
msgid "RESIZING WINDOWS BOOT PARTITIONS"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:729
msgid ""
"In Windows Vista and later versions, Microsoft switched to using a separate "
"boot partition.  In these VMs, typically F</dev/sda1> is the boot partition "
"and F</dev/sda2> is the main (C:) drive.  Resizing the first (boot) "
"partition causes the bootloader to fail with C<0xC0000225> error.  Resizing "
"the second partition (ie. C: drive)  should work."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:736
msgid "WINDOWS CHKDSK"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:738
msgid ""
"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 C<chkdsk /f> on all NTFS partitions, then shut down the VM cleanly.  "
"For further information see: "
"L<https://bugzilla.redhat.com/show_bug.cgi?id=975753>"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:744
msgid ""
"I<After resize> 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."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:748
msgid "WINDOWS UNMOUNTABLE_BOOT_VOLUME BSOD"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:750
msgid ""
"After sysprepping a Windows guest and then resizing it with virt-resize, you "
"may see the guest fail to boot with an C<UNMOUNTABLE_BOOT_VOLUME> BSOD.  "
"This error is caused by having C<ExtendOemPartition=1> in the sysprep.inf "
"file.  Removing this line before sysprepping should fix the problem."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:756 sparsify/virt-sparsify.pod:413
#: sysprep/virt-sysprep.pod:564 win-reg/virt-win-reg.in:638
msgid "WINDOWS 8"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:758
msgid ""
"Windows 8 \"fast startup\" can prevent virt-resize from resizing NTFS "
"partitions.  See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST "
"STARTUP>."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:762
msgid "SPARSE COPYING"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:764
msgid "You should create a fresh, zeroed target disk image for virt-resize to use."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:767
msgid ""
"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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:772
msgid ""
"The main time this can be a problem is if the target is a host partition "
"(eg. S<C<virt-resize source.img /dev/sda4>>) because the usual partitioning "
"tools tend to leave whatever data happened to be on the disk before."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:777
msgid ""
"If you have to reuse a target which contains data already, you should use "
"the I<--no-sparse> option.  Note this can be much slower."
msgstr ""

#. type: =head2
#: resize/virt-resize.pod:780
msgid ""
"\"unknown/unavailable method for expanding the TYPE filesystem on "
"DEVICE/LV\""
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:782
msgid ""
"Virt-resize was asked to expand a partition or a logical volume containing a "
"filesystem with the type C<TYPE>, but there is no available nor known "
"expanding method for that filesystem."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:786
msgid "This may be due to either of the following:"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:792
msgid ""
"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 C<btrfs>, C<ntfs>, C<xfs>, and C<f2fs> filesystems."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:797
msgid "Check the results of:"
msgstr ""

#. type: verbatim
#: resize/virt-resize.pod:799
#, no-wrap
msgid ""
" virt-resize --machine-readable\n"
" guestfish -a /dev/null run : available\n"
" guestfish -a /dev/null run : filesystem_available TYPE\n"
"\n"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:803
msgid ""
"In this case, it is enough to install the proper packages adding support for "
"them.  For example, C<libguestfs-xfs> on Red Hat Enterprise Linux, CentOS, "
"Debian, Ubuntu, and distributions derived from them, for supporting the "
"C<xfs> filesystem."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:810
msgid "Virt-resize has no support for expanding that type of filesystem."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:812
msgid ""
"In this case, there’s nothing that can be done to let virt-resize expand "
"that type of filesystem."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:817
msgid ""
"In both cases, virt-resize will not expand the mentioned filesystem; the "
"result (unless I<--unknown-filesystems error> 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."
msgstr ""

#. type: =head1
#: resize/virt-resize.pod:823
msgid "ALTERNATIVE TOOLS"
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:825
msgid ""
"There are several proprietary tools for resizing partitions.  We won't "
"mention any here."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:828
msgid ""
"L<parted(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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:833
msgid ""
"L<guestfish(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 "
"I<--debug> flag."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:839
msgid ""
"L<dracut(8)> includes a module called C<dracut-modules-growroot> 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."
msgstr ""

#. type: textblock
#: resize/virt-resize.pod:850
msgid ""
"L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, "
"L<lvm(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, "
"L<ntfsresize(8)>, L<btrfs(8)>, L<xfs_growfs(8)>, L<resize.f2fs(8)>, "
"L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, L<grub(8)>, "
"L<grub-install(8)>, L<virt-rescue(1)>, L<virt-sparsify(1)>, "
"L<virt-alignment-scan(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:3
msgid "virt-sparsify - Make a virtual machine disk sparse"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:7
#, no-wrap
msgid ""
" virt-sparsify [--options] indisk outdisk\n"
"\n"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:9
#, no-wrap
msgid ""
" virt-sparsify [--options] --in-place disk\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:13
msgid ""
"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."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:18
msgid ""
"Virt-sparsify can locate and sparsify free space in most filesystems "
"(eg. ext2/3/4, btrfs, NTFS, etc.), and also in LVM physical volumes."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:21
msgid ""
"Virt-sparsify can also convert between some disk formats, for example "
"converting a raw disk image to a thin-provisioned qcow2 image."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:24
msgid ""
"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 "
"(L<http://bugzilla.redhat.com/887826>)."
msgstr ""

#. type: =head2
#: sparsify/virt-sparsify.pod:29
msgid "IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:31
msgid ""
"If the input is raw, then the default output is raw sparse.  B<You must "
"check the output size using a tool that understands sparseness> such as C<du "
"-sh>.  It can make a huge difference:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:35
#, no-wrap
msgid ""
" $ ls -lh test1.img\n"
" -rw-rw-r--. 1 rjones rjones 100M Aug  8 08:08 test1.img\n"
" $ du -sh test1.img\n"
" 3.6M\ttest1.img\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:40
msgid "(Compare the apparent size B<100M> vs the actual size B<3.6M>)"
msgstr ""

#. type: =head2
#: sparsify/virt-sparsify.pod:42
msgid "IMPORTANT LIMITATIONS"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:48
msgid "The virtual machine I<must be shut down> before using this tool."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:52
msgid ""
"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."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:56 sparsify/virt-sparsify.pod:444
msgid ""
"If you are using the I<--in-place> option, then large amounts of temporary "
"space are B<not> required."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:61
msgid "Virt-sparsify cannot resize disk images.  To do that, use L<virt-resize(1)>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:66
msgid ""
"Virt-sparsify cannot handle encrypted disks.  Libguestfs supports encrypted "
"disks, but encrypted disks themselves cannot be sparsified."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:71
msgid ""
"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."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:77
msgid ""
"In copy mode, qcow2 internal snapshots are not copied over to the "
"destination image."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:82
msgid ""
"You may also want to read the manual pages for the associated tools "
"L<virt-filesystems(1)> and L<virt-df(1)> before starting."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:87
msgid "Typical usage is:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:89
#, no-wrap
msgid ""
" virt-sparsify indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:91
msgid ""
"which copies C<indisk> to C<outdisk>, making the output sparse.  C<outdisk> "
"is created, or overwritten if it already exists.  The format of the input "
"disk is detected (eg. qcow2) and the same format is used for the output "
"disk."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:96
msgid "To convert between formats, use the I<--convert> option:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:98
#, no-wrap
msgid ""
" virt-sparsify disk.raw --convert qcow2 disk.qcow2\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:100
msgid ""
"Virt-sparsify tries to zero and sparsify free space on every filesystem it "
"can find within the source disk image.  You can get it to ignore (don't zero "
"free space on) certain filesystems by doing:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:104
#, no-wrap
msgid ""
" virt-sparsify --ignore /dev/sda1 indisk outdisk\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:106
msgid "See L<virt-filesystems(1)> to get a list of filesystems within a disk image."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:109
msgid ""
"Since virt-sparsify E<ge> 1.26, you can now sparsify a disk image in place "
"by doing:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:112 sparsify/virt-sparsify.pod:350
#, no-wrap
msgid ""
" virt-sparsify --in-place disk.img\n"
"\n"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:122
msgid "B<--check-tmpdir> B<ignore>"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:124
msgid "B<--check-tmpdir> B<continue>"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:126
msgid "B<--check-tmpdir> B<warn>"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:128
msgid "B<--check-tmpdir> B<fail>"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:130
msgid ""
"Check if L</TMPDIR> or I<--tmp> directory has enough space to complete the "
"operation.  This is just an estimate."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:133
msgid "If the check indicates a problem, then you can either:"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:139
msgid "B<ignore> it,"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:143
msgid "print a warning and B<continue>,"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:147
msgid ""
"B<warn> and wait for the user to press the Return key (this is the default), "
"or:"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:152
msgid "B<fail> and exit."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:156 sparsify/virt-sparsify.pod:172
#: sparsify/virt-sparsify.pod:193 sparsify/virt-sparsify.pod:257
#: sparsify/virt-sparsify.pod:279
msgid "You cannot use this option and I<--in-place> together."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:167
msgid "B<--compress>"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:169
msgid ""
"Compress the output file.  This I<only> works if the output format is "
"C<qcow2>."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:174
msgid "B<--convert> raw"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:176
msgid "B<--convert> qcow2"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:178
msgid "B<--convert> [other formats]"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:180
msgid ""
"Use C<output-format> as the format for the destination image.  If this is "
"not specified, then the input format is used."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:183
msgid "Supported and known-working output formats are: C<raw>, C<qcow2>, C<vdi>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:185
msgid ""
"You can also use any format supported by the L<qemu-img(1)> program, "
"eg. C<vmdk>, but support for other formats is reliant on qemu."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:188
msgid ""
"Specifying the I<--convert> option is usually a good idea, because then "
"virt-sparsify doesn't need to try to guess the input format."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:191
msgid "For fine-tuning the output format, see: I<--compress>, I<-o>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:197
msgid ""
"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."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:212
msgid "B<--ignore> filesystem"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:214
msgid "B<--ignore> volgroup"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:216
msgid "Ignore the named filesystem."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:218
msgid ""
"When not using I<--in-place>: Free space on the filesystem will not be "
"zeroed, but existing blocks of zeroes will still be sparsified."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:221
msgid "When using I<--in-place>, the filesystem is ignored completely."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:223
msgid ""
"In the second form, this ignores the named volume group.  Use the volume "
"group name without the F</dev/> prefix, eg. I<--ignore vg_foo>"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:228
msgid "B<--in-place>"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:230
msgid ""
"Do in-place sparsification instead of copying sparsification.  See "
"L</IN-PLACE SPARSIFICATION> below."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:245
msgid "B<-o> option[,option,...]"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:247
msgid ""
"Pass I<-o> option(s) to the L<qemu-img(1)> command to fine-tune the output "
"format.  Options available depend on the output format (see I<--convert>) "
"and the installed version of the qemu-img program."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:251
msgid ""
"You should use I<-o> at most once.  To pass multiple options, separate them "
"with commas, eg:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:254
#, no-wrap
msgid ""
" virt-sparsify --convert qcow2 \\\n"
"   -o cluster_size=512,preallocation=metadata ...\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:263
msgid "This disables progress bars and other unnecessary output."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:265
msgid "B<--tmp> block_device"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:267
msgid "B<--tmp> dir"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:269
msgid ""
"In copying mode only, use the named device or directory as the location of "
"the temporary overlay (see also L</TMPDIR> below)."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:272
msgid ""
"If the parameter given is a block device, then the block device is written "
"to directly.  B<Note this erases the existing contents of the block device>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:276
msgid ""
"If the parameter is a directory, then this is the same as setting the "
"L</TMPDIR> environment variable."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:281
msgid "B<--tmp> prebuilt:file"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:283
msgid ""
"In copying mode only, the specialized option I<--tmp prebuilt:file> (where "
"C<prebuilt:> is a literal string) causes virt-sparsify to use the qcow2 "
"C<file> as temporary space."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:291
msgid ""
"The file B<must> be freshly formatted as qcow2, with indisk as the backing "
"file."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:296
msgid "If you rerun virt-sparsify, you B<must> recreate the file before each run."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:301
msgid "Virt-sparsify does not delete the file."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:305
msgid ""
"This option is used by oVirt which requires a specially formatted temporary "
"file."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:330
msgid "B<--zero> partition"
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:332
msgid "B<--zero> logvol"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:334
msgid ""
"Zero the contents of the named partition or logical volume in the guest.  "
"All data on the device is lost, but sparsification is excellent! You can "
"give this option multiple times."
msgstr ""

#. type: =head1
#: sparsify/virt-sparsify.pod:340
msgid "IN-PLACE SPARSIFICATION"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:342
msgid ""
"Since virt-sparsify E<ge> 1.26, the tool is able to do in-place "
"sparsification (instead of copying from an input disk to an output disk).  "
"This is more efficient.  It is not able to recover quite as much space as "
"copying sparsification."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:347
msgid "To use this mode, specify a disk image which will be modified in place:"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:352
msgid ""
"Some options are not compatible with this mode: I<--convert>, I<--compress> "
"and I<-o> because they require wholesale disk format changes; "
"I<--check-tmpdir> because large amounts of temporary space are not required."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:357
msgid "In-place sparsification works using discard (a.k.a trim or unmap)  support."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:362
msgid ""
"The I<--machine-readable> option can be used to make the output more machine "
"friendly, which is useful when calling virt-sparsify from other programs, "
"GUIs etc."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:368
msgid ""
"Firstly use the option on its own to query the capabilities of the "
"virt-sparsify binary.  Typical output looks like this:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:371
#, no-wrap
msgid ""
" $ virt-sparsify --machine-readable\n"
" virt-sparsify\n"
" ntfs\n"
" btrfs\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:401
msgid ""
"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."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:407
msgid ""
"All versions of virt-sparsify have supported the I<--machine-readable> "
"option."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:415
msgid ""
"Windows 8 \"fast startup\" can prevent virt-sparsify from working.  See "
"L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>."
msgstr ""

#. type: =item
#: sparsify/virt-sparsify.pod:422
msgid "TMPDIR"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:424
msgid ""
"Location of the temporary directory used for the potentially large temporary "
"overlay file."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:427
msgid ""
"In virt-sparsify E<ge> 1.28, you can override this environment variable "
"using the I<--tmp> option."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:430
msgid ""
"You should ensure there is enough free space in the worst case for a full "
"copy of the source disk (I<virtual> size), or else set C<$TMPDIR> to point "
"to another directory that has enough space."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:434
msgid "This defaults to F</tmp>."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:436
msgid ""
"Note that if C<$TMPDIR> is a tmpfs (eg. if F</tmp> is on tmpfs, or if you "
"use C<TMPDIR=/dev/shm>), tmpfs defaults to a maximum size of I<half> 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:"
msgstr ""

#. type: verbatim
#: sparsify/virt-sparsify.pod:442
#, no-wrap
msgid ""
" mount -o remount,size=10G /tmp\n"
"\n"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:453
msgid ""
"This program returns 0 if the operation completed without errors.  (This "
"doesn't necessarily mean that space could be freed up.)"
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:456
msgid "A non-zero exit code indicates an error."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:458
msgid ""
"If the exit code is C<3> and the I<--in-place> option was used, that "
"indicates that discard support is not available in libguestfs, so copying "
"mode must be used instead."
msgstr ""

#. type: textblock
#: sparsify/virt-sparsify.pod:464
msgid ""
"L<virt-df(1)>, L<virt-filesystems(1)>, L<virt-resize(1)>, L<virt-rescue(1)>, "
"L<guestfs(3)>, L<guestfish(1)>, L<truncate(1)>, L<fallocate(1)>, "
"L<qemu-img(1)>, L<http://libguestfs.org/>."
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:1
msgid "B<--append-line> FILE:LINE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:32
msgid "B<--chmod> PERMISSIONS:FILE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:40
msgid "B<--chown> UID:GID:PATH (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:65
msgid "B<--commands-from-file> FILENAME (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:90
msgid "B<--copy> SOURCE:DEST (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:97
msgid "B<--copy-in> LOCALPATH:REMOTEDIR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:105
msgid "B<--delete> PATH (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:119
msgid "B<--edit> FILE:EXPR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:131
msgid "B<--firstboot> SCRIPT (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:150
msgid "B<--firstboot-command> 'CMD+ARGS' (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:164
msgid "B<--firstboot-install> PKG,PKG..  (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:174
msgid "B<--hostname> HOSTNAME (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:180
msgid "B<--inject-blnsvr> METHOD (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:193
msgid "B<--inject-qemu-ga> METHOD (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:208
msgid "B<--inject-virtio-win> METHOD (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:243
msgid "B<--install> PKG,PKG..  (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:255
msgid "B<--keep-user-accounts> USERS (see C<user-account> below)"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:258
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: sysprep/sysprep-extra-options.pod:263
#, no-wrap
msgid ""
" --keep-user-accounts mary\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:265
msgid "would keep the user account C<mary>."
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:267 sysprep/sysprep-extra-options.pod:357
msgid "This option can be specified multiple times."
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:269
msgid "B<--link> TARGET:LINK[:LINK..] (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:275
msgid "B<--mkdir> DIR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:283
msgid "B<--move> SOURCE:DEST (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:290
msgid "B<--no-logfile> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:299
msgid "B<--no-selinux-relabel> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:313
msgid "B<--password> USER:SELECTOR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:322
msgid "B<--password-crypto> md5|sha256|sha512 (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:345
msgid "B<--remove-user-accounts> USERS (see C<user-account> below)"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:348
msgid ""
"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:"
msgstr ""

#. type: verbatim
#: sysprep/sysprep-extra-options.pod:353
#, no-wrap
msgid ""
" --remove-user-accounts bob,eve\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:355
msgid "would only remove the user accounts C<bob> and C<eve>."
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:359
msgid "B<--root-password> SELECTOR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:370
msgid "B<--run> SCRIPT (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:390
msgid "B<--run-command> 'CMD+ARGS' (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:407
msgid "B<--script> SCRIPT (see C<script> below)"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:410
msgid ""
"Run the named C<SCRIPT> (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."
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:414
msgid ""
"B<Note:> If the script is not on the $PATH, then you must give the full "
"absolute path to the script."
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:417
msgid "B<--scriptdir> SCRIPTDIR (see C<script> below)"
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:420
msgid ""
"The mount point (an empty directory on the host) used when the C<script> "
"operation is enabled and one or more scripts are specified using I<--script> "
"parameter(s)."
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:424
msgid "B<Note:> C<SCRIPTDIR> B<must> be an absolute path."
msgstr ""

#. type: textblock
#: sysprep/sysprep-extra-options.pod:426
msgid ""
"If I<--scriptdir> is not specified then a temporary mountpoint will be "
"created."
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:429
msgid "B<--scrub> FILE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:446
msgid "B<--selinux-relabel> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:451
msgid "B<--sm-attach> SELECTOR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:459
msgid "B<--sm-credentials> SELECTOR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:467
msgid "B<--sm-register> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:474
msgid "B<--sm-remove> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:480
msgid "B<--sm-unregister> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:485
msgid "B<--ssh-inject> USER[:SELECTOR] (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:498
msgid "B<--tar-in> TARFILE:REMOTEDIR (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:507
msgid "B<--timezone> TIMEZONE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:513
msgid "B<--touch> FILE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:518
msgid "B<--truncate> FILE (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:524
msgid "B<--truncate-recursive> PATH (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:529
msgid "B<--uninstall> PKG,PKG..  (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:539
msgid "B<--update> (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:548
msgid "B<--upload> FILE:DEST (see C<customize> below)"
msgstr ""

#. type: =item
#: sysprep/sysprep-extra-options.pod:564
msgid "B<--write> FILE:CONTENT (see C<customize> below)"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:1
msgid "B<abrt-data> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:4
msgid "Remove the crash data generated by ABRT."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:6
msgid "Remove the automatically generated ABRT crash data in C</var/spool/abrt/>."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:9
msgid "B<backup-files> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:12
msgid "Remove editor backup files from the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:14
msgid "The following files are removed from anywhere in the guest filesystem:"
msgstr ""

#. type: =item
#: sysprep/sysprep-operations.pod:19 sysprep/sysprep-operations.pod:23
#: sysprep/sysprep-operations.pod:34 sysprep/sysprep-operations.pod:38
#: sysprep/sysprep-operations.pod:42 sysprep/sysprep-operations.pod:46
#: sysprep/sysprep-operations.pod:50 sysprep/sysprep-operations.pod:180
#: sysprep/sysprep-operations.pod:184 sysprep/sysprep-operations.pod:188
#: sysprep/sysprep-operations.pod:192 sysprep/sysprep-operations.pod:196
#: sysprep/sysprep-operations.pod:200 sysprep/sysprep-operations.pod:204
#: sysprep/sysprep-operations.pod:208 sysprep/sysprep-operations.pod:212
#: sysprep/sysprep-operations.pod:216 sysprep/sysprep-operations.pod:220
#: sysprep/sysprep-operations.pod:224 sysprep/sysprep-operations.pod:228
#: sysprep/sysprep-operations.pod:232 sysprep/sysprep-operations.pod:236
#: sysprep/sysprep-operations.pod:240 sysprep/sysprep-operations.pod:244
#: sysprep/sysprep-operations.pod:248 sysprep/sysprep-operations.pod:252
#: sysprep/sysprep-operations.pod:256 sysprep/sysprep-operations.pod:260
#: sysprep/sysprep-operations.pod:264 sysprep/sysprep-operations.pod:268
#: sysprep/sysprep-operations.pod:272 sysprep/sysprep-operations.pod:276
#: sysprep/sysprep-operations.pod:280 sysprep/sysprep-operations.pod:284
#: sysprep/sysprep-operations.pod:288 sysprep/sysprep-operations.pod:292
#: sysprep/sysprep-operations.pod:296 sysprep/sysprep-operations.pod:300
#: sysprep/sysprep-operations.pod:304 sysprep/sysprep-operations.pod:308
#: sysprep/sysprep-operations.pod:312 sysprep/sysprep-operations.pod:316
#: sysprep/sysprep-operations.pod:320 sysprep/sysprep-operations.pod:324
#: sysprep/sysprep-operations.pod:328 sysprep/sysprep-operations.pod:332
#: sysprep/sysprep-operations.pod:336 sysprep/sysprep-operations.pod:340
#: sysprep/sysprep-operations.pod:344 sysprep/sysprep-operations.pod:348
#: sysprep/sysprep-operations.pod:352 sysprep/sysprep-operations.pod:356
#: sysprep/sysprep-operations.pod:360 sysprep/sysprep-operations.pod:364
#: sysprep/sysprep-operations.pod:368 sysprep/sysprep-operations.pod:372
#: sysprep/sysprep-operations.pod:376 sysprep/sysprep-operations.pod:380
#: sysprep/sysprep-operations.pod:384 sysprep/sysprep-operations.pod:388
#: sysprep/sysprep-operations.pod:392 sysprep/sysprep-operations.pod:396
#: sysprep/sysprep-operations.pod:400 sysprep/sysprep-operations.pod:404
#: sysprep/sysprep-operations.pod:408 sysprep/sysprep-operations.pod:412
#: sysprep/sysprep-operations.pod:416 sysprep/sysprep-operations.pod:420
#: sysprep/sysprep-operations.pod:424 sysprep/sysprep-operations.pod:428
#: sysprep/sysprep-operations.pod:432 sysprep/sysprep-operations.pod:436
#: sysprep/sysprep-operations.pod:440 sysprep/sysprep-operations.pod:444
#: sysprep/sysprep-operations.pod:448 sysprep/sysprep-operations.pod:452
#: sysprep/sysprep-operations.pod:456 sysprep/sysprep-operations.pod:542
#: sysprep/sysprep-operations.pod:546 sysprep/sysprep-operations.pod:550
#: sysprep/sysprep-operations.pod:554 sysprep/sysprep-operations.pod:558
#: sysprep/sysprep-operations.pod:562
msgid "·"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:21
msgid "*.bak"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:25
msgid "*~"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:29
msgid ""
"On Linux and Unix operating systems, only the following filesystems will be "
"examined:"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:36
msgid "/etc"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:40
msgid "/root"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:44
msgid "/srv"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:48
msgid "/tmp"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:52
msgid "/var"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:56
msgid "B<bash-history> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:59
msgid "Remove the bash history in the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:61
msgid ""
"Remove the bash history of user \"root\" and any other users who have a "
"C<.bash_history> file in their home directory."
msgstr ""

#. type: =head3
#: sysprep/sysprep-operations.pod:64
msgid "Notes on bash-history"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:66
msgid ""
"Currently this only looks in C</root> and C</home/*> for home directories, "
"so users with home directories in other locations won't have the bash "
"history removed."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:70
msgid "B<blkid-tab> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:73
msgid "Remove blkid tab in the guest."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:75
msgid "B<ca-certificates>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:77
msgid "Remove CA certificates in the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:79
msgid "In case any certificate is removed, the system CA store is updated."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:81
msgid "B<crash-data> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:84
msgid "Remove the crash data generated by kexec-tools."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:86
msgid "Remove the automatically generated kdump kernel crash data."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:88
msgid "B<cron-spool> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:91
msgid "Remove user at-jobs and cron-jobs."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:93
msgid "B<customize> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:96
msgid "Customize the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:98
msgid ""
"Customize the guest by providing L<virt-customize(1)> options for installing "
"packages, editing files and so on."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:101
msgid "B<dhcp-client-state> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:104
msgid "Remove DHCP client leases."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:106
msgid "B<dhcp-server-state> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:109
msgid "Remove DHCP server leases."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:111
msgid "B<dovecot-data> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:114
msgid "Remove Dovecot (mail server) data."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:116
msgid "B<firewall-rules>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:118
msgid "Remove the firewall rules."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:120
msgid ""
"This removes custom firewall rules by removing C</etc/sysconfig/iptables> or "
"custom firewalld configuration in C</etc/firewalld/*/*>."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:123
msgid ""
"Note this is I<not> enabled by default since it may expose guests to "
"exploits.  Use with care."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:126
msgid "B<flag-reconfiguration>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:128
msgid "Flag the system for reconfiguration."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:130
msgid ""
"For Linux guests, this touches C</.unconfigured>, which causes the first "
"boot to interactively query the user for settings such as the root password "
"and timezone."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:134
msgid "B<fs-uuids>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:136
msgid "Change filesystem UUIDs."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:138
msgid ""
"On guests and filesystem types where this is supported, new random UUIDs are "
"generated and assigned to filesystems."
msgstr ""

#. type: =head3
#: sysprep/sysprep-operations.pod:141
msgid "Notes on fs-uuids"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:143
msgid ""
"The fs-uuids operation is disabled by default because it does not yet find "
"and update all the places in the guest that use the UUIDs.  For example "
"C</etc/fstab> or the bootloader.  Enabling this operation is more likely "
"than not to make your guest unbootable."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:149
msgid "See: L<https://bugzilla.redhat.com/show_bug.cgi?id=991641>"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:151
msgid "B<ipa-client> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:154
msgid "Remove the IPA files."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:156
msgid ""
"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."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:160
msgid "This operation does not run C<ipa-client>."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:162
msgid "B<kerberos-data>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:164
msgid "Remove Kerberos data in the guest."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:166
msgid "B<kerberos-hostkeytab> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:169
msgid "Remove the Kerberos host keytab file in the guest."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:171
msgid "B<logfiles> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:174
msgid "Remove many log files from the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:176 sysprep/sysprep-operations.pod:538
msgid "On Linux the following files are removed:"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:182
msgid "/etc/Pegasus/*.cnf"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:186
msgid "/etc/Pegasus/*.crt"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:190
msgid "/etc/Pegasus/*.csr"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:194
msgid "/etc/Pegasus/*.pem"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:198
msgid "/etc/Pegasus/*.srl"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:202
msgid "/root/anaconda-ks.cfg"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:206
msgid "/root/anaconda-post.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:210
msgid "/root/initial-setup-ks.cfg"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:214
msgid "/root/install.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:218
msgid "/root/install.log.syslog"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:222
msgid "/root/original-ks.cfg"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:226
msgid "/var/cache/fontconfig/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:230
msgid "/var/cache/gdm/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:234
msgid "/var/cache/man/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:238
msgid "/var/lib/AccountService/users/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:242
msgid "/var/lib/fprint/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:246
msgid "/var/lib/logrotate.status"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:250
msgid "/var/log/*.log*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:254
msgid "/var/log/BackupPC/LOG"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:258
msgid "/var/log/ConsoleKit/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:262
msgid "/var/log/anaconda.syslog"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:266
msgid "/var/log/anaconda/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:270
msgid "/var/log/apache2/*_log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:274
msgid "/var/log/apache2/*_log-*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:278
msgid "/var/log/apt/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:282
msgid "/var/log/aptitude*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:286
msgid "/var/log/audit/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:290
msgid "/var/log/btmp*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:294
msgid "/var/log/ceph/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:298
msgid "/var/log/chrony/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:302
msgid "/var/log/cron*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:306
msgid "/var/log/cups/*_log*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:310
msgid "/var/log/debug*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:314
msgid "/var/log/dmesg*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:318
msgid "/var/log/exim4/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:322
msgid "/var/log/faillog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:326
msgid "/var/log/firewalld*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:330
msgid "/var/log/gdm/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:334
msgid "/var/log/glusterfs/*glusterd.vol.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:338
msgid "/var/log/glusterfs/glusterfs.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:342
msgid "/var/log/grubby*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:346
msgid "/var/log/httpd/*log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:350
msgid "/var/log/installer/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:354
msgid "/var/log/jetty/jetty-console.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:358
msgid "/var/log/journal/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:362
msgid "/var/log/lastlog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:366
msgid "/var/log/libvirt/libvirtd.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:370
msgid "/var/log/libvirt/libxl/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:374
msgid "/var/log/libvirt/lxc/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:378
msgid "/var/log/libvirt/qemu/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:382
msgid "/var/log/libvirt/uml/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:386
msgid "/var/log/lightdm/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:390
msgid "/var/log/mail/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:394
msgid "/var/log/maillog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:398
msgid "/var/log/messages*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:402
msgid "/var/log/ntp"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:406
msgid "/var/log/ntpstats/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:410
msgid "/var/log/ppp/connect-errors"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:414
msgid "/var/log/rhsm/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:418
msgid "/var/log/sa/*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:422
msgid "/var/log/secure*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:426
msgid "/var/log/setroubleshoot/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:430
msgid "/var/log/spooler*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:434
msgid "/var/log/squid/*.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:438
msgid "/var/log/syslog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:442
msgid "/var/log/tallylog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:446
msgid "/var/log/tuned/tuned.log"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:450
msgid "/var/log/wtmp*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:454
msgid "/var/log/xferlog*"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:458
msgid "/var/named/data/named.run"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:462
msgid "B<lvm-system-devices> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:465
msgid "Remove LVM2 system.devices file."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:467
msgid ""
"On Linux guests, LVM2's scanning for physical volumes (PVs) may be "
"restricted to those block devices whose WWIDs are listed in "
"C</etc/lvm/devices/system.devices>.  When cloning VMs, WWIDs may change, "
"breaking C<lvm pvscan>.  Remove C</etc/lvm/devices/system.devices>."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:469
msgid "B<lvm-uuids> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:472
msgid "Change LVM2 PV and VG UUIDs."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:474
msgid ""
"On Linux guests that have LVM2 physical volumes (PVs) or volume groups "
"(VGs), new random UUIDs are generated and assigned to those PVs and VGs."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:477
msgid "B<machine-id> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:480
msgid "Remove the local machine ID."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:482
msgid ""
"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."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:487
msgid "B<mail-spool> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:490
msgid "Remove email from the local mail spool directory."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:492
msgid "B<net-hostname> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:495
msgid "Remove HOSTNAME and DHCP_HOSTNAME in network interface configuration."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:497 sysprep/sysprep-operations.pod:505
msgid ""
"For Fedora and Red Hat Enterprise Linux, this is removed from C<ifcfg-*> "
"files."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:500
msgid "B<net-hwaddr> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:503
msgid "Remove HWADDR (hard-coded MAC address) configuration."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:508
msgid "B<net-nmconn> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:511
msgid "Remove system-local NetworkManager connection profiles (keyfiles)."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:513
msgid ""
"On Fedora and Red Hat Enterprise Linux, remove the "
"C</etc/NetworkManager/system-connections/*.nmconnection> files."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:515
msgid "B<pacct-log> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:518
msgid "Remove the process accounting log files."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:520
msgid ""
"The system wide process accounting will store to the pacct log files if the "
"process accounting is on."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:523
msgid "B<package-manager-cache> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:526
msgid "Remove package manager cache."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:528
msgid "B<pam-data> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:531
msgid "Remove the PAM data in the guest."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:533
msgid "B<passwd-backups> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:536
msgid "Remove /etc/passwd- and similar backup files."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:544
msgid "/etc/group-"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:548
msgid "/etc/gshadow-"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:552
msgid "/etc/passwd-"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:556
msgid "/etc/shadow-"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:560
msgid "/etc/subgid-"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:564
msgid "/etc/subuid-"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:568
msgid "B<puppet-data-log> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:571
msgid "Remove the data and log files of puppet."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:573
msgid "B<rh-subscription-manager> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:576
msgid "Remove the RH subscription manager files."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:578
msgid "B<rhn-systemid> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:581
msgid "Remove the RHN system ID."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:583
msgid "B<rpm-db> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:586
msgid "Remove host-specific RPM database files."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:588
msgid ""
"Remove host-specific RPM database files and locks.  RPM will recreate these "
"files automatically if needed."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:591
msgid "B<samba-db-log> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:594
msgid "Remove the database and log files of Samba."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:596
msgid "B<script> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:599
msgid "Run arbitrary scripts against the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:601
msgid ""
"The C<script> module lets you run arbitrary shell scripts or programs "
"against the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:604
msgid ""
"Note this feature requires FUSE support.  You may have to enable this in "
"your host, for example by adding the current user to the C<fuse> group, or "
"by loading a kernel module."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:608
msgid ""
"Use one or more I<--script> parameters to specify scripts or programs that "
"will be run against the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:611
msgid ""
"The script or program is run with its current directory being the guest’s "
"root directory, so relative paths should be used.  For example: C<rm "
"etc/resolv.conf> in the script would remove a Linux guest’s DNS "
"configuration file, but C<rm /etc/resolv.conf> would (try to) remove the "
"host’s file."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:617
msgid ""
"Normally a temporary mount point for the guest is used, but you can choose a "
"specific one by using the I<--scriptdir> parameter."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:620
msgid ""
"B<Note:> This is different from I<--firstboot> scripts (which run in the "
"context of the guest when it is booting first time).  I<--script> scripts "
"run on the host, not in the guest."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:624
msgid "B<smolt-uuid> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:627
msgid "Remove the Smolt hardware UUID."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:629
msgid "B<ssh-hostkeys> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:632
msgid "Remove the SSH host keys in the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:634
msgid ""
"The SSH host keys are regenerated (differently) next time the guest is "
"booted."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:637
msgid ""
"If, after cloning, the guest gets the same IP address, ssh will give you a "
"stark warning about the host key changing:"
msgstr ""

#. type: verbatim
#: sysprep/sysprep-operations.pod:640
#, no-wrap
msgid ""
" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
" @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @\n"
" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
" IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
"\n"
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:645
msgid "B<ssh-userdir> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:648
msgid "Remove \".ssh\" directories in the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:650
msgid ""
"Remove the C<.ssh> directory of user \"root\" and any other users who have a "
"C<.ssh> directory in their home directory."
msgstr ""

#. type: =head3
#: sysprep/sysprep-operations.pod:653
msgid "Notes on ssh-userdir"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:655
msgid ""
"Currently this only looks in C</root> and C</home/*> for home directories, "
"so users with home directories in other locations won't have the ssh files "
"removed."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:659
msgid "B<sssd-db-log> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:662
msgid "Remove the database and log files of sssd."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:664
msgid "B<tmp-files> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:667
msgid "Remove temporary files."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:669
msgid "This removes temporary files under C</tmp> and C</var/tmp>."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:671
msgid "B<udev-persistent-net> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:674
msgid "Remove udev persistent net rules."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:676
msgid ""
"Remove udev persistent net rules which map the guest’s existing MAC address "
"to a fixed ethernet device (eg. eth0)."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:679
msgid ""
"After a guest is cloned, the MAC address usually changes.  Since the old MAC "
"address occupies the old name (eg. eth0), this means the fresh MAC address "
"is assigned to a new name (eg. eth1) and this is usually undesirable.  "
"Erasing the udev persistent net rules avoids this."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:684
msgid "B<user-account>"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:686
msgid "Remove the user accounts in the guest."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:688
msgid ""
"By default remove all the user accounts and their home directories.  The "
"\"root\" account is not removed."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:691
msgid ""
"See the I<--remove-user-accounts> parameter for a way to specify how to "
"remove only some users, or to not remove some others."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:694
msgid "B<utmp> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:697
msgid "Remove the utmp file."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:699
msgid ""
"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."
msgstr ""

#. type: =head2
#: sysprep/sysprep-operations.pod:703
msgid "B<yum-uuid> *"
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:706
msgid "Remove the yum UUID."
msgstr ""

#. type: textblock
#: sysprep/sysprep-operations.pod:708
msgid ""
"Yum creates a fresh UUID the next time it runs when it notices that the "
"original UUID has been erased."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:3
msgid ""
"virt-sysprep - Reset, unconfigure or customize a virtual machine so clones "
"can be made"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:7
#, no-wrap
msgid ""
" virt-sysprep [--options] -d domname\n"
"\n"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:9
#, no-wrap
msgid ""
" virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:13
msgid ""
"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."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:20
msgid ""
"Virt-sysprep modifies the guest or disk image I<in place>.  The guest must "
"be shut down.  If you want to preserve the existing contents of the guest, "
"I<you must snapshot, copy or clone the disk first>.  See L</COPYING AND "
"CLONING> below."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:25
msgid ""
"You do I<not> 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."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:31
msgid ""
"\"Sysprep\" stands for \"system preparation\" tool.  The name comes from the "
"Microsoft program F<sysprep.exe> which is used to unconfigure Windows "
"machines in preparation for cloning them.  (Virt-sysprep does not work on "
"Microsoft Windows guests.)"
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:93
msgid "B<--enable> operations"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:95 sysprep/virt-sysprep.pod:119
msgid ""
"Choose which sysprep operations to perform.  Give a comma-separated list of "
"operations, for example:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:98
#, no-wrap
msgid ""
" --enable ssh-hostkeys,udev-persistent-net\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:100 sysprep/virt-sysprep.pod:124
msgid "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:102
msgid ""
"If the I<--enable> option is not given, then we default to trying most "
"sysprep operations (see I<--list-operations> to show which are enabled)."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:106
msgid ""
"Regardless of the I<--enable> option, sysprep operations are skipped for "
"some guest types."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:109 sysprep/virt-sysprep.pod:150
msgid ""
"Use I<--list-operations> to list operations supported by a particular "
"version of virt-sysprep."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:112 sysprep/virt-sysprep.pod:153
msgid "See L</OPERATIONS> below for a list and an explanation of each operation."
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:115
msgid "B<--operation> operations"
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:117
msgid "B<--operations> operations"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:122
#, no-wrap
msgid ""
" --operations ssh-hostkeys,udev-persistent-net\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:126
msgid ""
"I<--operations> allows you to enable and disable any operation, including "
"the default ones (which would be tried when specifying neither "
"I<--operations> nor I<--enable>) and all the available ones; prepending a "
"C<-> in front of an operation name removes it from the list of enabled "
"operations, while the meta-names C<defaults> and C<all> represent "
"respectively the operations enabled by default and all the available ones.  "
"For example:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:134
#, no-wrap
msgid ""
" --operations firewall-rules,defaults,-tmp-files\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:136
msgid ""
"would enable the C<firewall-rules> operation (regardless whether it is "
"enabled by default), all the default ones, and disable the C<tmp-files> "
"operation."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:139
msgid ""
"I<--operations> can be specified multiple times; the first time the set of "
"enabled operations is empty, while any further I<--operations> affects the "
"operations enabled so far."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:143
msgid ""
"If the I<--operations> option is not given, then we default to trying most "
"sysprep operations (see I<--list-operations> to show which are enabled)."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:147
msgid ""
"Regardless of the I<--operations> option, sysprep operations are skipped for "
"some guest types."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:158
msgid ""
"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."
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:174
#, no-wrap
msgid ""
" virt-sysprep --format raw -a disk.img\n"
"\n"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:178
#, no-wrap
msgid ""
" virt-sysprep --format raw -a disk.img --format auto -a another.img\n"
"\n"
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:191
msgid "B<--list-operations>"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:193
msgid "List the operations supported by the virt-sysprep program."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:195
msgid ""
"These are listed one per line, with one or more single-space-separated "
"fields, eg:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:198
#, no-wrap
msgid ""
" $ virt-sysprep --list-operations\n"
" bash-history * Remove the bash history in the guest\n"
" cron-spool * Remove user at-jobs and cron-jobs\n"
" dhcp-client-state * Remove DHCP client leases\n"
" dhcp-server-state * Remove DHCP server leases\n"
" [etc]\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:205
msgid ""
"The first field is the operation name, which can be supplied to "
"I<--enable>.  The second field is a C<*> character if the operation is "
"enabled by default or blank if not.  Subsequent fields on the same line are "
"the description of the operation."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:210
msgid ""
"Before libguestfs 1.17.33 only the first (operation name) field was shown "
"and all operations were enabled by default."
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:213
msgid "B<--mount-options> mp:opts[;mp:opts;...]"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:215
msgid ""
"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."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:219
msgid ""
"Use a semicolon-separated list of C<mountpoint:options> pairs.  You may need "
"to quote this list to protect it from the shell."
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:224
#, no-wrap
msgid ""
" --mount-options \"/:noatime\"\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:226
msgid "will mount the root directory with C<notime>.  This example:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:228
#, no-wrap
msgid ""
" --mount-options \"/:noatime;/var:rw,nodiratime\"\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:230
msgid "will do the same, plus mount F</var> with C<rw,nodiratime>."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:246
msgid ""
"In virt-sysprep, the network is I<disabled> by default.  You must use "
"I<--network> to enable it, in order that options such as I<--install> or "
"I<--update> will work."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:250
msgid ""
"L<virt-builder(1)> has more information about the security advantages of "
"disabling the network."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:275
msgid "__EXTRA_OPTIONS__"
msgstr ""

#. type: =head1
#: sysprep/virt-sysprep.pod:279
msgid "OPERATIONS"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:281
msgid ""
"If the I<--enable>/I<--operations> option is I<not> given, then most sysprep "
"operations are enabled."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:284
msgid ""
"Use C<virt-sysprep --list-operations> to list all operations for your "
"virt-sysprep binary.  The ones which are enabled by default are marked with "
"a C<*> character.  Regardless of the I<--enable>/I<--operations> options, "
"sysprep operations are skipped for some guest types."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:289
msgid ""
"Operations can be individually enabled using the I<--enable>/I<--operations> "
"options.  Use a comma-separated list, for example:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:293
#, no-wrap
msgid ""
" virt-sysprep --operations ssh-hostkeys,udev-persistent-net [etc..]\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:295
msgid ""
"Future versions of virt-sysprep may add more operations.  If you are using "
"virt-sysprep and want predictable behaviour, specify only the operations "
"that you want to have enabled."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:299
msgid ""
"C<*> = enabled by default when no I<--enable>/I<--operations> option is "
"given."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:302
msgid "__OPERATIONS__"
msgstr ""

#. type: =head1
#: sysprep/virt-sysprep.pod:304
msgid "COPYING AND CLONING"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:306
msgid ""
"Virt-sysprep can be used as part of a process of cloning guests, or to "
"prepare a template from which guests can be cloned.  There are many "
"different ways to achieve this using the virt tools, and this section is "
"just an introduction."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:311
msgid "A virtual machine (when switched off) consists of two parts:"
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:315
msgid "I<configuration>"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:317
msgid ""
"The configuration or description of the guest.  eg. The libvirt XML (see "
"C<virsh dumpxml>), the running configuration of the guest, or another "
"external format like OVF."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:321
msgid "Some configuration items that might need to be changed:"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:327
msgid "name"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:331 sysprep/virt-sysprep.pod:358
msgid "UUID"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:335
msgid "path to block device(s)"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:339
msgid "network card MAC address"
msgstr ""

#. type: =item
#: sysprep/virt-sysprep.pod:343
msgid "I<block device(s)>"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:345
msgid ""
"One or more hard disk images, themselves containing files, directories, "
"applications, kernels, configuration, etc."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:348
msgid "Some things inside the block devices that might need to be changed:"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:354
msgid "hostname and other net configuration"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:362
msgid "SSH host keys"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:366
msgid "Windows unique security ID (SID)"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:370
msgid "Puppet registration"
msgstr ""

#. type: =head2
#: sysprep/virt-sysprep.pod:376
msgid "COPYING THE BLOCK DEVICE"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:378
msgid ""
"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."
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:383
#, no-wrap
msgid ""
"                        virt-sysprep\n"
"                             |\n"
"                             v\n"
" original guest --------> template ---------->\n"
"                                      \\------> cloned\n"
"                                       \\-----> guests\n"
"                                        \\---->\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:391
msgid ""
"You can, of course, just copy the block device on the host using L<cp(1)> or "
"L<dd(1)>."
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:394
#, no-wrap
msgid ""
"                   dd                 dd\n"
" original guest --------> template ---------->\n"
"                                      \\------> cloned\n"
"                                       \\-----> guests\n"
"                                        \\---->\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:400
msgid "There are some smarter (and faster) ways too:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:402
#, no-wrap
msgid ""
"                          snapshot\n"
"                template ---------->\n"
"                            \\------> cloned\n"
"                             \\-----> guests\n"
"                              \\---->\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:408
msgid ""
"You may want to run virt-sysprep twice, once to reset the guest (to make a "
"template) and a second time to customize the guest for a specific user:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:412
#, no-wrap
msgid ""
"                    virt-sysprep        virt-sysprep\n"
"                      (reset)      (add user, keys, logos)\n"
"                         |                   |\n"
"                 dd      v          dd       v\n"
" original guest ----> template ---------> copied ------> custom\n"
"                                          template       guest\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:423
msgid "Create a snapshot using qemu-img:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:425
#, no-wrap
msgid ""
" qemu-img create -f qcow2 -o backing_file=original snapshot.qcow\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:427
msgid ""
"The advantage is that you don’t need to copy the original (very fast)  and "
"only changes are stored (less storage required)."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:430
msgid ""
"Note that writing to the backing file once you have created guests on top of "
"it is not possible: you will corrupt the guests."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:435
msgid "Create a snapshot using C<lvcreate --snapshot>."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:439
msgid ""
"Other ways to create snapshots include using filesystems-level tools (for "
"filesystems such as btrfs)."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:442
msgid ""
"Most Network Attached Storage (NAS) devices can also create cheap snapshots "
"from files or LUNs."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:447
msgid ""
"Get your NAS to duplicate the LUN.  Most NAS devices can also duplicate LUNs "
"very cheaply (they copy them on-demand in the background)."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:453
msgid "Prepare your template using L<virt-sparsify(1)>.  See below."
msgstr ""

#. type: =head2
#: sysprep/virt-sysprep.pod:457
msgid "VIRT-CLONE"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:459
msgid ""
"A separate tool, L<virt-clone(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."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:464
msgid ""
"L<virt-clone(1)> does not use libguestfs and cannot look inside the disk "
"image.  This was the original motivation to write virt-sysprep."
msgstr ""

#. type: =head2
#: sysprep/virt-sysprep.pod:467
msgid "SPARSIFY"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:469
#, no-wrap
msgid ""
"              virt-sparsify\n"
" original guest --------> template\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:472
msgid ""
"L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
"it easier to compress and/or faster to copy."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:475
msgid ""
"Notice that since virt-sparsify also copies the image, you can use it to "
"make the initial copy (instead of C<dd>)."
msgstr ""

#. type: =head2
#: sysprep/virt-sysprep.pod:478
msgid "RESIZE"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:480
#, no-wrap
msgid ""
"                         virt-resize\n"
"                template ---------->\n"
"                            \\------> cloned\n"
"                             \\-----> guests\n"
"                              \\---->\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:486
msgid ""
"If you want to give people cloned guests, but let them pick the size of the "
"guest themselves (eg. depending on how much they are prepared to pay for "
"disk space), then instead of copying the template, you can run "
"L<virt-resize(1)>.  Virt-resize performs a copy and resize, and thus is "
"ideal for cloning guests from a template."
msgstr ""

#. type: =head1
#: sysprep/virt-sysprep.pod:492
msgid "FIRSTBOOT VS SCRIPT"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:494
msgid ""
"The two options I<--firstboot> and I<--script> both supply shell scripts "
"that are run against the guest.  However these two options are significantly "
"different."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:498
msgid ""
"I<--firstboot script> uploads the file C<script> 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\")."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:502
msgid ""
"I<--script script> runs the shell C<script> I<on the host>, with its current "
"directory inside the guest filesystem."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:505
msgid ""
"If you needed, for example, to C<yum install> new packages, then you I<must "
"not> use I<--script> for this, since that would (a) run the C<yum> command "
"on the host and (b) wouldn't have access to the same resources "
"(repositories, keys, etc.) as the guest.  Any command that needs to run on "
"the guest I<must> be run via I<--firstboot>."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:511
msgid ""
"On the other hand if you need to make adjustments to the guest filesystem "
"(eg. copying in files), then I<--script> is ideal since (a)  it has access "
"to the host filesystem and (b) you will get immediate feedback on errors."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:516
msgid "Either or both options can be used multiple times on the command line."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:520
msgid ""
"Virtual machines that employ full disk encryption I<internally to the guest> "
"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 L<LUKS "
"FAQ|https://gitlab.com/cryptsetup/cryptsetup/-/blob/main/FAQ.md> for "
"details."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:527
msgid ""
"Although virt-sysprep removes some sensitive information from the guest, it "
"does not pretend to remove all of it.  You should examine the L</OPERATIONS> "
"above and the guest afterwards."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:531
msgid ""
"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 "
"I<--scrub> option can be used to scrub files instead of just deleting them.  "
"L<virt-sparsify(1)> is another way to remove this content.  See also the "
"L<scrub(1)> command to get rid of deleted content in directory entries and "
"inodes."
msgstr ""

#. type: =head2
#: sysprep/virt-sysprep.pod:538
msgid "RANDOM SEED"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:540
msgid "I<(This section applies to Linux guests only)>"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:542
msgid ""
"For supported guests, virt-sysprep writes a few bytes of randomness from the "
"host into the guest’s random seed file."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:545
msgid ""
"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."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:549
msgid ""
"Therefore you should arrange to add more randomness I<after> cloning from a "
"template too, which can be done by enabling just the customize module:"
msgstr ""

#. type: verbatim
#: sysprep/virt-sysprep.pod:553
#, no-wrap
msgid ""
" cp template.img newguest.img\n"
" virt-sysprep --enable customize -a newguest.img\n"
"\n"
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:566
msgid ""
"Windows 8 \"fast startup\" can prevent virt-sysprep from working.  See "
"L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:611
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-builder(1)>, L<virt-clone(1)>, "
"L<virt-customize(1)>, L<virt-rescue(1)>, L<virt-resize(1)>, "
"L<virt-sparsify(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)>, "
"L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:630
msgid "Wanlong Gao, Fujitsu Ltd."
msgstr ""

#. type: textblock
#: sysprep/virt-sysprep.pod:636
msgid "Copyright (C) 2012 Fujitsu Ltd."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:34
msgid ""
"virt-win-reg - Export and merge Windows Registry entries from a Windows "
"guest"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:38
#, no-wrap
msgid ""
" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
"\n"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:40
#, no-wrap
msgid ""
" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
"\n"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:42
#, no-wrap
msgid ""
" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
"\n"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:44
#, no-wrap
msgid ""
" virt-win-reg --merge domname [input.reg ...]\n"
"\n"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:46
#, no-wrap
msgid ""
" virt-win-reg [--options] disk.img ... # instead of domname\n"
"\n"
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:48
msgid "WARNING"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:50
msgid ""
"You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
"virtual machines.  If you do this, you I<will> get irreversible disk "
"corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
"but doesn't catch all cases."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:55
msgid ""
"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 I<--merge> option, make sure "
"you have a reliable backup first."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:62
msgid ""
"This program can export and merge Windows Registry entries from a Windows "
"guest."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:65
msgid ""
"The first parameter is the libvirt guest name or the raw disk image of a "
"Windows guest."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:68
msgid ""
"If I<--merge> is I<not> specified, then the chosen registry key is "
"displayed/exported (recursively).  For example:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:71
#, no-wrap
msgid ""
" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:73
msgid "You can also display single values from within registry keys, for example:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:76
#, no-wrap
msgid ""
" $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
" $ virt-win-reg Windows7 $cvkey ProductName\n"
" Windows 7 Enterprise\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:80
msgid ""
"With I<--merge>, you can merge a textual regedit file into the Windows "
"Registry:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:83
#, no-wrap
msgid ""
" $ virt-win-reg --merge Windows7 changes.reg\n"
"\n"
msgstr ""

#. type: =head2
#: win-reg/virt-win-reg.in:85
msgid "NOTE"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:87
msgid ""
"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 L<libguestfs(3)> or L<guestfish(1)> "
"and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
"L<hivexregedit(1)>."
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:125
msgid "B<-c URI>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:127
msgid "B<--connect URI>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:156
msgid "B<--merge>"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:158
msgid ""
"In merge mode, this merges a textual regedit file into the Windows Registry "
"of the virtual machine.  If this flag is I<not> given then virt-win-reg "
"displays or exports Registry entries instead."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:162
msgid ""
"Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
"result in disk corruption.  However exporting (without this flag)  is always "
"safe."
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:170
msgid "B<--encoding> UTF-16LE|ASCII"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:172
msgid ""
"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<Win::Hivex::Regedit(3)/ENCODING STRINGS>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:176
msgid ""
"The default is to use UTF-16LE, which should work with recent versions of "
"Windows."
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:183
msgid "B<--unsafe-printable-strings>"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:185
msgid ""
"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."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:189
msgid ""
"This is unsafe and does not preserve the fidelity of strings in the original "
"Registry for various reasons:"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:196
msgid ""
"Assumes the original encoding is UTF-16LE.  ASCII strings and strings in "
"other encodings will be corrupted by this transformation."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:201
msgid ""
"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."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:207
msgid ""
"Loses information about whether a zero codepoint followed the string in the "
"Registry or not."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:212
msgid ""
"This all happens because the Registry itself contains no information about "
"how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:216
msgid ""
"You should only use this option for quick hacking and debugging of the "
"Registry contents, and I<never> use it if the output is going to be passed "
"into another program or stored in another Registry."
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:603
msgid "SUPPORTED SYSTEMS"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:605
msgid ""
"The program currently supports Windows NT-derived guests starting with "
"Windows XP through to at least Windows 8."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:608
msgid "The following Registry keys are supported:"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:612
msgid "C<HKEY_LOCAL_MACHINE\\SAM>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:614
msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:616
msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:618
msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:620
msgid "C<HKEY_USERS\\.DEFAULT>"
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:622
msgid "C<HKEY_USERS\\I<SID>>"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:624
msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)."
msgstr ""

#. type: =item
#: win-reg/virt-win-reg.in:626
msgid "C<HKEY_USERS\\I<username>>"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:628
msgid "where I<username> is a local user name (this is a libguestfs extension)."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:632
msgid ""
"You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
"C<HKEY_USERS>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:635
msgid ""
"The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not "
"supported (there is no \"current user\")."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:640
msgid ""
"Windows 8 \"fast startup\" can prevent virt-win-reg from being able to edit "
"the Registry.  See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST "
"STARTUP>."
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:644
msgid "ENCODING"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:646
msgid ""
"C<virt-win-reg> 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."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:652
msgid ""
"To reencode a file from Windows format to Linux (before processing it with "
"the I<--merge> option), you would do something like this:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:655
#, no-wrap
msgid ""
" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:657
msgid ""
"To go in the opposite direction, after exporting and before sending the file "
"to a Windows user, do something like this:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:660
#, no-wrap
msgid ""
" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:662
msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:664
msgid ""
"If you are unsure about the current encoding, use the L<file(1)> command.  "
"Recent versions of Windows regedit.exe produce a UTF-16LE file with "
"Windows-style (CRLF) line endings, like this:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:668
#, no-wrap
msgid ""
" $ file software.reg\n"
" software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
" with CRLF line terminators\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:672
msgid "This file would need conversion before you could I<--merge> it."
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:674
msgid "CurrentControlSet etc."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:676
msgid ""
"Registry keys like C<CurrentControlSet> don’t really exist in the Windows "
"Registry at the level of the hive file, and therefore you cannot modify "
"these."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:680
msgid ""
"C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
"circumstances it might refer to another control set.  The way to find out is "
"to look at the C<HKLM\\SYSTEM\\Select> key:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:684
#, no-wrap
msgid ""
" # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
" [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
" \"Current\"=dword:00000001\n"
" \"Default\"=dword:00000001\n"
" \"Failed\"=dword:00000000\n"
" \"LastKnownGood\"=dword:00000002\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:691
msgid "\"Current\" is the one which Windows will choose when it boots."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:693
msgid "Similarly, other C<Current...> keys in the path may need to be replaced."
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:696
msgid "DELETING REGISTRY KEYS AND VALUES"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:698
msgid "To delete a whole registry key, use the syntax:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:700
#, no-wrap
msgid ""
" [-HKEY_LOCAL_MACHINE\\Foo]\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:702
msgid "To delete a single value within a key, use the syntax:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:704
#, no-wrap
msgid ""
" [HKEY_LOCAL_MACHINE\\Foo]\n"
" \"Value\"=-\n"
"\n"
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:707
msgid "WINDOWS TIPS"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:709
msgid ""
"Note that some of these tips modify the guest disk image.  The guest I<must> "
"be shut off, else you will get disk corruption."
msgstr ""

#. type: =head2
#: win-reg/virt-win-reg.in:712
msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:714
msgid ""
"Prepare a DOS batch script, VBScript or executable.  Upload this using "
"L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
"is uploaded into C<C:\\>:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:718
#, no-wrap
msgid ""
" guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:720
msgid "Prepare a regedit file containing the registry change:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:722
#, no-wrap
msgid ""
" cat > test.reg <<'EOF'\n"
" [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
" \"Test\"=\"c:\\\\test.bat\"\n"
" EOF\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:727
msgid ""
"In this example we use the key C<RunOnce> which means that the script will "
"run precisely once when the first user logs in.  If you want it to run every "
"time a user logs in, replace C<RunOnce> with C<Run>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:731
msgid "Now update the registry:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:733
#, no-wrap
msgid ""
" virt-win-reg --merge WindowsGuest test.reg\n"
"\n"
msgstr ""

#. type: =head2
#: win-reg/virt-win-reg.in:735
msgid "INSTALLING A SERVICE"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:737
msgid ""
"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."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:742
msgid ""
"First upload the program and optionally the service wrapper.  In this case "
"the test program is called C<test.exe> and we are using the RHSrvAny "
"wrapper:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:746
#, no-wrap
msgid ""
" guestfish -i -d WindowsGuest <<EOF\n"
"   upload rhsrvany.exe /rhsrvany.exe\n"
"   upload test.exe /test.exe\n"
" EOF\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:751
msgid ""
"Prepare a regedit file containing the registry changes.  In this example, "
"the first registry change is needed for the service itself or the service "
"wrapper (if used).  The second registry change is only needed because I am "
"using the RHSrvAny service wrapper."
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:756
#, no-wrap
msgid ""
" cat > service.reg <<'EOF'\n"
" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
" \"Type\"=dword:00000010\n"
" \"Start\"=dword:00000002\n"
" \"ErrorControl\"=dword:00000001\n"
" \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
" \"DisplayName\"=\"RHSrvAny\"\n"
" \"ObjectName\"=\"NetworkService\"\n"
" \n"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:765
#, no-wrap
msgid ""
" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
" \"CommandLine\"=\"c:\\\\test.exe\"\n"
" \"PWD\"=\"c:\\\\Temp\"\n"
" EOF\n"
"\n"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:776
msgid ""
"For use of C<ControlSet001> 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."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:782
msgid ""
"C<\"ObjectName\"> controls the privileges that the service will have.  An "
"alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
"privileged account."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:788
msgid ""
"For the meaning of the magic numbers, see this Microsoft KB article: "
"L<http://support.microsoft.com/kb/103000>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:793
msgid "Update the registry:"
msgstr ""

#. type: verbatim
#: win-reg/virt-win-reg.in:795
#, no-wrap
msgid ""
" virt-win-reg --merge WindowsGuest service.reg\n"
"\n"
msgstr ""

#. type: =head1
#: win-reg/virt-win-reg.in:797
msgid "SHELL QUOTING"
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:799
msgid ""
"Be careful when passing parameters containing C<\\> (backslash) in the "
"shell.  Usually you will have to use 'single quotes' or double backslashes "
"(but not both) to protect them from the shell."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:803
msgid "Paths and value names are case-insensitive."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:807
msgid ""
"L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, "
"L<guestfish(1)>, L<virt-cat(1)>, L<virt-tail(1)>, L<Sys::Guestfs(3)>, "
"L<Win::Hivex(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, "
"L<http://libguestfs.org/>."
msgstr ""

#. type: textblock
#: win-reg/virt-win-reg.in:826
msgid "Copyright (C) 2010 Red Hat Inc."
msgstr ""