# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Red Hat Inc. # This file is distributed under the same license as the libguestfs package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: libguestfs 1.19.14\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" "POT-Creation-Date: 2012-06-28 08:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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:14 ../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 ../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:35 ../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:39 ../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:18 ../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:18 ../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:23 ../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:47 ../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" 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 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" 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 if the alignment is best for performance, or C 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 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:92 ../inspector/virt-inspector.pod:54 ../rescue/virt-rescue.pod:115 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:94 ../sysprep/virt-sysprep.pod:39 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:55 ../tools/virt-list-partitions.pl:56 ../tools/virt-make-fs.pl:155 ../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:160 ../inspector/virt-inspector.pod:58 ../rescue/virt-rescue.pod:119 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:98 ../sysprep/virt-sysprep.pod:43 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:163 ../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:45 ../tools/virt-list-filesystems.pl:65 ../tools/virt-list-partitions.pl:66 ../tools/virt-make-fs.pl:165 ../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:47 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:49 msgid "B<--add> file" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:115 ../sysprep/virt-sysprep.pod:51 msgid "Add I 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:102 ../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:56 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:58 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:60 ../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. 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:63 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:66 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:68 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:70 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:142 ../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:144 ../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:146 ../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:685 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:164 ../src/guestfs.pod:2955 ../sysprep/virt-sysprep.pod:111 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:115 msgid "forces raw format (no auto-detection) for C." 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:119 msgid "" "forces raw format (no auto-detection) for C and reverts to " "auto-detection for C." 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:122 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:172 ../sysprep/virt-sysprep.pod:148 msgid "B<-q>" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:163 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:174 ../sysprep/virt-sysprep.pod:150 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 " "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:402 ../format/virt-format.pod:145 ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:118 ../rescue/virt-rescue.pod:234 ../sparsify/virt-sparsify.pod:178 ../sysprep/virt-sysprep.pod:166 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:404 ../format/virt-format.pod:147 ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:120 ../rescue/virt-rescue.pod:236 ../sparsify/virt-sparsify.pod:180 ../sysprep/virt-sysprep.pod:168 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:182 ../sysprep/virt-sysprep.pod:170 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:409 ../format/virt-format.pod:151 ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:124 ../rescue/virt-rescue.pod:240 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:184 ../sysprep/virt-sysprep.pod:172 ../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:411 ../format/virt-format.pod:153 ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:126 ../rescue/virt-rescue.pod:242 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:186 ../sysprep/virt-sysprep.pod:174 ../test-tool/libguestfs-test-tool.pod:63 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../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:188 ../sysprep/virt-sysprep.pod:176 ../tools/virt-list-filesystems.pl:73 ../tools/virt-list-partitions.pl:74 ../tools/virt-make-fs.pl:173 ../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:424 ../format/virt-format.pod:167 ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:130 ../rescue/virt-rescue.pod:255 ../sparsify/virt-sparsify.pod:190 ../sysprep/virt-sysprep.pod:178 ../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:192 ../sysprep/virt-sysprep.pod:180 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 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" 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 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" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:329 msgid "" "For Red Hat Enterprise Linux E 5, use a Kickstart script that contains " "an explicit C<%pre> section that creates aligned partitions using " "L. Do not use the Kickstart C 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:421 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:584 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 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:423 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:752 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 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:1126 ../format/virt-format.pod:173 ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:496 ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:254 ../sysprep/virt-sysprep.pod:428 ../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:151 ../examples/guestfs-faq.pod:157 ../examples/guestfs-faq.pod:196 ../examples/guestfs-faq.pod:202 ../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:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:445 ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:460 ../fish/guestfish-actions.pod:467 ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:1458 ../fish/guestfish-actions.pod:1462 ../fish/guestfish-actions.pod:1470 ../fish/guestfish-actions.pod:1474 ../fish/guestfish-actions.pod:1478 ../fish/guestfish-actions.pod:1488 ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1496 ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:1607 ../fish/guestfish-actions.pod:1612 ../fish/guestfish-actions.pod:1617 ../fish/guestfish-actions.pod:1659 ../fish/guestfish-actions.pod:1663 ../fish/guestfish-actions.pod:1668 ../fish/guestfish-actions.pod:2078 ../fish/guestfish-actions.pod:2085 ../fish/guestfish-actions.pod:2092 ../fish/guestfish-actions.pod:2505 ../fish/guestfish-actions.pod:2511 ../fish/guestfish-actions.pod:2519 ../fish/guestfish-actions.pod:2526 ../fish/guestfish-actions.pod:2533 ../fish/guestfish.pod:457 ../fish/guestfish.pod:461 ../fish/guestfish.pod:465 ../fish/guestfish.pod:469 ../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:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:59 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:645 ../src/guestfs-actions.pod:653 ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:667 ../src/guestfs-actions.pod:2423 ../src/guestfs-actions.pod:2427 ../src/guestfs-actions.pod:2431 ../src/guestfs-actions.pod:2435 ../src/guestfs-actions.pod:2443 ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2461 ../src/guestfs-actions.pod:2465 ../src/guestfs-actions.pod:2469 ../src/guestfs-actions.pod:2628 ../src/guestfs-actions.pod:2632 ../src/guestfs-actions.pod:2637 ../src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:2703 ../src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:2712 ../src/guestfs-actions.pod:3328 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3342 ../src/guestfs-actions.pod:3897 ../src/guestfs-actions.pod:3903 ../src/guestfs-actions.pod:3911 ../src/guestfs-actions.pod:3918 ../src/guestfs-actions.pod:3925 ../src/guestfs.pod:390 ../src/guestfs.pod:395 ../src/guestfs.pod:400 ../src/guestfs.pod:404 ../src/guestfs.pod:409 ../src/guestfs.pod:413 ../src/guestfs.pod:418 ../src/guestfs.pod:423 ../src/guestfs.pod:1177 ../src/guestfs.pod:1181 ../src/guestfs.pod:1185 ../src/guestfs.pod:1190 ../src/guestfs.pod:1198 ../src/guestfs.pod:1217 ../src/guestfs.pod:1225 ../src/guestfs.pod:1247 ../src/guestfs.pod:1251 ../src/guestfs.pod:1255 ../src/guestfs.pod:1259 ../src/guestfs.pod:1263 ../src/guestfs.pod:1267 ../src/guestfs.pod:1767 ../src/guestfs.pod:1772 ../src/guestfs.pod:1776 ../src/guestfs.pod:1878 ../src/guestfs.pod:1883 ../src/guestfs.pod:1887 ../src/guestfs.pod:1897 ../src/guestfs.pod:2186 ../src/guestfs.pod:2191 ../src/guestfs.pod:2197 ../src/guestfs.pod:2205 ../src/guestfs.pod:2722 ../src/guestfs.pod:2728 ../src/guestfs.pod:2733 ../src/guestfs.pod:2739 ../src/guestfs.pod:3130 ../src/guestfs.pod:3135 ../src/guestfs.pod:3139 ../src/guestfs.pod:3143 ../src/guestfs.pod:3147 ../src/guestfs.pod:3161 ../src/guestfs.pod:3166 ../src/guestfs.pod:3418 ../src/guestfs.pod:3422 ../src/guestfs.pod:3426 ../src/guestfs.pod:3430 ../sysprep/virt-sysprep.pod:230 ../sysprep/virt-sysprep.pod:234 ../sysprep/virt-sysprep.pod:238 ../sysprep/virt-sysprep.pod:242 ../sysprep/virt-sysprep.pod:257 ../sysprep/virt-sysprep.pod:261 ../sysprep/virt-sysprep.pod:265 ../sysprep/virt-sysprep.pod:269 ../sysprep/virt-sysprep.pod:273 ../sysprep/virt-sysprep.pod:309 ../sysprep/virt-sysprep.pod:331 ../sysprep/virt-sysprep.pod:335 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 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 64K for best performance" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:355 msgid "1" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:357 msgid "an error scanning the disk image or guest" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:361 msgid "2" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:363 msgid "" "successful exit, some partitions have alignment E 64K which can result " "in poor performance on high end network storage" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:368 msgid "3" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:370 msgid "" "successful exit, some partitions have alignment E 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:658 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../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:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../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:286 ../src/guestfs.pod:3353 ../sysprep/virt-sysprep.pod:432 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:591 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:377 msgid "" "L, L, L, L, " "L, L." 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 ../rescue/virt-rescue.pod:349 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:299 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:617 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 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:301 ../sysprep/virt-sysprep.pod:449 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:619 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 msgid "Richard W.M. Jones L" 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:668 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../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:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../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:303 ../src/guestfs.pod:3441 ../sysprep/virt-sysprep.pod:453 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:621 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:390 ../sparsify/virt-sparsify.pod:305 msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:392 ../appliance/libguestfs-make-fixed-appliance.pod:162 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:408 ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:528 ../rescue/virt-rescue.pod:357 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:307 ../sysprep/virt-sysprep.pod:459 ../test-tool/libguestfs-test-tool.pod:121 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:625 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:791 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation; either version 2 of the License, or (at your option) " "any later version." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:397 ../appliance/libguestfs-make-fixed-appliance.pod:167 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:413 ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 ../fish/guestfish.pod:1322 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:533 ../rescue/virt-rescue.pod:362 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:312 ../sysprep/virt-sysprep.pod:464 ../test-tool/libguestfs-test-tool.pod:126 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:630 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:796 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for " "more details." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:402 ../appliance/libguestfs-make-fixed-appliance.pod:172 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:418 ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 ../fish/guestfish.pod:1327 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:538 ../rescue/virt-rescue.pod:367 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:317 ../sysprep/virt-sysprep.pod:469 ../test-tool/libguestfs-test-tool.pod:131 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:635 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:801 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, write to the Free Software Foundation, Inc., 51 " "Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA." 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. 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. To understand why you might need to use this " "tool, read the section L below." msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:24 msgid "" "Instead of running this tool, you can download fixed appliances from " "L. 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 "" " /kernel\n" " /initrd\n" " /root\n" " /README.fixed\n" "\n" msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:46 msgid "" "Note that C/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." 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 directory called:" msgstr "" #. type: verbatim #: ../appliance/libguestfs-make-fixed-appliance.pod:62 #, no-wrap msgid "" " appliance-.tar.xz\n" "\n" msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:64 msgid "" "(where C 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 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.tar.xz> where C 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 environment variable." msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:109 msgid "" "Normally a supermin appliance is located on this path (see " "L). libguestfs reconstructs this into a " "full appliance by running L." 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, C, C and C (note the C " "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:1131 ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:259 ../src/guestfs.pod:3292 ../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 manual page." msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:146 msgid "" "L, L, L, " "L, L, L." 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:664 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../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:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3437 ../sysprep/virt-sysprep.pod:447 ../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:666 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../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:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3439 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C)" msgstr "" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:159 ../fish/guestfish.pod:1314 ../fuse/guestmount.pod:334 ../src/guestfs.pod:3443 ../test-tool/libguestfs-test-tool.pod:118 msgid "Copyright (C) 2009-2012 Red Hat Inc. L" 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 is a command line tool to display the contents of C where " "C 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 can be used to quickly view a file. To edit a file, use " "C. For more complex cases you should look at the L " "tool (see L 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:1063 ../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:70 ../tools/virt-tar.pl:50 msgid "EXAMPLES" msgstr "" #. type: textblock #: ../cat/virt-cat.pod:34 msgid "Display C file from inside the libvirt VM called C:" 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 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:135 ../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:172 ../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:174 ../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." 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:870 msgid "WINDOWS PATHS" msgstr "" #. type: textblock #: ../cat/virt-cat.pod:170 msgid "" "C has a limited ability to understand Windows drive letters and " "paths (eg. C)." 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 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 is a more powerful, lower level tool which you can use when " "C doesn't work." msgstr "" #. type: textblock #: ../cat/virt-cat.pod:213 msgid "Using C 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 is the name of the libvirt guest, and C 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 is the disk image, C is the filesystem within " "the disk image, and C 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:314 ../inspector/virt-inspector.pod:498 ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:256 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, L, L, L, " "L, L." msgstr "" #. type: textblock #: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:526 ../resize/virt-resize.pod:731 ../tools/virt-make-fs.pl:623 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 and L." 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). If you are curious about what an " "unknown disk image contains, use this tool along with L." 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 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 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 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." 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 msgid "B<--volume-groups>" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:279 msgid "Display LVM volume groups." msgstr "" #. type: =head1 #: ../cat/virt-filesystems.pod:287 msgid "COLUMNS" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:289 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:294 msgid "B" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:296 msgid "The filesystem, partition, block device or LVM name." msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:298 msgid "" "For device and partition names these are displayed as canonical libguestfs " "names, so that for example C is the second partition on the first " "device." msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:302 msgid "" "If the I<--long> option is B specified, then only the name column is " "shown in the output." msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:305 msgid "B" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:307 msgid "The object type, for example C, C, C etc." msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:309 msgid "B" msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:311 msgid "" "If there is a filesystem, then this column displays the filesystem type if " "one could be detected, eg. C." msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:314 msgid "B