X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Flibguestfs-docs.pot;h=78577507cb1a4a033204f708cd92237f35f8693e;hp=22e464f1e9299276c4d02f5c7c6d8311ce24f864;hb=e59e35708b4ad66c99f908c5226cb232931e1791;hpb=a6f99dd9326c2da66f6b7e49d94901fffdddd6ea diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 22e464f..7857750 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.11.20\n" +"Project-Id-Version: libguestfs 1.13.18\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-07-19 18:42+0200\n" +"POT-Creation-Date: 2011-10-05 18:11+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,278 +18,297 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. type: =head1 -#: ../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 ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14 ../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 ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3 ../libguestfs-1.11.20/cat/virt-cat.pod:3 ../libguestfs-1.11.20/cat/virt-filesystems.pod:3 ../libguestfs-1.11.20/cat/virt-ls.pod:3 ../libguestfs-1.11.20/df/virt-df.pod:3 ../libguestfs-1.11.20/edit/virt-edit.pod:3 ../libguestfs-1.11.20/examples/guestfs-examples.pod:3 ../libguestfs-1.11.20/examples/guestfs-recipes.pod:14 ../libguestfs-1.11.20/fish/guestfish.pod:3 ../libguestfs-1.11.20/fish/virt-copy-in.pod:3 ../libguestfs-1.11.20/fish/virt-copy-out.pod:3 ../libguestfs-1.11.20/fish/virt-tar-in.pod:3 ../libguestfs-1.11.20/fish/virt-tar-out.pod:3 ../libguestfs-1.11.20/fuse/guestmount.pod:3 ../libguestfs-1.11.20/inspector/virt-inspector.pod:3 ../libguestfs-1.11.20/java/examples/guestfs-java.pod:3 ../libguestfs-1.11.20/ocaml/examples/guestfs-ocaml.pod:3 ../libguestfs-1.11.20/perl/examples/guestfs-perl.pod:3 ../libguestfs-1.11.20/python/examples/guestfs-python.pod:3 ../libguestfs-1.11.20/rescue/virt-rescue.pod:3 ../libguestfs-1.11.20/resize/virt-resize.pod:3 ../libguestfs-1.11.20/ruby/examples/guestfs-ruby.pod:3 ../libguestfs-1.11.20/src/guestfs.pod:3 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.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 ../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 +#: ../align/virt-alignment-scan.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-recipes.pod:14 ../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 ../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 -#: ../cat/virt-cat.pod:5 ../libguestfs-1.11.20/cat/virt-cat.pod:5 -msgid "virt-cat - Display files in a virtual machine" +#: ../align/virt-alignment-scan.pod:5 +msgid "virt-alignment-scan - Check alignment of virtual machine partitions" msgstr "" #. type: =head1 -#: ../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 ../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 ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7 ../libguestfs-1.11.20/cat/virt-cat.pod:7 ../libguestfs-1.11.20/cat/virt-filesystems.pod:7 ../libguestfs-1.11.20/cat/virt-ls.pod:7 ../libguestfs-1.11.20/df/virt-df.pod:7 ../libguestfs-1.11.20/edit/virt-edit.pod:7 ../libguestfs-1.11.20/examples/guestfs-examples.pod:7 ../libguestfs-1.11.20/fish/guestfish.pod:7 ../libguestfs-1.11.20/fish/virt-copy-in.pod:7 ../libguestfs-1.11.20/fish/virt-copy-out.pod:7 ../libguestfs-1.11.20/fish/virt-tar-in.pod:7 ../libguestfs-1.11.20/fish/virt-tar-out.pod:7 ../libguestfs-1.11.20/fuse/guestmount.pod:7 ../libguestfs-1.11.20/inspector/virt-inspector.pod:7 ../libguestfs-1.11.20/java/examples/guestfs-java.pod:7 ../libguestfs-1.11.20/ocaml/examples/guestfs-ocaml.pod:7 ../libguestfs-1.11.20/perl/examples/guestfs-perl.pod:7 ../libguestfs-1.11.20/python/examples/guestfs-python.pod:7 ../libguestfs-1.11.20/rescue/virt-rescue.pod:7 ../libguestfs-1.11.20/resize/virt-resize.pod:7 ../libguestfs-1.11.20/ruby/examples/guestfs-ruby.pod:7 ../libguestfs-1.11.20/src/guestfs.pod:7 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.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 ../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 +#: ../align/virt-alignment-scan.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 ../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 -#: ../cat/virt-cat.pod:9 ../libguestfs-1.11.20/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 ../libguestfs-1.11.20/cat/virt-cat.pod:11 +#: ../align/virt-alignment-scan.pod:9 #, no-wrap msgid "" -" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" +" virt-alignment-scan [--options]\n" "\n" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 ../inspector/virt-inspector.pod:13 ../libguestfs-1.11.20/cat/virt-cat.pod:13 ../libguestfs-1.11.20/edit/virt-edit.pod:15 ../libguestfs-1.11.20/inspector/virt-inspector.pod:13 -msgid "Old-style:" -msgstr "" - #. type: verbatim -#: ../cat/virt-cat.pod:15 ../libguestfs-1.11.20/cat/virt-cat.pod:15 +#: ../align/virt-alignment-scan.pod:11 #, no-wrap msgid "" -" virt-cat domname file\n" +" virt-alignment-scan [--options] -d domname\n" "\n" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:17 ../libguestfs-1.11.20/cat/virt-cat.pod:17 +#: ../align/virt-alignment-scan.pod:13 #, no-wrap msgid "" -" virt-cat disk.img file\n" +" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" #. type: =head1 -#: ../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 ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 ../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 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../libguestfs-1.11.20/cat/virt-cat.pod:19 ../libguestfs-1.11.20/cat/virt-filesystems.pod:13 ../libguestfs-1.11.20/cat/virt-ls.pod:19 ../libguestfs-1.11.20/df/virt-df.pod:21 ../libguestfs-1.11.20/edit/virt-edit.pod:27 ../libguestfs-1.11.20/examples/guestfs-examples.pod:19 ../libguestfs-1.11.20/examples/guestfs-recipes.pod:18 ../libguestfs-1.11.20/fish/guestfish.pod:30 ../libguestfs-1.11.20/fish/virt-copy-in.pod:19 ../libguestfs-1.11.20/fish/virt-copy-out.pod:13 ../libguestfs-1.11.20/fish/virt-tar-in.pod:21 ../libguestfs-1.11.20/fish/virt-tar-out.pod:15 ../libguestfs-1.11.20/fuse/guestmount.pod:20 ../libguestfs-1.11.20/inspector/virt-inspector.pod:19 ../libguestfs-1.11.20/java/examples/guestfs-java.pod:15 ../libguestfs-1.11.20/ocaml/examples/guestfs-ocaml.pod:25 ../libguestfs-1.11.20/perl/examples/guestfs-perl.pod:18 ../libguestfs-1.11.20/python/examples/guestfs-python.pod:14 ../libguestfs-1.11.20/rescue/virt-rescue.pod:29 ../libguestfs-1.11.20/resize/virt-resize.pod:13 ../libguestfs-1.11.20/ruby/examples/guestfs-ruby.pod:15 ../libguestfs-1.11.20/src/guestfs.pod:23 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:11 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11 ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 +#: ../align/virt-alignment-scan.pod:15 ../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-recipes.pod:18 ../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 ../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:29 ../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:40 ../tools/virt-list-partitions.pl:40 ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 ../tools/virt-win-reg.pl:63 msgid "DESCRIPTION" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:21 ../libguestfs-1.11.20/cat/virt-cat.pod:21 +#: ../align/virt-alignment-scan.pod:17 msgid "" -"C is a command line tool to display the contents of C where " -"C exists in the named virtual machine (or disk image)." +"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 -#: ../cat/virt-cat.pod:24 ../libguestfs-1.11.20/cat/virt-cat.pod:24 +#: ../align/virt-alignment-scan.pod:23 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 '/')." +"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 -#: ../cat/virt-cat.pod:28 ../libguestfs-1.11.20/cat/virt-cat.pod:28 +#: ../align/virt-alignment-scan.pod:27 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)." +"Currently there is no virt tool for fixing alignment problems, except to " +"reinstall the operating system. The following NetApp document summarises " +"the problem and possible solutions: " +"L" 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:1007 ../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 ../libguestfs-1.11.20/cat/virt-cat.pod:32 ../libguestfs-1.11.20/cat/virt-ls.pod:35 ../libguestfs-1.11.20/df/virt-df.pod:43 ../libguestfs-1.11.20/edit/virt-edit.pod:44 ../libguestfs-1.11.20/fish/guestfish.pod:41 ../libguestfs-1.11.20/fish/guestfish.pod:1007 ../libguestfs-1.11.20/fish/virt-copy-in.pod:29 ../libguestfs-1.11.20/fish/virt-copy-out.pod:21 ../libguestfs-1.11.20/fish/virt-tar-in.pod:30 ../libguestfs-1.11.20/fish/virt-tar-out.pod:24 ../libguestfs-1.11.20/fuse/guestmount.pod:39 ../libguestfs-1.11.20/resize/virt-resize.pod:27 ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50 -msgid "EXAMPLES" +#: ../align/virt-alignment-scan.pod:32 +msgid "OUTPUT" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:34 ../libguestfs-1.11.20/cat/virt-cat.pod:34 -msgid "Display C file from inside the libvirt VM called C:" +#: ../align/virt-alignment-scan.pod:34 +msgid "To run this tool on a disk image directly, use the I<-a> option:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:37 ../libguestfs-1.11.20/cat/virt-cat.pod:37 +#: ../align/virt-alignment-scan.pod:36 #, no-wrap msgid "" -" virt-cat -d mydomain /etc/fstab\n" +" $ virt-alignment-scan -a winxp.img\n" +" /dev/sda1 32256 512 bad (alignment < 4K)\n" "\n" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:39 ../libguestfs-1.11.20/cat/virt-cat.pod:39 -msgid "List syslog messages from a VM disk image file:" -msgstr "" - #. type: verbatim -#: ../cat/virt-cat.pod:41 ../libguestfs-1.11.20/cat/virt-cat.pod:41 +#: ../align/virt-alignment-scan.pod:39 #, no-wrap msgid "" -" virt-cat -a disk.img /var/log/messages | tail\n" +" $ 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 -#: ../cat/virt-cat.pod:43 ../libguestfs-1.11.20/cat/virt-cat.pod:43 -msgid "Find out what DHCP IP address a VM acquired:" +#: ../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 -#: ../cat/virt-cat.pod:45 ../libguestfs-1.11.20/cat/virt-cat.pod:45 +#: ../align/virt-alignment-scan.pod:47 #, no-wrap msgid "" -" virt-cat -d mydomain /var/log/messages | \\\n" -" grep 'dhclient: bound to' | tail\n" +" # 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: textblock -#: ../cat/virt-cat.pod:48 ../libguestfs-1.11.20/cat/virt-cat.pod:48 -msgid "Find out what packages were recently installed:" -msgstr "" - #. type: verbatim -#: ../cat/virt-cat.pod:50 ../libguestfs-1.11.20/cat/virt-cat.pod:50 +#: ../align/virt-alignment-scan.pod:51 #, no-wrap msgid "" -" virt-cat -d mydomain /var/log/yum.log | tail\n" +" $ 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 -#: ../cat/virt-cat.pod:52 ../libguestfs-1.11.20/cat/virt-cat.pod:52 -msgid "Find out who is logged on inside a virtual machine:" +#: ../align/virt-alignment-scan.pod:56 +msgid "" +"The output consists of 4 or more whitespace-separated columns. Only the " +"first 4 columns are signficant if you want to parse this from a program. " +"The columns are:" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:54 ../libguestfs-1.11.20/cat/virt-cat.pod:54 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:62 +msgid "col 1" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:64 msgid "" -" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" -" who /tmp/utmp\n" -"\n" +"the device and partition name (eg. C meaning the first partition " +"on the first block device)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:67 +msgid "col 2" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:57 ../libguestfs-1.11.20/cat/virt-cat.pod:57 -msgid "or who was logged on:" +#: ../align/virt-alignment-scan.pod:69 +msgid "the start of the partition in bytes" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:59 ../libguestfs-1.11.20/cat/virt-cat.pod:59 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:71 +msgid "col 3" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:73 +msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:75 +msgid "col 4" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:77 msgid "" -" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" -" last -f /tmp/wtmp\n" -"\n" +"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:80 +msgid "cols 5+" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:82 +msgid "optional free-text explanation." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:86 +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:89 +msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 -#: ../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 ../fuse/guestmount.pod:83 ../inspector/virt-inspector.pod:55 ../libguestfs-1.11.20/cat/virt-cat.pod:62 ../libguestfs-1.11.20/cat/virt-filesystems.pod:91 ../libguestfs-1.11.20/cat/virt-ls.pod:261 ../libguestfs-1.11.20/df/virt-df.pod:59 ../libguestfs-1.11.20/edit/virt-edit.pod:62 ../libguestfs-1.11.20/fish/guestfish.pod:148 ../libguestfs-1.11.20/fish/virt-copy-in.pod:45 ../libguestfs-1.11.20/fish/virt-copy-out.pod:34 ../libguestfs-1.11.20/fish/virt-tar-in.pod:42 ../libguestfs-1.11.20/fish/virt-tar-out.pod:36 ../libguestfs-1.11.20/fuse/guestmount.pod:83 ../libguestfs-1.11.20/inspector/virt-inspector.pod:55 ../libguestfs-1.11.20/rescue/virt-rescue.pod:84 ../libguestfs-1.11.20/resize/virt-resize.pod:241 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:37 ../rescue/virt-rescue.pod:84 ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:37 ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 +#: ../align/virt-alignment-scan.pod:91 ../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 ../fuse/guestmount.pod:83 ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 ../resize/virt-resize.pod:241 ../sparsify/virt-sparsify.pod:99 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96 msgid "OPTIONS" msgstr "" #. type: =item -#: ../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 ../fuse/guestmount.pod:151 ../inspector/virt-inspector.pod:59 ../libguestfs-1.11.20/cat/virt-cat.pod:66 ../libguestfs-1.11.20/cat/virt-filesystems.pod:95 ../libguestfs-1.11.20/cat/virt-ls.pod:265 ../libguestfs-1.11.20/df/virt-df.pod:63 ../libguestfs-1.11.20/edit/virt-edit.pod:66 ../libguestfs-1.11.20/fish/guestfish.pod:152 ../libguestfs-1.11.20/fuse/guestmount.pod:151 ../libguestfs-1.11.20/inspector/virt-inspector.pod:59 ../libguestfs-1.11.20/rescue/virt-rescue.pod:88 ../libguestfs-1.11.20/resize/virt-resize.pod:245 ../rescue/virt-rescue.pod:88 ../resize/virt-resize.pod:245 ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 +#: ../align/virt-alignment-scan.pod:95 ../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 ../fuse/guestmount.pod:151 ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88 ../resize/virt-resize.pod:245 ../sparsify/virt-sparsify.pod:103 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104 msgid "B<--help>" msgstr "" #. type: textblock -#: ../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 ../inspector/virt-inspector.pod:61 ../libguestfs-1.11.20/cat/virt-cat.pod:68 ../libguestfs-1.11.20/cat/virt-filesystems.pod:97 ../libguestfs-1.11.20/cat/virt-ls.pod:267 ../libguestfs-1.11.20/df/virt-df.pod:65 ../libguestfs-1.11.20/edit/virt-edit.pod:68 ../libguestfs-1.11.20/inspector/virt-inspector.pod:61 ../libguestfs-1.11.20/rescue/virt-rescue.pod:90 ../rescue/virt-rescue.pod:90 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106 +#: ../align/virt-alignment-scan.pod:97 ../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 ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106 msgid "Display brief help." msgstr "" #. type: =item -#: ../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 ../inspector/virt-inspector.pod:63 ../libguestfs-1.11.20/cat/virt-cat.pod:70 ../libguestfs-1.11.20/cat/virt-filesystems.pod:99 ../libguestfs-1.11.20/cat/virt-ls.pod:269 ../libguestfs-1.11.20/df/virt-df.pod:67 ../libguestfs-1.11.20/edit/virt-edit.pod:70 ../libguestfs-1.11.20/inspector/virt-inspector.pod:63 ../libguestfs-1.11.20/rescue/virt-rescue.pod:92 ../rescue/virt-rescue.pod:92 +#: ../align/virt-alignment-scan.pod:99 ../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 ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92 msgid "B<-a> file" msgstr "" #. type: =item -#: ../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 ../inspector/virt-inspector.pod:65 ../libguestfs-1.11.20/cat/virt-cat.pod:72 ../libguestfs-1.11.20/cat/virt-filesystems.pod:101 ../libguestfs-1.11.20/cat/virt-ls.pod:271 ../libguestfs-1.11.20/df/virt-df.pod:69 ../libguestfs-1.11.20/edit/virt-edit.pod:72 ../libguestfs-1.11.20/inspector/virt-inspector.pod:65 ../libguestfs-1.11.20/rescue/virt-rescue.pod:94 ../rescue/virt-rescue.pod:94 +#: ../align/virt-alignment-scan.pod:101 ../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 ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94 msgid "B<--add> file" 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:67 ../libguestfs-1.11.20/cat/virt-cat.pod:74 ../libguestfs-1.11.20/cat/virt-filesystems.pod:103 ../libguestfs-1.11.20/cat/virt-ls.pod:273 ../libguestfs-1.11.20/df/virt-df.pod:71 ../libguestfs-1.11.20/edit/virt-edit.pod:74 ../libguestfs-1.11.20/inspector/virt-inspector.pod:67 ../libguestfs-1.11.20/rescue/virt-rescue.pod:96 ../rescue/virt-rescue.pod:96 -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." +#: ../align/virt-alignment-scan.pod:103 +msgid "Add I which should be a disk image from a virtual machine." msgstr "" #. type: textblock -#: ../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 ../fuse/guestmount.pod:93 ../inspector/virt-inspector.pod:71 ../libguestfs-1.11.20/cat/virt-cat.pod:78 ../libguestfs-1.11.20/cat/virt-filesystems.pod:107 ../libguestfs-1.11.20/cat/virt-ls.pod:277 ../libguestfs-1.11.20/df/virt-df.pod:75 ../libguestfs-1.11.20/edit/virt-edit.pod:78 ../libguestfs-1.11.20/fish/guestfish.pod:174 ../libguestfs-1.11.20/fuse/guestmount.pod:93 ../libguestfs-1.11.20/inspector/virt-inspector.pod:71 ../libguestfs-1.11.20/rescue/virt-rescue.pod:100 ../rescue/virt-rescue.pod:100 +#: ../align/virt-alignment-scan.pod:105 ../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 ../fuse/guestmount.pod:93 ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100 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 -#: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../libguestfs-1.11.20/cat/virt-cat.pod:81 ../libguestfs-1.11.20/cat/virt-filesystems.pod:125 ../libguestfs-1.11.20/cat/virt-ls.pod:291 ../libguestfs-1.11.20/df/virt-df.pod:78 ../libguestfs-1.11.20/rescue/virt-rescue.pod:107 ../rescue/virt-rescue.pod:107 +#: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107 msgid "B<-c> URI" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../libguestfs-1.11.20/cat/virt-cat.pod:83 ../libguestfs-1.11.20/cat/virt-filesystems.pod:127 ../libguestfs-1.11.20/cat/virt-ls.pod:293 ../libguestfs-1.11.20/df/virt-df.pod:80 ../libguestfs-1.11.20/rescue/virt-rescue.pod:109 ../rescue/virt-rescue.pod:109 +#: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109 msgid "B<--connect> URI" msgstr "" #. type: textblock -#: ../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:78 ../libguestfs-1.11.20/cat/virt-cat.pod:85 ../libguestfs-1.11.20/cat/virt-filesystems.pod:129 ../libguestfs-1.11.20/cat/virt-ls.pod:295 ../libguestfs-1.11.20/df/virt-df.pod:82 ../libguestfs-1.11.20/edit/virt-edit.pod:99 ../libguestfs-1.11.20/inspector/virt-inspector.pod:78 ../libguestfs-1.11.20/rescue/virt-rescue.pod:111 ../rescue/virt-rescue.pod:111 ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132 +#: ../align/virt-alignment-scan.pod:112 ../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:78 ../rescue/virt-rescue.pod:111 ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 ../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 -#: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../libguestfs-1.11.20/cat/virt-cat.pod:88 ../libguestfs-1.11.20/cat/virt-filesystems.pod:132 ../libguestfs-1.11.20/cat/virt-ls.pod:298 ../libguestfs-1.11.20/df/virt-df.pod:85 ../libguestfs-1.11.20/rescue/virt-rescue.pod:114 ../rescue/virt-rescue.pod:114 +#: ../align/virt-alignment-scan.pod:115 ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114 msgid "" "If you specify guest block devices directly (I<-a>), then libvirt is not " "used at all." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../df/virt-df.pod:88 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:85 ../libguestfs-1.11.20/cat/virt-cat.pod:91 ../libguestfs-1.11.20/cat/virt-filesystems.pod:141 ../libguestfs-1.11.20/cat/virt-ls.pod:307 ../libguestfs-1.11.20/df/virt-df.pod:88 ../libguestfs-1.11.20/edit/virt-edit.pod:105 ../libguestfs-1.11.20/inspector/virt-inspector.pod:85 ../libguestfs-1.11.20/rescue/virt-rescue.pod:117 ../rescue/virt-rescue.pod:117 +#: ../align/virt-alignment-scan.pod:118 ../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:85 ../rescue/virt-rescue.pod:117 msgid "B<-d> guest" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../df/virt-df.pod:90 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:87 ../libguestfs-1.11.20/cat/virt-cat.pod:93 ../libguestfs-1.11.20/cat/virt-filesystems.pod:143 ../libguestfs-1.11.20/cat/virt-ls.pod:309 ../libguestfs-1.11.20/df/virt-df.pod:90 ../libguestfs-1.11.20/edit/virt-edit.pod:107 ../libguestfs-1.11.20/inspector/virt-inspector.pod:87 ../libguestfs-1.11.20/rescue/virt-rescue.pod:119 ../rescue/virt-rescue.pod:119 +#: ../align/virt-alignment-scan.pod:120 ../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:87 ../rescue/virt-rescue.pod:119 msgid "B<--domain> guest" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../df/virt-df.pod:92 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:89 ../libguestfs-1.11.20/cat/virt-cat.pod:95 ../libguestfs-1.11.20/cat/virt-filesystems.pod:145 ../libguestfs-1.11.20/cat/virt-ls.pod:311 ../libguestfs-1.11.20/df/virt-df.pod:92 ../libguestfs-1.11.20/edit/virt-edit.pod:109 ../libguestfs-1.11.20/inspector/virt-inspector.pod:89 ../libguestfs-1.11.20/rescue/virt-rescue.pod:121 ../rescue/virt-rescue.pod:121 +#: ../align/virt-alignment-scan.pod:122 ../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:89 ../rescue/virt-rescue.pod:121 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " "instead of names." 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:126 ../inspector/virt-inspector.pod:92 ../libguestfs-1.11.20/cat/virt-cat.pod:98 ../libguestfs-1.11.20/cat/virt-filesystems.pod:148 ../libguestfs-1.11.20/cat/virt-ls.pod:314 ../libguestfs-1.11.20/edit/virt-edit.pod:112 ../libguestfs-1.11.20/fish/guestfish.pod:217 ../libguestfs-1.11.20/fuse/guestmount.pod:126 ../libguestfs-1.11.20/inspector/virt-inspector.pod:92 -msgid "B<--echo-keys>" -msgstr "" - -#. type: textblock -#: ../cat/virt-cat.pod:100 ../libguestfs-1.11.20/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: =item -#: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../df/virt-df.pod:95 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 ../libguestfs-1.11.20/cat/virt-cat.pod:105 ../libguestfs-1.11.20/cat/virt-filesystems.pod:170 ../libguestfs-1.11.20/cat/virt-ls.pod:328 ../libguestfs-1.11.20/df/virt-df.pod:95 ../libguestfs-1.11.20/fish/guestfish.pod:233 ../libguestfs-1.11.20/fuse/guestmount.pod:133 ../libguestfs-1.11.20/inspector/virt-inspector.pod:99 ../libguestfs-1.11.20/rescue/virt-rescue.pod:124 ../rescue/virt-rescue.pod:124 +#: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124 msgid "B<--format=raw|qcow2|..>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../df/virt-df.pod:97 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101 ../libguestfs-1.11.20/cat/virt-cat.pod:107 ../libguestfs-1.11.20/cat/virt-filesystems.pod:172 ../libguestfs-1.11.20/cat/virt-ls.pod:330 ../libguestfs-1.11.20/df/virt-df.pod:97 ../libguestfs-1.11.20/edit/virt-edit.pod:134 ../libguestfs-1.11.20/fish/guestfish.pod:235 ../libguestfs-1.11.20/fuse/guestmount.pod:135 ../libguestfs-1.11.20/inspector/virt-inspector.pod:101 ../libguestfs-1.11.20/rescue/virt-rescue.pod:126 ../rescue/virt-rescue.pod:126 +#: ../align/virt-alignment-scan.pod:127 ../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 ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126 msgid "B<--format>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../df/virt-df.pod:99 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137 ../libguestfs-1.11.20/cat/virt-cat.pod:109 ../libguestfs-1.11.20/cat/virt-filesystems.pod:174 ../libguestfs-1.11.20/cat/virt-ls.pod:332 ../libguestfs-1.11.20/df/virt-df.pod:99 ../libguestfs-1.11.20/edit/virt-edit.pod:136 ../libguestfs-1.11.20/fish/guestfish.pod:237 ../libguestfs-1.11.20/fuse/guestmount.pod:137 ../libguestfs-1.11.20/rescue/virt-rescue.pod:128 ../rescue/virt-rescue.pod:128 +#: ../align/virt-alignment-scan.pod:129 ../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 ../fuse/guestmount.pod:137 ../rescue/virt-rescue.pod:128 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 " @@ -298,40 +317,40 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../df/virt-df.pod:104 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:335 ../libguestfs-1.11.20/cat/virt-cat.pod:114 ../libguestfs-1.11.20/cat/virt-filesystems.pod:179 ../libguestfs-1.11.20/cat/virt-ls.pod:337 ../libguestfs-1.11.20/df/virt-df.pod:104 ../libguestfs-1.11.20/edit/virt-edit.pod:141 ../libguestfs-1.11.20/fish/guestfish.pod:242 ../libguestfs-1.11.20/fish/guestfish.pod:673 ../libguestfs-1.11.20/inspector/virt-inspector.pod:335 ../libguestfs-1.11.20/rescue/virt-rescue.pod:133 ../libguestfs-1.11.20/src/guestfs.pod:2652 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2652 +#: ../align/virt-alignment-scan.pod:134 ../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:673 ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2791 msgid "For example:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:116 ../libguestfs-1.11.20/cat/virt-cat.pod:116 +#: ../align/virt-alignment-scan.pod:136 #, no-wrap msgid "" -" virt-cat --format=raw -a disk.img file\n" +" virt-alignment-scan --format=raw -a disk.img\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../df/virt-df.pod:108 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../libguestfs-1.11.20/cat/virt-cat.pod:118 ../libguestfs-1.11.20/cat/virt-filesystems.pod:183 ../libguestfs-1.11.20/cat/virt-ls.pod:341 ../libguestfs-1.11.20/df/virt-df.pod:108 ../libguestfs-1.11.20/edit/virt-edit.pod:145 ../libguestfs-1.11.20/fish/guestfish.pod:246 ../libguestfs-1.11.20/rescue/virt-rescue.pod:137 ../rescue/virt-rescue.pod:137 +#: ../align/virt-alignment-scan.pod:138 ../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 ../rescue/virt-rescue.pod:137 msgid "forces raw format (no auto-detection) for C." msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:120 ../libguestfs-1.11.20/cat/virt-cat.pod:120 +#: ../align/virt-alignment-scan.pod:140 #, no-wrap msgid "" -" virt-cat --format=raw -a disk.img --format -a another.img file\n" +" virt-alignment-scan --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../df/virt-df.pod:112 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../libguestfs-1.11.20/cat/virt-cat.pod:122 ../libguestfs-1.11.20/cat/virt-filesystems.pod:187 ../libguestfs-1.11.20/cat/virt-ls.pod:345 ../libguestfs-1.11.20/df/virt-df.pod:112 ../libguestfs-1.11.20/edit/virt-edit.pod:149 ../libguestfs-1.11.20/fish/guestfish.pod:250 ../libguestfs-1.11.20/rescue/virt-rescue.pod:141 ../rescue/virt-rescue.pod:141 +#: ../align/virt-alignment-scan.pod:142 ../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 ../rescue/virt-rescue.pod:141 msgid "" "forces raw format (no auto-detection) for C and reverts to " "auto-detection for C." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../df/virt-df.pod:115 ../edit/virt-edit.pod:152 ../libguestfs-1.11.20/cat/virt-cat.pod:125 ../libguestfs-1.11.20/cat/virt-filesystems.pod:190 ../libguestfs-1.11.20/cat/virt-ls.pod:348 ../libguestfs-1.11.20/df/virt-df.pod:115 ../libguestfs-1.11.20/edit/virt-edit.pod:152 ../libguestfs-1.11.20/rescue/virt-rescue.pod:144 ../rescue/virt-rescue.pod:144 +#: ../align/virt-alignment-scan.pod:145 ../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 ../rescue/virt-rescue.pod:144 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 " @@ -339,204 +358,164 @@ msgid "" 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:163 ../inspector/virt-inspector.pod:114 ../libguestfs-1.11.20/cat/virt-cat.pod:129 ../libguestfs-1.11.20/cat/virt-filesystems.pod:200 ../libguestfs-1.11.20/cat/virt-ls.pod:361 ../libguestfs-1.11.20/edit/virt-edit.pod:156 ../libguestfs-1.11.20/fish/guestfish.pod:289 ../libguestfs-1.11.20/fuse/guestmount.pod:163 ../libguestfs-1.11.20/inspector/virt-inspector.pod:114 -msgid "B<--keys-from-stdin>" +#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:414 ../sparsify/virt-sparsify.pod:153 +msgid "B<-q>" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:151 ../resize/virt-resize.pod:416 ../sparsify/virt-sparsify.pod:155 +msgid "B<--quiet>" 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:165 ../inspector/virt-inspector.pod:116 ../libguestfs-1.11.20/cat/virt-cat.pod:131 ../libguestfs-1.11.20/cat/virt-filesystems.pod:202 ../libguestfs-1.11.20/cat/virt-ls.pod:363 ../libguestfs-1.11.20/edit/virt-edit.pod:158 ../libguestfs-1.11.20/fish/guestfish.pod:291 ../libguestfs-1.11.20/fuse/guestmount.pod:165 ../libguestfs-1.11.20/inspector/virt-inspector.pod:116 +#: ../align/virt-alignment-scan.pod:153 msgid "" -"Read key or passphrase parameters from stdin. The default is to try to read " -"passphrases from the user by opening C." +"Don't produce any output. Just set the exit code (see L " +"below)." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../df/virt-df.pod:167 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119 ../libguestfs-1.11.20/cat/virt-cat.pod:134 ../libguestfs-1.11.20/cat/virt-filesystems.pod:261 ../libguestfs-1.11.20/cat/virt-ls.pod:425 ../libguestfs-1.11.20/df/virt-df.pod:167 ../libguestfs-1.11.20/edit/virt-edit.pod:161 ../libguestfs-1.11.20/fish/guestfish.pod:390 ../libguestfs-1.11.20/fuse/guestmount.pod:257 ../libguestfs-1.11.20/inspector/virt-inspector.pod:119 ../libguestfs-1.11.20/rescue/virt-rescue.pod:178 ../rescue/virt-rescue.pod:178 +#: ../align/virt-alignment-scan.pod:156 ../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:390 ../fuse/guestmount.pod:257 ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159 msgid "B<-v>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../df/virt-df.pod:169 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121 ../libguestfs-1.11.20/cat/virt-cat.pod:136 ../libguestfs-1.11.20/cat/virt-filesystems.pod:263 ../libguestfs-1.11.20/cat/virt-ls.pod:427 ../libguestfs-1.11.20/df/virt-df.pod:169 ../libguestfs-1.11.20/edit/virt-edit.pod:163 ../libguestfs-1.11.20/fish/guestfish.pod:392 ../libguestfs-1.11.20/fuse/guestmount.pod:259 ../libguestfs-1.11.20/inspector/virt-inspector.pod:121 ../libguestfs-1.11.20/rescue/virt-rescue.pod:180 ../rescue/virt-rescue.pod:180 +#: ../align/virt-alignment-scan.pod:158 ../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:392 ../fuse/guestmount.pod:259 ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161 msgid "B<--verbose>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../df/virt-df.pod:171 ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 ../libguestfs-1.11.20/cat/virt-cat.pod:138 ../libguestfs-1.11.20/cat/virt-filesystems.pod:265 ../libguestfs-1.11.20/cat/virt-ls.pod:429 ../libguestfs-1.11.20/df/virt-df.pod:171 ../libguestfs-1.11.20/edit/virt-edit.pod:165 ../libguestfs-1.11.20/inspector/virt-inspector.pod:123 ../libguestfs-1.11.20/rescue/virt-rescue.pod:182 ../rescue/virt-rescue.pod:182 +#: ../align/virt-alignment-scan.pod:160 ../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 ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:186 ../sparsify/virt-sparsify.pod:163 msgid "Enable verbose messages for debugging." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../df/virt-df.pod:173 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125 ../libguestfs-1.11.20/cat/virt-cat.pod:140 ../libguestfs-1.11.20/cat/virt-filesystems.pod:267 ../libguestfs-1.11.20/cat/virt-ls.pod:431 ../libguestfs-1.11.20/df/virt-df.pod:173 ../libguestfs-1.11.20/edit/virt-edit.pod:167 ../libguestfs-1.11.20/fish/guestfish.pod:397 ../libguestfs-1.11.20/fuse/guestmount.pod:263 ../libguestfs-1.11.20/inspector/virt-inspector.pod:125 ../libguestfs-1.11.20/rescue/virt-rescue.pod:184 ../libguestfs-1.11.20/resize/virt-resize.pod:478 ../rescue/virt-rescue.pod:184 ../resize/virt-resize.pod:478 +#: ../align/virt-alignment-scan.pod:162 ../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:397 ../fuse/guestmount.pod:263 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:484 ../sparsify/virt-sparsify.pod:165 msgid "B<-V>" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../df/virt-df.pod:175 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127 ../libguestfs-1.11.20/cat/virt-cat.pod:142 ../libguestfs-1.11.20/cat/virt-filesystems.pod:269 ../libguestfs-1.11.20/cat/virt-ls.pod:433 ../libguestfs-1.11.20/df/virt-df.pod:175 ../libguestfs-1.11.20/edit/virt-edit.pod:169 ../libguestfs-1.11.20/fish/guestfish.pod:399 ../libguestfs-1.11.20/fuse/guestmount.pod:265 ../libguestfs-1.11.20/inspector/virt-inspector.pod:127 ../libguestfs-1.11.20/rescue/virt-rescue.pod:186 ../libguestfs-1.11.20/resize/virt-resize.pod:480 ../rescue/virt-rescue.pod:186 ../resize/virt-resize.pod:480 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 +#: ../align/virt-alignment-scan.pod:164 ../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:399 ../fuse/guestmount.pod:265 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:486 ../sparsify/virt-sparsify.pod:167 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 msgid "B<--version>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../df/virt-df.pod:177 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../libguestfs-1.11.20/cat/virt-cat.pod:144 ../libguestfs-1.11.20/cat/virt-filesystems.pod:271 ../libguestfs-1.11.20/cat/virt-ls.pod:435 ../libguestfs-1.11.20/df/virt-df.pod:177 ../libguestfs-1.11.20/edit/virt-edit.pod:171 ../libguestfs-1.11.20/inspector/virt-inspector.pod:129 ../libguestfs-1.11.20/rescue/virt-rescue.pod:188 ../libguestfs-1.11.20/resize/virt-resize.pod:482 ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:482 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 +#: ../align/virt-alignment-scan.pod:166 ../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 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:488 ../sparsify/virt-sparsify.pod:169 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 msgid "Display version number and exit." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../df/virt-df.pod:179 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131 ../libguestfs-1.11.20/cat/virt-cat.pod:146 ../libguestfs-1.11.20/cat/virt-filesystems.pod:281 ../libguestfs-1.11.20/cat/virt-ls.pod:437 ../libguestfs-1.11.20/df/virt-df.pod:179 ../libguestfs-1.11.20/edit/virt-edit.pod:173 ../libguestfs-1.11.20/fish/guestfish.pod:412 ../libguestfs-1.11.20/fuse/guestmount.pod:278 ../libguestfs-1.11.20/inspector/virt-inspector.pod:131 ../libguestfs-1.11.20/rescue/virt-rescue.pod:199 ../rescue/virt-rescue.pod:199 ../tools/virt-tar.pl:158 +#: ../align/virt-alignment-scan.pod:168 ../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:412 ../fuse/guestmount.pod:278 ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171 ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../df/virt-df.pod:181 ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 ../libguestfs-1.11.20/cat/virt-cat.pod:148 ../libguestfs-1.11.20/cat/virt-filesystems.pod:283 ../libguestfs-1.11.20/cat/virt-ls.pod:439 ../libguestfs-1.11.20/df/virt-df.pod:181 ../libguestfs-1.11.20/edit/virt-edit.pod:175 ../libguestfs-1.11.20/inspector/virt-inspector.pod:133 ../libguestfs-1.11.20/rescue/virt-rescue.pod:201 ../rescue/virt-rescue.pod:201 +#: ../align/virt-alignment-scan.pod:170 ../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 ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:205 ../sparsify/virt-sparsify.pod:173 msgid "Enable tracing of libguestfs API calls." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 ../inspector/virt-inspector.pod:137 ../libguestfs-1.11.20/cat/virt-cat.pod:152 ../libguestfs-1.11.20/cat/virt-ls.pod:443 ../libguestfs-1.11.20/edit/virt-edit.pod:179 ../libguestfs-1.11.20/inspector/virt-inspector.pod:137 ../libguestfs-1.11.20/rescue/virt-rescue.pod:205 ../rescue/virt-rescue.pod:205 -msgid "OLD-STYLE COMMAND LINE ARGUMENTS" -msgstr "" - -#. type: textblock -#: ../cat/virt-cat.pod:154 ../libguestfs-1.11.20/cat/virt-cat.pod:154 -msgid "Previous versions of virt-cat allowed you to write either:" -msgstr "" - -#. type: verbatim -#: ../cat/virt-cat.pod:156 ../libguestfs-1.11.20/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:143 ../libguestfs-1.11.20/cat/virt-cat.pod:158 ../libguestfs-1.11.20/cat/virt-ls.pod:449 ../libguestfs-1.11.20/edit/virt-edit.pod:185 ../libguestfs-1.11.20/inspector/virt-inspector.pod:143 ../libguestfs-1.11.20/rescue/virt-rescue.pod:211 ../rescue/virt-rescue.pod:211 -msgid "or" -msgstr "" - -#. type: verbatim -#: ../cat/virt-cat.pod:160 ../libguestfs-1.11.20/cat/virt-cat.pod:160 -#, no-wrap -msgid "" -" virt-cat guestname file\n" -"\n" +#: ../align/virt-alignment-scan.pod:174 ../cat/virt-cat.pod:191 ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:601 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733 +msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 ../inspector/virt-inspector.pod:147 ../libguestfs-1.11.20/cat/virt-cat.pod:162 ../libguestfs-1.11.20/cat/virt-ls.pod:453 ../libguestfs-1.11.20/edit/virt-edit.pod:189 ../libguestfs-1.11.20/inspector/virt-inspector.pod:147 ../libguestfs-1.11.20/rescue/virt-rescue.pod:215 ../rescue/virt-rescue.pod:215 +#: ../align/virt-alignment-scan.pod:176 ../cat/virt-cat.pod:193 ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:603 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741 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:151 ../libguestfs-1.11.20/cat/virt-cat.pod:166 ../libguestfs-1.11.20/cat/virt-ls.pod:457 ../libguestfs-1.11.20/edit/virt-edit.pod:193 ../libguestfs-1.11.20/inspector/virt-inspector.pod:151 ../libguestfs-1.11.20/rescue/virt-rescue.pod:219 ../rescue/virt-rescue.pod:219 -msgid "For compatibility the old style is still supported." +"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 -#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 ../libguestfs-1.11.20/cat/virt-cat.pod:168 ../libguestfs-1.11.20/edit/virt-edit.pod:297 -msgid "USING GUESTFISH" +#: ../align/virt-alignment-scan.pod:181 ../cat/virt-cat.pod:198 ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1081 ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:608 ../sparsify/virt-sparsify.pod:227 ../test-tool/libguestfs-test-tool.pod:90 +msgid "EXIT STATUS" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:170 ../libguestfs-1.11.20/cat/virt-cat.pod:170 -msgid "" -"L is a more powerful, lower level tool which you can use when " -"C doesn't work." +#: ../align/virt-alignment-scan.pod:183 +msgid "This program returns:" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:173 ../libguestfs-1.11.20/cat/virt-cat.pod:173 -msgid "Using C is approximately equivalent to doing:" +#. type: =item +#: ../align/virt-alignment-scan.pod:187 +msgid "code 0" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:175 ../libguestfs-1.11.20/cat/virt-cat.pod:175 -#, no-wrap -msgid "" -" guestfish --ro -i -d domname download file -\n" -"\n" +#. type: textblock +#: ../align/virt-alignment-scan.pod:189 +msgid "successful exit, all partitions are aligned E 64K for best performance" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:177 ../libguestfs-1.11.20/cat/virt-cat.pod:177 -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\")." +#. type: =item +#: ../align/virt-alignment-scan.pod:191 +msgid "code 1" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:181 ../libguestfs-1.11.20/cat/virt-cat.pod:181 -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:" +#: ../align/virt-alignment-scan.pod:193 +msgid "an error scanning the disk image or guest" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:186 ../libguestfs-1.11.20/cat/virt-cat.pod:186 -#, no-wrap -msgid "" -" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" -"\n" +#. type: =item +#: ../align/virt-alignment-scan.pod:195 +msgid "code 2" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:188 ../libguestfs-1.11.20/cat/virt-cat.pod:188 +#: ../align/virt-alignment-scan.pod:197 msgid "" -"where C is the disk image, C is the filesystem within " -"the disk image to edit, and C is the full path to the file." +"successful exit, some partitions have alignment E 64K which can result " +"in poor performance on high end network storage" msgstr "" -#. type: =head1 -#: ../cat/virt-cat.pod:192 ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:483 ../df/virt-df.pod:209 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:349 ../libguestfs-1.11.20/cat/virt-cat.pod:192 ../libguestfs-1.11.20/cat/virt-filesystems.pod:365 ../libguestfs-1.11.20/cat/virt-ls.pod:483 ../libguestfs-1.11.20/df/virt-df.pod:209 ../libguestfs-1.11.20/edit/virt-edit.pod:342 ../libguestfs-1.11.20/inspector/virt-inspector.pod:349 ../libguestfs-1.11.20/rescue/virt-rescue.pod:262 ../libguestfs-1.11.20/resize/virt-resize.pod:543 ../rescue/virt-rescue.pod:262 ../resize/virt-resize.pod:543 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733 -msgid "SHELL QUOTING" +#. type: =item +#: ../align/virt-alignment-scan.pod:200 +msgid "code 3" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:194 ../cat/virt-filesystems.pod:367 ../cat/virt-ls.pod:485 ../df/virt-df.pod:211 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:351 ../libguestfs-1.11.20/cat/virt-cat.pod:194 ../libguestfs-1.11.20/cat/virt-filesystems.pod:367 ../libguestfs-1.11.20/cat/virt-ls.pod:485 ../libguestfs-1.11.20/df/virt-df.pod:211 ../libguestfs-1.11.20/edit/virt-edit.pod:344 ../libguestfs-1.11.20/inspector/virt-inspector.pod:351 ../libguestfs-1.11.20/rescue/virt-rescue.pod:264 ../libguestfs-1.11.20/resize/virt-resize.pod:545 ../rescue/virt-rescue.pod:264 ../resize/virt-resize.pod:545 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741 +#: ../align/virt-alignment-scan.pod:202 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." +"successful exit, some partitions have alignment E 4K which can result in " +"poor performance on most hypervisors" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372 ../cat/virt-ls.pod:490 ../df/virt-df.pod:216 ../edit/virt-edit.pod:349 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1214 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:303 ../inspector/virt-inspector.pod:372 ../java/examples/guestfs-java.pod:45 ../libguestfs-1.11.20/cat/virt-cat.pod:199 ../libguestfs-1.11.20/cat/virt-filesystems.pod:372 ../libguestfs-1.11.20/cat/virt-ls.pod:490 ../libguestfs-1.11.20/df/virt-df.pod:216 ../libguestfs-1.11.20/edit/virt-edit.pod:349 ../libguestfs-1.11.20/examples/guestfs-examples.pod:33 ../libguestfs-1.11.20/examples/guestfs-recipes.pod:384 ../libguestfs-1.11.20/fish/guestfish.pod:1214 ../libguestfs-1.11.20/fish/virt-copy-in.pod:50 ../libguestfs-1.11.20/fish/virt-copy-out.pod:39 ../libguestfs-1.11.20/fish/virt-tar-in.pod:47 ../libguestfs-1.11.20/fish/virt-tar-out.pod:41 ../libguestfs-1.11.20/fuse/guestmount.pod:303 ../libguestfs-1.11.20/inspector/virt-inspector.pod:372 ../libguestfs-1.11.20/java/examples/guestfs-java.pod:45 ../libguestfs-1.11.20/ocaml/examples/guestfs-ocaml.pod:78 ../libguestfs-1.11.20/perl/examples/guestfs-perl.pod:39 ../libguestfs-1.11.20/python/examples/guestfs-python.pod:42 ../libguestfs-1.11.20/rescue/virt-rescue.pod:284 ../libguestfs-1.11.20/resize/virt-resize.pod:550 ../libguestfs-1.11.20/ruby/examples/guestfs-ruby.pod:36 ../libguestfs-1.11.20/src/guestfs.pod:3011 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:87 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:284 ../resize/virt-resize.pod:550 ../ruby/examples/guestfs-ruby.pod:36 ../src/guestfs.pod:3011 ../test-tool/libguestfs-test-tool.pod:87 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:746 +#: ../align/virt-alignment-scan.pod:207 ../cat/virt-cat.pod:203 ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:495 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1235 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308 ../inspector/virt-inspector.pod:380 ../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:288 ../resize/virt-resize.pod:613 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3179 ../test-tool/libguestfs-test-tool.pod:100 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:746 msgid "SEE ALSO" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:201 ../libguestfs-1.11.20/cat/virt-cat.pod:201 +#: ../align/virt-alignment-scan.pod:209 msgid "" -"L, L, L, L, " -"L, L." +"L, L, L, " +"L." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:208 ../cat/virt-filesystems.pod:383 ../cat/virt-ls.pod:502 ../df/virt-df.pod:224 ../edit/virt-edit.pod:363 ../libguestfs-1.11.20/cat/virt-cat.pod:208 ../libguestfs-1.11.20/cat/virt-filesystems.pod:383 ../libguestfs-1.11.20/cat/virt-ls.pod:502 ../libguestfs-1.11.20/df/virt-df.pod:224 ../libguestfs-1.11.20/edit/virt-edit.pod:363 ../libguestfs-1.11.20/rescue/virt-rescue.pod:292 ../libguestfs-1.11.20/resize/virt-resize.pod:571 ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:571 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772 +#: ../align/virt-alignment-scan.pod:214 ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:388 ../cat/virt-ls.pod:507 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:635 ../sparsify/virt-sparsify.pod:264 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:772 msgid "AUTHOR" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:210 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:504 ../df/virt-df.pod:226 ../edit/virt-edit.pod:365 ../inspector/virt-inspector.pod:386 ../libguestfs-1.11.20/cat/virt-cat.pod:210 ../libguestfs-1.11.20/cat/virt-filesystems.pod:385 ../libguestfs-1.11.20/cat/virt-ls.pod:504 ../libguestfs-1.11.20/df/virt-df.pod:226 ../libguestfs-1.11.20/edit/virt-edit.pod:365 ../libguestfs-1.11.20/inspector/virt-inspector.pod:386 ../libguestfs-1.11.20/rescue/virt-rescue.pod:294 ../libguestfs-1.11.20/resize/virt-resize.pod:573 ../rescue/virt-rescue.pod:294 ../resize/virt-resize.pod:573 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774 +#: ../align/virt-alignment-scan.pod:216 ../cat/virt-cat.pod:214 ../cat/virt-filesystems.pod:390 ../cat/virt-ls.pod:509 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298 ../resize/virt-resize.pod:637 ../sparsify/virt-sparsify.pod:266 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774 msgid "Richard W.M. Jones L" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:387 ../cat/virt-ls.pod:506 ../df/virt-df.pod:228 ../edit/virt-edit.pod:367 ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400 ../fish/guestfish.pod:1242 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:318 ../inspector/virt-inspector.pod:394 ../java/examples/guestfs-java.pod:61 ../libguestfs-1.11.20/cat/virt-cat.pod:212 ../libguestfs-1.11.20/cat/virt-filesystems.pod:387 ../libguestfs-1.11.20/cat/virt-ls.pod:506 ../libguestfs-1.11.20/df/virt-df.pod:228 ../libguestfs-1.11.20/edit/virt-edit.pod:367 ../libguestfs-1.11.20/examples/guestfs-examples.pod:48 ../libguestfs-1.11.20/examples/guestfs-recipes.pod:400 ../libguestfs-1.11.20/fish/guestfish.pod:1242 ../libguestfs-1.11.20/fish/virt-copy-in.pod:64 ../libguestfs-1.11.20/fish/virt-copy-out.pod:53 ../libguestfs-1.11.20/fish/virt-tar-in.pod:62 ../libguestfs-1.11.20/fish/virt-tar-out.pod:55 ../libguestfs-1.11.20/fuse/guestmount.pod:318 ../libguestfs-1.11.20/inspector/virt-inspector.pod:394 ../libguestfs-1.11.20/java/examples/guestfs-java.pod:61 ../libguestfs-1.11.20/ocaml/examples/guestfs-ocaml.pod:94 ../libguestfs-1.11.20/perl/examples/guestfs-perl.pod:55 ../libguestfs-1.11.20/python/examples/guestfs-python.pod:57 ../libguestfs-1.11.20/rescue/virt-rescue.pod:296 ../libguestfs-1.11.20/resize/virt-resize.pod:575 ../libguestfs-1.11.20/ruby/examples/guestfs-ruby.pod:51 ../libguestfs-1.11.20/src/guestfs.pod:3086 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:97 ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55 ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:575 ../ruby/examples/guestfs-ruby.pod:51 ../src/guestfs.pod:3086 ../test-tool/libguestfs-test-tool.pod:97 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:776 +#: ../align/virt-alignment-scan.pod:218 ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:392 ../cat/virt-ls.pod:511 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../fish/guestfish.pod:1266 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323 ../inspector/virt-inspector.pod:403 ../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:300 ../resize/virt-resize.pod:639 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3259 ../test-tool/libguestfs-test-tool.pod:110 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:776 msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:214 ../inspector/virt-inspector.pod:396 ../libguestfs-1.11.20/cat/virt-cat.pod:214 ../libguestfs-1.11.20/inspector/virt-inspector.pod:396 ../libguestfs-1.11.20/resize/virt-resize.pod:577 ../resize/virt-resize.pod:577 -msgid "Copyright (C) 2010-2011 Red Hat Inc." +#: ../align/virt-alignment-scan.pod:220 ../sparsify/virt-sparsify.pod:270 +msgid "Copyright (C) 2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:391 ../cat/virt-ls.pod:510 ../df/virt-df.pod:232 ../edit/virt-edit.pod:371 ../fish/guestfish.pod:1247 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:323 ../inspector/virt-inspector.pod:398 ../libguestfs-1.11.20/cat/virt-cat.pod:216 ../libguestfs-1.11.20/cat/virt-filesystems.pod:391 ../libguestfs-1.11.20/cat/virt-ls.pod:510 ../libguestfs-1.11.20/df/virt-df.pod:232 ../libguestfs-1.11.20/edit/virt-edit.pod:371 ../libguestfs-1.11.20/fish/guestfish.pod:1247 ../libguestfs-1.11.20/fish/virt-copy-in.pod:69 ../libguestfs-1.11.20/fish/virt-copy-out.pod:58 ../libguestfs-1.11.20/fish/virt-tar-in.pod:67 ../libguestfs-1.11.20/fish/virt-tar-out.pod:60 ../libguestfs-1.11.20/fuse/guestmount.pod:323 ../libguestfs-1.11.20/inspector/virt-inspector.pod:398 ../libguestfs-1.11.20/rescue/virt-rescue.pod:300 ../libguestfs-1.11.20/resize/virt-resize.pod:579 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:102 ../rescue/virt-rescue.pod:300 ../resize/virt-resize.pod:579 ../test-tool/libguestfs-test-tool.pod:102 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:780 +#: ../align/virt-alignment-scan.pod:222 ../cat/virt-cat.pod:220 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1271 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:304 ../resize/virt-resize.pod:643 ../sparsify/virt-sparsify.pod:272 ../test-tool/libguestfs-test-tool.pod:115 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:780 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 " @@ -545,7 +524,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:515 ../df/virt-df.pod:237 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1252 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:403 ../libguestfs-1.11.20/cat/virt-cat.pod:221 ../libguestfs-1.11.20/cat/virt-filesystems.pod:396 ../libguestfs-1.11.20/cat/virt-ls.pod:515 ../libguestfs-1.11.20/df/virt-df.pod:237 ../libguestfs-1.11.20/edit/virt-edit.pod:376 ../libguestfs-1.11.20/fish/guestfish.pod:1252 ../libguestfs-1.11.20/fish/virt-copy-in.pod:74 ../libguestfs-1.11.20/fish/virt-copy-out.pod:63 ../libguestfs-1.11.20/fish/virt-tar-in.pod:72 ../libguestfs-1.11.20/fish/virt-tar-out.pod:65 ../libguestfs-1.11.20/fuse/guestmount.pod:328 ../libguestfs-1.11.20/inspector/virt-inspector.pod:403 ../libguestfs-1.11.20/rescue/virt-rescue.pod:305 ../libguestfs-1.11.20/resize/virt-resize.pod:584 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:107 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:584 ../test-tool/libguestfs-test-tool.pod:107 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:785 +#: ../align/virt-alignment-scan.pod:227 ../cat/virt-cat.pod:225 ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1276 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:309 ../resize/virt-resize.pod:648 ../sparsify/virt-sparsify.pod:277 ../test-tool/libguestfs-test-tool.pod:120 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:785 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 " @@ -554,7 +533,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401 ../cat/virt-ls.pod:520 ../df/virt-df.pod:242 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1257 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:333 ../inspector/virt-inspector.pod:408 ../libguestfs-1.11.20/cat/virt-cat.pod:226 ../libguestfs-1.11.20/cat/virt-filesystems.pod:401 ../libguestfs-1.11.20/cat/virt-ls.pod:520 ../libguestfs-1.11.20/df/virt-df.pod:242 ../libguestfs-1.11.20/edit/virt-edit.pod:381 ../libguestfs-1.11.20/fish/guestfish.pod:1257 ../libguestfs-1.11.20/fish/virt-copy-in.pod:79 ../libguestfs-1.11.20/fish/virt-copy-out.pod:68 ../libguestfs-1.11.20/fish/virt-tar-in.pod:77 ../libguestfs-1.11.20/fish/virt-tar-out.pod:70 ../libguestfs-1.11.20/fuse/guestmount.pod:333 ../libguestfs-1.11.20/inspector/virt-inspector.pod:408 ../libguestfs-1.11.20/rescue/virt-rescue.pod:310 ../libguestfs-1.11.20/resize/virt-resize.pod:589 ../libguestfs-1.11.20/test-tool/libguestfs-test-tool.pod:112 ../rescue/virt-rescue.pod:310 ../resize/virt-resize.pod:589 ../test-tool/libguestfs-test-tool.pod:112 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:790 +#: ../align/virt-alignment-scan.pod:232 ../cat/virt-cat.pod:230 ../cat/virt-filesystems.pod:406 ../cat/virt-ls.pod:525 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1281 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:338 ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:314 ../resize/virt-resize.pod:653 ../sparsify/virt-sparsify.pod:282 ../test-tool/libguestfs-test-tool.pod:125 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:790 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., 675 Mass " @@ -562,480 +541,797 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:5 ../libguestfs-1.11.20/cat/virt-filesystems.pod:5 -msgid "" -"virt-filesystems - List filesystems, partitions, block devices, LVM in a " -"virtual machine or disk image" +#: ../cat/virt-cat.pod:5 +msgid "virt-cat - Display files in a virtual machine" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:9 ../libguestfs-1.11.20/cat/virt-filesystems.pod:9 +#: ../cat/virt-cat.pod:9 #, no-wrap msgid "" -" virt-filesystems [--options] -d domname\n" +" virt-cat [--options] -d domname file [file ...]\n" "\n" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:11 ../libguestfs-1.11.20/cat/virt-filesystems.pod:11 +#: ../cat/virt-cat.pod:11 #, no-wrap msgid "" -" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:15 ../libguestfs-1.11.20/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." +#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 ../inspector/virt-inspector.pod:13 +msgid "Old-style:" msgstr "" -#. type: textblock -#: ../cat/virt-filesystems.pod:20 ../libguestfs-1.11.20/cat/virt-filesystems.pod:20 +#. type: verbatim +#: ../cat/virt-cat.pod:15 +#, no-wrap msgid "" -"One use for this tool is from shell scripts to iterate over all filesystems " -"from a disk image:" +" virt-cat domname file\n" +"\n" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:23 ../libguestfs-1.11.20/cat/virt-filesystems.pod:23 +#: ../cat/virt-cat.pod:17 #, no-wrap msgid "" -" for fs in $(virt-filesystems -a disk.img); do\n" -" # ...\n" -" done\n" +" virt-cat disk.img file\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:27 ../libguestfs-1.11.20/cat/virt-filesystems.pod:27 +#: ../cat/virt-cat.pod:21 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." +"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-filesystems.pod:32 ../libguestfs-1.11.20/cat/virt-filesystems.pod:32 +#: ../cat/virt-cat.pod:24 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:" +"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: verbatim -#: ../cat/virt-filesystems.pod:37 ../libguestfs-1.11.20/cat/virt-filesystems.pod:37 -#, no-wrap +#. type: textblock +#: ../cat/virt-cat.pod:28 msgid "" -" $ virt-filesystems -a disk.img\n" -" /dev/sda1\n" -" /dev/vg_guest/lv_root\n" -"\n" +"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:1018 ../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:75 ../tools/virt-tar.pl:50 +msgid "EXAMPLES" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:41 ../libguestfs-1.11.20/cat/virt-filesystems.pod:41 -msgid "If you add I<-l> or I<--long> then the output includes extra information:" +#: ../cat/virt-cat.pod:34 +msgid "Display C file from inside the libvirt VM called C:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:44 ../libguestfs-1.11.20/cat/virt-filesystems.pod:44 +#: ../cat/virt-cat.pod:37 #, 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" +" virt-cat -d mydomain /etc/fstab\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:49 ../libguestfs-1.11.20/cat/virt-filesystems.pod:49 -msgid "" -"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " -"shown as well:" +#: ../cat/virt-cat.pod:39 +msgid "List syslog messages from a VM disk image file:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:52 ../libguestfs-1.11.20/cat/virt-filesystems.pod:52 +#: ../cat/virt-cat.pod:41 #, 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" +" virt-cat -a disk.img /var/log/messages | tail\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:58 ../libguestfs-1.11.20/cat/virt-filesystems.pod:58 -msgid "If you add I<--partitions> then partitions are shown instead of filesystems:" +#: ../cat/virt-cat.pod:43 +msgid "Find out what DHCP IP address a VM acquired:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:60 ../libguestfs-1.11.20/cat/virt-filesystems.pod:60 +#: ../cat/virt-cat.pod:45 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img --partitions\n" -" /dev/sda1\n" -" /dev/sda2\n" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:64 ../libguestfs-1.11.20/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." +#: ../cat/virt-cat.pod:48 +msgid "Find out what packages were recently installed:" msgstr "" -#. type: textblock -#: ../cat/virt-filesystems.pod:67 ../libguestfs-1.11.20/cat/virt-filesystems.pod:67 +#. type: verbatim +#: ../cat/virt-cat.pod:50 +#, no-wrap 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." +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:74 ../libguestfs-1.11.20/cat/virt-filesystems.pod:74 +#: ../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 "" -"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." +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:78 ../libguestfs-1.11.20/cat/virt-filesystems.pod:78 -msgid "" -"I<--all --long --uuid> is a useful combination to display all possible " -"information about everything." +#: ../cat/virt-cat.pod:57 +msgid "or who was logged on:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:81 ../libguestfs-1.11.20/cat/virt-filesystems.pod:81 +#: ../cat/virt-cat.pod:59 #, 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" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:89 ../libguestfs-1.11.20/cat/virt-filesystems.pod:89 -msgid "For machine-readable output, use I<--csv> to get Comma-Separated Values." +#: ../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:67 ../rescue/virt-rescue.pod:96 +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-filesystems.pod:110 ../libguestfs-1.11.20/cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121 -msgid "B<--all>" +#: ../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:126 ../inspector/virt-inspector.pod:92 +msgid "B<--echo-keys>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:112 ../libguestfs-1.11.20/cat/virt-filesystems.pod:112 +#: ../cat/virt-cat.pod:100 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)." +"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: textblock -#: ../cat/virt-filesystems.pod:117 ../libguestfs-1.11.20/cat/virt-filesystems.pod:117 -msgid "See also I<--long>." +#. type: verbatim +#: ../cat/virt-cat.pod:116 +#, no-wrap +msgid "" +" virt-cat --format=raw -a disk.img file\n" +"\n" msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:119 ../libguestfs-1.11.20/cat/virt-filesystems.pod:119 -msgid "B<--blkdevs>" +#. 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-filesystems.pod:121 ../libguestfs-1.11.20/cat/virt-filesystems.pod:121 -msgid "B<--block-devices>" +#: ../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:163 ../inspector/virt-inspector.pod:114 +msgid "B<--keys-from-stdin>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:123 ../libguestfs-1.11.20/cat/virt-filesystems.pod:123 -msgid "Display block devices." +#: ../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:165 ../inspector/virt-inspector.pod:116 +msgid "" +"Read key or passphrase parameters from stdin. The default is to try to read " +"passphrases from the user by opening C." msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../libguestfs-1.11.20/cat/virt-filesystems.pod:135 ../libguestfs-1.11.20/cat/virt-ls.pod:301 -msgid "B<--csv>" +#. type: =head1 +#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209 +msgid "OLD-STYLE COMMAND LINE ARGUMENTS" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../libguestfs-1.11.20/cat/virt-filesystems.pod:137 ../libguestfs-1.11.20/cat/virt-ls.pod:303 +#: ../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 "" -"Write out the results in CSV format (comma-separated values). This format " -"can be imported easily into databases and spreadsheets, but read L below." +" virt-cat disk.img [disk.img ...] file\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:150 ../libguestfs-1.11.20/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." +#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215 +msgid "or" msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:155 ../libguestfs-1.11.20/cat/virt-filesystems.pod:155 -msgid "B<--extra>" +#. type: verbatim +#: ../cat/virt-cat.pod:160 +#, no-wrap +msgid "" +" virt-cat guestname file\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:157 ../libguestfs-1.11.20/cat/virt-filesystems.pod:157 +#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219 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." +"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-filesystems.pod:161 ../libguestfs-1.11.20/cat/virt-filesystems.pod:161 -msgid "This option implies I<--filesystems>." +#: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223 +msgid "For compatibility the old style is still supported." msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:163 ../libguestfs-1.11.20/cat/virt-filesystems.pod:163 -msgid "B<--filesystems>" +#. type: =head1 +#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 +msgid "USING GUESTFISH" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:165 ../libguestfs-1.11.20/cat/virt-filesystems.pod:165 +#: ../cat/virt-cat.pod:170 msgid "" -"Display mountable filesystems. If no display option was selected then this " -"option is implied." +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:168 ../libguestfs-1.11.20/cat/virt-filesystems.pod:168 -msgid "With I<--extra>, non-mountable filesystems are shown too." +#: ../cat/virt-cat.pod:173 +msgid "Using C is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:181 ../libguestfs-1.11.20/cat/virt-filesystems.pod:181 +#: ../cat/virt-cat.pod:175 #, no-wrap msgid "" -" virt-filesystems --format=raw -a disk.img\n" +" guestfish --ro -i -d domname download file -\n" "\n" msgstr "" -#. type: verbatim -#: ../cat/virt-filesystems.pod:185 ../libguestfs-1.11.20/cat/virt-filesystems.pod:185 -#, no-wrap +#. type: textblock +#: ../cat/virt-cat.pod:177 msgid "" -" virt-filesystems --format=raw -a disk.img --format -a another.img\n" -"\n" +"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: =item -#: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352 ../df/virt-df.pod:119 ../fish/guestfish.pod:156 ../libguestfs-1.11.20/cat/virt-filesystems.pod:194 ../libguestfs-1.11.20/cat/virt-ls.pod:352 ../libguestfs-1.11.20/df/virt-df.pod:119 ../libguestfs-1.11.20/fish/guestfish.pod:156 ../tools/virt-list-partitions.pl:109 -msgid "B<-h>" +#. type: textblock +#: ../cat/virt-cat.pod:181 +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: =item -#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 ../df/virt-df.pod:121 ../libguestfs-1.11.20/cat/virt-filesystems.pod:196 ../libguestfs-1.11.20/cat/virt-ls.pod:354 ../libguestfs-1.11.20/df/virt-df.pod:121 ../tools/virt-list-partitions.pl:111 -msgid "B<--human-readable>" +#. type: verbatim +#: ../cat/virt-cat.pod:186 +#, no-wrap +msgid "" +" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:198 ../libguestfs-1.11.20/cat/virt-filesystems.pod:198 -msgid "In I<--long> mode, display sizes in human-readable format." +#: ../cat/virt-cat.pod:188 +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: =item -#: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366 ../libguestfs-1.11.20/cat/virt-filesystems.pod:205 ../libguestfs-1.11.20/cat/virt-ls.pod:366 ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119 -msgid "B<-l>" +#. type: textblock +#: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374 ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351 ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377 ../resize/virt-resize.pod:610 ../sparsify/virt-sparsify.pod:229 +msgid "This program returns 0 if successful, or non-zero if there was an error." msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 ../libguestfs-1.11.20/cat/virt-filesystems.pod:207 ../libguestfs-1.11.20/cat/virt-ls.pod:368 ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121 -msgid "B<--long>" +#. type: textblock +#: ../cat/virt-cat.pod:205 +msgid "" +"L, L, L, L, " +"L, L." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:209 ../libguestfs-1.11.20/cat/virt-filesystems.pod:209 -msgid "Display extra columns of data (\"long format\")." +#: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405 ../resize/virt-resize.pod:641 +msgid "Copyright (C) 2010-2011 Red Hat Inc." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:211 ../libguestfs-1.11.20/cat/virt-filesystems.pod:211 -msgid "A title row is added unless you also specify I<--no-title>." +#: ../cat/virt-filesystems.pod:5 +msgid "" +"virt-filesystems - List filesystems, partitions, block devices, LVM in a " +"virtual machine or disk image" msgstr "" -#. type: textblock -#: ../cat/virt-filesystems.pod:213 ../libguestfs-1.11.20/cat/virt-filesystems.pod:213 +#. type: verbatim +#: ../cat/virt-filesystems.pod:9 +#, no-wrap 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." +" virt-filesystems [--options] -d domname\n" +"\n" msgstr "" -#. type: textblock -#: ../cat/virt-filesystems.pod:218 ../libguestfs-1.11.20/cat/virt-filesystems.pod:218 +#. type: verbatim +#: ../cat/virt-filesystems.pod:11 +#, no-wrap msgid "" -"Use I<-h> if you want sizes to be displayed in human-readable format. The " -"default is to show raw numbers of I." +" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +"\n" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:221 ../libguestfs-1.11.20/cat/virt-filesystems.pod:221 -msgid "Use I<--uuid> to display UUIDs too." +#: ../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: =item -#: ../cat/virt-filesystems.pod:223 ../libguestfs-1.11.20/cat/virt-filesystems.pod:223 -msgid "B<--lvs>" +#. 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: =item -#: ../cat/virt-filesystems.pod:225 ../libguestfs-1.11.20/cat/virt-filesystems.pod:225 -msgid "B<--logvols>" +#. 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: =item -#: ../cat/virt-filesystems.pod:227 ../libguestfs-1.11.20/cat/virt-filesystems.pod:227 -msgid "B<--logical-volumes>" +#. 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:229 ../libguestfs-1.11.20/cat/virt-filesystems.pod:229 +#: ../cat/virt-filesystems.pod:32 msgid "" -"Display LVM logical volumes. In this mode, these are displayed irrespective " -"of whether the LVs contain filesystems." +"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: =item -#: ../cat/virt-filesystems.pod:232 ../libguestfs-1.11.20/cat/virt-filesystems.pod:232 -msgid "B<--no-title>" +#. 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:234 ../libguestfs-1.11.20/cat/virt-filesystems.pod:234 -msgid "In I<--long> mode, don't add a title row." +#: ../cat/virt-filesystems.pod:41 +msgid "If you add I<-l> or I<--long> then the output includes extra information:" msgstr "" -#. type: textblock -#: ../cat/virt-filesystems.pod:236 ../libguestfs-1.11.20/cat/virt-filesystems.pod:236 +#. type: verbatim +#: ../cat/virt-filesystems.pod:44 +#, no-wrap 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." +" $ 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: =item -#: ../cat/virt-filesystems.pod:240 ../libguestfs-1.11.20/cat/virt-filesystems.pod:240 -msgid "B<--parts>" +#. 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: =item -#: ../cat/virt-filesystems.pod:242 ../libguestfs-1.11.20/cat/virt-filesystems.pod:242 -msgid "B<--partitions>" +#. 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:244 ../libguestfs-1.11.20/cat/virt-filesystems.pod:244 -msgid "" -"Display partitions. In this mode, these are displayed irrespective of " -"whether the partitions contain filesystems." +#: ../cat/virt-filesystems.pod:58 +msgid "If you add I<--partitions> then partitions are shown instead of filesystems:" msgstr "" -#. type: =item -#: ../cat/virt-filesystems.pod:247 ../libguestfs-1.11.20/cat/virt-filesystems.pod:247 -msgid "B<--pvs>" +#. 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:121 +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:109 +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:111 +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:108 ../tools/virt-list-partitions.pl:119 +msgid "B<-l>" +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121 +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:249 ../libguestfs-1.11.20/cat/virt-filesystems.pod:249 +#: ../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 ../libguestfs-1.11.20/cat/virt-filesystems.pod:251 +#: ../cat/virt-filesystems.pod:251 msgid "B<--physical-volumes>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:253 ../libguestfs-1.11.20/cat/virt-filesystems.pod:253 +#: ../cat/virt-filesystems.pod:253 msgid "Display LVM physical volumes." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:157 ../libguestfs-1.11.20/cat/virt-filesystems.pod:255 ../libguestfs-1.11.20/df/virt-df.pod:157 +#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163 msgid "B<--uuid>" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:257 ../libguestfs-1.11.20/cat/virt-filesystems.pod:257 +#: ../cat/virt-filesystems.pod:257 msgid "B<--uuids>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:259 ../libguestfs-1.11.20/cat/virt-filesystems.pod:259 +#: ../cat/virt-filesystems.pod:259 msgid "In I<--long> mode, display UUIDs as well." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:273 ../libguestfs-1.11.20/cat/virt-filesystems.pod:273 +#: ../cat/virt-filesystems.pod:273 msgid "B<--vgs>" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:275 ../libguestfs-1.11.20/cat/virt-filesystems.pod:275 +#: ../cat/virt-filesystems.pod:275 msgid "B<--volgroups>" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:277 ../libguestfs-1.11.20/cat/virt-filesystems.pod:277 +#: ../cat/virt-filesystems.pod:277 msgid "B<--volume-groups>" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:279 ../libguestfs-1.11.20/cat/virt-filesystems.pod:279 +#: ../cat/virt-filesystems.pod:279 msgid "Display LVM volume groups." msgstr "" #. type: =head1 -#: ../cat/virt-filesystems.pod:287 ../libguestfs-1.11.20/cat/virt-filesystems.pod:287 +#: ../cat/virt-filesystems.pod:287 msgid "COLUMNS" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:289 ../libguestfs-1.11.20/cat/virt-filesystems.pod:289 +#: ../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 ../libguestfs-1.11.20/cat/virt-filesystems.pod:294 +#: ../cat/virt-filesystems.pod:294 msgid "B" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:296 ../libguestfs-1.11.20/cat/virt-filesystems.pod:296 +#: ../cat/virt-filesystems.pod:296 msgid "The filesystem, partition, block device or LVM name." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:298 ../libguestfs-1.11.20/cat/virt-filesystems.pod:298 +#: ../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 " @@ -1043,65 +1339,65 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:302 ../libguestfs-1.11.20/cat/virt-filesystems.pod:302 +#: ../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 ../libguestfs-1.11.20/cat/virt-filesystems.pod:305 +#: ../cat/virt-filesystems.pod:305 msgid "B" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:307 ../libguestfs-1.11.20/cat/virt-filesystems.pod:307 +#: ../cat/virt-filesystems.pod:307 msgid "The object type, for example C, C, C etc." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:309 ../libguestfs-1.11.20/cat/virt-filesystems.pod:309 +#: ../cat/virt-filesystems.pod:309 msgid "B" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:311 ../libguestfs-1.11.20/cat/virt-filesystems.pod:311 +#: ../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 ../libguestfs-1.11.20/cat/virt-filesystems.pod:314 +#: ../cat/virt-filesystems.pod:314 msgid "B