# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Red Hat Inc.
# This file is distributed under the same license as the libguestfs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.19.46\n"
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
"POT-Creation-Date: 2012-10-01 13:31+0200\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:3 ../appliance/libguestfs-make-fixed-appliance.pod:3 ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 ../examples/guestfs-faq.pod:3 ../examples/guestfs-performance.pod:3 ../examples/guestfs-recipes.pod:10 ../examples/guestfs-testing.pod:3 ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 ../format/virt-format.pod:3 ../fuse/guestmount.pod:3 ../guestfs-release-notes.pod:3 ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3 ../sysprep/virt-sysprep.pod:3 ../test-tool/libguestfs-test-tool.pod:3 ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 ../tools/virt-make-fs.pl:36 ../tools/virt-tar.pl:31 ../tools/virt-win-reg.pl:35
msgid "NAME"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:5
msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:7 ../appliance/libguestfs-make-fixed-appliance.pod:7 ../cat/virt-cat.pod:7 ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7 ../df/virt-df.pod:7 ../edit/virt-edit.pod:7 ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7 ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7 ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7 ../fish/virt-tar-out.pod:7 ../format/virt-format.pod:7 ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7 ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7 ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7 ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7 ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7 ../sysprep/virt-sysprep.pod:7 ../test-tool/libguestfs-test-tool.pod:7 ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34 ../tools/virt-make-fs.pl:40 ../tools/virt-tar.pl:35 ../tools/virt-win-reg.pl:39
msgid "SYNOPSIS"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:9
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -d domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:11
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:13
#, no-wrap
msgid ""
" virt-alignment-scan [--options]\n"
"\n"
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:15 ../appliance/libguestfs-make-fixed-appliance.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-performance.pod:7 ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../format/virt-format.pod:11 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:19 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:24 ../sysprep/virt-sysprep.pod:13 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:45 ../tools/virt-list-partitions.pl:45 ../tools/virt-make-fs.pl:48 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63
msgid "DESCRIPTION"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:17
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:23
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:27
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:32
msgid "OUTPUT"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:34
msgid "To run this tool on a disk image directly, use the I<-a> option:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:36
#, 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:39
#, 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:44
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:47
#, 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:51
#, 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:56
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:59
#, 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:64
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:70
msgid "col 1"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:72
msgid ""
"The device and partition name (eg. C</dev/sda1> meaning the first partition "
"on the first block device)."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:75
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:79
msgid "col 2"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:81
msgid "the start of the partition in bytes"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:83
msgid "col 3"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:85
msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:87
msgid "col 4"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:89
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:92
msgid "cols 5+"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:94
msgid "optional free-text explanation."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:98
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:101
msgid "If you just want the exit code with no output, use the I<-q> option."
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:103 ../appliance/libguestfs-make-fixed-appliance.pod:77 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45 ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42 ../fish/virt-tar-out.pod:36 ../format/virt-format.pod:59 ../fuse/guestmount.pod:169 ../inspector/virt-inspector.pod:54 ../rescue/virt-rescue.pod:115 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:107 ../sysprep/virt-sysprep.pod:40 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:55 ../tools/virt-list-partitions.pl:56 ../tools/virt-make-fs.pl:152 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96
msgid "OPTIONS"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:107 ../appliance/libguestfs-make-fixed-appliance.pod:81 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../format/virt-format.pod:63 ../fuse/guestmount.pod:237 ../inspector/virt-inspector.pod:58 ../rescue/virt-rescue.pod:119 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:111 ../sysprep/virt-sysprep.pod:44 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:160 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104
msgid "B<--help>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:109 ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 ../format/virt-format.pod:65 ../inspector/virt-inspector.pod:60 ../rescue/virt-rescue.pod:121 ../sysprep/virt-sysprep.pod:46 ../tools/virt-list-filesystems.pl:65 ../tools/virt-list-partitions.pl:66 ../tools/virt-make-fs.pl:162 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106
msgid "Display brief help."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:111 ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 ../format/virt-format.pod:67 ../inspector/virt-inspector.pod:62 ../rescue/virt-rescue.pod:123 ../sysprep/virt-sysprep.pod:48
msgid "B<-a> file"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 ../format/virt-format.pod:69 ../inspector/virt-inspector.pod:64 ../rescue/virt-rescue.pod:125 ../sysprep/virt-sysprep.pod:50
msgid "B<--add> file"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:115 ../sysprep/virt-sysprep.pod:52
msgid "Add I<file> which should be a disk image from a virtual machine."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:117 ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 ../fish/guestfish.pod:174 ../format/virt-format.pod:73 ../fuse/guestmount.pod:179 ../inspector/virt-inspector.pod:70 ../rescue/virt-rescue.pod:131
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:120 ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:138 ../sysprep/virt-sysprep.pod:57
msgid "B<-c> URI"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:122 ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:140 ../sysprep/virt-sysprep.pod:59
msgid "B<--connect> URI"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:124 ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 ../inspector/virt-inspector.pod:77 ../rescue/virt-rescue.pod:142 ../sysprep/virt-sysprep.pod:61 ../tools/virt-list-filesystems.pl:83 ../tools/virt-list-partitions.pl:84 ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
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:127 ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:145 ../sysprep/virt-sysprep.pod:64
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:130 ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:84 ../rescue/virt-rescue.pod:148 ../sysprep/virt-sysprep.pod:67
msgid "B<-d> guest"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:86 ../rescue/virt-rescue.pod:150 ../sysprep/virt-sysprep.pod:69
msgid "B<--domain> guest"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:134 ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:88 ../rescue/virt-rescue.pod:152 ../sysprep/virt-sysprep.pod:71
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:137 ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 ../format/virt-format.pod:87 ../fuse/guestmount.pod:219 ../inspector/virt-inspector.pod:98 ../rescue/virt-rescue.pod:155
msgid "B<--format=raw|qcow2|..>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:139 ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 ../format/virt-format.pod:89 ../fuse/guestmount.pod:221 ../inspector/virt-inspector.pod:100 ../rescue/virt-rescue.pod:157
msgid "B<--format>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:141 ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 ../format/virt-format.pod:91 ../fuse/guestmount.pod:223 ../rescue/virt-rescue.pod:159
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:146 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:689 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:3162 ../sysprep/virt-sysprep.pod:112
msgid "For example:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:148
#, no-wrap
msgid ""
" virt-alignment-scan --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:150 ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../format/virt-format.pod:100 ../rescue/virt-rescue.pod:168 ../sysprep/virt-sysprep.pod:116
msgid "forces raw format (no auto-detection) for C<disk.img>."
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:152
#, 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:154 ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../format/virt-format.pod:104 ../rescue/virt-rescue.pod:172 ../sysprep/virt-sysprep.pod:120
msgid ""
"forces raw format (no auto-detection) for C<disk.img> and reverts to "
"auto-detection for C<another.img>."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:157 ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 ../format/virt-format.pod:107 ../rescue/virt-rescue.pod:175 ../sysprep/virt-sysprep.pod:123
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:161 ../resize/virt-resize.pod:497 ../sparsify/virt-sparsify.pod:185 ../sysprep/virt-sysprep.pod:149
msgid "B<-q>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:163 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:187 ../sysprep/virt-sysprep.pod:151
msgid "B<--quiet>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:165
msgid ""
"Don't produce any output. Just set the exit code (see L</EXIT STATUS> "
"below)."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:168 ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
msgid "B<--uuid>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:170 ../df/virt-df.pod:165
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:174
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:177 ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:406 ../format/virt-format.pod:145 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:118 ../rescue/virt-rescue.pod:234 ../sparsify/virt-sparsify.pod:191 ../sysprep/virt-sysprep.pod:167
msgid "B<-v>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:179 ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:408 ../format/virt-format.pod:147 ../fuse/guestmount.pod:349 ../inspector/virt-inspector.pod:120 ../rescue/virt-rescue.pod:236 ../sparsify/virt-sparsify.pod:193 ../sysprep/virt-sysprep.pod:169
msgid "B<--verbose>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:181 ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165 ../format/virt-format.pod:149 ../inspector/virt-inspector.pod:122 ../rescue/virt-rescue.pod:238 ../sparsify/virt-sparsify.pod:195 ../sysprep/virt-sysprep.pod:171
msgid "Enable verbose messages for debugging."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:183 ../appliance/libguestfs-make-fixed-appliance.pod:85 ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:413 ../format/virt-format.pod:151 ../fuse/guestmount.pod:353 ../inspector/virt-inspector.pod:124 ../rescue/virt-rescue.pod:240 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:197 ../sysprep/virt-sysprep.pod:173 ../test-tool/libguestfs-test-tool.pod:61
msgid "B<-V>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:185 ../appliance/libguestfs-make-fixed-appliance.pod:87 ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:415 ../format/virt-format.pod:153 ../fuse/guestmount.pod:355 ../inspector/virt-inspector.pod:126 ../rescue/virt-rescue.pod:242 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:199 ../sysprep/virt-sysprep.pod:175 ../test-tool/libguestfs-test-tool.pod:63 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:168 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
msgid "B<--version>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:187 ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../format/virt-format.pod:155 ../inspector/virt-inspector.pod:128 ../rescue/virt-rescue.pod:244 ../resize/virt-resize.pod:571 ../sparsify/virt-sparsify.pod:201 ../sysprep/virt-sysprep.pod:177 ../tools/virt-list-filesystems.pl:73 ../tools/virt-list-partitions.pl:74 ../tools/virt-make-fs.pl:170 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
msgid "Display version number and exit."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:189 ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:428 ../format/virt-format.pod:167 ../fuse/guestmount.pod:368 ../inspector/virt-inspector.pod:130 ../rescue/virt-rescue.pod:255 ../sparsify/virt-sparsify.pod:203 ../sysprep/virt-sysprep.pod:179 ../tools/virt-tar.pl:158
msgid "B<-x>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:191 ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175 ../format/virt-format.pod:169 ../inspector/virt-inspector.pod:132 ../rescue/virt-rescue.pod:257 ../sparsify/virt-sparsify.pod:205 ../sysprep/virt-sysprep.pod:181
msgid "Enable tracing of libguestfs API calls."
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:195
msgid "RECOMMENDED ALIGNMENT"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:197
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:206
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:211
msgid "* 512 bytes"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:213
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:216
msgid "* 4 Kbytes"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:218
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:222
msgid "* 64 Kbytes"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:224
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:227
msgid "* 1 Mbyte"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:229
msgid "see L</1 MB PARTITION ALIGNMENT> below."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:233
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:236
#, 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:245
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:250
msgid "LINUX HOST BLOCK AND I/O SIZE"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:252
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:255
msgid "For a typical consumer hard drive with 512 byte sectors:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:257
#, 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:268
msgid "For a new consumer hard drive with 4Kbyte sectors:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:270
#, 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:281
msgid "For a NetApp LUN:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:283
#, 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:292
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:296
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:299
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:302
msgid "1 MB PARTITION ALIGNMENT"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:304
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:307
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:311
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:314
msgid "SETTING ALIGNMENT"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:316
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:322
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:326
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:329
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:334 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:469 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:620 ../tools/virt-tar.pl:287 ../tools/virt-win-reg.pl:734
msgid "SHELL QUOTING"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:471 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:622 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:742
msgid ""
"Libvirt guest names can contain arbitrary characters, some of which have "
"meaning to the shell such as C<#> and space. You may need to quote or "
"escape these characters on the command line. See the shell manual page "
"L<sh(1)> for details."
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:341 ../appliance/libguestfs-make-fixed-appliance.pod:134 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:384 ../cat/virt-ls.pod:490 ../df/virt-df.pod:248 ../edit/virt-edit.pod:363 ../fish/guestfish.pod:1130 ../format/virt-format.pod:173 ../fuse/guestmount.pod:393 ../inspector/virt-inspector.pod:496 ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:267 ../sysprep/virt-sysprep.pod:476 ../test-tool/libguestfs-test-tool.pod:96
msgid "EXIT STATUS"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:343
msgid "This program returns:"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:347 ../align/virt-alignment-scan.pod:353 ../align/virt-alignment-scan.pod:359 ../align/virt-alignment-scan.pod:366 ../appliance/libguestfs-make-fixed-appliance.pod:32 ../appliance/libguestfs-make-fixed-appliance.pod:53 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-faq.pod:149 ../examples/guestfs-faq.pod:155 ../examples/guestfs-faq.pod:194 ../examples/guestfs-faq.pod:200 ../examples/guestfs-performance.pod:107 ../examples/guestfs-performance.pod:113 ../examples/guestfs-performance.pod:118 ../examples/guestfs-performance.pod:253 ../examples/guestfs-performance.pod:258 ../examples/guestfs-performance.pod:263 ../examples/guestfs-recipes.pod:128 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:136 ../examples/guestfs-recipes.pod:162 ../examples/guestfs-recipes.pod:167 ../examples/guestfs-recipes.pod:257 ../examples/guestfs-recipes.pod:261 ../examples/guestfs-recipes.pod:265 ../examples/guestfs-recipes.pod:269 ../examples/guestfs-recipes.pod:273 ../examples/guestfs-testing.pod:124 ../examples/guestfs-testing.pod:128 ../examples/guestfs-testing.pod:132 ../fish/guestfish-actions.pod:417 ../fish/guestfish-actions.pod:425 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:439 ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:1484 ../fish/guestfish-actions.pod:1488 ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:1504 ../fish/guestfish-actions.pod:1508 ../fish/guestfish-actions.pod:1518 ../fish/guestfish-actions.pod:1522 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1637 ../fish/guestfish-actions.pod:1641 ../fish/guestfish-actions.pod:1646 ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1692 ../fish/guestfish-actions.pod:1697 ../fish/guestfish-actions.pod:2143 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2735 ../fish/guestfish-actions.pod:2741 ../fish/guestfish-actions.pod:2749 ../fish/guestfish-actions.pod:2756 ../fish/guestfish-actions.pod:2763 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../fish/guestfish.pod:473 ../guestfs-release-notes.pod:82 ../guestfs-release-notes.pod:86 ../guestfs-release-notes.pod:90 ../guestfs-release-notes.pod:94 ../guestfs-release-notes.pod:98 ../guestfs-release-notes.pod:102 ../guestfs-release-notes.pod:107 ../guestfs-release-notes.pod:214 ../guestfs-release-notes.pod:218 ../guestfs-release-notes.pod:222 ../guestfs-release-notes.pod:226 ../guestfs-release-notes.pod:230 ../guestfs-release-notes.pod:234 ../guestfs-release-notes.pod:238 ../inspector/virt-inspector.pod:514 ../inspector/virt-inspector.pod:518 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:45 ../sparsify/virt-sparsify.pod:52 ../sparsify/virt-sparsify.pod:56 ../sparsify/virt-sparsify.pod:62 ../sparsify/virt-sparsify.pod:67 ../sparsify/virt-sparsify.pod:72 ../src/guestfs-actions.pod:622 ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:637 ../src/guestfs-actions.pod:644 ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2479 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:2495 ../src/guestfs-actions.pod:2499 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2513 ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2763 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2772 ../src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4324 ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4346 ../src/guestfs.pod:394 ../src/guestfs.pod:399 ../src/guestfs.pod:404 ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417 ../src/guestfs.pod:422 ../src/guestfs.pod:427 ../src/guestfs.pod:1208 ../src/guestfs.pod:1212 ../src/guestfs.pod:1216 ../src/guestfs.pod:1221 ../src/guestfs.pod:1229 ../src/guestfs.pod:1248 ../src/guestfs.pod:1256 ../src/guestfs.pod:1273 ../src/guestfs.pod:1278 ../src/guestfs.pod:1282 ../src/guestfs.pod:1424 ../src/guestfs.pod:1428 ../src/guestfs.pod:1432 ../src/guestfs.pod:1436 ../src/guestfs.pod:1440 ../src/guestfs.pod:1444 ../src/guestfs.pod:1970 ../src/guestfs.pod:1975 ../src/guestfs.pod:1979 ../src/guestfs.pod:2081 ../src/guestfs.pod:2086 ../src/guestfs.pod:2090 ../src/guestfs.pod:2100 ../src/guestfs.pod:2389 ../src/guestfs.pod:2394 ../src/guestfs.pod:2400 ../src/guestfs.pod:2408 ../src/guestfs.pod:2925 ../src/guestfs.pod:2931 ../src/guestfs.pod:2936 ../src/guestfs.pod:2942 ../src/guestfs.pod:3344 ../src/guestfs.pod:3349 ../src/guestfs.pod:3353 ../src/guestfs.pod:3357 ../src/guestfs.pod:3361 ../src/guestfs.pod:3375 ../src/guestfs.pod:3380 ../sysprep/virt-sysprep.pod:231 ../sysprep/virt-sysprep.pod:235 ../sysprep/virt-sysprep.pod:239 ../sysprep/virt-sysprep.pod:243 ../sysprep/virt-sysprep.pod:258 ../sysprep/virt-sysprep.pod:262 ../sysprep/virt-sysprep.pod:266 ../sysprep/virt-sysprep.pod:270 ../sysprep/virt-sysprep.pod:274 ../sysprep/virt-sysprep.pod:327 ../sysprep/virt-sysprep.pod:339 ../sysprep/virt-sysprep.pod:343 ../sysprep/virt-sysprep.pod:351 ../sysprep/virt-sysprep.pod:357 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:711 ../tools/virt-win-reg.pl:717 ../tools/virt-win-reg.pl:723
msgid "*"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:349
msgid "0"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:351
msgid "successful exit, all partitions are aligned E<ge> 64K for best performance"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:355 ../src/guestfs.pod:1617
msgid "1"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:357
msgid "an error scanning the disk image or guest"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:361 ../src/guestfs.pod:1621
msgid "2"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:363
msgid ""
"successful exit, some partitions have alignment E<lt> 64K which can result "
"in poor performance on high end network storage"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:368 ../src/guestfs.pod:1625
msgid "3"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:370
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:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:779 ../examples/guestfs-performance.pod:429 ../examples/guestfs-recipes.pod:473 ../examples/guestfs-testing.pod:305 ../fish/guestfish.pod:1289 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:398 ../guestfs-release-notes.pod:1711 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:40 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:299 ../src/guestfs.pod:3580 ../sysprep/virt-sysprep.pod:480 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:627 ../tools/virt-tar.pl:294 ../tools/virt-win-reg.pl:747
msgid "SEE ALSO"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:377
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:384 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 ../format/virt-format.pod:187 ../guestfs-release-notes.pod:1722 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:312 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:642 ../tools/virt-tar.pl:309 ../tools/virt-win-reg.pl:762
msgid "AUTHOR"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:314 ../sysprep/virt-sysprep.pod:497 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:644 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:764
msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:789 ../examples/guestfs-performance.pod:446 ../examples/guestfs-recipes.pod:490 ../examples/guestfs-testing.pod:316 ../fish/guestfish.pod:1321 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:413 ../guestfs-release-notes.pod:1726 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:57 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:316 ../src/guestfs.pod:3636 ../sysprep/virt-sysprep.pod:501 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:646 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:766
msgid "COPYRIGHT"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:390
msgid "Copyright (C) 2011 Red Hat Inc."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:5
msgid "libguestfs-make-fixed-appliance - Make a \"fixed appliance\" for libguestfs"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:9
#, no-wrap
msgid ""
" libguestfs-make-fixed-appliance [--options] OUTPUTDIR\n"
"\n"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:11
#, no-wrap
msgid ""
" libguestfs-make-fixed-appliance [--options] --xz\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:15
msgid ""
"libguestfs-make-fixed-appliance lets you make a pre-built binary appliance "
"for libguestfs."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:18
msgid ""
"B<Note that ordinary users should not need to run this tool>. The only "
"reason to use it is if you want to make a self-contained libguestfs "
"appliance that can be copied to another machine or platform that doesn't "
"support L<febootstrap(8)>. To understand why you might need to use this "
"tool, read the section L</FIXED APPLIANCE> below."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:24
msgid ""
"Instead of running this tool, you can download fixed appliances from "
"L<http://libguestfs.org/download/binaries/appliance/>. These appliances "
"were made using this tool."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:28
msgid "There are two ways to use this tool."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:34
msgid "Specify an output directory, for example:"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:36
#, no-wrap
msgid ""
" libguestfs-make-fixed-appliance /usr/local/lib/guestfs/appliance\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:38
msgid ""
"The output directory is created if it does not exist. Four files are "
"created in this directory:"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:41
#, no-wrap
msgid ""
" <OUTPUTDIR>/kernel\n"
" <OUTPUTDIR>/initrd\n"
" <OUTPUTDIR>/root\n"
" <OUTPUTDIR>/README.fixed\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:46
msgid ""
"Note that C<I<OUTPUTDIR>/root> is a sparse file, so take care when copying "
"it."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:49
msgid ""
"You can then run libguestfs (possibly after copying this directory to "
"another machine) by setting the environment variable LIBGUESTFS_PATH to "
"C<OUTPUTDIR>."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:55
msgid ""
"The alternative method is to use the I<--xz> option to create a compressed "
"tarball:"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:58
#, no-wrap
msgid ""
" libguestfs-make-fixed-appliance --xz\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:60
msgid "This creates a tarball in the I<current> directory called:"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:62
#, no-wrap
msgid ""
" appliance-<VERSION>.tar.xz\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:64
msgid ""
"(where C<VERSION> is the version of libguestfs). The tarball contains the "
"four files:"
msgstr ""
#. type: verbatim
#: ../appliance/libguestfs-make-fixed-appliance.pod:67
#, no-wrap
msgid ""
" appliance/kernel\n"
" appliance/initrd\n"
" appliance/root\n"
" appliance/README.fixed\n"
"\n"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:72
msgid "Note that C<appliance/root> is a sparse file, so take care when copying it."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:83 ../test-tool/libguestfs-test-tool.pod:42
msgid "Display short usage information and exit."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:89
msgid "Display the version number and exit."
msgstr ""
#. type: =item
#: ../appliance/libguestfs-make-fixed-appliance.pod:91
msgid "B<--xz>"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:93
msgid ""
"Instead of creating the appliance in an output directory, create a "
"compressed tarball of the appliance in the current directory called "
"C<appliance-I<VERSION>.tar.xz> where C<VERSION> is the version of "
"libguestfs."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:98
msgid ""
"Using I<--xz> can take some time. If working normally, the tool is "
"completely silent when it is running."
msgstr ""
#. type: =head1
#: ../appliance/libguestfs-make-fixed-appliance.pod:103
msgid "FIXED APPLIANCE"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:105
msgid ""
"When libguestfs (or libguestfs tools) are run, they search a path looking "
"for an appliance. The path is built into libguestfs, or can be set using "
"the C<LIBGUESTFS_PATH> environment variable."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:109
msgid ""
"Normally a supermin appliance is located on this path (see "
"L<febootstrap(8)/SUPERMIN APPLIANCE>). libguestfs reconstructs this into a "
"full appliance by running L<febootstrap-supermin-helper(8)>."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:113
msgid ""
"However, a simpler \"fixed appliance\" can also be used. libguestfs detects "
"this by looking for a directory on the path containing four files called "
"C<kernel>, C<initrd>, C<root> and C<README.fixed> (note the C<README.fixed> "
"file must be present as well)."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:118
msgid ""
"If the fixed appliance is found, libguestfs skips febootstrap entirely and "
"just runs qemu with the kernel, initrd and root disk from the fixed "
"appliance."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:122
msgid ""
"Thus the fixed appliance can be used when a platform or Linux distro does "
"not support febootstrap. You build the fixed appliance on a platform that "
"does support febootstrap, and copy it over, and use that to run libguestfs."
msgstr ""
#. type: =head1
#: ../appliance/libguestfs-make-fixed-appliance.pod:127
msgid "LICENSING"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:129
msgid ""
"The fixed appliance is a complete Linux binary distro. If you distribute "
"it, you may need to distribute corresponding source files to remain in legal "
"compliance with the licenses of the software in the appliance (such as the "
"GNU General Public License)."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:136
msgid ""
"libguestfs-make-fixed-appliance returns I<0> if the appliance was built "
"without errors."
msgstr ""
#. type: =head1
#: ../appliance/libguestfs-make-fixed-appliance.pod:139 ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1135 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:272 ../src/guestfs.pod:3514 ../test-tool/libguestfs-test-tool.pod:101
msgid "ENVIRONMENT VARIABLES"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:141 ../test-tool/libguestfs-test-tool.pod:103
msgid ""
"For the full list of environment variables which may affect libguestfs, "
"please see the L<guestfs(3)> manual page."
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:146
msgid ""
"L<guestfs(3)>, L<febootstrap(8)>, L<febootstrap-supermin-helper(8)>, "
"L<xz(1)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
msgstr ""
#. type: =head1
#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:785 ../examples/guestfs-performance.pod:442 ../examples/guestfs-recipes.pod:486 ../examples/guestfs-testing.pod:312 ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:409 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:53 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3632 ../sysprep/virt-sysprep.pod:495 ../test-tool/libguestfs-test-tool.pod:112
msgid "AUTHORS"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:787 ../examples/guestfs-performance.pod:444 ../examples/guestfs-recipes.pod:488 ../examples/guestfs-testing.pod:314 ../fish/guestfish.pod:1319 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:411 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3634 ../test-tool/libguestfs-test-tool.pod:114
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr ""
#. type: textblock
#: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 ../examples/guestfs-recipes.pod:492 ../fish/guestfish.pod:1323 ../fuse/guestmount.pod:415 ../guestfs-release-notes.pod:1728 ../rescue/virt-rescue.pod:355 ../src/guestfs.pod:3638 ../test-tool/libguestfs-test-tool.pod:118 ../tools/virt-list-partitions.pl:285
msgid "Copyright (C) 2009-2012 Red Hat Inc."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:5
msgid "virt-cat - Display files in a virtual machine"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:9
#, no-wrap
msgid ""
" virt-cat [--options] -d domname file [file ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:11
#, no-wrap
msgid ""
" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 ../inspector/virt-inspector.pod:13
msgid "Old-style:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:15
#, no-wrap
msgid ""
" virt-cat domname file\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:17
#, no-wrap
msgid ""
" virt-cat disk.img file\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:21
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:24
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:28
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: =head1
#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 ../fish/guestfish.pod:1067 ../fish/virt-copy-in.pod:29 ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:83 ../tools/virt-tar.pl:50
msgid "EXAMPLES"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:34
msgid "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:37
#, no-wrap
msgid ""
" virt-cat -d mydomain /etc/fstab\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:39
msgid "List syslog messages from a VM disk image file:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:41
#, no-wrap
msgid ""
" virt-cat -a disk.img /var/log/messages | tail\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:43
msgid "Find out what DHCP IP address a VM acquired:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:45
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/log/messages | \\\n"
" grep 'dhclient: bound to' | tail\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:48
msgid "Find out what packages were recently installed:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:50
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/log/yum.log | tail\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:52
msgid "Find out who is logged on inside a virtual machine:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:54
#, 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:57
msgid "or who was logged on:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:59
#, 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:74 ../cat/virt-filesystems.pod:103 ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 ../inspector/virt-inspector.pod:66 ../rescue/virt-rescue.pod:127
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:98 ../cat/virt-filesystems.pod:148 ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217 ../fuse/guestmount.pod:212 ../inspector/virt-inspector.pod:91
msgid "B<--echo-keys>"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:100
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:116
#, no-wrap
msgid ""
" virt-cat --format=raw -a disk.img file\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:120
#, no-wrap
msgid ""
" virt-cat --format=raw -a disk.img --format -a another.img file\n"
"\n"
msgstr ""
#. type: =item
#: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200 ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289 ../fuse/guestmount.pod:249 ../inspector/virt-inspector.pod:113
msgid "B<--keys-from-stdin>"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202 ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291 ../fuse/guestmount.pod:251 ../inspector/virt-inspector.pod:115
msgid ""
"Read key or passphrase parameters from stdin. The default is to try to read "
"passphrases from the user by opening C</dev/tty>."
msgstr ""
#. type: =head1
#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:261
msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:154
msgid "Previous versions of virt-cat allowed you to write either:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:156
#, no-wrap
msgid ""
" virt-cat disk.img [disk.img ...] file\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 ../inspector/virt-inspector.pod:149 ../rescue/virt-rescue.pod:267
msgid "or"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:160
#, no-wrap
msgid ""
" virt-cat guestname file\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 ../inspector/virt-inspector.pod:153 ../rescue/virt-rescue.pod:271
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:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 ../inspector/virt-inspector.pod:157 ../rescue/virt-rescue.pod:275
msgid "For compatibility the old style is still supported."
msgstr ""
#. type: =head1
#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:874
msgid "WINDOWS PATHS"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:170
msgid ""
"C<virt-cat> has a limited ability to understand Windows drive letters and "
"paths (eg. C<E:\\foo\\bar.txt>)."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262
msgid "If and only if the guest is running Windows then:"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268
msgid ""
"Drive letter prefixes like C<C:> are resolved against the Windows Registry "
"to the correct filesystem."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273
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:189
msgid ""
"The path is resolved case insensitively to locate the file that should be "
"displayed."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283
msgid "There are some known shortcomings:"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289
msgid "Some NTFS symbolic links may not be followed correctly."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293
msgid "NTFS junction points that cross filesystems are not followed."
msgstr ""
#. type: =head1
#: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297
msgid "USING GUESTFISH"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:210
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:213
msgid "Using C<virt-cat> is approximately equivalent to doing:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:215
#, no-wrap
msgid ""
" guestfish --ro -i -d domname download file -\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:217
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:221
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:226
#, no-wrap
msgid ""
" guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:228
msgid ""
"where C<disk.img> is the disk image, C</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:240 ../cat/virt-filesystems.pod:386 ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:365 ../fuse/guestmount.pod:395 ../inspector/virt-inspector.pod:498 ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:269
msgid "This program returns 0 if successful, or non-zero if there was an error."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:245
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
"L<virt-tar-out(1)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:258 ../cat/virt-filesystems.pod:406 ../examples/guestfs-examples.pod:51 ../inspector/virt-inspector.pod:526 ../ocaml/examples/guestfs-ocaml.pod:97 ../python/examples/guestfs-python.pod:60 ../resize/virt-resize.pod:731 ../ruby/examples/guestfs-ruby.pod:54 ../tools/virt-make-fs.pl:648
msgid "Copyright (C) 2010-2012 Red Hat Inc."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:5
msgid ""
"virt-filesystems - List filesystems, partitions, block devices, LVM in a "
"virtual machine or disk image"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:9
#, no-wrap
msgid ""
" virt-filesystems [--options] -d domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:11
#, no-wrap
msgid ""
" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:15
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:20
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:23
#, no-wrap
msgid ""
" for fs in $(virt-filesystems -a disk.img); do\n"
" # ...\n"
" done\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:27
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:32
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:37
#, 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:41
msgid "If you add I<-l> or I<--long> then the output includes extra information:"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:44
#, 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:49
msgid ""
"If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
"shown as well:"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:52
#, 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:58
msgid "If you add I<--partitions> then partitions are shown instead of filesystems:"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:60
#, no-wrap
msgid ""
" $ virt-filesystems -a disk.img --partitions\n"
" /dev/sda1\n"
" /dev/sda2\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:64
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:67
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. C</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:74
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:78
msgid ""
"I<--all --long --uuid> is a useful combination to display all possible "
"information about everything."
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:81
#, 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:89
msgid "For machine-readable output, use I<--csv> to get Comma-Separated Values."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:123
msgid "B<--all>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:112
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:117
msgid "See also I<--long>."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:119
msgid "B<--blkdevs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:121
msgid "B<--block-devices>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:123
msgid "Display block devices."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
msgid "B<--csv>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
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:150
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:155
msgid "B<--extra>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:157
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:161
msgid "This option implies I<--filesystems>."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:163
msgid "B<--filesystems>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:165
msgid ""
"Display mountable filesystems. If no display option was selected then this "
"option is implied."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:168
msgid "With I<--extra>, non-mountable filesystems are shown too."
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:181
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:185
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352 ../df/virt-df.pod:125 ../fish/guestfish.pod:156 ../tools/virt-list-partitions.pl:111
msgid "B<-h>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:113
msgid "B<--human-readable>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:198
msgid "In I<--long> mode, display sizes in human-readable format."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366 ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
msgid "B<-l>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 ../tools/virt-list-filesystems.pl:112 ../tools/virt-list-partitions.pl:123
msgid "B<--long>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:209
msgid "Display extra columns of data (\"long format\")."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:211
msgid "A title row is added unless you also specify I<--no-title>."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:213
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:218
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:221
msgid "Use I<--uuid> to display UUIDs too."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:223
msgid "B<--lvs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:225
msgid "B<--logvols>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:227
msgid "B<--logical-volumes>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:229
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:232
msgid "B<--no-title>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:234
msgid "In I<--long> mode, don't add a title row."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:236
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:240
msgid "B<--parts>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:242
msgid "B<--partitions>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:244
msgid ""
"Display partitions. In this mode, these are displayed irrespective of "
"whether the partitions contain filesystems."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:247
msgid "B<--pvs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:249
msgid "B<--physvols>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:251
msgid "B<--physical-volumes>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:253
msgid "Display LVM physical volumes."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:257
msgid "B<--uuids>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:259
msgid "In I<--long> mode, display UUIDs as well."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:273
msgid "B<--vgs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:275
msgid "B<--volgroups>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:277
| 