From: Richard W.M. Jones Date: Mon, 18 Jul 2011 10:55:41 +0000 (+0100) Subject: Version 1.11.19. X-Git-Tag: 1.11.19^0 X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=commitdiff_plain;h=463a739bf0475cf45bf03ad2c4130b2ed656686e;ds=sidebyside Version 1.11.19. --- diff --git a/BUGS b/BUGS index cfed015..5367ed4 100644 --- a/BUGS +++ b/BUGS @@ -1,5 +1,5 @@ NOTE: This file is automatically generated from "update-bugs.sh". -Last updated: 2011-07-15 +Last updated: 2011-07-18 This contains a local list of the bugs that are open against libguestfs. Bugs are tracked in the Red Hat Bugzilla database diff --git a/configure.ac b/configure.ac index 435b5e1..fc94224 100644 --- a/configure.ac +++ b/configure.ac @@ -18,7 +18,7 @@ # major/minor/release must be numbers m4_define([libguestfs_major], [1]) m4_define([libguestfs_minor], [11]) -m4_define([libguestfs_release], [18]) +m4_define([libguestfs_release], [19]) # extra can be any string m4_define([libguestfs_extra], []) diff --git a/po-docs/ja.po b/po-docs/ja.po index e17f970..9704ecd 100644 --- a/po-docs/ja.po +++ b/po-docs/ja.po @@ -1,31035 +1,44048 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Red Hat Inc. # This file is distributed under the same license as the libguestfs package. -# +# # rjones , 2011. msgid "" msgstr "" "Project-Id-Version: libguestfs\n" -"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/\n" -"POT-Creation-Date: 2011-07-15 17:18+0200\n" +"Report-Msgid-Bugs-To: libguestfs@redhat.com\n" +"POT-Creation-Date: 2011-07-18 11:32+0200\n" "PO-Revision-Date: 2011-07-17 20:50+0000\n" "Last-Translator: rjones \n" -"Language-Team: Japanese (http://www.transifex.net/projects/p/fedora/team/ja/)\n" +"Language-Team: Japanese (http://www.transifex.net/projects/p/fedora/team/" +"ja/)\n" +"Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: ja\n" "Plural-Forms: nplurals=1; plural=0\n" #. type: =head1 -#: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 -#: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 -#: ../tools/virt-win-reg.pl:35 ../tools/virt-list-filesystems.pl:30 -#: ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35 -#: ../tools/virt-list-partitions.pl:30 +#: ../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 ../libguestfs-1.11.19/cat/virt-cat.pod:3 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:3 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:3 +#: ../libguestfs-1.11.19/df/virt-df.pod:3 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:3 +#: ../libguestfs-1.11.19/examples/guestfs-examples.pod:3 +#: ../libguestfs-1.11.19/examples/guestfs-recipes.pod:14 +#: ../libguestfs-1.11.19/fish/guestfish.pod:3 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:3 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:3 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:3 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:3 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:3 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:3 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:3 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:3 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:3 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:3 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:3 +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:3 +#: ../libguestfs-1.11.19/src/guestfs.pod:3 +#: ../libguestfs-1.11.19/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 msgid "NAME" msgstr "名前" #. type: textblock -#: ../src/guestfs.pod:5 -msgid "guestfs - Library for accessing and modifying virtual machine images" +#: ../cat/virt-cat.pod:5 ../libguestfs-1.11.19/cat/virt-cat.pod:5 +msgid "virt-cat - Display files in a virtual machine" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:7 ../fish/guestfish.pod:7 -#: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7 -#: ../tools/virt-win-reg.pl:39 ../tools/virt-list-filesystems.pl:34 -#: ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39 -#: ../tools/virt-list-partitions.pl:34 +#: ../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 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:7 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:7 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:7 +#: ../libguestfs-1.11.19/df/virt-df.pod:7 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:7 +#: ../libguestfs-1.11.19/examples/guestfs-examples.pod:7 +#: ../libguestfs-1.11.19/fish/guestfish.pod:7 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:7 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:7 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:7 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:7 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:7 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:7 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:7 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:7 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:7 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:7 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:7 +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:7 +#: ../libguestfs-1.11.19/src/guestfs.pod:7 +#: ../libguestfs-1.11.19/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 msgid "SYNOPSIS" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:9 +#: ../cat/virt-cat.pod:9 ../libguestfs-1.11.19/cat/virt-cat.pod:9 #, no-wrap msgid "" -" #include \n" -" \n" +" virt-cat [--options] -d domname file [file ...]\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:11 +#: ../cat/virt-cat.pod:11 ../libguestfs-1.11.19/cat/virt-cat.pod:11 #, no-wrap msgid "" -" guestfs_h *g = guestfs_create ();\n" -" guestfs_add_drive (g, \"guest.img\");\n" -" guestfs_launch (g);\n" -" guestfs_mount (g, \"/dev/sda1\", \"/\");\n" -" guestfs_touch (g, \"/hello\");\n" -" guestfs_umount (g, \"/\");\n" -" guestfs_close (g);\n" +" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 +#: ../inspector/virt-inspector.pod:13 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:13 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:15 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:13 +msgid "Old-style:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:15 ../libguestfs-1.11.19/cat/virt-cat.pod:15 +#, no-wrap +msgid "" +" virt-cat domname file\n" "\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:19 +#: ../cat/virt-cat.pod:17 ../libguestfs-1.11.19/cat/virt-cat.pod:17 #, no-wrap msgid "" -" cc prog.c -o prog -lguestfs\n" -"or:\n" -" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +" virt-cat disk.img file\n" "\n" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:23 ../fish/guestfish.pod:30 -#: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20 -#: ../tools/virt-win-reg.pl:63 ../tools/virt-list-filesystems.pl:40 -#: ../tools/virt-tar.pl:77 ../tools/virt-make-fs.pl:47 -#: ../tools/virt-list-partitions.pl:40 +#: ../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 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:19 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:13 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:19 +#: ../libguestfs-1.11.19/df/virt-df.pod:21 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:27 +#: ../libguestfs-1.11.19/examples/guestfs-examples.pod:19 +#: ../libguestfs-1.11.19/examples/guestfs-recipes.pod:18 +#: ../libguestfs-1.11.19/fish/guestfish.pod:30 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:19 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:13 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:21 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:15 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:20 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:19 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:25 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:18 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:14 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:29 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:13 +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:15 +#: ../libguestfs-1.11.19/src/guestfs.pod:23 +#: ../libguestfs-1.11.19/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 msgid "DESCRIPTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:25 +#: ../cat/virt-cat.pod:21 ../libguestfs-1.11.19/cat/virt-cat.pod:21 msgid "" -"Libguestfs is a library for accessing and modifying guest disk images. " -"Amongst the things this is good for: making batch configuration changes to " -"guests, getting disk used/free statistics (see also: virt-df), migrating " -"between virtualization systems (see also: virt-p2v), performing partial " -"backups, performing partial guest clones, cloning guests and changing " -"registry/UUID/hostname info, and much else besides." +"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 -#: ../src/guestfs.pod:33 +#: ../cat/virt-cat.pod:24 ../libguestfs-1.11.19/cat/virt-cat.pod:24 msgid "" -"Libguestfs uses Linux kernel and qemu code, and can access any type of guest" -" filesystem that Linux and qemu can, including but not limited to: ext2/3/4," -" btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, " -"qcow2, vmdk." +"Multiple filenames can be given, in which case they are concatenated " +"together. Each filename must be a full path, starting at the root directory " +"(starting with '/')." msgstr "" #. type: textblock -#: ../src/guestfs.pod:38 +#: ../cat/virt-cat.pod:28 ../libguestfs-1.11.19/cat/virt-cat.pod:28 msgid "" -"Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, " -"what filesystem is in each LV, etc.). It can also run commands in the " -"context of the guest. Also you can access filesystems over FUSE." +"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: textblock -#: ../src/guestfs.pod:43 -msgid "" -"Libguestfs is a library that can be linked with C and C++ management " -"programs (or management programs written in OCaml, Perl, Python, Ruby, Java," -" PHP, Haskell or C#). You can also use it from shell scripts or the command" -" line." +#. 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.19/cat/virt-cat.pod:32 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:35 +#: ../libguestfs-1.11.19/df/virt-df.pod:43 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:44 +#: ../libguestfs-1.11.19/fish/guestfish.pod:41 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1007 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:29 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:21 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:30 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:24 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:39 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:27 +#: ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50 +msgid "EXAMPLES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:48 +#: ../cat/virt-cat.pod:34 ../libguestfs-1.11.19/cat/virt-cat.pod:34 msgid "" -"You don't need to be root to use libguestfs, although obviously you do need " -"enough permissions to access the disk images." +"Display C file from inside the libvirt VM called C:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:51 +#. type: verbatim +#: ../cat/virt-cat.pod:37 ../libguestfs-1.11.19/cat/virt-cat.pod:37 +#, no-wrap msgid "" -"Libguestfs is a large API because it can do many things. For a gentle " -"introduction, please read the L section next." +" virt-cat -d mydomain /etc/fstab\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:54 -msgid "" -"There are also some example programs in the L manual " -"page." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:57 -msgid "API OVERVIEW" +#: ../cat/virt-cat.pod:39 ../libguestfs-1.11.19/cat/virt-cat.pod:39 +msgid "List syslog messages from a VM disk image file:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:59 +#. type: verbatim +#: ../cat/virt-cat.pod:41 ../libguestfs-1.11.19/cat/virt-cat.pod:41 +#, no-wrap msgid "" -"This section provides a gentler overview of the libguestfs API. We also try" -" to group API calls together, where that may not be obvious from reading " -"about the individual calls in the main section of this manual." +" virt-cat -a disk.img /var/log/messages | tail\n" +"\n" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:64 -msgid "HANDLES" +#. type: textblock +#: ../cat/virt-cat.pod:43 ../libguestfs-1.11.19/cat/virt-cat.pod:43 +msgid "Find out what DHCP IP address a VM acquired:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:66 +#. type: verbatim +#: ../cat/virt-cat.pod:45 ../libguestfs-1.11.19/cat/virt-cat.pod:45 +#, no-wrap msgid "" -"Before you can use libguestfs calls, you have to create a handle. Then you " -"must add at least one disk image to the handle, followed by launching the " -"handle, then performing whatever operations you want, and finally closing " -"the handle. By convention we use the single letter C for the name of the" -" handle variable, although of course you can use any name you want." +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:73 -msgid "" -"The general structure of all libguestfs-using programs looks like this:" +#: ../cat/virt-cat.pod:48 ../libguestfs-1.11.19/cat/virt-cat.pod:48 +msgid "Find out what packages were recently installed:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:76 +#: ../cat/virt-cat.pod:50 ../libguestfs-1.11.19/cat/virt-cat.pod:50 #, no-wrap msgid "" -" guestfs_h *g = guestfs_create ();\n" -" \n" +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:78 -#, no-wrap -msgid "" -" /* Call guestfs_add_drive additional times if there are\n" -" * multiple disk images.\n" -" */\n" -" guestfs_add_drive (g, \"guest.img\");\n" -" \n" +#. type: textblock +#: ../cat/virt-cat.pod:52 ../libguestfs-1.11.19/cat/virt-cat.pod:52 +msgid "Find out who is logged on inside a virtual machine:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:83 +#: ../cat/virt-cat.pod:54 ../libguestfs-1.11.19/cat/virt-cat.pod:54 #, no-wrap msgid "" -" /* Most manipulation calls won't work until you've launched\n" -" * the handle 'g'. You have to do this _after_ adding drives\n" -" * and _before_ other commands.\n" -" */\n" -" guestfs_launch (g);\n" -" \n" +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:89 -#, no-wrap -msgid "" -" /* Now you can examine what partitions, LVs etc are available.\n" -" */\n" -" char **partitions = guestfs_list_partitions (g);\n" -" char **logvols = guestfs_lvs (g);\n" -" \n" +#. type: textblock +#: ../cat/virt-cat.pod:57 ../libguestfs-1.11.19/cat/virt-cat.pod:57 +msgid "or who was logged on:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:94 +#: ../cat/virt-cat.pod:59 ../libguestfs-1.11.19/cat/virt-cat.pod:59 #, no-wrap msgid "" -" /* To access a filesystem in the image, you must mount it.\n" -" */\n" -" guestfs_mount (g, \"/dev/sda1\", \"/\");\n" -" \n" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:98 -#, no-wrap -msgid "" -" /* Now you can perform filesystem actions on the guest\n" -" * disk image.\n" -" */\n" -" guestfs_touch (g, \"/hello\");\n" -" \n" +#. 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.19/cat/virt-cat.pod:62 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:91 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:261 +#: ../libguestfs-1.11.19/df/virt-df.pod:59 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:62 +#: ../libguestfs-1.11.19/fish/guestfish.pod:148 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:45 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:34 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:42 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:36 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:83 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:55 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:84 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:241 +#: ../libguestfs-1.11.19/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 +msgid "OPTIONS" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:103 -#, no-wrap -msgid "" -" /* This is only needed for libguestfs < 1.5.24. Since then\n" -" * it is done automatically when you close the handle. See\n" -" * discussion of autosync in this page.\n" -" */\n" -" guestfs_sync (g);\n" -" \n" +#. 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.19/cat/virt-cat.pod:66 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:95 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:265 +#: ../libguestfs-1.11.19/df/virt-df.pod:63 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:66 +#: ../libguestfs-1.11.19/fish/guestfish.pod:152 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:151 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:59 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:88 +#: ../libguestfs-1.11.19/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 +msgid "B<--help>" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:109 -#, no-wrap +#. 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.19/cat/virt-cat.pod:68 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:97 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:267 +#: ../libguestfs-1.11.19/df/virt-df.pod:65 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:68 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:61 +#: ../libguestfs-1.11.19/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 +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.19/cat/virt-cat.pod:70 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:99 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:269 +#: ../libguestfs-1.11.19/df/virt-df.pod:67 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:70 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:63 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:92 +#: ../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.19/cat/virt-cat.pod:72 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:101 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:271 +#: ../libguestfs-1.11.19/df/virt-df.pod:69 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:72 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:65 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:94 +#: ../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.19/cat/virt-cat.pod:74 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:103 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:273 +#: ../libguestfs-1.11.19/df/virt-df.pod:71 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:74 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:67 +#: ../libguestfs-1.11.19/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." +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.19/cat/virt-cat.pod:78 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:107 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:277 +#: ../libguestfs-1.11.19/df/virt-df.pod:75 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:78 +#: ../libguestfs-1.11.19/fish/guestfish.pod:174 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:93 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:71 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:100 +#: ../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.19/cat/virt-cat.pod:81 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:125 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:291 +#: ../libguestfs-1.11.19/df/virt-df.pod:78 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:107 +#: ../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.19/cat/virt-cat.pod:83 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:127 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:293 +#: ../libguestfs-1.11.19/df/virt-df.pod:80 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:109 +#: ../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.19/cat/virt-cat.pod:85 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:129 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:295 +#: ../libguestfs-1.11.19/df/virt-df.pod:82 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:99 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:78 +#: ../libguestfs-1.11.19/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 msgid "" -" /* Close the handle 'g'. */\n" -" guestfs_close (g);\n" -"\n" +"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.19/cat/virt-cat.pod:88 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:132 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:298 +#: ../libguestfs-1.11.19/df/virt-df.pod:85 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:114 +#: ../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.19/cat/virt-cat.pod:91 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:141 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:307 +#: ../libguestfs-1.11.19/df/virt-df.pod:88 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:105 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:85 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:117 +#: ../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.19/cat/virt-cat.pod:93 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:143 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:309 +#: ../libguestfs-1.11.19/df/virt-df.pod:90 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:107 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:87 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:119 +#: ../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.19/cat/virt-cat.pod:95 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:145 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:311 +#: ../libguestfs-1.11.19/df/virt-df.pod:92 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:109 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:89 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:121 +#: ../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.19/cat/virt-cat.pod:98 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:148 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:314 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:112 +#: ../libguestfs-1.11.19/fish/guestfish.pod:217 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:126 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:92 +msgid "B<--echo-keys>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:112 +#: ../cat/virt-cat.pod:100 ../libguestfs-1.11.19/cat/virt-cat.pod:100 msgid "" -"The code above doesn't include any error checking. In real code you should " -"check return values carefully for errors. In general all functions that " -"return integers return C<-1> on error, and all functions that return " -"pointers return C on error. See section L below for " -"how to handle errors, and consult the documentation for each function call " -"below to see precisely how they return error indications. See L for fully worked examples." +"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: =head2 -#: ../src/guestfs.pod:121 -msgid "DISK IMAGES" +#. 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.19/cat/virt-cat.pod:105 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:170 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:328 +#: ../libguestfs-1.11.19/df/virt-df.pod:95 +#: ../libguestfs-1.11.19/fish/guestfish.pod:233 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:133 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:99 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:124 +#: ../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.19/cat/virt-cat.pod:107 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:172 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:330 +#: ../libguestfs-1.11.19/df/virt-df.pod:97 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:134 +#: ../libguestfs-1.11.19/fish/guestfish.pod:235 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:135 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:101 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:126 +#: ../rescue/virt-rescue.pod:126 +msgid "B<--format>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:123 +#: ../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.19/cat/virt-cat.pod:109 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:174 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:332 +#: ../libguestfs-1.11.19/df/virt-df.pod:99 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:136 +#: ../libguestfs-1.11.19/fish/guestfish.pod:237 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:137 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:128 +#: ../rescue/virt-rescue.pod:128 msgid "" -"The image filename (C<\"guest.img\"> in the example above) could be a disk " -"image from a virtual machine, a L copy of a physical hard disk, an " -"actual block device, or simply an empty file of zeroes that you have created" -" through L. Libguestfs lets you do useful things to all" -" of these." +"The default for the I<-a> option is to auto-detect the format of the disk " +"image. Using this forces the disk format for I<-a> options which follow on " +"the command line. Using I<--format> with no argument switches back to auto-" +"detection for subsequent I<-a> options." msgstr "" #. type: textblock -#: ../src/guestfs.pod:129 -msgid "" -"The call you should use in modern code for adding drives is " -"L. To add a disk image, allowing writes, and " -"specifying that the format is raw, do:" +#: ../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.19/cat/virt-cat.pod:114 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:179 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:337 +#: ../libguestfs-1.11.19/df/virt-df.pod:104 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:141 +#: ../libguestfs-1.11.19/fish/guestfish.pod:242 +#: ../libguestfs-1.11.19/fish/guestfish.pod:673 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:335 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:133 +#: ../libguestfs-1.11.19/src/guestfs.pod:2652 ../rescue/virt-rescue.pod:133 +#: ../src/guestfs.pod:2652 +msgid "For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:133 +#: ../cat/virt-cat.pod:116 ../libguestfs-1.11.19/cat/virt-cat.pod:116 #, no-wrap msgid "" -" guestfs_add_drive_opts (g, filename,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n" -" -1);\n" +" virt-cat --format=raw -a disk.img file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:137 -msgid "You can add a disk read-only using:" +#: ../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.19/cat/virt-cat.pod:118 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:183 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:341 +#: ../libguestfs-1.11.19/df/virt-df.pod:108 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:145 +#: ../libguestfs-1.11.19/fish/guestfish.pod:246 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:137 +#: ../rescue/virt-rescue.pod:137 +msgid "forces raw format (no auto-detection) for C." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:139 +#: ../cat/virt-cat.pod:120 ../libguestfs-1.11.19/cat/virt-cat.pod:120 #, no-wrap msgid "" -" guestfs_add_drive_opts (g, filename,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n" -" GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n" -" -1);\n" +" virt-cat --format=raw -a disk.img --format -a another.img file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:144 +#: ../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.19/cat/virt-cat.pod:122 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:187 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:345 +#: ../libguestfs-1.11.19/df/virt-df.pod:112 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:149 +#: ../libguestfs-1.11.19/fish/guestfish.pod:250 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:141 +#: ../rescue/virt-rescue.pod:141 msgid "" -"or by calling the older function L. In either case " -"libguestfs won't modify the file." +"forces raw format (no auto-detection) for C and reverts to auto-" +"detection for C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:147 +#: ../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.19/cat/virt-cat.pod:125 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:190 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:348 +#: ../libguestfs-1.11.19/df/virt-df.pod:115 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:152 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:144 +#: ../rescue/virt-rescue.pod:144 msgid "" -"Be extremely cautious if the disk image is in use, eg. if it is being used " -"by a virtual machine. Adding it read-write will almost certainly cause disk" -" corruption, but adding it read-only is safe." +"If you have untrusted raw-format guest disk images, you should use this " +"option to specify the disk format. This avoids a possible security problem " +"with malicious guests (CVE-2010-3851)." +msgstr "" + +#. type: =item +#: ../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.19/cat/virt-cat.pod:129 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:200 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:361 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:156 +#: ../libguestfs-1.11.19/fish/guestfish.pod:289 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:163 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:114 +msgid "B<--keys-from-stdin>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:151 -msgid "" -"You must add at least one disk image, and you may add multiple disk images." -" In the API, the disk images are usually referred to as C (for " -"the first one you added), C (for the second one you added), etc." +#: ../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.19/cat/virt-cat.pod:131 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:202 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:363 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:158 +#: ../libguestfs-1.11.19/fish/guestfish.pod:291 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:165 +#: ../libguestfs-1.11.19/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-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.19/cat/virt-cat.pod:134 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:261 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:425 +#: ../libguestfs-1.11.19/df/virt-df.pod:167 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:161 +#: ../libguestfs-1.11.19/fish/guestfish.pod:390 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:257 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:119 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:178 +#: ../rescue/virt-rescue.pod:178 +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.19/cat/virt-cat.pod:136 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:263 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:427 +#: ../libguestfs-1.11.19/df/virt-df.pod:169 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:163 +#: ../libguestfs-1.11.19/fish/guestfish.pod:392 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:259 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:121 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:180 +#: ../rescue/virt-rescue.pod:180 +msgid "B<--verbose>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:156 -msgid "" -"Once L has been called you cannot add any more images. You" -" can call L to get a list of the device names, in the" -" order that you added them. See also L below." +#: ../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.19/cat/virt-cat.pod:138 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:265 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:429 +#: ../libguestfs-1.11.19/df/virt-df.pod:171 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:165 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:123 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:182 +#: ../rescue/virt-rescue.pod:182 +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.19/cat/virt-cat.pod:140 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:267 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:431 +#: ../libguestfs-1.11.19/df/virt-df.pod:173 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:167 +#: ../libguestfs-1.11.19/fish/guestfish.pod:397 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:263 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:125 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:184 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:478 +#: ../rescue/virt-rescue.pod:184 ../resize/virt-resize.pod:478 +msgid "B<-V>" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:161 -msgid "MOUNTING" +#. 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.19/cat/virt-cat.pod:142 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:269 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:433 +#: ../libguestfs-1.11.19/df/virt-df.pod:175 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:169 +#: ../libguestfs-1.11.19/fish/guestfish.pod:399 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:265 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:127 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:186 +#: ../libguestfs-1.11.19/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 +msgid "B<--version>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:163 -msgid "" -"Before you can read or write files, create directories and so on in a disk " -"image that contains filesystems, you have to mount those filesystems using " -"L or L. If you already know that" -" a disk image contains (for example) one partition with a filesystem on that" -" partition, then you can mount it directly:" +#: ../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.19/cat/virt-cat.pod:144 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:271 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:435 +#: ../libguestfs-1.11.19/df/virt-df.pod:177 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:171 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:129 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:188 +#: ../libguestfs-1.11.19/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 +msgid "Display version number and exit." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:170 -#, no-wrap -msgid "" -" guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n" -"\n" +#. 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.19/cat/virt-cat.pod:146 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:281 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:437 +#: ../libguestfs-1.11.19/df/virt-df.pod:179 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:173 +#: ../libguestfs-1.11.19/fish/guestfish.pod:412 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:278 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:131 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:199 +#: ../rescue/virt-rescue.pod:199 ../tools/virt-tar.pl:158 +msgid "B<-x>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:172 -msgid "" -"where C means literally the first partition (C<1>) of the first " -"disk image that we added (C). If the disk contains Linux LVM2 " -"logical volumes you could refer to those instead (eg. C). Note " -"that these are libguestfs virtual devices, and are nothing to do with host " -"devices." +#: ../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.19/cat/virt-cat.pod:148 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:283 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:439 +#: ../libguestfs-1.11.19/df/virt-df.pod:181 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:175 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:133 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:201 +#: ../rescue/virt-rescue.pod:201 +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.19/cat/virt-cat.pod:152 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:443 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:179 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:137 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:205 +#: ../rescue/virt-rescue.pod:205 +msgid "OLD-STYLE COMMAND LINE ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:178 +#: ../cat/virt-cat.pod:154 ../libguestfs-1.11.19/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.19/cat/virt-cat.pod:156 +#, no-wrap msgid "" -"If you are given a disk image and you don't know what it contains then you " -"have to find out. Libguestfs can do that too: use " -"L and L to list possible partitions " -"and LVs, and either try mounting each to see what is mountable, or else " -"examine them with L or L. To list just " -"filesystems, use L." +" virt-cat disk.img [disk.img ...] file\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:186 +#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 +#: ../inspector/virt-inspector.pod:143 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:158 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:449 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:185 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:143 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:211 +#: ../rescue/virt-rescue.pod:211 +msgid "or" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:160 ../libguestfs-1.11.19/cat/virt-cat.pod:160 +#, no-wrap msgid "" -"Libguestfs also has a set of APIs for inspection of unknown disk images (see" -" L below). But you might find it easier to look at higher " -"level programs built on top of libguestfs, in particular L." +" virt-cat guestname file\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:191 +#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 +#: ../inspector/virt-inspector.pod:147 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:162 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:453 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:189 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:147 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:215 +#: ../rescue/virt-rescue.pod:215 msgid "" -"To mount a filesystem read-only, use L. There are " -"several other variations of the C call." +"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: =head2 -#: ../src/guestfs.pod:194 -msgid "FILESYSTEM ACCESS AND MODIFICATION" +#. 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.19/cat/virt-cat.pod:166 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:457 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:193 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:151 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:219 +#: ../rescue/virt-rescue.pod:219 +msgid "For compatibility the old style is still supported." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:196 -msgid "" -"The majority of the libguestfs API consists of fairly low-level calls for " -"accessing and modifying the files, directories, symlinks etc on mounted " -"filesystems. There are over a hundred such calls which you can find listed " -"in detail below in this man page, and we don't even pretend to cover them " -"all in this overview." +#. type: =head1 +#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:168 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:297 +msgid "USING GUESTFISH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:202 +#: ../cat/virt-cat.pod:170 ../libguestfs-1.11.19/cat/virt-cat.pod:170 msgid "" -"Specify filenames as full paths, starting with C<\"/\"> and including the " -"mount point." +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." msgstr "" #. type: textblock -#: ../src/guestfs.pod:205 -msgid "" -"For example, if you mounted a filesystem at C<\"/\"> and you want to read " -"the file called C<\"etc/passwd\"> then you could do:" +#: ../cat/virt-cat.pod:173 ../libguestfs-1.11.19/cat/virt-cat.pod:173 +msgid "Using C is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:208 +#: ../cat/virt-cat.pod:175 ../libguestfs-1.11.19/cat/virt-cat.pod:175 #, no-wrap msgid "" -" char *data = guestfs_cat (g, \"/etc/passwd\");\n" +" guestfish --ro -i -d domname download file -\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:210 +#: ../cat/virt-cat.pod:177 ../libguestfs-1.11.19/cat/virt-cat.pod:177 msgid "" -"This would return C as a newly allocated buffer containing the full " -"content of that file (with some conditions: see also L below)," -" or C if there was an error." +"where C is the name of the libvirt guest, and C is the full " +"path to the file. Note the final C<-> (meaning \"output to stdout\")." msgstr "" #. type: textblock -#: ../src/guestfs.pod:214 +#: ../cat/virt-cat.pod:181 ../libguestfs-1.11.19/cat/virt-cat.pod:181 msgid "" -"As another example, to create a top-level directory on that filesystem " -"called C<\"var\"> you would do:" +"The command above uses libguestfs's guest inspection feature and so does not " +"work on guests that libguestfs cannot inspect, or on things like arbitrary " +"disk images that don't contain guests. To display a file from a disk image " +"directly, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:217 +#: ../cat/virt-cat.pod:186 ../libguestfs-1.11.19/cat/virt-cat.pod:186 #, no-wrap msgid "" -" guestfs_mkdir (g, \"/var\");\n" +" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:219 -msgid "To create a symlink you could do:" +#: ../cat/virt-cat.pod:188 ../libguestfs-1.11.19/cat/virt-cat.pod:188 +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." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:221 -#, no-wrap -msgid "" -" guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" -" \"/etc/rc3.d/S30portmap\");\n" -"\n" +#. 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.19/cat/virt-cat.pod:192 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:365 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:483 +#: ../libguestfs-1.11.19/df/virt-df.pod:209 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:342 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:349 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:262 +#: ../libguestfs-1.11.19/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" msgstr "" #. type: textblock -#: ../src/guestfs.pod:224 +#: ../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.19/cat/virt-cat.pod:194 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:367 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:485 +#: ../libguestfs-1.11.19/df/virt-df.pod:211 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:344 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:351 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:264 +#: ../libguestfs-1.11.19/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 msgid "" -"Libguestfs will reject attempts to use relative paths and there is no " -"concept of a current working directory." +"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: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 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:199 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:372 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:490 +#: ../libguestfs-1.11.19/df/virt-df.pod:216 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:349 +#: ../libguestfs-1.11.19/examples/guestfs-examples.pod:33 +#: ../libguestfs-1.11.19/examples/guestfs-recipes.pod:384 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1214 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:50 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:39 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:47 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:41 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:303 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:372 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:78 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:39 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:42 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:284 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:550 +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:36 +#: ../libguestfs-1.11.19/src/guestfs.pod:3011 +#: ../libguestfs-1.11.19/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 +msgid "SEE ALSO" msgstr "" #. type: textblock -#: ../src/guestfs.pod:227 +#: ../cat/virt-cat.pod:201 ../libguestfs-1.11.19/cat/virt-cat.pod:201 msgid "" -"Libguestfs can return errors in many situations: for example if the " -"filesystem isn't writable, or if a file or directory that you requested " -"doesn't exist. If you are using the C API (documented here) you have to " -"check for those error conditions after each call. (Other language bindings " -"turn these errors into exceptions)." +"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.19/cat/virt-cat.pod:208 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:383 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:502 +#: ../libguestfs-1.11.19/df/virt-df.pod:224 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:363 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:292 +#: ../libguestfs-1.11.19/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 +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.19/cat/virt-cat.pod:210 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:385 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:504 +#: ../libguestfs-1.11.19/df/virt-df.pod:226 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:365 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:386 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:294 +#: ../libguestfs-1.11.19/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 +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:47 ../examples/guestfs-recipes.pod:399 +#: ../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 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:212 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:387 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:506 +#: ../libguestfs-1.11.19/df/virt-df.pod:228 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:367 +#: ../libguestfs-1.11.19/examples/guestfs-examples.pod:47 +#: ../libguestfs-1.11.19/examples/guestfs-recipes.pod:399 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1242 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:64 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:53 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:62 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:55 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:318 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:394 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:93 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:54 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:56 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:296 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:575 +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:50 +#: ../libguestfs-1.11.19/src/guestfs.pod:3084 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:97 +#: ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 +#: ../python/examples/guestfs-python.pod:56 ../rescue/virt-rescue.pod:296 +#: ../resize/virt-resize.pod:575 ../ruby/examples/guestfs-ruby.pod:50 +#: ../src/guestfs.pod:3084 ../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 +msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:233 +#: ../cat/virt-cat.pod:214 ../inspector/virt-inspector.pod:396 +#: ../libguestfs-1.11.19/cat/virt-cat.pod:214 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:396 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:577 +#: ../resize/virt-resize.pod:577 +msgid "Copyright (C) 2010-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.19/cat/virt-cat.pod:216 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:391 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:510 +#: ../libguestfs-1.11.19/df/virt-df.pod:232 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:371 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1247 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:69 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:58 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:67 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:60 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:323 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:398 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:300 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:579 +#: ../libguestfs-1.11.19/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 msgid "" -"File writes are affected by the per-handle umask, set by calling " -"L and defaulting to 022. See L." +"This program is free software; you can redistribute it and/or modify it " +"under the terms of the GNU General Public License as published by the Free " +"Software Foundation; either version 2 of the License, or (at your option) " +"any later version." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:236 -msgid "PARTITIONING" +#. 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.19/cat/virt-cat.pod:221 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:396 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:515 +#: ../libguestfs-1.11.19/df/virt-df.pod:237 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:376 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1252 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:74 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:63 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:72 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:65 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:328 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:403 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:305 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:584 +#: ../libguestfs-1.11.19/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 +msgid "" +"This program is distributed in the hope that it will be useful, but WITHOUT " +"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " +"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for " +"more details." msgstr "" #. type: textblock -#: ../src/guestfs.pod:238 +#: ../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.19/cat/virt-cat.pod:226 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:401 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:520 +#: ../libguestfs-1.11.19/df/virt-df.pod:242 +#: ../libguestfs-1.11.19/edit/virt-edit.pod:381 +#: ../libguestfs-1.11.19/fish/guestfish.pod:1257 +#: ../libguestfs-1.11.19/fish/virt-copy-in.pod:79 +#: ../libguestfs-1.11.19/fish/virt-copy-out.pod:68 +#: ../libguestfs-1.11.19/fish/virt-tar-in.pod:77 +#: ../libguestfs-1.11.19/fish/virt-tar-out.pod:70 +#: ../libguestfs-1.11.19/fuse/guestmount.pod:333 +#: ../libguestfs-1.11.19/inspector/virt-inspector.pod:408 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:310 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:589 +#: ../libguestfs-1.11.19/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 msgid "" -"Libguestfs contains API calls to read, create and modify partition tables on" -" disk images." +"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 " +"Ave, Cambridge, MA 02139, USA." msgstr "" #. type: textblock -#: ../src/guestfs.pod:241 +#: ../cat/virt-filesystems.pod:5 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:5 msgid "" -"In the common case where you want to create a single partition covering the " -"whole disk, you should use the L call:" +"virt-filesystems - List filesystems, partitions, block devices, LVM in a " +"virtual machine or disk image" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:245 +#: ../cat/virt-filesystems.pod:9 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:9 #, no-wrap msgid "" -" const char *parttype = \"mbr\";\n" -" if (disk_is_larger_than_2TB)\n" -" parttype = \"gpt\";\n" -" guestfs_part_disk (g, \"/dev/sda\", parttype);\n" +" virt-filesystems [--options] -d domname\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:250 +#. type: verbatim +#: ../cat/virt-filesystems.pod:11 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:11 +#, no-wrap msgid "" -"Obviously this effectively wipes anything that was on that disk image " -"before." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:253 -msgid "LVM2" +" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:255 +#: ../cat/virt-filesystems.pod:15 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:15 msgid "" -"Libguestfs provides access to a large part of the LVM2 API, such as " -"L and L. It won't make much sense " -"unless you familiarize yourself with the concepts of physical volumes, " -"volume groups and logical volumes." +"This tool allows you to discover filesystems, partitions, logical volumes, " +"and their sizes in a disk image or virtual machine. It is a replacement for " +"L and L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:260 +#: ../cat/virt-filesystems.pod:20 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:20 msgid "" -"This author strongly recommends reading the LVM HOWTO, online at " -"L." +"One use for this tool is from shell scripts to iterate over all filesystems " +"from a disk image:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:263 -msgid "DOWNLOADING" +#. type: verbatim +#: ../cat/virt-filesystems.pod:23 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:23 +#, no-wrap +msgid "" +" for fs in $(virt-filesystems -a disk.img); do\n" +" # ...\n" +" done\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:265 +#: ../cat/virt-filesystems.pod:27 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:27 msgid "" -"Use L to download small, text only files. This call is " -"limited to files which are less than 2 MB and which cannot contain any ASCII" -" NUL (C<\\0>) characters. However the API is very simple to use." +"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 -#: ../src/guestfs.pod:269 +#: ../cat/virt-filesystems.pod:32 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:32 msgid "" -"L can be used to read files which contain arbitrary 8 " -"bit data, since it returns a (pointer, size) pair. However it is still " -"limited to \"small\" files, less than 2 MB." +"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: textblock -#: ../src/guestfs.pod:273 +#. type: verbatim +#: ../cat/virt-filesystems.pod:37 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:37 +#, no-wrap msgid "" -"L can be used to download any file, with no limits on " -"content or size (even files larger than 4 GB)." +" $ virt-filesystems -a disk.img\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:276 +#: ../cat/virt-filesystems.pod:41 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:41 msgid "" -"To download multiple files, see L and L." +"If you add I<-l> or I<--long> then the output includes extra information:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:279 -msgid "UPLOADING" +#. type: verbatim +#: ../cat/virt-filesystems.pod:44 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:44 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img -l\n" +" Name Type VFS Label Size\n" +" /dev/sda1 filesystem ext4 boot 524288000\n" +" /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:281 +#: ../cat/virt-filesystems.pod:49 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:49 msgid "" -"It's often the case that you want to write a file or files to the disk " -"image." +"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " +"shown as well:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:284 +#. type: verbatim +#: ../cat/virt-filesystems.pod:52 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:52 +#, no-wrap msgid "" -"To write a small file with fixed content, use L. To create " -"a file of all zeroes, use L (sparse) or " -"L (with all disk blocks allocated). There are a " -"variety of other functions for creating test files, for example " -"L and L." +" $ 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 -#: ../src/guestfs.pod:290 +#: ../cat/virt-filesystems.pod:58 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:58 msgid "" -"To upload a single file, use L. This call has no limits on" -" file content or size (even files larger than 4 GB)." +"If you add I<--partitions> then partitions are shown instead of filesystems:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:60 +#: ../libguestfs-1.11.19/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 -#: ../src/guestfs.pod:293 +#: ../cat/virt-filesystems.pod:64 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:64 msgid "" -"To upload multiple files, see L and L." +"Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-" +"volumes>, I<--block-devices> to list those items." msgstr "" #. type: textblock -#: ../src/guestfs.pod:295 +#: ../cat/virt-filesystems.pod:67 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:67 msgid "" -"However the fastest way to upload I is to " -"turn them into a squashfs or CD ISO (see L and " -"L), then attach this using L. If you add" -" the drive in a predictable way (eg. adding it last after all other drives) " -"then you can get the device name from L and mount it " -"directly using L. Note that squashfs images are " -"sometimes non-portable between kernel versions, and they don't support " -"labels or UUIDs. If you want to pre-build an image or you need to mount it " -"using a label or UUID, use an ISO image instead." +"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: =head2 -#: ../src/guestfs.pod:306 -msgid "COPYING" +#. type: textblock +#: ../cat/virt-filesystems.pod:74 +#: ../libguestfs-1.11.19/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 -#: ../src/guestfs.pod:308 +#: ../cat/virt-filesystems.pod:78 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:78 msgid "" -"There are various different commands for copying between files and devices " -"and in and out of the guest filesystem. These are summarised in the table " -"below." +"I<--all --long --uuid> is a useful combination to display all possible " +"information about everything." msgstr "" -#. type: =item -#: ../src/guestfs.pod:314 -msgid "B to B" +#. type: verbatim +#: ../cat/virt-filesystems.pod:81 +#: ../libguestfs-1.11.19/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 -#: ../src/guestfs.pod:316 +#: ../cat/virt-filesystems.pod:89 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:89 msgid "" -"Use L to copy a single file, or L to copy " -"directories recursively." +"For machine-readable output, use I<--csv> to get Comma-Separated Values." msgstr "" #. type: =item -#: ../src/guestfs.pod:319 -msgid "B to B" +#: ../cat/virt-filesystems.pod:110 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:110 +#: ../tools/virt-list-filesystems.pl:121 +msgid "B<--all>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:321 +#: ../cat/virt-filesystems.pod:112 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:112 msgid "" -"Use L which efficiently uses L to copy between files and" -" devices in the guest." +"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 -#: ../src/guestfs.pod:324 -msgid "Example: duplicate the contents of an LV:" +#: ../cat/virt-filesystems.pod:117 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:117 +msgid "See also I<--long>." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:326 -#, no-wrap -msgid "" -" guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n" -"\n" +#. type: =item +#: ../cat/virt-filesystems.pod:119 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:119 +msgid "B<--blkdevs>" +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:121 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:121 +msgid "B<--block-devices>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:328 -msgid "" -"The destination (C) must be at least as large as the source " -"(C). To copy less than the whole source device, use " -"L." +#: ../cat/virt-filesystems.pod:123 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:123 +msgid "Display block devices." msgstr "" #. type: =item -#: ../src/guestfs.pod:332 -msgid "B to B" +#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:135 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:301 +msgid "B<--csv>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:334 -msgid "Use L. See L above." +#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:137 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:303 +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 +#: ../libguestfs-1.11.19/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 -#: ../src/guestfs.pod:336 -msgid "B to B" +#: ../cat/virt-filesystems.pod:155 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:155 +msgid "B<--extra>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:338 -msgid "Use L. See L above." +#: ../cat/virt-filesystems.pod:157 +#: ../libguestfs-1.11.19/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: =head2 -#: ../src/guestfs.pod:342 -msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" +#. type: textblock +#: ../cat/virt-filesystems.pod:161 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:161 +msgid "This option implies I<--filesystems>." +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:163 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:163 +msgid "B<--filesystems>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:344 +#: ../cat/virt-filesystems.pod:165 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:165 msgid "" -"Calls like L, L, L, " -"L etc appear to only take filenames as arguments, so it " -"appears you can only upload and download to files. However many Un*x-like " -"hosts let you use the special device files C, C, " -"C and C to read and write from stdin, stdout, " -"stderr, and arbitrary file descriptor N." +"Display mountable filesystems. If no display option was selected then this " +"option is implied." msgstr "" #. type: textblock -#: ../src/guestfs.pod:352 -msgid "For example, L writes its output to stdout by doing:" +#: ../cat/virt-filesystems.pod:168 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:168 +msgid "With I<--extra>, non-mountable filesystems are shown too." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:355 +#: ../cat/virt-filesystems.pod:181 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:181 #, no-wrap msgid "" -" guestfs_download (g, filename, \"/dev/stdout\");\n" +" virt-filesystems --format=raw -a disk.img\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:357 -msgid "and you can write tar output to a file descriptor C by doing:" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:359 +#: ../cat/virt-filesystems.pod:185 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:185 #, no-wrap msgid "" -" char devfd[64];\n" -" snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n" -" guestfs_tar_out (g, \"/\", devfd);\n" +" virt-filesystems --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:363 -msgid "LISTING FILES" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:365 -msgid "" -"L is just designed for humans to read (mainly when using the " -"L-equivalent command C)." +#. type: =item +#: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352 +#: ../df/virt-df.pod:119 ../fish/guestfish.pod:156 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:194 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:352 +#: ../libguestfs-1.11.19/df/virt-df.pod:119 +#: ../libguestfs-1.11.19/fish/guestfish.pod:156 +#: ../tools/virt-list-partitions.pl:109 +msgid "B<-h>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:368 -msgid "" -"L is a quick way to get a list of files in a directory from " -"programs, as a flat list of strings." +#. type: =item +#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 +#: ../df/virt-df.pod:121 ../libguestfs-1.11.19/cat/virt-filesystems.pod:196 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:354 +#: ../libguestfs-1.11.19/df/virt-df.pod:121 +#: ../tools/virt-list-partitions.pl:111 +msgid "B<--human-readable>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:371 -msgid "" -"L is a programmatic way to get a list of files in a " -"directory, plus additional information about each one. It is more " -"equivalent to using the L call on a local filesystem." +#: ../cat/virt-filesystems.pod:198 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:198 +msgid "In I<--long> mode, display sizes in human-readable format." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:375 -msgid "" -"L and L can be used to recursively list " -"files." +#. type: =item +#: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:205 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:366 +#: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119 +msgid "B<-l>" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:378 -msgid "RUNNING COMMANDS" +#. type: =item +#: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:207 +#: ../libguestfs-1.11.19/cat/virt-ls.pod:368 +#: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121 +msgid "B<--long>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:380 -msgid "" -"Although libguestfs is primarily an API for manipulating files inside guest " -"images, we also provide some limited facilities for running commands inside " -"guests." +#: ../cat/virt-filesystems.pod:209 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:209 +msgid "Display extra columns of data (\"long format\")." msgstr "" #. type: textblock -#: ../src/guestfs.pod:384 -msgid "There are many limitations to this:" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 -#: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 -#: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064 -#: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 -#: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 -#: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 -#: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 -#: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652 -#: ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763 -#: ../src/guestfs.pod:1773 ../src/guestfs.pod:2047 ../src/guestfs.pod:2052 -#: ../src/guestfs.pod:2058 ../src/guestfs.pod:2066 ../src/guestfs.pod:2420 -#: ../src/guestfs.pod:2426 ../src/guestfs.pod:2431 ../src/guestfs.pod:2437 -#: ../src/guestfs.pod:3011 ../src/guestfs.pod:3015 ../src/guestfs.pod:3019 -#: ../src/guestfs.pod:3023 ../src/guestfs-actions.pod:15 -#: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:583 -#: ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598 -#: ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1662 -#: ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1670 -#: ../src/guestfs-actions.pod:1674 ../src/guestfs-actions.pod:1682 -#: ../src/guestfs-actions.pod:1686 ../src/guestfs-actions.pod:1690 -#: ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1704 -#: ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:1846 -#: ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1855 -#: ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1921 -#: ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1930 -#: ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:2863 -#: ../src/guestfs-actions.pod:2871 ../src/guestfs-actions.pod:2878 -#: ../src/guestfs-actions.pod:2885 ../fish/guestfish.pod:445 -#: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 -#: ../fish/guestfish.pod:457 ../fish/guestfish-actions.pod:13 -#: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 -#: ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 -#: ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1099 -#: ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1107 -#: ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1119 -#: ../fish/guestfish-actions.pod:1123 ../fish/guestfish-actions.pod:1127 -#: ../fish/guestfish-actions.pod:1137 ../fish/guestfish-actions.pod:1141 -#: ../fish/guestfish-actions.pod:1145 ../fish/guestfish-actions.pod:1235 -#: ../fish/guestfish-actions.pod:1239 ../fish/guestfish-actions.pod:1244 -#: ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1291 -#: ../fish/guestfish-actions.pod:1295 ../fish/guestfish-actions.pod:1300 -#: ../fish/guestfish-actions.pod:1933 ../fish/guestfish-actions.pod:1939 -#: ../fish/guestfish-actions.pod:1947 ../fish/guestfish-actions.pod:1954 -#: ../fish/guestfish-actions.pod:1961 ../tools/virt-win-reg.pl:195 -#: ../tools/virt-win-reg.pl:200 ../tools/virt-win-reg.pl:206 -#: ../tools/virt-win-reg.pl:708 ../tools/virt-win-reg.pl:714 -#: ../tools/virt-win-reg.pl:720 -msgid "*" +#: ../cat/virt-filesystems.pod:211 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:211 +msgid "A title row is added unless you also specify I<--no-title>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:390 +#: ../cat/virt-filesystems.pod:213 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:213 msgid "" -"The kernel version that the command runs under will be different from what " -"it expects." +"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 -#: ../src/guestfs.pod:395 +#: ../cat/virt-filesystems.pod:218 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:218 msgid "" -"If the command needs to communicate with daemons, then most likely they " -"won't be running." +"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 -#: ../src/guestfs.pod:400 -msgid "The command will be running in limited memory." +#: ../cat/virt-filesystems.pod:221 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:221 +msgid "Use I<--uuid> to display UUIDs too." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:404 -msgid "" -"The network may not be available unless you enable it (see " -"L)." +#. type: =item +#: ../cat/virt-filesystems.pod:223 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:223 +msgid "B<--lvs>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:409 -msgid "Only supports Linux guests (not Windows, BSD, etc)." +#. type: =item +#: ../cat/virt-filesystems.pod:225 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:225 +msgid "B<--logvols>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:413 -msgid "" -"Architecture limitations (eg. won't work for a PPC guest on an X86 host)." +#. type: =item +#: ../cat/virt-filesystems.pod:227 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:227 +msgid "B<--logical-volumes>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:418 +#: ../cat/virt-filesystems.pod:229 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:229 msgid "" -"For SELinux guests, you may need to enable SELinux and load policy first. " -"See L in this manpage." +"Display LVM logical volumes. In this mode, these are displayed irrespective " +"of whether the LVs contain filesystems." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:423 -msgid "" -"I It is not safe to run commands from untrusted, possibly " -"malicious guests. These commands may attempt to exploit your program by " -"sending unexpected output. They could also try to exploit the Linux kernel " -"or qemu provided by the libguestfs appliance. They could use the network " -"provided by the libguestfs appliance to bypass ordinary network partitions " -"and firewalls. They could use the elevated privileges or different SELinux " -"context of your program to their advantage." +#. type: =item +#: ../cat/virt-filesystems.pod:232 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:232 +msgid "B<--no-title>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:432 -msgid "" -"A secure alternative is to use libguestfs to install a \"firstboot\" script " -"(a script which runs when the guest next boots normally), and to have this " -"script run the commands you want in the normal context of the running guest," -" network security and so on. For information about other security issues, " -"see L." +#: ../cat/virt-filesystems.pod:234 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:234 +msgid "In I<--long> mode, don't add a title row." msgstr "" #. type: textblock -#: ../src/guestfs.pod:440 +#: ../cat/virt-filesystems.pod:236 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:236 msgid "" -"The two main API calls to run commands are L and " -"L (there are also variations)." +"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: textblock -#: ../src/guestfs.pod:443 -msgid "" -"The difference is that L runs commands using the shell, so any " -"shell globs, redirections, etc will work." +#. type: =item +#: ../cat/virt-filesystems.pod:240 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:240 +msgid "B<--parts>" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:446 -msgid "CONFIGURATION FILES" +#. type: =item +#: ../cat/virt-filesystems.pod:242 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:242 +msgid "B<--partitions>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:448 +#: ../cat/virt-filesystems.pod:244 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:244 msgid "" -"To read and write configuration files in Linux guest filesystems, we " -"strongly recommend using Augeas. For example, Augeas understands how to " -"read and write, say, a Linux shadow password file or X.org configuration " -"file, and so avoids you having to write that code." +"Display partitions. In this mode, these are displayed irrespective of " +"whether the partitions contain filesystems." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:453 -msgid "" -"The main Augeas calls are bound through the C APIs. We don't" -" document Augeas itself here because there is excellent documentation on the" -" L website." +#. type: =item +#: ../cat/virt-filesystems.pod:247 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:247 +msgid "B<--pvs>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:457 -msgid "" -"If you don't want to use Augeas (you fool!) then try calling " -"L to get the file as a list of lines which you can " -"iterate over." +#. type: =item +#: ../cat/virt-filesystems.pod:249 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:249 +msgid "B<--physvols>" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:461 -msgid "SELINUX" +#. type: =item +#: ../cat/virt-filesystems.pod:251 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:251 +msgid "B<--physical-volumes>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:463 -msgid "" -"We support SELinux guests. To ensure that labeling happens correctly in " -"SELinux guests, you need to enable SELinux and load the guest's policy:" +#: ../cat/virt-filesystems.pod:253 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:253 +msgid "Display LVM physical volumes." msgstr "" #. type: =item -#: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 -#: ../src/guestfs.pod:2465 -msgid "1." +#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:157 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:255 +#: ../libguestfs-1.11.19/df/virt-df.pod:157 +msgid "B<--uuid>" +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:257 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:257 +msgid "B<--uuids>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:471 -msgid "Before launching, do:" +#: ../cat/virt-filesystems.pod:259 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:259 +msgid "In I<--long> mode, display UUIDs as well." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:473 -#, no-wrap -msgid "" -" guestfs_set_selinux (g, 1);\n" -"\n" +#. type: =item +#: ../cat/virt-filesystems.pod:273 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:273 +msgid "B<--vgs>" msgstr "" #. type: =item -#: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 -#: ../src/guestfs.pod:2490 -msgid "2." +#: ../cat/virt-filesystems.pod:275 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:275 +msgid "B<--volgroups>" +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:277 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:277 +msgid "B<--volume-groups>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:477 -msgid "" -"After mounting the guest's filesystem(s), load the policy. This is best " -"done by running the L command in the guest itself:" +#: ../cat/virt-filesystems.pod:279 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:279 +msgid "Display LVM volume groups." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:481 -#, no-wrap -msgid "" -" guestfs_sh (g, \"/usr/sbin/load_policy\");\n" -"\n" +#. type: =head1 +#: ../cat/virt-filesystems.pod:287 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:287 +msgid "COLUMNS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:483 +#: ../cat/virt-filesystems.pod:289 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:289 msgid "" -"(Older versions of C require you to specify the name of the " -"policy file)." +"Note that columns in the output are subject to reordering and change in " +"future versions of this tool." msgstr "" #. type: =item -#: ../src/guestfs.pod:486 ../src/guestfs.pod:1405 -msgid "3." +#: ../cat/virt-filesystems.pod:294 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:294 +msgid "B" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:296 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:296 +msgid "The filesystem, partition, block device or LVM name." msgstr "" #. type: textblock -#: ../src/guestfs.pod:488 +#: ../cat/virt-filesystems.pod:298 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:298 msgid "" -"Optionally, set the security context for the API. The correct security " -"context to use can only be known by inspecting the guest. As an example:" +"For device and partition names these are displayed as canonical libguestfs " +"names, so that for example C is the second partition on the first " +"device." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:492 -#, no-wrap +#. type: textblock +#: ../cat/virt-filesystems.pod:302 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:302 msgid "" -" guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" -"\n" +"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.19/cat/virt-filesystems.pod:305 +msgid "B" msgstr "" #. type: textblock -#: ../src/guestfs.pod:496 -msgid "This will work for running commands and editing existing files." +#: ../cat/virt-filesystems.pod:307 +#: ../libguestfs-1.11.19/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.19/cat/virt-filesystems.pod:309 +msgid "B" msgstr "" #. type: textblock -#: ../src/guestfs.pod:498 +#: ../cat/virt-filesystems.pod:311 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:311 msgid "" -"When new files are created, you may need to label them explicitly, for " -"example by running the external command C." +"If there is a filesystem, then this column displays the filesystem type if " +"one could be detected, eg. C." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:502 -msgid "UMASK" +#. type: =item +#: ../cat/virt-filesystems.pod:314 +#: ../libguestfs-1.11.19/cat/virt-filesystems.pod:314 +msgid "B