# 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.16.19\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" "POT-Creation-Date: 2012-04-17 23:33+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 ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../clone/virt-sysprep.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-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 ../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 ../cat/virt-cat.pod:7 ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7 ../clone/virt-sysprep.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 ../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: =head1 #: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../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 ../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:15 msgid "" "When older operating systems install themselves, the partitioning tools " "place partitions at a sector misaligned with the underlying storage " "(commonly the first partition starts on sector C<63>). Misaligned " "partitions can result in an operating system issuing more I/O than should be " "necessary." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:21 msgid "" "The virt-alignment-scan tool checks the alignment of partitions in virtual " "machines and disk images and warns you if there are alignment problems." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:25 msgid "" "Currently there is no virt tool for fixing alignment problems. You can only " "reinstall the guest operating system. The following NetApp document " "summarises the problem and possible solutions: " "L" msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:30 msgid "OUTPUT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:32 msgid "To run this tool on a disk image directly, use the I<-a> option:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:34 #, no-wrap msgid "" " $ virt-alignment-scan -a winxp.img\n" " /dev/sda1 32256 512 bad (alignment < 4K)\n" "\n" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:37 #, no-wrap msgid "" " $ virt-alignment-scan -a fedora16.img\n" " /dev/sda1 1048576 1024K ok\n" " /dev/sda2 2097152 2048K ok\n" " /dev/sda3 526385152 2048K ok\n" "\n" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:42 msgid "" "To run the tool on a guest known to libvirt, use the I<-d> option and " "possibly the I<-c> option:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:45 #, no-wrap msgid "" " # virt-alignment-scan -d RHEL5\n" " /dev/sda1 32256 512 bad (alignment < 4K)\n" " /dev/sda2 106928640 512 bad (alignment < 4K)\n" "\n" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:49 #, no-wrap msgid "" " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n" " /dev/sda1 1048576 1024K ok\n" " /dev/sda2 105906176 1024K ok\n" " /dev/sdb1 65536 64K ok\n" "\n" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:54 msgid "" "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:60 msgid "col 1" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:62 msgid "" "the device and partition name (eg. C meaning the first partition " "on the first block device)" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:65 msgid "col 2" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:67 msgid "the start of the partition in bytes" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:69 msgid "col 3" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:71 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:73 msgid "col 4" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:75 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:78 msgid "cols 5+" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:80 msgid "optional free-text explanation." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:84 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:87 msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 ../clone/virt-sysprep.pod:42 ../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:112 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:100 ../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:93 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../clone/virt-sysprep.pod:46 ../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:116 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:104 ../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:95 ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 ../format/virt-format.pod:65 ../inspector/virt-inspector.pod:60 ../rescue/virt-rescue.pod:118 ../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:97 ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 ../format/virt-format.pod:67 ../inspector/virt-inspector.pod:62 ../rescue/virt-rescue.pod:120 msgid "B<-a> file" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 ../format/virt-format.pod:69 ../inspector/virt-inspector.pod:64 ../rescue/virt-rescue.pod:122 msgid "B<--add> file" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54 msgid "Add I which should be a disk image from a virtual machine." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 ../clone/virt-sysprep.pod:56 ../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:128 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:106 ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:135 msgid "B<-c> URI" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:137 msgid "B<--connect> URI" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 ../inspector/virt-inspector.pod:77 ../rescue/virt-rescue.pod:139 ../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:113 ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:142 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:116 ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:84 ../rescue/virt-rescue.pod:145 msgid "B<-d> guest" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:86 ../rescue/virt-rescue.pod:147 msgid "B<--domain> guest" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:88 ../rescue/virt-rescue.pod:149 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:123 ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../clone/virt-sysprep.pod:95 ../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:152 msgid "B<--format=raw|qcow2|..>" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../clone/virt-sysprep.pod:97 ../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:154 msgid "B<--format>" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../clone/virt-sysprep.pod:99 ../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:156 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:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../format/virt-format.pod:96 ../inspector/virt-inspector.pod:350 ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2885 msgid "For example:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:134 #, no-wrap msgid "" " virt-alignment-scan --format=raw -a disk.img\n" "\n" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../format/virt-format.pod:100 ../rescue/virt-rescue.pod:165 msgid "forces raw format (no auto-detection) for C." msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:138 #, 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:140 ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../format/virt-format.pod:104 ../rescue/virt-rescue.pod:169 msgid "" "forces raw format (no auto-detection) for C and reverts to " "auto-detection for C." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 ../format/virt-format.pod:107 ../rescue/virt-rescue.pod:172 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:147 ../resize/virt-resize.pod:497 ../sparsify/virt-sparsify.pod:178 msgid "B<-q>" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:180 msgid "B<--quiet>" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:151 msgid "" "Don't produce any output. Just set the exit code (see L " "below)." msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 ../format/virt-format.pod:145 ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:118 ../rescue/virt-rescue.pod:219 ../sparsify/virt-sparsify.pod:184 msgid "B<-v>" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 ../format/virt-format.pod:147 ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:120 ../rescue/virt-rescue.pod:221 ../sparsify/virt-sparsify.pod:186 msgid "B<--verbose>" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165 ../format/virt-format.pod:149 ../inspector/virt-inspector.pod:122 ../rescue/virt-rescue.pod:223 ../sparsify/virt-sparsify.pod:188 msgid "Enable verbose messages for debugging." msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../format/virt-format.pod:151 ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:124 ../rescue/virt-rescue.pod:225 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:190 msgid "B<-V>" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../format/virt-format.pod:153 ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:126 ../rescue/virt-rescue.pod:227 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:192 ../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:164 ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../format/virt-format.pod:155 ../inspector/virt-inspector.pod:128 ../rescue/virt-rescue.pod:229 ../resize/virt-resize.pod:571 ../sparsify/virt-sparsify.pod:194 ../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:166 ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 ../format/virt-format.pod:167 ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:130 ../rescue/virt-rescue.pod:240 ../sparsify/virt-sparsify.pod:196 ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175 ../format/virt-format.pod:169 ../inspector/virt-inspector.pod:132 ../rescue/virt-rescue.pod:242 ../sparsify/virt-sparsify.pod:198 msgid "Enable tracing of libguestfs API calls." msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:172 msgid "RECOMMENDED ALIGNMENT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:174 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:183 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:188 msgid "* 512 bytes" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:190 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:193 msgid "* 4 Kbytes" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:195 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:199 msgid "* 64 Kbytes" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:201 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:204 msgid "* 1 Mbyte" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:206 msgid "see L below." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:210 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:213 #, 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:222 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:227 msgid "LINUX HOST BLOCK AND I/O SIZE" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:229 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:232 msgid "For a typical consumer hard drive with 512 byte sectors:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:234 #, 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:245 msgid "For a new consumer hard drive with 4Kbyte sectors:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:247 #, 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:258 msgid "For a NetApp LUN:" msgstr "" #. type: verbatim #: ../align/virt-alignment-scan.pod:260 #, 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:269 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:273 msgid "" "For detailed information about what these numbers mean, see " "L" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:276 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:279 msgid "1 MB PARTITION ALIGNMENT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:281 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:284 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:288 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:291 msgid "SETTING ALIGNMENT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:293 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:299 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:303 msgid "" "For older versions of Windows, the following NetApp document contains useful " "information: L" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:306 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:311 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:241 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:690 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:243 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:692 ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 ../tools/virt-make-fs.pl:554 ../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:318 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490 ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:248 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114 ../format/virt-format.pod:173 ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:496 ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:252 ../test-tool/libguestfs-test-tool.pod:90 msgid "EXIT STATUS" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:320 msgid "This program returns:" msgstr "" #. type: =item #: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../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 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../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-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:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1321 ../fish/guestfish-actions.pod:1325 ../fish/guestfish-actions.pod:1329 ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:1341 ../fish/guestfish-actions.pod:1345 ../fish/guestfish-actions.pod:1349 ../fish/guestfish-actions.pod:1359 ../fish/guestfish-actions.pod:1363 ../fish/guestfish-actions.pod:1367 ../fish/guestfish-actions.pod:1457 ../fish/guestfish-actions.pod:1461 ../fish/guestfish-actions.pod:1466 ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1513 ../fish/guestfish-actions.pod:1517 ../fish/guestfish-actions.pod:1522 ../fish/guestfish-actions.pod:1778 ../fish/guestfish-actions.pod:1785 ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:2193 ../fish/guestfish-actions.pod:2199 ../fish/guestfish-actions.pod:2207 ../fish/guestfish-actions.pod:2214 ../fish/guestfish-actions.pod:2221 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../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 ../sparsify/virt-sparsify.pod:65 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2183 ../src/guestfs-actions.pod:2187 ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2195 ../src/guestfs-actions.pod:2203 ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:2221 ../src/guestfs-actions.pod:2225 ../src/guestfs-actions.pod:2229 ../src/guestfs-actions.pod:2367 ../src/guestfs-actions.pod:2371 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:2442 ../src/guestfs-actions.pod:2446 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2866 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:3423 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3437 ../src/guestfs-actions.pod:3444 ../src/guestfs-actions.pod:3451 ../src/guestfs.pod:403 ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417 ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431 ../src/guestfs.pod:436 ../src/guestfs.pod:1116 ../src/guestfs.pod:1120 ../src/guestfs.pod:1124 ../src/guestfs.pod:1129 ../src/guestfs.pod:1137 ../src/guestfs.pod:1156 ../src/guestfs.pod:1164 ../src/guestfs.pod:1186 ../src/guestfs.pod:1190 ../src/guestfs.pod:1194 ../src/guestfs.pod:1198 ../src/guestfs.pod:1202 ../src/guestfs.pod:1206 ../src/guestfs.pod:1696 ../src/guestfs.pod:1701 ../src/guestfs.pod:1705 ../src/guestfs.pod:1807 ../src/guestfs.pod:1812 ../src/guestfs.pod:1816 ../src/guestfs.pod:1826 ../src/guestfs.pod:2115 ../src/guestfs.pod:2120 ../src/guestfs.pod:2126 ../src/guestfs.pod:2134 ../src/guestfs.pod:2652 ../src/guestfs.pod:2658 ../src/guestfs.pod:2663 ../src/guestfs.pod:2669 ../src/guestfs.pod:3061 ../src/guestfs.pod:3066 ../src/guestfs.pod:3070 ../src/guestfs.pod:3074 ../src/guestfs.pod:3078 ../src/guestfs.pod:3092 ../src/guestfs.pod:3097 ../src/guestfs.pod:3331 ../src/guestfs.pod:3335 ../src/guestfs.pod:3339 ../src/guestfs.pod:3343 ../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:326 msgid "0" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:328 msgid "successful exit, all partitions are aligned E 64K for best performance" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:332 msgid "1" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:334 msgid "an error scanning the disk image or guest" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:338 msgid "2" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:340 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:345 msgid "3" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:347 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:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1268 ../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:325 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:276 ../src/guestfs.pod:3269 ../test-tool/libguestfs-test-tool.pod:100 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:559 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:354 msgid "" "L, L, L, L, " "L, L." msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 ../edit/virt-edit.pod:368 ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:334 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:289 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:585 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783 msgid "AUTHOR" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 ../edit/virt-edit.pod:370 ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:727 ../sparsify/virt-sparsify.pod:291 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:587 ../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:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1300 ../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:338 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:293 ../src/guestfs.pod:3354 ../test-tool/libguestfs-test-tool.pod:110 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:589 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:367 ../clone/virt-sysprep.pod:507 ../sparsify/virt-sparsify.pod:295 msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock #: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 ../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:342 ../resize/virt-resize.pod:733 ../sparsify/virt-sparsify.pod:297 ../test-tool/libguestfs-test-tool.pod:115 ../tools/virt-list-filesystems.pl:218 ../tools/virt-list-partitions.pl:287 ../tools/virt-make-fs.pl:593 ../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:374 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 ../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:347 ../resize/virt-resize.pod:738 ../sparsify/virt-sparsify.pod:302 ../test-tool/libguestfs-test-tool.pod:120 ../tools/virt-list-filesystems.pl:223 ../tools/virt-list-partitions.pl:292 ../tools/virt-make-fs.pl:598 ../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:379 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 ../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:352 ../resize/virt-resize.pod:743 ../sparsify/virt-sparsify.pod:307 ../test-tool/libguestfs-test-tool.pod:125 ../tools/virt-list-filesystems.pl:228 ../tools/virt-list-partitions.pl:297 ../tools/virt-make-fs.pl:603 ../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 #: ../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:1051 ../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:76 ../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:124 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:246 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:252 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:256 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:260 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:858 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:382 ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:351 ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:498 ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:254 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:591 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:255 ../df/virt-df.pod:163 msgid "B<--uuid>" 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