diff options
| author | Richard W.M. Jones <rjones@redhat.com> | 2011-07-18 11:55:41 +0100 |
|---|---|---|
| committer | Richard W.M. Jones <rjones@redhat.com> | 2011-07-18 12:13:08 +0100 |
| commit | 463a739bf0475cf45bf03ad2c4130b2ed656686e (patch) | |
| tree | feb9176d0c2c9dd19c8245b5af015c71627b40fa /po-docs/libguestfs-docs.pot | |
| parent | 3b9d52b2a82bd6cdb10aa267b514805ad3f5e552 (diff) | |
| download | libguestfs-463a739bf0475cf45bf03ad2c4130b2ed656686e.tar.gz libguestfs-463a739bf0475cf45bf03ad2c4130b2ed656686e.tar.xz libguestfs-463a739bf0475cf45bf03ad2c4130b2ed656686e.zip | |
Version 1.11.19.1.11.19
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 31294 |
1 files changed, 18632 insertions, 12662 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 0cf7964d..a80c6dc4 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.11.18\n" +"Project-Id-Version: libguestfs 1.11.19\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-07-15 17:18+0200\n" +"POT-Creation-Date: 2011-07-18 11:32+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -18,5945 +18,3747 @@ msgstr "" "Content-Transfer-Encoding: 8bit\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 -#, no-wrap -msgid "" -" #include <guestfs.h>\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:11 +#: ../cat/virt-cat.pod:9 ../libguestfs-1.11.19/cat/virt-cat.pod:9 #, 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] -d domname file [file ...]\n" "\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:19 +#: ../cat/virt-cat.pod:11 ../libguestfs-1.11.19/cat/virt-cat.pod:11 #, 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 [--options] -a disk.img [-a disk.img ...] file [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 -msgid "DESCRIPTION" -msgstr "" - #. type: textblock -#: ../src/guestfs.pod:25 -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." +#: ../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: textblock -#: ../src/guestfs.pod:33 +#. type: verbatim +#: ../cat/virt-cat.pod:15 ../libguestfs-1.11.19/cat/virt-cat.pod:15 +#, no-wrap 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." +" virt-cat domname file\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:38 +#. type: verbatim +#: ../cat/virt-cat.pod:17 ../libguestfs-1.11.19/cat/virt-cat.pod:17 +#, no-wrap 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." +" virt-cat disk.img file\n" +"\n" 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: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:48 +#: ../cat/virt-cat.pod:21 ../libguestfs-1.11.19/cat/virt-cat.pod:21 msgid "" -"You don't need to be root to use libguestfs, although obviously you do need " -"enough permissions to access the disk images." +"C<virt-cat> is a command line tool to display the contents of C<file> where " +"C<file> exists in the named virtual machine (or disk image)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:51 +#: ../cat/virt-cat.pod:24 ../libguestfs-1.11.19/cat/virt-cat.pod:24 msgid "" -"Libguestfs is a large API because it can do many things. For a gentle " -"introduction, please read the L</API OVERVIEW> section next." +"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:54 +#: ../cat/virt-cat.pod:28 ../libguestfs-1.11.19/cat/virt-cat.pod:28 msgid "" -"There are also some example programs in the L<guestfs-examples(3)> manual " -"page." +"C<virt-cat> can be used to quickly view a file. To edit a file, use " +"C<virt-edit>. For more complex cases you should look at the L<guestfish(1)> " +"tool (see L</USING GUESTFISH> below)." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:57 -msgid "API OVERVIEW" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:59 -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." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:64 -msgid "HANDLES" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:66 -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<g> for the name of the " -"handle variable, although of course you can use any name you want." +#: ../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:73 -msgid "The general structure of all libguestfs-using programs looks like this:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:76 -#, no-wrap -msgid "" -" guestfs_h *g = guestfs_create ();\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" +#: ../cat/virt-cat.pod:34 ../libguestfs-1.11.19/cat/virt-cat.pod:34 +msgid "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:83 +#: ../cat/virt-cat.pod:37 ../libguestfs-1.11.19/cat/virt-cat.pod:37 #, 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" -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" +" virt-cat -d mydomain /etc/fstab\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:94 -#, no-wrap -msgid "" -" /* To access a filesystem in the image, you must mount it.\n" -" */\n" -" guestfs_mount (g, \"/dev/sda1\", \"/\");\n" -" \n" +#. type: textblock +#: ../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: verbatim -#: ../src/guestfs.pod:98 +#: ../cat/virt-cat.pod:41 ../libguestfs-1.11.19/cat/virt-cat.pod:41 #, no-wrap msgid "" -" /* Now you can perform filesystem actions on the guest\n" -" * disk image.\n" -" */\n" -" guestfs_touch (g, \"/hello\");\n" -" \n" +" virt-cat -a disk.img /var/log/messages | tail\n" +"\n" 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: 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: verbatim -#: ../src/guestfs.pod:109 +#: ../cat/virt-cat.pod:45 ../libguestfs-1.11.19/cat/virt-cat.pod:45 #, no-wrap msgid "" -" /* Close the handle 'g'. */\n" -" guestfs_close (g);\n" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:112 -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<NULL> on error. See section L</ERROR HANDLING> 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<guestfs-examples(3)> for fully worked examples." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:121 -msgid "DISK IMAGES" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:123 -msgid "" -"The image filename (C<\"guest.img\"> in the example above) could be a disk " -"image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an " -"actual block device, or simply an empty file of zeroes that you have created " -"through L<posix_fallocate(3)>. Libguestfs lets you do useful things to all " -"of these." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:129 -msgid "" -"The call you should use in modern code for adding drives is " -"L</guestfs_add_drive_opts>. To add a disk image, allowing writes, and " -"specifying that the format is raw, do:" +#: ../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:133 +#: ../cat/virt-cat.pod:50 ../libguestfs-1.11.19/cat/virt-cat.pod:50 #, no-wrap msgid "" -" guestfs_add_drive_opts (g, filename,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n" -" -1);\n" +" virt-cat -d mydomain /var/log/yum.log | tail\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:137 -msgid "You can add a disk read-only using:" +#: ../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:139 +#: ../cat/virt-cat.pod:54 ../libguestfs-1.11.19/cat/virt-cat.pod:54 #, 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 -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:144 -msgid "" -"or by calling the older function L</guestfs_add_drive_ro>. In either case " -"libguestfs won't modify the file." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:147 -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." -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</dev/sda> (for the " -"first one you added), C</dev/sdb> (for the second one you added), etc." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:156 -msgid "" -"Once L</guestfs_launch> has been called you cannot add any more images. You " -"can call L</guestfs_list_devices> to get a list of the device names, in the " -"order that you added them. See also L</BLOCK DEVICE NAMING> below." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:161 -msgid "MOUNTING" -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</guestfs_mount_options> or L</guestfs_mount_ro>. 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:57 ../libguestfs-1.11.19/cat/virt-cat.pod:57 +msgid "or who was logged on:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:170 +#: ../cat/virt-cat.pod:59 ../libguestfs-1.11.19/cat/virt-cat.pod:59 #, no-wrap msgid "" -" guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:172 -msgid "" -"where C</dev/sda1> means literally the first partition (C<1>) of the first " -"disk image that we added (C</dev/sda>). If the disk contains Linux LVM2 " -"logical volumes you could refer to those instead (eg. C</dev/VG/LV>). Note " -"that these are libguestfs virtual devices, and are nothing to do with host " -"devices." +#. 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: textblock -#: ../src/guestfs.pod:178 -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</guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions " -"and LVs, and either try mounting each to see what is mountable, or else " -"examine them with L</guestfs_vfs_type> or L</guestfs_file>. To list just " -"filesystems, use L</guestfs_list_filesystems>." +#. 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: textblock -#: ../src/guestfs.pod:186 -msgid "" -"Libguestfs also has a set of APIs for inspection of unknown disk images (see " -"L</INSPECTION> below). But you might find it easier to look at higher level " -"programs built on top of libguestfs, in particular L<virt-inspector(1)>." +#: ../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: textblock -#: ../src/guestfs.pod:191 -msgid "" -"To mount a filesystem read-only, use L</guestfs_mount_ro>. There are " -"several other variations of the C<guestfs_mount_*> call." +#. 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: =head2 -#: ../src/guestfs.pod:194 -msgid "FILESYSTEM ACCESS AND MODIFICATION" +#. 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 -#: ../src/guestfs.pod:196 +#: ../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 "" -"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." +"Add I<file> which should be a disk image from a virtual machine. If the " +"virtual machine has multiple block devices, you must supply all of them with " +"separate I<-a> options." msgstr "" #. type: textblock -#: ../src/guestfs.pod:202 +#: ../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 "" -"Specify filenames as full paths, starting with C<\"/\"> and including the " -"mount point." +"The format of the disk image is auto-detected. To override this and force a " +"particular format use the I<--format=..> option." 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:" +#. 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: verbatim -#: ../src/guestfs.pod:208 -#, no-wrap -msgid "" -" char *data = guestfs_cat (g, \"/etc/passwd\");\n" -"\n" +#. 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 -#: ../src/guestfs.pod:210 +#: ../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 "" -"This would return C<data> as a newly allocated buffer containing the full " -"content of that file (with some conditions: see also L</DOWNLOADING> below), " -"or C<NULL> if there was an error." +"If using libvirt, connect to the given I<URI>. If omitted, then we connect " +"to the default libvirt hypervisor." msgstr "" #. type: textblock -#: ../src/guestfs.pod:214 +#: ../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 "" -"As another example, to create a top-level directory on that filesystem " -"called C<\"var\"> you would do:" +"If you specify guest block devices directly (I<-a>), then libvirt is not " +"used at all." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:217 -#, no-wrap -msgid "" -" guestfs_mkdir (g, \"/var\");\n" -"\n" +#. 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: textblock -#: ../src/guestfs.pod:219 -msgid "To create a symlink you could do:" +#. 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: verbatim -#: ../src/guestfs.pod:221 -#, no-wrap +#. 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 "" -" guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" -" \"/etc/rc3.d/S30portmap\");\n" -"\n" +"Add all the disks from the named libvirt guest. Domain UUIDs can be used " +"instead of names." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:224 -msgid "" -"Libguestfs will reject attempts to use relative paths and there is no " -"concept of a current working directory." +#. 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:227 +#: ../cat/virt-cat.pod:100 ../libguestfs-1.11.19/cat/virt-cat.pod:100 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)." +"When prompting for keys and passphrases, virt-cat normally turns echoing off " +"so you cannot see what you are typing. If you are not worried about Tempest " +"attacks and there is no one else in the room you can specify this flag to " +"see what you are typing." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:233 -msgid "" -"File writes are affected by the per-handle umask, set by calling " -"L</guestfs_umask> and defaulting to 022. See L</UMASK>." +#. 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: =head2 -#: ../src/guestfs.pod:236 -msgid "PARTITIONING" +#. 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:238 +#: ../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 "" -"Libguestfs contains API calls to read, create and modify partition tables on " -"disk images." +"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:241 -msgid "" -"In the common case where you want to create a single partition covering the " -"whole disk, you should use the L</guestfs_part_disk> call:" +#: ../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:245 +#: ../cat/virt-cat.pod:116 ../libguestfs-1.11.19/cat/virt-cat.pod:116 #, 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-cat --format=raw -a disk.img file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:250 -msgid "" -"Obviously this effectively wipes anything that was on that disk image " -"before." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:253 -msgid "LVM2" +#: ../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<disk.img>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:255 +#. type: verbatim +#: ../cat/virt-cat.pod:120 ../libguestfs-1.11.19/cat/virt-cat.pod:120 +#, no-wrap msgid "" -"Libguestfs provides access to a large part of the LVM2 API, such as " -"L</guestfs_lvcreate> and L</guestfs_vgremove>. It won't make much sense " -"unless you familiarize yourself with the concepts of physical volumes, " -"volume groups and logical volumes." +" virt-cat --format=raw -a disk.img --format -a another.img file\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:260 +#: ../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 "" -"This author strongly recommends reading the LVM HOWTO, online at " -"L<http://tldp.org/HOWTO/LVM-HOWTO/>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:263 -msgid "DOWNLOADING" +"forces raw format (no auto-detection) for C<disk.img> and reverts to " +"auto-detection for C<another.img>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:265 +#: ../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 "" -"Use L</guestfs_cat> 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." +"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: textblock -#: ../src/guestfs.pod:269 -msgid "" -"L</guestfs_read_file> 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." +#. 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:273 +#: ../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 "" -"L</guestfs_download> can be used to download any file, with no limits on " -"content or size (even files larger than 4 GB)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:276 -msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>." +"Read key or passphrase parameters from stdin. The default is to try to read " +"passphrases from the user by opening C</dev/tty>." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:279 -msgid "UPLOADING" +#. 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: textblock -#: ../src/guestfs.pod:281 -msgid "" -"It's often the case that you want to write a file or files to the disk " -"image." +#. 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:284 -msgid "" -"To write a small file with fixed content, use L</guestfs_write>. To create " -"a file of all zeroes, use L</guestfs_truncate_size> (sparse) or " -"L</guestfs_fallocate64> (with all disk blocks allocated). There are a " -"variety of other functions for creating test files, for example " -"L</guestfs_fill> and L</guestfs_fill_pattern>." +#: ../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: textblock -#: ../src/guestfs.pod:290 -msgid "" -"To upload a single file, use L</guestfs_upload>. This call has no limits on " -"file content or size (even files larger than 4 GB)." +#. 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: textblock -#: ../src/guestfs.pod:293 -msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>." +#. 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:295 -msgid "" -"However the fastest way to upload I<large numbers of arbitrary files> is to " -"turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and " -"L<mkisofs(8)>), then attach this using L</guestfs_add_drive_ro>. 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</guestfs_list_devices> and mount it " -"directly using L</guestfs_mount_ro>. 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." +#: ../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: =head2 -#: ../src/guestfs.pod:306 -msgid "COPYING" +#. 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:308 -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." +#: ../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: =item -#: ../src/guestfs.pod:314 -msgid "B<file> to B<file>" +#. 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:316 -msgid "" -"Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy " -"directories recursively." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:319 -msgid "B<file or device> to B<file or device>" +#: ../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: textblock -#: ../src/guestfs.pod:321 +#. type: verbatim +#: ../cat/virt-cat.pod:156 ../libguestfs-1.11.19/cat/virt-cat.pod:156 +#, no-wrap msgid "" -"Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and " -"devices in the guest." +" virt-cat disk.img [disk.img ...] file\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:324 -msgid "Example: duplicate the contents of an LV:" +#: ../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 -#: ../src/guestfs.pod:326 +#: ../cat/virt-cat.pod:160 ../libguestfs-1.11.19/cat/virt-cat.pod:160 #, no-wrap msgid "" -" guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n" +" virt-cat guestname file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:328 +#: ../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 "" -"The destination (C</dev/VG/Copy>) must be at least as large as the source " -"(C</dev/VG/Original>). To copy less than the whole source device, use " -"L</guestfs_copy_size>." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:332 -msgid "B<file on the host> to B<file or device>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:334 -msgid "Use L</guestfs_upload>. See L</UPLOADING> above." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:336 -msgid "B<file or device> to B<file on the host>" +"whereas in this version you should use I<-a> or I<-d> respectively to avoid " +"the confusing case where a disk image might have the same name as a guest." msgstr "" #. type: textblock -#: ../src/guestfs.pod:338 -msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." +#: ../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: =head2 -#: ../src/guestfs.pod:342 -msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" +#. 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:344 +#: ../cat/virt-cat.pod:170 ../libguestfs-1.11.19/cat/virt-cat.pod:170 msgid "" -"Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, " -"L</guestfs_tar_out> 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</dev/stdin>, C</dev/stdout>, " -"C</dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, " -"stderr, and arbitrary file descriptor N." +"L<guestfish(1)> is a more powerful, lower level tool which you can use when " +"C<virt-cat> doesn't work." msgstr "" #. type: textblock -#: ../src/guestfs.pod:352 -msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" +#: ../cat/virt-cat.pod:173 ../libguestfs-1.11.19/cat/virt-cat.pod:173 +msgid "Using C<virt-cat> is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:355 +#: ../cat/virt-cat.pod:175 ../libguestfs-1.11.19/cat/virt-cat.pod:175 #, no-wrap msgid "" -" guestfs_download (g, filename, \"/dev/stdout\");\n" +" guestfish --ro -i -d domname download file -\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:357 -msgid "and you can write tar output to a file descriptor C<fd> by doing:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:359 -#, no-wrap +#: ../cat/virt-cat.pod:177 ../libguestfs-1.11.19/cat/virt-cat.pod:177 msgid "" -" char devfd[64];\n" -" snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n" -" guestfs_tar_out (g, \"/\", devfd);\n" -"\n" -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:363 -msgid "LISTING FILES" +"where C<domname> is the name of the libvirt guest, and C<file> is the full " +"path to the file. Note the final C<-> (meaning \"output to stdout\")." msgstr "" #. type: textblock -#: ../src/guestfs.pod:365 +#: ../cat/virt-cat.pod:181 ../libguestfs-1.11.19/cat/virt-cat.pod:181 msgid "" -"L</guestfs_ll> is just designed for humans to read (mainly when using the " -"L<guestfish(1)>-equivalent command C<ll>)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:368 -msgid "" -"L</guestfs_ls> is a quick way to get a list of files in a directory from " -"programs, as a flat list of strings." +"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: textblock -#: ../src/guestfs.pod:371 +#. type: verbatim +#: ../cat/virt-cat.pod:186 ../libguestfs-1.11.19/cat/virt-cat.pod:186 +#, no-wrap msgid "" -"L</guestfs_readdir> 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<readdir(3)> call on a local filesystem." +" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:375 +#: ../cat/virt-cat.pod:188 ../libguestfs-1.11.19/cat/virt-cat.pod:188 msgid "" -"L</guestfs_find> and L</guestfs_find0> can be used to recursively list " -"files." +"where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within " +"the disk image to edit, and C<file> is the full path to the file." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:378 -msgid "RUNNING COMMANDS" +#. 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:380 +#: ../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 "" -"Although libguestfs is primarily an API for manipulating files inside guest " -"images, we also provide some limited facilities for running commands inside " -"guests." -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 "*" +"Libvirt guest names can contain arbitrary characters, some of which have " +"meaning to the shell such as C<#> and space. You may need to quote or " +"escape these characters on the command line. See the shell manual page " +"L<sh(1)> for details." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:390 -msgid "" -"The kernel version that the command runs under will be different from what " -"it expects." +#. 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:395 +#: ../cat/virt-cat.pod:201 ../libguestfs-1.11.19/cat/virt-cat.pod:201 msgid "" -"If the command needs to communicate with daemons, then most likely they " -"won't be running." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, " +"L<virt-tar-out(1)>, L<http://libguestfs.org/>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:400 -msgid "The command will be running in limited memory." +#. 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 -#: ../src/guestfs.pod:404 -msgid "" -"The network may not be available unless you enable it (see " -"L</guestfs_set_network>)." +#: ../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<http://people.redhat.com/~rjones/>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:409 -msgid "Only supports Linux guests (not Windows, BSD, etc)." +#. 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:413 -msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." +#: ../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 -#: ../src/guestfs.pod:418 +#: ../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 "" -"For SELinux guests, you may need to enable SELinux and load policy first. " -"See L</SELINUX> in this manpage." +"This program is free software; you can redistribute it and/or modify it " +"under the terms of the GNU General Public License as published by the Free " +"Software Foundation; either version 2 of the License, or (at your option) " +"any later version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:423 +#: ../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 "" -"I<Security:> 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." +"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:432 +#: ../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 "" -"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</SECURITY>." +"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:440 +#: ../cat/virt-filesystems.pod:5 ../libguestfs-1.11.19/cat/virt-filesystems.pod:5 msgid "" -"The two main API calls to run commands are L</guestfs_command> and " -"L</guestfs_sh> (there are also variations)." +"virt-filesystems - List filesystems, partitions, block devices, LVM in a " +"virtual machine or disk image" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:443 +#. type: verbatim +#: ../cat/virt-filesystems.pod:9 ../libguestfs-1.11.19/cat/virt-filesystems.pod:9 +#, no-wrap msgid "" -"The difference is that L</guestfs_sh> runs commands using the shell, so any " -"shell globs, redirections, etc will work." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:446 -msgid "CONFIGURATION FILES" +" virt-filesystems [--options] -d domname\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:448 +#. type: verbatim +#: ../cat/virt-filesystems.pod:11 ../libguestfs-1.11.19/cat/virt-filesystems.pod:11 +#, no-wrap 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." +" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:453 +#: ../cat/virt-filesystems.pod:15 ../libguestfs-1.11.19/cat/virt-filesystems.pod:15 msgid "" -"The main Augeas calls are bound through the C<guestfs_aug_*> APIs. We don't " -"document Augeas itself here because there is excellent documentation on the " -"L<http://augeas.net/> website." +"This tool allows you to discover filesystems, partitions, logical volumes, " +"and their sizes in a disk image or virtual machine. It is a replacement for " +"L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:457 +#: ../cat/virt-filesystems.pod:20 ../libguestfs-1.11.19/cat/virt-filesystems.pod:20 msgid "" -"If you don't want to use Augeas (you fool!) then try calling " -"L</guestfs_read_lines> to get the file as a list of lines which you can " -"iterate over." +"One use for this tool is from shell scripts to iterate over all filesystems " +"from a disk image:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:461 -msgid "SELINUX" +#. 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:463 +#: ../cat/virt-filesystems.pod:27 ../libguestfs-1.11.19/cat/virt-filesystems.pod:27 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:" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2465 -msgid "1." +"Another use is to list partitions before using another tool to modify those " +"partitions (such as L<virt-resize(1)>). If you are curious about what an " +"unknown disk image contains, use this tool along with L<virt-inspector(1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:471 -msgid "Before launching, do:" +#: ../cat/virt-filesystems.pod:32 ../libguestfs-1.11.19/cat/virt-filesystems.pod:32 +msgid "" +"Various command line options control what this program displays. You need " +"to give either I<-a> or I<-d> options to specify the disk image or libvirt " +"guest respectively. If you just specify that then the program shows " +"filesystems found, one per line, like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:473 +#: ../cat/virt-filesystems.pod:37 ../libguestfs-1.11.19/cat/virt-filesystems.pod:37 #, no-wrap msgid "" -" guestfs_set_selinux (g, 1);\n" +" $ virt-filesystems -a disk.img\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" "\n" msgstr "" -#. type: =item -#: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2490 -msgid "2." -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<load_policy(8)> command in the guest itself:" +#: ../cat/virt-filesystems.pod:41 ../libguestfs-1.11.19/cat/virt-filesystems.pod:41 +msgid "If you add I<-l> or I<--long> then the output includes extra information:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:481 +#: ../cat/virt-filesystems.pod:44 ../libguestfs-1.11.19/cat/virt-filesystems.pod:44 #, no-wrap msgid "" -" guestfs_sh (g, \"/usr/sbin/load_policy\");\n" +" $ 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:483 +#: ../cat/virt-filesystems.pod:49 ../libguestfs-1.11.19/cat/virt-filesystems.pod:49 msgid "" -"(Older versions of C<load_policy> require you to specify the name of the " -"policy file)." +"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " +"shown as well:" msgstr "" -#. type: =item -#: ../src/guestfs.pod:486 ../src/guestfs.pod:1405 -msgid "3." +#. type: verbatim +#: ../cat/virt-filesystems.pod:52 ../libguestfs-1.11.19/cat/virt-filesystems.pod:52 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img --extra\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +" /dev/vg_guest/lv_swap\n" +" /dev/vg_guest/lv_data\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:488 -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:" +#: ../cat/virt-filesystems.pod:58 ../libguestfs-1.11.19/cat/virt-filesystems.pod:58 +msgid "If you add I<--partitions> then partitions are shown instead of filesystems:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:492 +#: ../cat/virt-filesystems.pod:60 ../libguestfs-1.11.19/cat/virt-filesystems.pod:60 #, no-wrap msgid "" -" guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" +" $ virt-filesystems -a disk.img --partitions\n" +" /dev/sda1\n" +" /dev/sda2\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:496 -msgid "This will work for running commands and editing existing files." +#: ../cat/virt-filesystems.pod:64 ../libguestfs-1.11.19/cat/virt-filesystems.pod:64 +msgid "" +"Similarly you can use I<--logical-volumes>, I<--volume-groups>, " +"I<--physical-volumes>, I<--block-devices> to list those items." msgstr "" #. type: textblock -#: ../src/guestfs.pod:498 +#: ../cat/virt-filesystems.pod:67 ../libguestfs-1.11.19/cat/virt-filesystems.pod:67 msgid "" -"When new files are created, you may need to label them explicitly, for " -"example by running the external command C<restorecon pathname>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:502 -msgid "UMASK" +"You can use these options in combination as well (if you want a combination " +"including filesystems, you have to add I<--filesystems>). Notice that some " +"items fall into several categories (eg. C</dev/sda1> might be both a " +"partition and a filesystem). These items are listed several times. To get " +"a list which includes absolutely everything that virt-filesystems knows " +"about, use the I<--all> option." msgstr "" #. type: textblock -#: ../src/guestfs.pod:504 +#: ../cat/virt-filesystems.pod:74 ../libguestfs-1.11.19/cat/virt-filesystems.pod:74 msgid "" -"Certain calls are affected by the current file mode creation mask (the " -"\"umask\"). In particular ones which create files or directories, such as " -"L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>. This affects " -"either the default mode that the file is created with or modifies the mode " -"that you supply." +"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:510 +#: ../cat/virt-filesystems.pod:78 ../libguestfs-1.11.19/cat/virt-filesystems.pod:78 msgid "" -"The default umask is C<022>, so files are created with modes such as C<0644> " -"and directories with C<0755>." +"I<--all --long --uuid> is a useful combination to display all possible " +"information about everything." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:513 +#. type: verbatim +#: ../cat/virt-filesystems.pod:81 ../libguestfs-1.11.19/cat/virt-filesystems.pod:81 +#, no-wrap msgid "" -"There are two ways to avoid being affected by umask. Either set umask to 0 " -"(call C<guestfs_umask (g, 0)> early after launching). Or call " -"L</guestfs_chmod> after creating each file or directory." +" $ 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:517 -msgid "For more information about umask, see L<umask(2)>." +#: ../cat/virt-filesystems.pod:89 ../libguestfs-1.11.19/cat/virt-filesystems.pod:89 +msgid "For machine-readable output, use I<--csv> to get Comma-Separated Values." msgstr "" -#. type: =head1 -#: ../src/guestfs.pod:519 ../fish/guestfish.pod:825 -msgid "ENCRYPTED DISKS" +#. type: =item +#: ../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:521 +#: ../cat/virt-filesystems.pod:112 ../libguestfs-1.11.19/cat/virt-filesystems.pod:112 msgid "" -"Libguestfs allows you to access Linux guests which have been encrypted using " -"whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) " -"standard. This includes nearly all whole disk encryption systems used by " -"modern Linux guests." +"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:527 -msgid "" -"Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it " -"returns the string C<crypto_LUKS>)." +#: ../cat/virt-filesystems.pod:117 ../libguestfs-1.11.19/cat/virt-filesystems.pod:117 +msgid "See also I<--long>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:530 -msgid "" -"Then open these devices by calling L</guestfs_luks_open>. Obviously you " -"will require the passphrase!" +#. 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:533 -msgid "" -"Opening a LUKS device creates a new device mapper device called " -"C</dev/mapper/mapname> (where C<mapname> is the string you supply to " -"L</guestfs_luks_open>). Reads and writes to this mapper device are " -"decrypted from and encrypted to the underlying block device respectively." +#: ../cat/virt-filesystems.pod:123 ../libguestfs-1.11.19/cat/virt-filesystems.pod:123 +msgid "Display block devices." +msgstr "" + +#. type: =item +#: ../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:539 +#: ../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 "" -"LVM volume groups on the device can be made visible by calling " -"L</guestfs_vgscan> followed by L</guestfs_vg_activate_all>. The logical " -"volume(s) can now be mounted in the usual way." +"Write out the results in CSV format (comma-separated values). This format " +"can be imported easily into databases and spreadsheets, but read L</NOTE " +"ABOUT CSV FORMAT> below." msgstr "" #. type: textblock -#: ../src/guestfs.pod:543 +#: ../cat/virt-filesystems.pod:150 ../libguestfs-1.11.19/cat/virt-filesystems.pod:150 msgid "" -"Use the reverse process to close a LUKS device. Unmount any logical volumes " -"on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, " -"[\"/dev/VG\"])>. Then close the mapper device by calling " -"L</guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the " -"underlying encrypted block device)." +"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: =head2 -#: ../src/guestfs.pod:550 -msgid "INSPECTION" +#. type: =item +#: ../cat/virt-filesystems.pod:155 ../libguestfs-1.11.19/cat/virt-filesystems.pod:155 +msgid "B<--extra>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:552 +#: ../cat/virt-filesystems.pod:157 ../libguestfs-1.11.19/cat/virt-filesystems.pod:157 msgid "" -"Libguestfs has APIs for inspecting an unknown disk image to find out if it " -"contains operating systems, an install CD or a live CD. (These APIs used to " -"be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since " -"version 1.5.3 the most frequently used part of this library has been " -"rewritten in C and moved into the core code)." +"This causes filesystems that are not ordinary, mountable filesystems to be " +"displayed. This category includes swapspace, and filesystems that are empty " +"or contain unknown data." msgstr "" #. type: textblock -#: ../src/guestfs.pod:559 -msgid "" -"Add all disks belonging to the unknown virtual machine and call " -"L</guestfs_launch> in the usual way." +#: ../cat/virt-filesystems.pod:161 ../libguestfs-1.11.19/cat/virt-filesystems.pod:161 +msgid "This option implies I<--filesystems>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:562 -msgid "" -"Then call L</guestfs_inspect_os>. This function uses other libguestfs calls " -"and certain heuristics, and returns a list of operating systems that were " -"found. An empty list means none were found. A single element is the root " -"filesystem of the operating system. For dual- or multi-boot guests, " -"multiple roots can be returned, each one corresponding to a separate " -"operating system. (Multi-boot virtual machines are extremely rare in the " -"world of virtualization, but since this scenario can happen, we have built " -"libguestfs to deal with it.)" +#. 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:571 +#: ../cat/virt-filesystems.pod:165 ../libguestfs-1.11.19/cat/virt-filesystems.pod:165 msgid "" -"For each root, you can then call various C<guestfs_inspect_get_*> functions " -"to get additional details about that operating system. For example, call " -"L</guestfs_inspect_get_type> to return the string C<windows> or C<linux> for " -"Windows and Linux-based operating systems respectively." +"Display mountable filesystems. If no display option was selected then this " +"option is implied." msgstr "" #. type: textblock -#: ../src/guestfs.pod:577 -msgid "" -"Un*x-like and Linux-based operating systems usually consist of several " -"filesystems which are mounted at boot time (for example, a separate boot " -"partition mounted on C</boot>). The inspection rules are able to detect how " -"filesystems correspond to mount points. Call " -"C<guestfs_inspect_get_mountpoints> to get this mapping. It might return a " -"hash table like this example:" +#: ../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:584 +#: ../cat/virt-filesystems.pod:181 ../libguestfs-1.11.19/cat/virt-filesystems.pod:181 #, no-wrap msgid "" -" /boot => /dev/sda1\n" -" / => /dev/vg_guest/lv_root\n" -" /usr => /dev/vg_guest/lv_usr\n" +" virt-filesystems --format=raw -a disk.img\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:588 +#. type: verbatim +#: ../cat/virt-filesystems.pod:185 ../libguestfs-1.11.19/cat/virt-filesystems.pod:185 +#, no-wrap msgid "" -"The caller can then make calls to L</guestfs_mount_options> to mount the " -"filesystems as suggested." +" virt-filesystems --format=raw -a disk.img --format -a another.img\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:591 -msgid "" -"Be careful to mount filesystems in the right order (eg. C</> before " -"C</usr>). Sorting the keys of the hash by length, shortest first, should " -"work." +#. 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:595 -msgid "" -"Inspection currently only works for some common operating systems. " -"Contributors are welcome to send patches for other operating systems that we " -"currently cannot detect." +#. 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:599 -msgid "" -"Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " -"for more details. The L</guestfs_inspect_os> function just ignores any " -"encrypted devices." +#: ../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:603 -msgid "" -"A note on the implementation: The call L</guestfs_inspect_os> performs " -"inspection and caches the results in the guest handle. Subsequent calls to " -"C<guestfs_inspect_get_*> return this cached information, but I<do not> " -"re-read the disks. If you change the content of the guest disks, you can " -"redo inspection by calling L</guestfs_inspect_os> again. " -"(L</guestfs_inspect_list_applications> works a little differently from the " -"other calls and does read the disks. See documentation for that function " -"for details)." +#. 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: =head3 -#: ../src/guestfs.pod:612 -msgid "INSPECTING INSTALL DISKS" +#. 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:614 -msgid "" -"Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " -"CDs and more." +#: ../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:617 -msgid "" -"Call L</guestfs_inspect_get_format> to return the format of the operating " -"system, which currently can be C<installed> (a regular operating system) or " -"C<installer> (some sort of install disk)." +#: ../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:621 +#: ../cat/virt-filesystems.pod:213 ../libguestfs-1.11.19/cat/virt-filesystems.pod:213 msgid "" -"Further information is available about the operating system that can be " -"installed using the regular inspection APIs like " -"L</guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> " -"etc." +"The extra columns displayed depend on what output you select, and the " +"ordering of columns may change in future versions. Use the title row, " +"I<--csv> output and/or L<csvtool(1)> to match columns to data in external " +"programs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:626 +#: ../cat/virt-filesystems.pod:218 ../libguestfs-1.11.19/cat/virt-filesystems.pod:218 msgid "" -"Some additional information specific to installer disks is also available " -"from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " -"L</guestfs_inspect_is_multipart> calls." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:631 -msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" +"Use I<-h> if you want sizes to be displayed in human-readable format. The " +"default is to show raw numbers of I<bytes>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:633 -msgid "" -"Libguestfs can mount NTFS partitions. It does this using the " -"L<http://www.ntfs-3g.org/> driver." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:636 -msgid "DRIVE LETTERS AND PATHS" +#: ../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:638 -msgid "" -"DOS and Windows still use drive letters, and the filesystems are always " -"treated as case insensitive by Windows itself, and therefore you might find " -"a Windows configuration file referring to a path like " -"C<c:\\windows\\system32>. When the filesystem is mounted in libguestfs, " -"that directory might be referred to as C</WINDOWS/System32>." +#. 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:644 -msgid "" -"Drive letter mappings can be found using inspection (see L</INSPECTION> and " -"L</guestfs_inspect_get_drive_mappings>)" +#. 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:647 -msgid "" -"Dealing with separator characters (backslash vs forward slash) is outside " -"the scope of libguestfs, but usually a simple character replacement will " -"work." +#. 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:651 +#: ../cat/virt-filesystems.pod:229 ../libguestfs-1.11.19/cat/virt-filesystems.pod:229 msgid "" -"To resolve the case insensitivity of paths, call " -"L</guestfs_case_sensitive_path>." +"Display LVM logical volumes. In this mode, these are displayed irrespective " +"of whether the LVs contain filesystems." msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:654 -msgid "ACCESSING THE WINDOWS REGISTRY" +#. 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:656 -msgid "" -"Libguestfs also provides some help for decoding Windows Registry \"hive\" " -"files, through the library C<hivex> which is part of the libguestfs project " -"although ships as a separate tarball. You have to locate and download the " -"hive file(s) yourself, and then pass them to C<hivex> functions. See also " -"the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and " -"L<virt-win-reg(1)> for more help on this issue." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:664 -msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" +#: ../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:666 +#: ../cat/virt-filesystems.pod:236 ../libguestfs-1.11.19/cat/virt-filesystems.pod:236 msgid "" -"Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to " -"provide something which looks like a Linux symlink. The way it tries to do " -"the rewriting is described here:" +"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:670 -msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" +#. type: =item +#: ../cat/virt-filesystems.pod:240 ../libguestfs-1.11.19/cat/virt-filesystems.pod:240 +msgid "B<--parts>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:672 -msgid "" -"The essential problem is that ntfs-3g simply does not have enough " -"information to do a correct job. NTFS links can contain drive letters and " -"references to external device GUIDs that ntfs-3g has no way of resolving. " -"It is almost certainly the case that libguestfs callers should ignore what " -"ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)." +#. 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:679 +#: ../cat/virt-filesystems.pod:244 ../libguestfs-1.11.19/cat/virt-filesystems.pod:244 msgid "" -"Instead if you encounter a symbolic link on an ntfs-3g filesystem, use " -"L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended " -"attribute, and read the raw reparse data from that (you can find the format " -"documented in various places around the web)." +"Display partitions. In this mode, these are displayed irrespective of " +"whether the partitions contain filesystems." msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:684 -msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:686 -msgid "" -"There are other useful extended attributes that can be read from ntfs-3g " -"filesystems (using L</guestfs_getxattr>). See:" +#. 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:689 -msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" +#. 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:691 -msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" +#. 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:693 -msgid "" -"Although we don't want to discourage you from using the C API, we will " -"mention here that the same API is also available in other languages." +#: ../cat/virt-filesystems.pod:253 ../libguestfs-1.11.19/cat/virt-filesystems.pod:253 +msgid "Display LVM physical volumes." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:696 -msgid "" -"The API is broadly identical in all supported languages. This means that " -"the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> " -"in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in " -"OCaml. In other words, a straightforward, predictable isomorphism between " -"each language." +#. type: =item +#: ../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: textblock -#: ../src/guestfs.pod:702 -msgid "" -"Error messages are automatically transformed into exceptions if the language " -"supports it." +#. 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:705 -msgid "" -"We don't try to \"object orientify\" parts of the API in OO languages, " -"although contributors are welcome to write higher level APIs above what we " -"provide in their favourite languages if they wish." +#: ../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: =item -#: ../src/guestfs.pod:711 -msgid "B<C++>" +#: ../cat/virt-filesystems.pod:273 ../libguestfs-1.11.19/cat/virt-filesystems.pod:273 +msgid "B<--vgs>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:713 -msgid "" -"You can use the I<guestfs.h> header file from C++ programs. The C++ API is " -"identical to the C API. C++ classes and exceptions are not used." +#. type: =item +#: ../cat/virt-filesystems.pod:275 ../libguestfs-1.11.19/cat/virt-filesystems.pod:275 +msgid "B<--volgroups>" msgstr "" #. type: =item -#: ../src/guestfs.pod:717 -msgid "B<C#>" +#: ../cat/virt-filesystems.pod:277 ../libguestfs-1.11.19/cat/virt-filesystems.pod:277 +msgid "B<--volume-groups>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:719 -msgid "" -"The C# bindings are highly experimental. Please read the warnings at the " -"top of C<csharp/Libguestfs.cs>." +#: ../cat/virt-filesystems.pod:279 ../libguestfs-1.11.19/cat/virt-filesystems.pod:279 +msgid "Display LVM volume groups." msgstr "" -#. type: =item -#: ../src/guestfs.pod:722 -msgid "B<Haskell>" +#. type: =head1 +#: ../cat/virt-filesystems.pod:287 ../libguestfs-1.11.19/cat/virt-filesystems.pod:287 +msgid "COLUMNS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:724 +#: ../cat/virt-filesystems.pod:289 ../libguestfs-1.11.19/cat/virt-filesystems.pod:289 msgid "" -"This is the only language binding that is working but incomplete. Only " -"calls which return simple integers have been bound in Haskell, and we are " -"looking for help to complete this binding." +"Note that columns in the output are subject to reordering and change in " +"future versions of this tool." msgstr "" #. type: =item -#: ../src/guestfs.pod:728 -msgid "B<Java>" +#: ../cat/virt-filesystems.pod:294 ../libguestfs-1.11.19/cat/virt-filesystems.pod:294 +msgid "B<Name>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:730 -msgid "" -"Full documentation is contained in the Javadoc which is distributed with " -"libguestfs." +#: ../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: =item -#: ../src/guestfs.pod:733 -msgid "B<OCaml>" +#. type: textblock +#: ../cat/virt-filesystems.pod:298 ../libguestfs-1.11.19/cat/virt-filesystems.pod:298 +msgid "" +"For device and partition names these are displayed as canonical libguestfs " +"names, so that for example C</dev/sda2> is the second partition on the first " +"device." msgstr "" #. type: textblock -#: ../src/guestfs.pod:735 -msgid "See L<guestfs-ocaml(3)>." +#: ../cat/virt-filesystems.pod:302 ../libguestfs-1.11.19/cat/virt-filesystems.pod:302 +msgid "" +"If the I<--long> option is B<not> specified, then only the name column is " +"shown in the output." msgstr "" #. type: =item -#: ../src/guestfs.pod:737 -msgid "B<Perl>" +#: ../cat/virt-filesystems.pod:305 ../libguestfs-1.11.19/cat/virt-filesystems.pod:305 +msgid "B<Type>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:739 -msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." +#: ../cat/virt-filesystems.pod:307 ../libguestfs-1.11.19/cat/virt-filesystems.pod:307 +msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc." msgstr "" #. type: =item -#: ../src/guestfs.pod:741 -msgid "B<PHP>" +#: ../cat/virt-filesystems.pod:309 ../libguestfs-1.11.19/cat/virt-filesystems.pod:309 +msgid "B<VFS>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:743 +#: ../cat/virt-filesystems.pod:311 ../libguestfs-1.11.19/cat/virt-filesystems.pod:311 msgid "" -"For documentation see C<README-PHP> supplied with libguestfs sources or in " -"the php-libguestfs package for your distribution." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:746 -msgid "The PHP binding only works correctly on 64 bit machines." +"If there is a filesystem, then this column displays the filesystem type if " +"one could be detected, eg. C<ext4>." msgstr "" #. type: =item -#: ../src/guestfs.pod:748 -msgid "B<Python>" +#: ../cat/virt-filesystems.pod:314 ../libguestfs-1.11.19/cat/virt-filesystems.pod:314 +msgid "B<Label>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:750 -msgid "See L<guestfs-python(3)>." +#: ../cat/virt-filesystems.pod:316 ../libguestfs-1.11.19/cat/virt-filesystems.pod:316 +msgid "" +"If the object has a label (used for identifying and mounting filesystems) " +"then this column contains the label." msgstr "" #. type: =item -#: ../src/guestfs.pod:752 -msgid "B<Ruby>" +#: ../cat/virt-filesystems.pod:319 ../libguestfs-1.11.19/cat/virt-filesystems.pod:319 +msgid "B<Size>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:754 -msgid "See L<guestfs-ruby(3)>." +#: ../cat/virt-filesystems.pod:321 ../libguestfs-1.11.19/cat/virt-filesystems.pod:321 +msgid "" +"The size of the object in bytes. If the I<--human> option is used then the " +"size is displayed in a human-readable form." msgstr "" #. type: =item -#: ../src/guestfs.pod:756 -msgid "B<shell scripts>" +#: ../cat/virt-filesystems.pod:324 ../libguestfs-1.11.19/cat/virt-filesystems.pod:324 +msgid "B<Parent>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:758 -msgid "See L<guestfish(1)>." +#: ../cat/virt-filesystems.pod:326 ../libguestfs-1.11.19/cat/virt-filesystems.pod:326 +msgid "" +"The parent column records the parent relationship between objects. For " +"example, if the object is a partition, then this column contains the name of " +"the containing device. If the object is a logical volume, then this column " +"is the name of the volume group." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:762 -msgid "LIBGUESTFS GOTCHAS" +#. type: =item +#: ../cat/virt-filesystems.pod:331 ../libguestfs-1.11.19/cat/virt-filesystems.pod:331 +msgid "B<UUID>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:764 +#: ../cat/virt-filesystems.pod:333 ../libguestfs-1.11.19/cat/virt-filesystems.pod:333 msgid "" -"L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a " -"system [...] that works in the way it is documented but is counterintuitive " -"and almost invites mistakes.\"" +"If the object has a UUID (used for identifying and mounting filesystems and " +"block devices) then this column contains the UUID as a string." msgstr "" #. type: textblock -#: ../src/guestfs.pod:768 -msgid "" -"Since we developed libguestfs and the associated tools, there are several " -"things we would have designed differently, but are now stuck with for " -"backwards compatibility or other reasons. If there is ever a libguestfs 2.0 " -"release, you can expect these to change. Beware of them." +#: ../cat/virt-filesystems.pod:337 ../libguestfs-1.11.19/cat/virt-filesystems.pod:337 +msgid "The UUID is only displayed if the I<--uuid> option is given." msgstr "" -#. type: =item -#: ../src/guestfs.pod:776 -msgid "Autosync / forgetting to sync." +#. type: =head1 +#: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459 ../df/virt-df.pod:185 ../libguestfs-1.11.19/cat/virt-filesystems.pod:341 ../libguestfs-1.11.19/cat/virt-ls.pod:459 ../libguestfs-1.11.19/df/virt-df.pod:185 +msgid "NOTE ABOUT CSV FORMAT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:778 +#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 ../df/virt-df.pod:187 ../libguestfs-1.11.19/cat/virt-filesystems.pod:343 ../libguestfs-1.11.19/cat/virt-ls.pod:461 ../libguestfs-1.11.19/df/virt-df.pod:187 msgid "" -"I<Update:> Autosync is enabled by default for all API users starting from " -"libguestfs 1.5.24. This section only applies to older versions." +"Comma-separated values (CSV) is a deceptive format. It I<seems> like it " +"should be easy to parse, but it is definitely not easy to parse." msgstr "" #. type: textblock -#: ../src/guestfs.pod:781 +#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 ../df/virt-df.pod:190 ../libguestfs-1.11.19/cat/virt-filesystems.pod:346 ../libguestfs-1.11.19/cat/virt-ls.pod:464 ../libguestfs-1.11.19/df/virt-df.pod:190 msgid "" -"When modifying a filesystem from C or another language, you B<must> unmount " -"all filesystems and call L</guestfs_sync> explicitly before you close the " -"libguestfs handle. You can also call:" +"Myth: Just split fields at commas. Reality: This does I<not> work " +"reliably. This example has two columns:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:785 +#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 ../df/virt-df.pod:193 ../libguestfs-1.11.19/cat/virt-filesystems.pod:349 ../libguestfs-1.11.19/cat/virt-ls.pod:467 ../libguestfs-1.11.19/df/virt-df.pod:193 #, no-wrap msgid "" -" guestfs_set_autosync (g, 1);\n" +" \"foo,bar\",baz\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:787 +#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 ../df/virt-df.pod:195 ../libguestfs-1.11.19/cat/virt-filesystems.pod:351 ../libguestfs-1.11.19/cat/virt-ls.pod:469 ../libguestfs-1.11.19/df/virt-df.pod:195 msgid "" -"to have the unmount/sync done automatically for you when the handle 'g' is " -"closed. (This feature is called \"autosync\", L</guestfs_set_autosync> " -"q.v.)" +"Myth: Read the file one line at a time. Reality: This does I<not> work " +"reliably. This example has one row:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:791 +#. type: verbatim +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 ../df/virt-df.pod:198 ../libguestfs-1.11.19/cat/virt-filesystems.pod:354 ../libguestfs-1.11.19/cat/virt-ls.pod:472 ../libguestfs-1.11.19/df/virt-df.pod:198 +#, no-wrap msgid "" -"If you forget to do this, then it is entirely possible that your changes " -"won't be written out, or will be partially written, or (very rarely) that " -"you'll get disk corruption." +" \"foo\n" +" bar\",baz\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:795 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 ../df/virt-df.pod:201 ../libguestfs-1.11.19/cat/virt-filesystems.pod:357 ../libguestfs-1.11.19/cat/virt-ls.pod:475 ../libguestfs-1.11.19/df/virt-df.pod:201 msgid "" -"Note that in L<guestfish(3)> autosync is the default. So quick and dirty " -"guestfish scripts that forget to sync will work just fine, which can make " -"this very puzzling if you are trying to debug a problem." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:799 -msgid "Mount option C<-o sync> should not be the default." +"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " +"packaged in major Linux distributions)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:801 +#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 ../df/virt-df.pod:204 ../libguestfs-1.11.19/cat/virt-filesystems.pod:360 ../libguestfs-1.11.19/cat/virt-ls.pod:478 ../libguestfs-1.11.19/df/virt-df.pod:204 msgid "" -"If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. " -"However C<-o sync> does not add any reliability benefit, but does have a " -"very large performance impact." +"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " +"or Python's built-in csv library)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:805 -msgid "" -"The work around is to use L</guestfs_mount_options> and set the mount " -"options that you actually want to use." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:808 -msgid "Read-only should be the default." +#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 ../df/virt-df.pod:207 ../libguestfs-1.11.19/cat/virt-filesystems.pod:363 ../libguestfs-1.11.19/cat/virt-ls.pod:481 ../libguestfs-1.11.19/df/virt-df.pod:207 +msgid "Most spreadsheets and databases can import CSV directly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:810 +#: ../cat/virt-filesystems.pod:374 ../libguestfs-1.11.19/cat/virt-filesystems.pod:374 msgid "" -"In L<guestfish(3)>, I<--ro> should be the default, and you should have to " -"specify I<--rw> if you want to make changes to the image." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, " +"L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, " +"L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:813 -msgid "This would reduce the potential to corrupt live VM images." +#: ../cat/virt-filesystems.pod:389 ../libguestfs-1.11.19/cat/virt-filesystems.pod:389 ../tools/virt-make-fs.pl:570 ../tools/virt-win-reg.pl:778 +msgid "Copyright (C) 2010 Red Hat Inc." msgstr "" #. type: textblock -#: ../src/guestfs.pod:815 -msgid "" -"Note that many filesystems change the disk when you just mount and unmount, " -"even if you didn't perform any writes. You need to use " -"L</guestfs_add_drive_ro> to guarantee that the disk is not changed." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:819 -msgid "guestfish command line is hard to use." +#: ../cat/virt-ls.pod:5 ../libguestfs-1.11.19/cat/virt-ls.pod:5 +msgid "virt-ls - List files in a virtual machine" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:821 +#. type: verbatim +#: ../cat/virt-ls.pod:9 ../libguestfs-1.11.19/cat/virt-ls.pod:9 +#, no-wrap msgid "" -"C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for " -"examination). It tries to run a guestfish command C<disk.img> which doesn't " -"exist, so it fails. In earlier versions of guestfish the error message was " -"also unintuitive, but we have corrected this since. Like the Bourne shell, " -"we should have used C<guestfish -c command> to run commands." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:828 -msgid "guestfish megabyte modifiers don't work right on all commands" +" virt-ls [--options] -d domname directory [directory ...]\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:830 +#. type: verbatim +#: ../cat/virt-ls.pod:11 ../libguestfs-1.11.19/cat/virt-ls.pod:11 +#, no-wrap msgid "" -"In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for " -"other modifiers). What guestfish actually does is to multiply the number " -"part by the modifier part and pass the result to the C API. However this " -"doesn't work for a few APIs which aren't expecting bytes, but are already " -"expecting some other unit (eg. megabytes)." +" virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory " +"...]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:837 -msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" +#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../libguestfs-1.11.19/cat/virt-ls.pod:13 ../libguestfs-1.11.19/df/virt-df.pod:15 ../libguestfs-1.11.19/rescue/virt-rescue.pod:13 ../rescue/virt-rescue.pod:13 +msgid "Old style:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:839 +#: ../cat/virt-ls.pod:15 ../libguestfs-1.11.19/cat/virt-ls.pod:15 #, no-wrap msgid "" -" lvcreate LV VG 100M\n" +" virt-ls [--options] domname directory\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:841 +#. type: verbatim +#: ../cat/virt-ls.pod:17 ../libguestfs-1.11.19/cat/virt-ls.pod:17 +#, no-wrap msgid "" -"does not do what you might expect. Instead because L</guestfs_lvcreate> is " -"already expecting megabytes, this tries to create a 100 I<terabyte> (100 " -"megabytes * megabytes) logical volume. The error message you get from this " -"is also a little obscure." +" virt-ls [--options] disk.img [disk.img ...] directory\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:846 +#: ../cat/virt-ls.pod:21 ../libguestfs-1.11.19/cat/virt-ls.pod:21 msgid "" -"This could be fixed in the generator by specially marking parameters and " -"return values which take bytes or other units." +"C<virt-ls> lists filenames, file sizes, checksums, extended attributes and " +"more from a virtual machine or disk image." msgstr "" -#. type: =item -#: ../src/guestfs.pod:849 -msgid "Ambiguity between devices and paths" +#. type: textblock +#: ../cat/virt-ls.pod:24 ../libguestfs-1.11.19/cat/virt-ls.pod:24 +msgid "" +"Multiple directory names can be given, in which case the output from each is " +"concatenated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:851 +#: ../cat/virt-ls.pod:27 ../libguestfs-1.11.19/cat/virt-ls.pod:27 msgid "" -"There is a subtle ambiguity in the API between a device name " -"(eg. C</dev/sdb2>) and a similar pathname. A file might just happen to be " -"called C<sdb2> in the directory C</dev> (consider some non-Unix VM image)." +"To list directories from a libvirt guest use the I<-d> option to specify the " +"name of the guest. For a disk image, use the I<-a> option." msgstr "" #. type: textblock -#: ../src/guestfs.pod:856 +#: ../cat/virt-ls.pod:31 ../libguestfs-1.11.19/cat/virt-ls.pod:31 msgid "" -"In the current API we usually resolve this ambiguity by having two separate " -"calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>. " -"Some API calls are ambiguous and (incorrectly) resolve the problem by " -"detecting if the path supplied begins with C</dev/>." +"C<virt-ls> can do many simple file listings. For more complicated cases you " +"may need to use L<guestfish(1)>, or write a program directly to the " +"L<guestfs(3)> API." msgstr "" #. type: textblock -#: ../src/guestfs.pod:862 -msgid "" -"To avoid both the ambiguity and the need to duplicate some calls, we could " -"make paths/devices into structured names. One way to do this would be to " -"use a notation like grub (C<hd(0,0)>), although nobody really likes this " -"aspect of grub. Another way would be to use a structured type, equivalent " -"to this OCaml type:" +#: ../cat/virt-ls.pod:37 ../libguestfs-1.11.19/cat/virt-ls.pod:37 +msgid "Get a list of all files and directories in a virtual machine:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:868 +#: ../cat/virt-ls.pod:39 ../libguestfs-1.11.19/cat/virt-ls.pod:39 #, no-wrap msgid "" -" type path = Path of string | Device of int | Partition of int * int\n" +" virt-ls -R -d guest /\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:870 -msgid "which would allow you to pass arguments like:" +#: ../cat/virt-ls.pod:41 ../libguestfs-1.11.19/cat/virt-ls.pod:41 +msgid "List all setuid or setgid programs in a Linux virtual machine:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:872 +#: ../cat/virt-ls.pod:43 ../libguestfs-1.11.19/cat/virt-ls.pod:43 #, no-wrap msgid "" -" Path \"/foo/bar\"\n" -" Device 1 (* /dev/sdb, or perhaps /dev/sda *)\n" -" Partition (1, 2) (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n" -" Path \"/dev/sdb2\" (* not a device *)\n" +" virt-ls -lR -d guest / | grep '^- [42]'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:877 -msgid "" -"As you can see there are still problems to resolve even with this " -"representation. Also consider how it might work in guestfish." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:882 -msgid "KEYS AND PASSPHRASES" +#: ../cat/virt-ls.pod:45 ../libguestfs-1.11.19/cat/virt-ls.pod:45 +msgid "List all public-writable directories in a Linux virtual machine:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:884 +#. type: verbatim +#: ../cat/virt-ls.pod:47 ../libguestfs-1.11.19/cat/virt-ls.pod:47 +#, no-wrap msgid "" -"Certain libguestfs calls take a parameter that contains sensitive key " -"material, passed in as a C string." +" virt-ls -lR -d guest / | grep '^d ...7'\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:887 -msgid "" -"In the future we would hope to change the libguestfs implementation so that " -"keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in " -"swap. However this is I<not> done at the moment, because of the complexity " -"of such an implementation." +#: ../cat/virt-ls.pod:49 ../libguestfs-1.11.19/cat/virt-ls.pod:49 +msgid "List all Unix domain sockets in a Linux virtual machine:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:892 +#. type: verbatim +#: ../cat/virt-ls.pod:51 ../libguestfs-1.11.19/cat/virt-ls.pod:51 +#, no-wrap msgid "" -"Therefore you should be aware that any key parameter you pass to libguestfs " -"might end up being written out to the swap partition. If this is a concern, " -"scrub the swap partition or don't use libguestfs on encrypted devices." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:897 -msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" +" virt-ls -lR -d guest / | grep '^s'\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:899 -msgid "" -"All high-level libguestfs actions are synchronous. If you want to use " -"libguestfs asynchronously then you must create a thread." +#: ../cat/virt-ls.pod:53 ../libguestfs-1.11.19/cat/virt-ls.pod:53 +msgid "List all regular files with filenames ending in '.png':" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:902 +#. type: verbatim +#: ../cat/virt-ls.pod:55 ../libguestfs-1.11.19/cat/virt-ls.pod:55 +#, no-wrap msgid "" -"Only use the handle from a single thread. Either use the handle exclusively " -"from one thread, or provide your own mutex so that two threads cannot issue " -"calls on the same handle at the same time." +" virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:906 -msgid "" -"See the graphical program guestfs-browser for one possible architecture for " -"multithreaded programs using libvirt and libguestfs." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:909 -msgid "PATH" +#: ../cat/virt-ls.pod:57 ../libguestfs-1.11.19/cat/virt-ls.pod:57 +msgid "To display files larger than 10MB in home directories:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:911 +#. type: verbatim +#: ../cat/virt-ls.pod:59 ../libguestfs-1.11.19/cat/virt-ls.pod:59 +#, no-wrap msgid "" -"Libguestfs needs a supermin appliance, which it finds by looking along an " -"internal path." +" virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:914 -msgid "" -"By default it looks for these in the directory C<$libdir/guestfs> " -"(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)." +#: ../cat/virt-ls.pod:61 ../libguestfs-1.11.19/cat/virt-ls.pod:61 +msgid "Find everything modified in the last 7 days:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:917 +#. type: verbatim +#: ../cat/virt-ls.pod:63 ../libguestfs-1.11.19/cat/virt-ls.pod:63 +#, no-wrap msgid "" -"Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> " -"to change the directories that libguestfs will search in. The value is a " -"colon-separated list of paths. The current directory is I<not> searched " -"unless the path contains an empty element or C<.>. For example " -"C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and " -"then C</usr/lib/guestfs>." +" virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n" +"\n" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:924 -msgid "QEMU WRAPPERS" +#. type: textblock +#: ../cat/virt-ls.pod:65 ../libguestfs-1.11.19/cat/virt-ls.pod:65 +msgid "Find regular files modified in the last 24 hours:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:926 +#. type: verbatim +#: ../cat/virt-ls.pod:67 ../libguestfs-1.11.19/cat/virt-ls.pod:67 +#, no-wrap msgid "" -"If you want to compile your own qemu, run qemu from a non-standard location, " -"or pass extra arguments to qemu, then you can write a shell-script wrapper " -"around qemu." +" virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:930 -msgid "" -"There is one important rule to remember: you I<must C<exec qemu>> as the " -"last command in the shell script (so that qemu replaces the shell and " -"becomes the direct child of the libguestfs-using program). If you don't do " -"this, then the qemu process won't be cleaned up correctly." +#. type: =head2 +#: ../cat/virt-ls.pod:69 ../libguestfs-1.11.19/cat/virt-ls.pod:69 +msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:935 +#: ../cat/virt-ls.pod:71 ../libguestfs-1.11.19/cat/virt-ls.pod:71 msgid "" -"Here is an example of a wrapper, where I have built my own copy of qemu from " -"source:" +"Find the differences between files in a guest and an earlier snapshot of the " +"same guest." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:938 +#: ../cat/virt-ls.pod:74 ../libguestfs-1.11.19/cat/virt-ls.pod:74 #, no-wrap msgid "" -" #!/bin/sh -\n" -" qemudir=/home/rjones/d/qemu\n" -" exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios " -"\"$@\"\n" +" virt-ls -lR -a snapshot.img / --uids --time-t > old\n" +" virt-ls -lR -a current.img / --uids --time-t > new\n" +" diff -u old new | less\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:942 +#: ../cat/virt-ls.pod:78 ../libguestfs-1.11.19/cat/virt-ls.pod:78 msgid "" -"Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and " -"then use it by setting the LIBGUESTFS_QEMU environment variable. For " -"example:" +"The commands above won't find files where the content has changed but the " +"metadata (eg. file size and modification date) is the same. To do that, you " +"need to add the I<--checksum> parameter to both C<virt-ls> commands. " +"I<--checksum> can be quite slow since it has to read and compute a checksum " +"of every regular file in the virtual machine." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:946 -#, no-wrap -msgid "" -" LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" -"\n" +#. type: =head1 +#: ../cat/virt-ls.pod:84 ../libguestfs-1.11.19/cat/virt-ls.pod:84 +msgid "OUTPUT MODES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:948 +#: ../cat/virt-ls.pod:86 ../libguestfs-1.11.19/cat/virt-ls.pod:86 msgid "" -"Note that libguestfs also calls qemu with the -help and -version options in " -"order to determine features." +"C<virt-ls> has four output modes, controlled by different combinations of " +"the I<-l> and I<-R> options." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:951 -msgid "ATTACHING TO RUNNING DAEMONS" +#: ../cat/virt-ls.pod:89 ../libguestfs-1.11.19/cat/virt-ls.pod:89 +msgid "SIMPLE LISTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:953 -msgid "" -"I<Note (1):> This is B<highly experimental> and has a tendency to eat " -"babies. Use with caution." +#: ../cat/virt-ls.pod:91 ../libguestfs-1.11.19/cat/virt-ls.pod:91 +msgid "A simple listing is like the ordinary L<ls(1)> command:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:956 +#. type: verbatim +#: ../cat/virt-ls.pod:93 ../libguestfs-1.11.19/cat/virt-ls.pod:93 +#, no-wrap msgid "" -"I<Note (2):> This section explains how to attach to a running daemon from a " -"low level perspective. For most users, simply using virt tools such as " -"L<guestfish(1)> with the I<--live> option will \"just work\"." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:960 -msgid "Using guestfs_set_attach_method" +" $ virt-ls -d guest /\n" +" bin\n" +" boot\n" +" [etc.]\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:962 -msgid "" -"By calling L</guestfs_set_attach_method> you can change how the library " -"connects to the C<guestfsd> daemon in L</guestfs_launch> (read " -"L</ARCHITECTURE> for some background)." +#. type: =head2 +#: ../cat/virt-ls.pod:98 ../libguestfs-1.11.19/cat/virt-ls.pod:98 +msgid "LONG LISTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:966 +#: ../cat/virt-ls.pod:100 ../libguestfs-1.11.19/cat/virt-ls.pod:100 msgid "" -"The normal attach method is C<appliance>, where a small appliance is created " -"containing the daemon, and then the library connects to this." +"With the I<-l> (I<--long>) option, the output is like the C<ls -l> command " +"(more specifically, like the C<guestfs_ll> function)." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:969 +#. type: verbatim +#: ../cat/virt-ls.pod:103 ../libguestfs-1.11.19/cat/virt-ls.pod:103 +#, no-wrap msgid "" -"Setting attach method to C<unix:I<path>> (where I<path> is the path of a " -"Unix domain socket) causes L</guestfs_launch> to connect to an existing " -"daemon over the Unix domain socket." +" $ virt-ls -l -d guest /\n" +" total 204\n" +" dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n" +" dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n" +" [etc.]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:973 +#: ../cat/virt-ls.pod:109 ../libguestfs-1.11.19/cat/virt-ls.pod:109 msgid "" -"The normal use for this is to connect to a running virtual machine that " -"contains a C<guestfsd> daemon, and send commands so you can read and write " -"files inside the live virtual machine." +"Note that while this is useful for displaying a directory, do not try " +"parsing this output in another program. Use L</RECURSIVE LONG LISTING> " +"instead." msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:977 -msgid "Using guestfs_add_domain with live flag" +#. type: =head2 +#: ../cat/virt-ls.pod:113 ../libguestfs-1.11.19/cat/virt-ls.pod:113 +msgid "RECURSIVE LISTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:979 +#: ../cat/virt-ls.pod:115 ../libguestfs-1.11.19/cat/virt-ls.pod:115 msgid "" -"L</guestfs_add_domain> provides some help for getting the correct attach " -"method. If you pass the C<live> option to this function, then (if the " -"virtual machine is running) it will examine the libvirt XML looking for a " -"virtio-serial channel to connect to:" +"With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files " +"and directories recursively:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:985 +#: ../cat/virt-ls.pod:118 ../libguestfs-1.11.19/cat/virt-ls.pod:118 #, no-wrap msgid "" -" <domain>\n" -" ...\n" -" <devices>\n" -" ...\n" -" <channel type='unix'>\n" -" <source mode='bind' path='/path/to/socket'/>\n" -" <target type='virtio' name='org.libguestfs.channel.0'/>\n" -" </channel>\n" -" ...\n" -" </devices>\n" -" </domain>\n" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [etc.]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:997 -msgid "" -"L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach " -"method to C<unix:/path/to/socket>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1000 -msgid "" -"Some of the libguestfs tools (including guestfish) support a I<--live> " -"option which is passed through to L</guestfs_add_domain> thus allowing you " -"to attach to and modify live virtual machines." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1004 +#: ../cat/virt-ls.pod:123 ../libguestfs-1.11.19/cat/virt-ls.pod:123 msgid "" -"The virtual machine needs to have been set up beforehand so that it has the " -"virtio-serial channel and so that guestfsd is running inside it." +"To generate this output, C<virt-ls> runs the C<guestfs_find0> function and " +"converts C<\\0> characters to C<\\n>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1008 -msgid "ABI GUARANTEE" +#: ../cat/virt-ls.pod:126 ../libguestfs-1.11.19/cat/virt-ls.pod:126 +msgid "RECURSIVE LONG LISTING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1010 +#: ../cat/virt-ls.pod:128 ../libguestfs-1.11.19/cat/virt-ls.pod:128 msgid "" -"We guarantee the libguestfs ABI (binary interface), for public, high-level " -"actions as outlined in this section. Although we will deprecate some " -"actions, for example if they get replaced by newer calls, we will keep the " -"old actions forever. This allows you the developer to program in confidence " -"against the libguestfs API." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1016 -msgid "BLOCK DEVICE NAMING" +"Using I<-lR> options together changes the output to display directories " +"recursively, with file stats, and optionally other features such as " +"checksums and extended attributes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1018 +#: ../cat/virt-ls.pod:132 ../libguestfs-1.11.19/cat/virt-ls.pod:132 msgid "" -"In the kernel there is now quite a profusion of schemata for naming block " -"devices (in this context, by I<block device> I mean a physical or virtual " -"hard drive). The original Linux IDE driver used names starting with " -"C</dev/hd*>. SCSI devices have historically used a different naming scheme, " -"C</dev/sd*>. When the Linux kernel I<libata> driver became a popular " -"replacement for the old IDE driver (particularly for SATA devices) those " -"devices also used the C</dev/sd*> scheme. Additionally we now have virtual " -"machines with paravirtualized drivers. This has created several different " -"naming systems, such as C</dev/vd*> for virtio disks and C</dev/xvd*> for " -"Xen PV disks." +"Most of the interesting features of C<virt-ls> are only available when using " +"I<-lR> mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1030 +#: ../cat/virt-ls.pod:135 ../libguestfs-1.11.19/cat/virt-ls.pod:135 msgid "" -"As discussed above, libguestfs uses a qemu appliance running an embedded " -"Linux kernel to access block devices. We can run a variety of appliances " -"based on a variety of Linux kernels." +"The fields are normally space-separated. Filenames are B<not> quoted, so " +"you cannot use the output in another program (because filenames can contain " +"spaces and other unsafe characters). If the guest was untrusted and someone " +"knew you were using C<virt-ls> to analyze the guest, they could play tricks " +"on you by creating filenames with embedded newline characters. To B<safely> " +"parse the output in another program, use the I<--csv> (Comma-Separated " +"Values) option." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1034 +#: ../cat/virt-ls.pod:143 ../libguestfs-1.11.19/cat/virt-ls.pod:143 msgid "" -"This causes a problem for libguestfs because many API calls use device or " -"partition names. Working scripts and the recipe (example) scripts that we " -"make available over the internet could fail if the naming scheme changes." +"Note that this output format is completely unrelated to the C<ls -lR> " +"command." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1039 +#. type: verbatim +#: ../cat/virt-ls.pod:146 ../libguestfs-1.11.19/cat/virt-ls.pod:146 +#, no-wrap msgid "" -"Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. " -"Internally C</dev/sd*> names are translated, if necessary, to other names as " -"required. For example, under RHEL 5 which uses the C</dev/hd*> scheme, any " -"device parameter C</dev/sda2> is translated to C</dev/hda2> transparently." +" $ virt-ls -lR -d guest /bin\n" +" d 0555 4096 /bin\n" +" - 0755 123 /bin/alsaunmute\n" +" - 0755 28328 /bin/arch\n" +" l 0777 4 /bin/awk -> gawk\n" +" - 0755 27216 /bin/basename\n" +" - 0755 943360 /bin/bash\n" +" [etc.]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1045 -msgid "" -"Note that this I<only> applies to parameters. The L</guestfs_list_devices>, " -"L</guestfs_list_partitions> and similar calls return the true names of the " -"devices and partitions as known to the appliance." +#: ../cat/virt-ls.pod:155 ../libguestfs-1.11.19/cat/virt-ls.pod:155 +msgid "These basic fields are always shown:" msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:1050 -msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" +#. type: =item +#: ../cat/virt-ls.pod:159 ../libguestfs-1.11.19/cat/virt-ls.pod:159 +msgid "type" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1052 +#: ../cat/virt-ls.pod:161 ../libguestfs-1.11.19/cat/virt-ls.pod:161 msgid "" -"Usually this translation is transparent. However in some (very rare) cases " -"you may need to know the exact algorithm. Such cases include where you use " -"L</guestfs_config> to add a mixture of virtio and IDE devices to the " -"qemu-based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> " -"devices." +"The file type, one of: C<-> (regular file), C<d> (directory), C<c> " +"(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic " +"link), C<s> (socket) or C<u> (unknown)." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1058 -msgid "" -"The algorithm is applied only to I<parameters> which are known to be either " -"device or partition names. Return values from functions such as " -"L</guestfs_list_devices> are never changed." +#. type: =item +#: ../cat/virt-ls.pod:171 ../libguestfs-1.11.19/cat/virt-ls.pod:171 +msgid "permissions" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1066 -msgid "Is the string a parameter which is a device or partition name?" +#: ../cat/virt-ls.pod:173 ../libguestfs-1.11.19/cat/virt-ls.pod:173 +msgid "The Unix permissions, displayed as a 4 digit octal number." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1070 -msgid "Does the string begin with C</dev/sd>?" +#. type: =item +#: ../cat/virt-ls.pod:175 ../libguestfs-1.11.19/cat/virt-ls.pod:175 +msgid "size" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1074 +#: ../cat/virt-ls.pod:177 ../libguestfs-1.11.19/cat/virt-ls.pod:177 msgid "" -"Does the named device exist? If so, we use that device. However if I<not> " -"then we continue with this algorithm." +"The size of the file. This is shown in bytes unless I<-h> or " +"I<--human-readable> option is given, in which case this is shown as a " +"human-readable number." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1079 -msgid "Replace initial C</dev/sd> string with C</dev/hd>." +#. type: =head2 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4183 ../libguestfs-1.11.19/cat/virt-ls.pod:181 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4183 +msgid "path" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1081 -msgid "For example, change C</dev/sda2> to C</dev/hda2>." +#: ../cat/virt-ls.pod:183 ../libguestfs-1.11.19/cat/virt-ls.pod:183 +msgid "The full path of the file or directory." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1083 -msgid "If that named device exists, use it. If not, continue." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1087 -msgid "Replace initial C</dev/sd> string with C</dev/vd>." +#. type: =item +#: ../cat/virt-ls.pod:185 ../libguestfs-1.11.19/cat/virt-ls.pod:185 +msgid "link" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1089 -msgid "If that named device exists, use it. If not, return an error." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1093 -msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" +#: ../cat/virt-ls.pod:187 ../libguestfs-1.11.19/cat/virt-ls.pod:187 +msgid "For symbolic links only, the link target." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1095 +#: ../cat/virt-ls.pod:191 ../libguestfs-1.11.19/cat/virt-ls.pod:191 msgid "" -"Although the standard naming scheme and automatic translation is useful for " -"simple programs and guestfish scripts, for larger programs it is best not to " -"rely on this mechanism." +"In I<-lR> mode, additional command line options enable the display of more " +"fields." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1099 +#: ../cat/virt-ls.pod:194 ../libguestfs-1.11.19/cat/virt-ls.pod:194 msgid "" -"Where possible for maximum future portability programs using libguestfs " -"should use these future-proof techniques:" +"With the I<--uids> flag, these additional fields are displayed before the " +"path:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1106 -msgid "" -"Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual " -"device names, and then use those names directly." +#. type: =item +#: ../cat/virt-ls.pod:199 ../libguestfs-1.11.19/cat/virt-ls.pod:199 +msgid "uid" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1109 -msgid "Since those device names exist by definition, they will never be translated." +#. type: =item +#: ../cat/virt-ls.pod:201 ../libguestfs-1.11.19/cat/virt-ls.pod:201 +msgid "gid" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1114 +#: ../cat/virt-ls.pod:203 ../libguestfs-1.11.19/cat/virt-ls.pod:203 msgid "" -"Use higher level ways to identify filesystems, such as LVM names, UUIDs and " -"filesystem labels." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:1119 -msgid "SECURITY" +"The UID and GID of the owner of the file (displayed numerically). Note " +"these only make sense in the context of a Unix-like guest." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1121 -msgid "" -"This section discusses security implications of using libguestfs, " -"particularly with untrusted or malicious guests or disk images." +#: ../cat/virt-ls.pod:208 ../libguestfs-1.11.19/cat/virt-ls.pod:208 +msgid "With the I<--times> flag, these additional fields are displayed:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1124 -msgid "GENERAL SECURITY CONSIDERATIONS" +#. type: =item +#: ../cat/virt-ls.pod:212 ../libguestfs-1.11.19/cat/virt-ls.pod:212 +msgid "atime" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1126 -msgid "" -"Be careful with any files or data that you download from a guest (by " -"\"download\" we mean not just the L</guestfs_download> command but any " -"command that reads files, filenames, directories or anything else from a " -"disk image). An attacker could manipulate the data to fool your program " -"into doing the wrong thing. Consider cases such as:" +#: ../cat/virt-ls.pod:214 ../libguestfs-1.11.19/cat/virt-ls.pod:214 +msgid "The time of last access." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1136 -msgid "the data (file etc) not being present" +#. type: =item +#: ../cat/virt-ls.pod:216 ../libguestfs-1.11.19/cat/virt-ls.pod:216 +msgid "mtime" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1140 -msgid "being present but empty" +#: ../cat/virt-ls.pod:218 ../libguestfs-1.11.19/cat/virt-ls.pod:218 +msgid "The time of last modification." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1144 -msgid "being much larger than normal" +#. type: =item +#: ../cat/virt-ls.pod:220 ../libguestfs-1.11.19/cat/virt-ls.pod:220 +msgid "ctime" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1148 -msgid "containing arbitrary 8 bit data" +#: ../cat/virt-ls.pod:222 ../libguestfs-1.11.19/cat/virt-ls.pod:222 +msgid "The time of last status change." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1152 -msgid "being in an unexpected character encoding" +#: ../cat/virt-ls.pod:226 ../libguestfs-1.11.19/cat/virt-ls.pod:226 +msgid "" +"The time fields are displayed as string dates and times, unless one of the " +"I<--time-t>, I<--time-relative> or I<--time-days> flags is given." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1156 -msgid "containing homoglyphs." +#: ../cat/virt-ls.pod:229 ../libguestfs-1.11.19/cat/virt-ls.pod:229 +msgid "With the I<--extra-stats> flag, these additional fields are displayed:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1160 -msgid "SECURITY OF MOUNTING FILESYSTEMS" +#. type: =item +#: ../cat/virt-ls.pod:233 ../libguestfs-1.11.19/cat/virt-ls.pod:233 +msgid "device" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1162 +#: ../cat/virt-ls.pod:235 ../libguestfs-1.11.19/cat/virt-ls.pod:235 msgid "" -"When you mount a filesystem under Linux, mistakes in the kernel filesystem " -"(VFS) module can sometimes be escalated into exploits by deliberately " -"creating a malicious, malformed filesystem. These exploits are very severe " -"for two reasons. Firstly there are very many filesystem drivers in the " -"kernel, and many of them are infrequently used and not much developer " -"attention has been paid to the code. Linux userspace helps potential " -"crackers by detecting the filesystem type and automatically choosing the " -"right VFS driver, even if that filesystem type is obscure or unexpected for " -"the administrator. Secondly, a kernel-level exploit is like a local root " -"exploit (worse in some ways), giving immediate and total access to the " -"system right down to the hardware level." +"The device containing the file (displayed as major:minor). This may not " +"match devices as known to the guest." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1175 -msgid "" -"That explains why you should never mount a filesystem from an untrusted " -"guest on your host kernel. How about libguestfs? We run a Linux kernel " -"inside a qemu virtual machine, usually running as a non-root user. The " -"attacker would need to write a filesystem which first exploited the kernel, " -"and then exploited either qemu virtualization (eg. a faulty qemu driver) or " -"the libguestfs protocol, and finally to be as serious as the host kernel " -"exploit it would need to escalate its privileges to root. This multi-step " -"escalation, performed by a static piece of data, is thought to be extremely " -"hard to do, although we never say 'never' about security issues." +#. type: =item +#: ../cat/virt-ls.pod:238 ../libguestfs-1.11.19/cat/virt-ls.pod:238 +msgid "inode" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1186 -msgid "" -"In any case callers can reduce the attack surface by forcing the filesystem " -"type when mounting (use L</guestfs_mount_vfs>)." +#: ../cat/virt-ls.pod:240 ../libguestfs-1.11.19/cat/virt-ls.pod:240 +msgid "The inode number." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1189 -msgid "PROTOCOL SECURITY" +#. type: =item +#: ../cat/virt-ls.pod:242 ../libguestfs-1.11.19/cat/virt-ls.pod:242 +msgid "nlink" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1191 -msgid "" -"The protocol is designed to be secure, being based on RFC 4506 (XDR) with a " -"defined upper message size. However a program that uses libguestfs must " -"also take care - for example you can write a program that downloads a binary " -"from a disk image and executes it locally, and no amount of protocol " -"security will save you from the consequences." +#: ../cat/virt-ls.pod:244 ../libguestfs-1.11.19/cat/virt-ls.pod:244 +msgid "The number of hard links." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1197 -msgid "INSPECTION SECURITY" +#. type: =item +#: ../cat/virt-ls.pod:246 ../libguestfs-1.11.19/cat/virt-ls.pod:246 +msgid "rdev" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1199 -msgid "" -"Parts of the inspection API (see L</INSPECTION>) return untrusted strings " -"directly from the guest, and these could contain any 8 bit data. Callers " -"should be careful to escape these before printing them to a structured file " -"(for example, use HTML escaping if creating a web page)." +#: ../cat/virt-ls.pod:248 ../libguestfs-1.11.19/cat/virt-ls.pod:248 +msgid "For block and char special files, the device (displayed as major:minor)." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1205 -msgid "" -"Guest configuration may be altered in unusual ways by the administrator of " -"the virtual machine, and may not reflect reality (particularly for untrusted " -"or actively malicious guests). For example we parse the hostname from " -"configuration files like C</etc/sysconfig/network> that we find in the " -"guest, but the guest administrator can easily manipulate these files to " -"provide the wrong hostname." +#. type: =item +#: ../cat/virt-ls.pod:251 ../libguestfs-1.11.19/cat/virt-ls.pod:251 +msgid "blocks" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1213 -msgid "" -"The inspection API parses guest configuration using two external libraries: " -"Augeas (Linux configuration) and hivex (Windows Registry). Both are " -"designed to be robust in the face of malicious data, although denial of " -"service attacks are still possible, for example with oversized configuration " -"files." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1219 -msgid "RUNNING UNTRUSTED GUEST COMMANDS" +#: ../cat/virt-ls.pod:253 ../libguestfs-1.11.19/cat/virt-ls.pod:253 +msgid "The number of 512 byte blocks allocated to the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1221 +#: ../cat/virt-ls.pod:257 ../libguestfs-1.11.19/cat/virt-ls.pod:257 msgid "" -"Be very cautious about running commands from the guest. By running a " -"command in the guest, you are giving CPU time to a binary that you do not " -"control, under the same user account as the library, albeit wrapped in qemu " -"virtualization. More information and alternatives can be found in the " -"section L</RUNNING COMMANDS>." +"With the I<--checksum> flag, the checksum of the file contents is shown " +"(only for regular files). Computing file checksums can take a considerable " +"amount of time." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1227 -msgid "CVE-2010-3851" +#. type: =item +#: ../cat/virt-ls.pod:280 ../libguestfs-1.11.19/cat/virt-ls.pod:280 +msgid "B<--checksum>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1229 -msgid "https://bugzilla.redhat.com/642934" +#. type: =item +#: ../cat/virt-ls.pod:282 ../libguestfs-1.11.19/cat/virt-ls.pod:282 +msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1231 +#: ../cat/virt-ls.pod:284 ../libguestfs-1.11.19/cat/virt-ls.pod:284 msgid "" -"This security bug concerns the automatic disk format detection that qemu " -"does on disk images." +"Display checksum over file contents for regular files. With no argument, " +"this defaults to using I<md5>. Using an argument, you can select the " +"checksum type to use." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1234 +#: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358 ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408 ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422 ../libguestfs-1.11.19/cat/virt-ls.pod:288 ../libguestfs-1.11.19/cat/virt-ls.pod:325 ../libguestfs-1.11.19/cat/virt-ls.pod:358 ../libguestfs-1.11.19/cat/virt-ls.pod:391 ../libguestfs-1.11.19/cat/virt-ls.pod:401 ../libguestfs-1.11.19/cat/virt-ls.pod:408 ../libguestfs-1.11.19/cat/virt-ls.pod:415 ../libguestfs-1.11.19/cat/virt-ls.pod:422 msgid "" -"A raw disk image is just the raw bytes, there is no header. Other disk " -"images like qcow2 contain a special header. Qemu deals with this by looking " -"for one of the known headers, and if none is found then assuming the disk " -"image must be raw." +"This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG " +"LISTING> above." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1239 +#: ../cat/virt-ls.pod:316 ../libguestfs-1.11.19/cat/virt-ls.pod:316 msgid "" -"This allows a guest which has been given a raw disk image to write some " -"other header. At next boot (or when the disk image is accessed by " -"libguestfs) qemu would do autodetection and think the disk image format was, " -"say, qcow2 based on the header written by the guest." +"When prompting for keys and passphrases, virt-ls normally turns echoing off " +"so you cannot see what you are typing. If you are not worried about Tempest " +"attacks and there is no one else in the room you can specify this flag to " +"see what you are typing." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1244 -msgid "" -"This in itself would not be a problem, but qcow2 offers many features, one " -"of which is to allow a disk image to refer to another image (called the " -"\"backing disk\"). It does this by placing the path to the backing disk " -"into the qcow2 header. This path is not validated and could point to any " -"host file (eg. \"/etc/passwd\"). The backing disk is then exposed through " -"\"holes\" in the qcow2 disk image, which of course is completely under the " -"control of the attacker." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1252 -msgid "In libguestfs this is rather hard to exploit except under two circumstances:" +#. type: =item +#: ../cat/virt-ls.pod:321 ../libguestfs-1.11.19/cat/virt-ls.pod:321 +msgid "B<--extra-stats>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1259 -msgid "You have enabled the network or have opened the disk in write mode." +#: ../cat/virt-ls.pod:323 ../libguestfs-1.11.19/cat/virt-ls.pod:323 +msgid "Display extra stats." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1263 -msgid "" -"You are also running untrusted code from the guest (see L</RUNNING " -"COMMANDS>)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1268 +#. type: verbatim +#: ../cat/virt-ls.pod:339 ../libguestfs-1.11.19/cat/virt-ls.pod:339 +#, no-wrap msgid "" -"The way to avoid this is to specify the expected disk format when adding " -"disks (the optional C<format> option to L</guestfs_add_drive_opts>). You " -"should always do this if the disk is raw format, and it's a good idea for " -"other cases too." +" virt-ls --format=raw -a disk.img /dir\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1273 +#. type: verbatim +#: ../cat/virt-ls.pod:343 ../libguestfs-1.11.19/cat/virt-ls.pod:343 +#, no-wrap msgid "" -"For disks added from libvirt using calls like L</guestfs_add_domain>, the " -"format is fetched from libvirt and passed through." +" virt-ls --format=raw -a disk.img --format -a another.img /dir\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1276 -msgid "" -"For libguestfs tools, use the I<--format> command line parameter as " -"appropriate." +#: ../cat/virt-ls.pod:356 ../libguestfs-1.11.19/cat/virt-ls.pod:356 +msgid "Display file sizes in human-readable format." msgstr "" -#. type: =head1 -#: ../src/guestfs.pod:1279 -msgid "CONNECTION MANAGEMENT" +#. type: =item +#: ../cat/virt-ls.pod:370 ../libguestfs-1.11.19/cat/virt-ls.pod:370 +msgid "B<-R>" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1281 -msgid "guestfs_h *" +#. type: =item +#: ../cat/virt-ls.pod:372 ../libguestfs-1.11.19/cat/virt-ls.pod:372 +msgid "B<--recursive>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1283 +#: ../cat/virt-ls.pod:374 ../libguestfs-1.11.19/cat/virt-ls.pod:374 msgid "" -"C<guestfs_h> is the opaque type representing a connection handle. Create a " -"handle by calling L</guestfs_create>. Call L</guestfs_close> to free the " -"handle and release all resources used." +"Select the mode. With neither of these options, C<virt-ls> produces a " +"simple, flat list of the files in the named directory. See L</SIMPLE " +"LISTING>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1287 +#: ../cat/virt-ls.pod:378 ../libguestfs-1.11.19/cat/virt-ls.pod:378 msgid "" -"For information on using multiple handles and threads, see the section " -"L</MULTIPLE HANDLES AND MULTIPLE THREADS> above." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1290 -msgid "guestfs_create" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1292 -#, no-wrap -msgid "" -" guestfs_h *guestfs_create (void);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1294 -msgid "Create a connection handle." +"C<virt-ls -l> produces a \"long listing\", which shows more detail. See " +"L</LONG LISTING>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1296 +#: ../cat/virt-ls.pod:381 ../libguestfs-1.11.19/cat/virt-ls.pod:381 msgid "" -"On success this returns a non-NULL pointer to a handle. On error it returns " -"NULL." +"C<virt-ls -R> produces a recursive list of files starting at the named " +"directory. See L</RECURSIVE LISTING>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1299 +#: ../cat/virt-ls.pod:384 ../libguestfs-1.11.19/cat/virt-ls.pod:384 msgid "" -"You have to \"configure\" the handle after creating it. This includes " -"calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the " -"handle at least once." +"C<virt-ls -lR> produces a recursive long listing which can be more easily " +"parsed. See L</RECURSIVE LONG LISTING>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1303 -msgid "After configuring the handle, you have to call L</guestfs_launch>." +#. type: =item +#: ../cat/virt-ls.pod:387 ../libguestfs-1.11.19/cat/virt-ls.pod:387 +msgid "B<--times>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1305 -msgid "" -"You may also want to configure error handling for the handle. See the " -"L</ERROR HANDLING> section below." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1308 -msgid "guestfs_close" +#: ../cat/virt-ls.pod:389 ../libguestfs-1.11.19/cat/virt-ls.pod:389 +msgid "Display time fields." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:1310 -#, no-wrap -msgid "" -" void guestfs_close (guestfs_h *g);\n" -"\n" +#. type: =item +#: ../cat/virt-ls.pod:394 ../libguestfs-1.11.19/cat/virt-ls.pod:394 +msgid "B<--time-days>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1312 -msgid "This closes the connection handle and frees up all resources used." +#: ../cat/virt-ls.pod:396 ../libguestfs-1.11.19/cat/virt-ls.pod:396 +msgid "Display time fields as days before now (negative if in the future)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1314 +#: ../cat/virt-ls.pod:398 ../libguestfs-1.11.19/cat/virt-ls.pod:398 msgid "" -"If autosync was set on the handle and the handle was launched, then this " -"implicitly calls various functions to unmount filesystems and sync the " -"disk. See L</guestfs_set_autosync> for more details." +"Note that C<0> in output means \"up to 1 day before now\", or that the age " +"of the file is between 0 and 86399 seconds." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1318 -msgid "If a close callback was set on the handle, then it is called." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:1320 -msgid "ERROR HANDLING" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1322 -msgid "" -"API functions can return errors. For example, almost all functions that " -"return C<int> will return C<-1> to indicate an error." +#. type: =item +#: ../cat/virt-ls.pod:404 ../libguestfs-1.11.19/cat/virt-ls.pod:404 +msgid "B<--time-relative>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1325 -msgid "" -"Additional information is available for errors: an error message string and " -"optionally an error number (errno) if the thing that failed was a system " -"call." +#: ../cat/virt-ls.pod:406 ../libguestfs-1.11.19/cat/virt-ls.pod:406 +msgid "Display time fields as seconds before now (negative if in the future)." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1329 -msgid "" -"You can get at the additional information about the last error on the handle " -"by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting " -"up an error handler with L</guestfs_set_error_handler>." +#. type: =item +#: ../cat/virt-ls.pod:411 ../libguestfs-1.11.19/cat/virt-ls.pod:411 +msgid "B<--time-t>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1334 -msgid "" -"When the handle is created, a default error handler is installed which " -"prints the error message string to C<stderr>. For small short-running " -"command line programs it is sufficient to do:" +#: ../cat/virt-ls.pod:413 ../libguestfs-1.11.19/cat/virt-ls.pod:413 +msgid "Display time fields as seconds since the Unix epoch." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:1338 -#, no-wrap -msgid "" -" if (guestfs_launch (g) == -1)\n" -" exit (EXIT_FAILURE);\n" -"\n" +#. type: =item +#: ../cat/virt-ls.pod:418 ../libguestfs-1.11.19/cat/virt-ls.pod:418 +msgid "B<--uids>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1341 -msgid "" -"since the default error handler will ensure that an error message has been " -"printed to C<stderr> before the program exits." +#: ../cat/virt-ls.pod:420 ../libguestfs-1.11.19/cat/virt-ls.pod:420 +msgid "Display UID and GID fields." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1344 -msgid "" -"For other programs the caller will almost certainly want to install an " -"alternate error handler or do error handling in-line like this:" +#: ../cat/virt-ls.pod:445 ../libguestfs-1.11.19/cat/virt-ls.pod:445 +msgid "Previous versions of virt-ls allowed you to write either:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1347 +#: ../cat/virt-ls.pod:447 ../libguestfs-1.11.19/cat/virt-ls.pod:447 #, no-wrap msgid "" -" g = guestfs_create ();\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1349 -#, no-wrap -msgid "" -" /* This disables the default behaviour of printing errors\n" -" on stderr. */\n" -" guestfs_set_error_handler (g, NULL, NULL);\n" -" \n" +" virt-ls disk.img [disk.img ...] /dir\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1353 +#: ../cat/virt-ls.pod:451 ../libguestfs-1.11.19/cat/virt-ls.pod:451 #, no-wrap msgid "" -" if (guestfs_launch (g) == -1) {\n" -" /* Examine the error message and print it etc. */\n" -" char *msg = guestfs_last_error (g);\n" -" int errnum = guestfs_last_errno (g);\n" -" fprintf (stderr, \"%s\\n\", msg);\n" -" /* ... */\n" -" }\n" +" virt-ls guestname /dir\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1361 +#: ../cat/virt-ls.pod:492 ../libguestfs-1.11.19/cat/virt-ls.pod:492 msgid "" -"Out of memory errors are handled differently. The default action is to call " -"L<abort(3)>. If this is undesirable, then you can set a handler using " -"L</guestfs_set_out_of_memory_handler>." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, " +"L<virt-tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, " +"L<Sys::Virt(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1365 -msgid "" -"L</guestfs_create> returns C<NULL> if the handle cannot be created, and " -"because there is no handle if this happens there is no way to get additional " -"error information. However L</guestfs_create> is supposed to be a " -"lightweight operation which can only fail because of insufficient memory (it " -"returns NULL in this case)." +#: ../cat/virt-ls.pod:508 ../df/virt-df.pod:230 ../edit/virt-edit.pod:369 ../libguestfs-1.11.19/cat/virt-ls.pod:508 ../libguestfs-1.11.19/df/virt-df.pod:230 ../libguestfs-1.11.19/edit/virt-edit.pod:369 ../libguestfs-1.11.19/rescue/virt-rescue.pod:298 ../rescue/virt-rescue.pod:298 +msgid "Copyright (C) 2009-2011 Red Hat Inc." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1371 -msgid "guestfs_last_error" +#. type: textblock +#: ../df/virt-df.pod:5 ../libguestfs-1.11.19/df/virt-df.pod:5 +msgid "virt-df - Display free space on virtual filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1373 +#: ../df/virt-df.pod:9 ../libguestfs-1.11.19/df/virt-df.pod:9 #, no-wrap msgid "" -" const char *guestfs_last_error (guestfs_h *g);\n" +" virt-df [--options]\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1375 -msgid "" -"This returns the last error message that happened on C<g>. If there has not " -"been an error since the handle was created, then this returns C<NULL>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1379 -msgid "" -"The lifetime of the returned string is until the next error occurs, or " -"L</guestfs_close> is called." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1382 -msgid "guestfs_last_errno" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:1384 +#: ../df/virt-df.pod:11 ../libguestfs-1.11.19/df/virt-df.pod:11 #, no-wrap msgid "" -" int guestfs_last_errno (guestfs_h *g);\n" +" virt-df [--options] -d domname\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1386 -msgid "This returns the last error number (errno) that happened on C<g>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1388 -msgid "If successful, an errno integer not equal to zero is returned." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1390 -msgid "If no error, this returns 0. This call can return 0 in three situations:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1397 -msgid "There has not been any error on the handle." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1401 -msgid "" -"There has been an error but the errno was meaningless. This corresponds to " -"the case where the error did not come from a failed system call, but for " -"some other reason." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1407 +#. type: verbatim +#: ../df/virt-df.pod:13 ../libguestfs-1.11.19/df/virt-df.pod:13 +#, no-wrap msgid "" -"There was an error from a failed system call, but for some reason the errno " -"was not captured and returned. This usually indicates a bug in libguestfs." +" virt-df [--options] -a disk.img [-a disk.img ...]\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1413 +#. type: verbatim +#: ../df/virt-df.pod:17 ../libguestfs-1.11.19/df/virt-df.pod:17 +#, no-wrap msgid "" -"Libguestfs tries to convert the errno from inside the applicance into a " -"corresponding errno for the caller (not entirely trivial: the appliance " -"might be running a completely different operating system from the library " -"and error numbers are not standardized across Un*xen). If this could not be " -"done, then the error is translated to C<EINVAL>. In practice this should " -"only happen in very rare circumstances." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1421 -msgid "guestfs_set_error_handler" +" virt-df [--options] domname\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1423 +#: ../df/virt-df.pod:19 ../libguestfs-1.11.19/df/virt-df.pod:19 #, no-wrap msgid "" -" typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" -" void *opaque,\n" -" const char *msg);\n" -" void guestfs_set_error_handler (guestfs_h *g,\n" -" guestfs_error_handler_cb cb,\n" -" void *opaque);\n" +" virt-df [--options] disk.img [disk.img ...]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1430 +#: ../df/virt-df.pod:23 ../libguestfs-1.11.19/df/virt-df.pod:23 msgid "" -"The callback C<cb> will be called if there is an error. The parameters " -"passed to the callback are an opaque data pointer and the error message " -"string." +"C<virt-df> is a command line tool to display free space on virtual machine " +"filesystems. Unlike other tools, it doesn't just display the size of disk " +"allocated to a virtual machine, but can look inside disk images to see how " +"much space is really being used." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1434 +#: ../df/virt-df.pod:28 ../libguestfs-1.11.19/df/virt-df.pod:28 msgid "" -"C<errno> is not passed to the callback. To get that the callback must call " -"L</guestfs_last_errno>." +"If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt " +"to get a list of all active and inactive guests, and performs a C<df>-type " +"operation on each one in turn, printing out the results." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1437 +#: ../df/virt-df.pod:32 ../libguestfs-1.11.19/df/virt-df.pod:32 msgid "" -"Note that the message string C<msg> is freed as soon as the callback " -"function returns, so if you want to stash it somewhere you must make your " -"own copy." +"If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a " +"C<df>-type operation on either the single named libvirt domain, or on the " +"disk image(s) listed on the command line (which must all belong to a single " +"VM). In this mode (with arguments), C<virt-df> will I<only work for a " +"single guest>. If you want to run on multiple guests, then you have to " +"invoke C<virt-df> multiple times." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1441 -msgid "The default handler prints messages on C<stderr>." +#: ../df/virt-df.pod:39 ../libguestfs-1.11.19/df/virt-df.pod:39 +msgid "" +"Use the I<--csv> option to get a format which can be easily parsed by other " +"programs. Other options are similar to the standard L<df(1)> command." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1443 -msgid "If you set C<cb> to C<NULL> then I<no> handler is called." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1445 -msgid "guestfs_get_error_handler" +#: ../df/virt-df.pod:45 ../libguestfs-1.11.19/df/virt-df.pod:45 +msgid "" +"Show disk usage for a single libvirt guest called C<F14x64>. Make the " +"output human-readable:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1447 +#: ../df/virt-df.pod:48 ../libguestfs-1.11.19/df/virt-df.pod:48 #, no-wrap msgid "" -" guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" -" void **opaque_rtn);\n" +" # virt-df -d F14x64 -h\n" +" Filesystem Size Used Available Use%\n" +" F14x64:/dev/sda1 484M 66M 393M 14%\n" +" F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1450 -msgid "Returns the current error handler callback." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1452 -msgid "guestfs_set_out_of_memory_handler" +#: ../df/virt-df.pod:53 ../libguestfs-1.11.19/df/virt-df.pod:53 +msgid "Show disk usage for a disk image file called C<test.img>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1454 +#: ../df/virt-df.pod:55 ../libguestfs-1.11.19/df/virt-df.pod:55 #, no-wrap msgid "" -" typedef void (*guestfs_abort_cb) (void);\n" -" int guestfs_set_out_of_memory_handler (guestfs_h *g,\n" -" guestfs_abort_cb);\n" +" $ virt-df -a test1.img\n" +" Filesystem 1K-blocks Used Available Use%\n" +" test1.img:/dev/sda1 99099 1551 92432 2%\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1458 +#. type: verbatim +#: ../df/virt-df.pod:106 ../libguestfs-1.11.19/df/virt-df.pod:106 +#, no-wrap msgid "" -"The callback C<cb> will be called if there is an out of memory situation. " -"I<Note this callback must not return>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1461 -msgid "The default is to call L<abort(3)>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1463 -msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1466 -msgid "guestfs_get_out_of_memory_handler" +" virt-df --format=raw -a disk.img\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1468 +#: ../df/virt-df.pod:110 ../libguestfs-1.11.19/df/virt-df.pod:110 #, no-wrap msgid "" -" guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" +" virt-df --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1470 -msgid "This returns the current out of memory handler." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:1472 -msgid "API CALLS" +#: ../df/virt-df.pod:123 ../libguestfs-1.11.19/df/virt-df.pod:123 +msgid "Print sizes in human-readable format." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1068 -msgid "@ACTIONS@" +#: ../df/virt-df.pod:125 ../libguestfs-1.11.19/df/virt-df.pod:125 +msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" -#. type: =head1 -#: ../src/guestfs.pod:1476 -msgid "STRUCTURES" +#. type: =item +#: ../df/virt-df.pod:127 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155 ../libguestfs-1.11.19/df/virt-df.pod:127 ../libguestfs-1.11.19/fish/guestfish.pod:258 ../libguestfs-1.11.19/fuse/guestmount.pod:155 +msgid "B<-i>" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1478 -msgid "@STRUCTS@" +#. type: =item +#: ../df/virt-df.pod:129 ../libguestfs-1.11.19/df/virt-df.pod:129 +msgid "B<--inodes>" msgstr "" -#. type: =head1 -#: ../src/guestfs.pod:1480 -msgid "AVAILABILITY" +#. type: textblock +#: ../df/virt-df.pod:131 ../libguestfs-1.11.19/df/virt-df.pod:131 +msgid "Print inodes instead of blocks." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1482 -msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" +#. type: =item +#: ../df/virt-df.pod:133 ../libguestfs-1.11.19/df/virt-df.pod:133 +msgid "B<--one-per-guest>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1484 +#: ../df/virt-df.pod:135 ../libguestfs-1.11.19/df/virt-df.pod:135 msgid "" -"Using L</guestfs_available> you can test availability of the following " -"groups of functions. This test queries the appliance to see if the " -"appliance you are currently using supports the functionality." +"Run one libguestfs appliance per guest. Normally C<virt-df> will add the " +"disks from several guests to a single libguestfs appliance." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1489 -msgid "@AVAILABILITY@" +#: ../df/virt-df.pod:138 ../libguestfs-1.11.19/df/virt-df.pod:138 +msgid "You might use this option in the following circumstances:" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1491 -msgid "GUESTFISH supported COMMAND" +#. type: =item +#: ../df/virt-df.pod:142 ../df/virt-df.pod:148 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../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 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:384 ../inspector/virt-inspector.pod:388 ../libguestfs-1.11.19/df/virt-df.pod:142 ../libguestfs-1.11.19/df/virt-df.pod:148 ../libguestfs-1.11.19/edit/virt-edit.pod:266 ../libguestfs-1.11.19/edit/virt-edit.pod:271 ../libguestfs-1.11.19/edit/virt-edit.pod:276 ../libguestfs-1.11.19/edit/virt-edit.pod:287 ../libguestfs-1.11.19/edit/virt-edit.pod:291 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:98 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:102 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:106 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:132 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:137 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:227 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:231 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:235 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:239 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:243 ../libguestfs-1.11.19/fish/guestfish-actions.pod:13 ../libguestfs-1.11.19/fish/guestfish-actions.pod:20 ../libguestfs-1.11.19/fish/guestfish-actions.pod:385 ../libguestfs-1.11.19/fish/guestfish-actions.pod:393 ../libguestfs-1.11.19/fish/guestfish-actions.pod:400 ../libguestfs-1.11.19/fish/guestfish-actions.pod:407 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1099 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1103 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1107 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1111 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1119 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1123 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1127 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1137 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1141 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1145 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1235 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1239 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1244 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1249 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1291 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1295 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1300 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1933 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1939 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1947 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1954 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1961 ../libguestfs-1.11.19/fish/guestfish.pod:445 ../libguestfs-1.11.19/fish/guestfish.pod:449 ../libguestfs-1.11.19/fish/guestfish.pod:453 ../libguestfs-1.11.19/fish/guestfish.pod:457 ../libguestfs-1.11.19/inspector/virt-inspector.pod:384 ../libguestfs-1.11.19/inspector/virt-inspector.pod:388 ../libguestfs-1.11.19/resize/virt-resize.pod:282 ../libguestfs-1.11.19/resize/virt-resize.pod:286 ../libguestfs-1.11.19/resize/virt-resize.pod:295 ../libguestfs-1.11.19/resize/virt-resize.pod:301 ../libguestfs-1.11.19/src/guestfs-actions.pod:15 ../libguestfs-1.11.19/src/guestfs-actions.pod:22 ../libguestfs-1.11.19/src/guestfs-actions.pod:583 ../libguestfs-1.11.19/src/guestfs-actions.pod:591 ../libguestfs-1.11.19/src/guestfs-actions.pod:598 ../libguestfs-1.11.19/src/guestfs-actions.pod:605 ../libguestfs-1.11.19/src/guestfs-actions.pod:1662 ../libguestfs-1.11.19/src/guestfs-actions.pod:1666 ../libguestfs-1.11.19/src/guestfs-actions.pod:1670 ../libguestfs-1.11.19/src/guestfs-actions.pod:1674 ../libguestfs-1.11.19/src/guestfs-actions.pod:1682 ../libguestfs-1.11.19/src/guestfs-actions.pod:1686 ../libguestfs-1.11.19/src/guestfs-actions.pod:1690 ../libguestfs-1.11.19/src/guestfs-actions.pod:1700 ../libguestfs-1.11.19/src/guestfs-actions.pod:1704 ../libguestfs-1.11.19/src/guestfs-actions.pod:1708 ../libguestfs-1.11.19/src/guestfs-actions.pod:1846 ../libguestfs-1.11.19/src/guestfs-actions.pod:1850 ../libguestfs-1.11.19/src/guestfs-actions.pod:1855 ../libguestfs-1.11.19/src/guestfs-actions.pod:1860 ../libguestfs-1.11.19/src/guestfs-actions.pod:1921 ../libguestfs-1.11.19/src/guestfs-actions.pod:1925 ../libguestfs-1.11.19/src/guestfs-actions.pod:1930 ../libguestfs-1.11.19/src/guestfs-actions.pod:2859 ../libguestfs-1.11.19/src/guestfs-actions.pod:2865 ../libguestfs-1.11.19/src/guestfs-actions.pod:2873 ../libguestfs-1.11.19/src/guestfs-actions.pod:2880 ../libguestfs-1.11.19/src/guestfs-actions.pod:2887 ../libguestfs-1.11.19/src/guestfs.pod:388 ../libguestfs-1.11.19/src/guestfs.pod:393 ../libguestfs-1.11.19/src/guestfs.pod:398 ../libguestfs-1.11.19/src/guestfs.pod:402 ../libguestfs-1.11.19/src/guestfs.pod:407 ../libguestfs-1.11.19/src/guestfs.pod:411 ../libguestfs-1.11.19/src/guestfs.pod:416 ../libguestfs-1.11.19/src/guestfs.pod:421 ../libguestfs-1.11.19/src/guestfs.pod:1064 ../libguestfs-1.11.19/src/guestfs.pod:1068 ../libguestfs-1.11.19/src/guestfs.pod:1072 ../libguestfs-1.11.19/src/guestfs.pod:1077 ../libguestfs-1.11.19/src/guestfs.pod:1085 ../libguestfs-1.11.19/src/guestfs.pod:1104 ../libguestfs-1.11.19/src/guestfs.pod:1112 ../libguestfs-1.11.19/src/guestfs.pod:1134 ../libguestfs-1.11.19/src/guestfs.pod:1138 ../libguestfs-1.11.19/src/guestfs.pod:1142 ../libguestfs-1.11.19/src/guestfs.pod:1146 ../libguestfs-1.11.19/src/guestfs.pod:1150 ../libguestfs-1.11.19/src/guestfs.pod:1154 ../libguestfs-1.11.19/src/guestfs.pod:1643 ../libguestfs-1.11.19/src/guestfs.pod:1648 ../libguestfs-1.11.19/src/guestfs.pod:1652 ../libguestfs-1.11.19/src/guestfs.pod:1754 ../libguestfs-1.11.19/src/guestfs.pod:1759 ../libguestfs-1.11.19/src/guestfs.pod:1763 ../libguestfs-1.11.19/src/guestfs.pod:1773 ../libguestfs-1.11.19/src/guestfs.pod:2047 ../libguestfs-1.11.19/src/guestfs.pod:2052 ../libguestfs-1.11.19/src/guestfs.pod:2058 ../libguestfs-1.11.19/src/guestfs.pod:2066 ../libguestfs-1.11.19/src/guestfs.pod:2420 ../libguestfs-1.11.19/src/guestfs.pod:2426 ../libguestfs-1.11.19/src/guestfs.pod:2431 ../libguestfs-1.11.19/src/guestfs.pod:2437 ../libguestfs-1.11.19/src/guestfs.pod:2818 ../libguestfs-1.11.19/src/guestfs.pod:2822 ../libguestfs-1.11.19/src/guestfs.pod:2826 ../libguestfs-1.11.19/src/guestfs.pod:2830 ../libguestfs-1.11.19/src/guestfs.pod:2844 ../libguestfs-1.11.19/src/guestfs.pod:2849 ../libguestfs-1.11.19/src/guestfs.pod:3061 ../libguestfs-1.11.19/src/guestfs.pod:3065 ../libguestfs-1.11.19/src/guestfs.pod:3069 ../libguestfs-1.11.19/src/guestfs.pod:3073 ../resize/virt-resize.pod:282 ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295 ../resize/virt-resize.pod:301 ../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:2859 ../src/guestfs-actions.pod:2865 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2887 ../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:2818 ../src/guestfs.pod:2822 ../src/guestfs.pod:2826 ../src/guestfs.pod:2830 ../src/guestfs.pod:2844 ../src/guestfs.pod:2849 ../src/guestfs.pod:3061 ../src/guestfs.pod:3065 ../src/guestfs.pod:3069 ../src/guestfs.pod:3073 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710 ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722 +msgid "*" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1493 +#: ../df/virt-df.pod:144 ../libguestfs-1.11.19/df/virt-df.pod:144 msgid "" -"In L<guestfish(3)> there is a handy interactive command C<supported> which " -"prints out the available groups and whether they are supported by this build " -"of libguestfs. Note however that you have to do C<run> first." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1498 -msgid "SINGLE CALLS AT COMPILE TIME" +"If you think an untrusted guest might actively try to exploit the libguestfs " +"appliance kernel, then this prevents one guest from interfering with the " +"stats printed for another guest." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1500 +#: ../df/virt-df.pod:150 ../libguestfs-1.11.19/df/virt-df.pod:150 msgid "" -"Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API " -"function, such as:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1503 -#, no-wrap -msgid "" -" #define LIBGUESTFS_HAVE_DD 1\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1505 -msgid "if L</guestfs_dd> is available." +"If the kernel has a bug which stops it from accessing a filesystem in one " +"guest (see for example RHBZ#635373) then this allows libguestfs to continue " +"and report stats for further guests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1507 +#: ../df/virt-df.pod:159 ../libguestfs-1.11.19/df/virt-df.pod:159 msgid "" -"Before version 1.5.8, if you needed to test whether a single libguestfs " -"function is available at compile time, we recommended using build tools such " -"as autoconf or cmake. For example in autotools you could use:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1512 -#, no-wrap -msgid "" -" AC_CHECK_LIB([guestfs],[guestfs_create])\n" -" AC_CHECK_FUNCS([guestfs_dd])\n" -"\n" +"Print UUIDs instead of names. This is useful for following a guest even " +"when the guest is migrated or renamed, or when two guests happen to have the " +"same name." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1515 +#: ../df/virt-df.pod:163 ../libguestfs-1.11.19/df/virt-df.pod:163 msgid "" -"which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " -"in your program." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1518 -msgid "SINGLE CALLS AT RUN TIME" +"Note that only domains that we fetch from libvirt come with UUIDs. For disk " +"images, we still print the disk image name even when this option is " +"specified." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1520 +#: ../df/virt-df.pod:218 ../libguestfs-1.11.19/df/virt-df.pod:218 msgid "" -"Testing at compile time doesn't guarantee that a function really exists in " -"the library. The reason is that you might be dynamically linked against a " -"previous I<libguestfs.so> (dynamic library) which doesn't have the call. " -"This situation unfortunately results in a segmentation fault, which is a " -"shortcoming of the C dynamic linking system itself." +"L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, " +"L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1527 -msgid "" -"You can use L<dlopen(3)> to test if a function is available at run time, as " -"in this example program (note that you still need the compile time check as " -"well):" +#: ../edit/virt-edit.pod:5 ../libguestfs-1.11.19/edit/virt-edit.pod:5 +msgid "virt-edit - Edit a file in a virtual machine" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1531 +#: ../edit/virt-edit.pod:9 ../libguestfs-1.11.19/edit/virt-edit.pod:9 #, no-wrap msgid "" -" #include <stdio.h>\n" -" #include <stdlib.h>\n" -" #include <unistd.h>\n" -" #include <dlfcn.h>\n" -" #include <guestfs.h>\n" -" \n" +" virt-edit [--options] -d domname file [file ...]\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1537 +#: ../edit/virt-edit.pod:11 ../libguestfs-1.11.19/edit/virt-edit.pod:11 #, no-wrap msgid "" -" main ()\n" -" {\n" -" #ifdef LIBGUESTFS_HAVE_DD\n" -" void *dl;\n" -" int has_function;\n" -" \n" +" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1543 +#: ../edit/virt-edit.pod:13 ../libguestfs-1.11.19/edit/virt-edit.pod:13 #, no-wrap msgid "" -" /* Test if the function guestfs_dd is really available. */\n" -" dl = dlopen (NULL, RTLD_LAZY);\n" -" if (!dl) {\n" -" fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n" -" exit (EXIT_FAILURE);\n" -" }\n" -" has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n" -" dlclose (dl);\n" -" \n" +" virt-edit [-d domname|-a disk.img] file -e 'expr'\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1552 +#: ../edit/virt-edit.pod:17 ../libguestfs-1.11.19/edit/virt-edit.pod:17 #, no-wrap msgid "" -" if (!has_function)\n" -" printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n" -" else {\n" -" printf (\"this libguestfs.so has guestfs_dd function\\n\");\n" -" /* Now it's safe to call\n" -" guestfs_dd (g, \"foo\", \"bar\");\n" -" */\n" -" }\n" -" #else\n" -" printf (\"guestfs_dd function was not found at compile time\\n\");\n" -" #endif\n" -" }\n" +" virt-edit domname file\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1565 -msgid "" -"You may think the above is an awful lot of hassle, and it is. There are " -"other ways outside of the C linking system to ensure that this kind of " -"incompatibility never arises, such as using package versioning:" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:1570 +#: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183 ../libguestfs-1.11.19/edit/virt-edit.pod:19 ../libguestfs-1.11.19/edit/virt-edit.pod:183 #, no-wrap msgid "" -" Requires: libguestfs >= 1.0.80\n" +" virt-edit disk.img [disk.img ...] file\n" "\n" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1572 -msgid "CALLS WITH OPTIONAL ARGUMENTS" +#: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 ../fuse/guestmount.pod:15 ../libguestfs-1.11.19/edit/virt-edit.pod:21 ../libguestfs-1.11.19/fish/guestfish.pod:23 ../libguestfs-1.11.19/fish/virt-copy-in.pod:13 ../libguestfs-1.11.19/fish/virt-tar-in.pod:15 ../libguestfs-1.11.19/fuse/guestmount.pod:15 ../libguestfs-1.11.19/rescue/virt-rescue.pod:19 ../rescue/virt-rescue.pod:19 ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 +msgid "WARNING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1574 +#: ../edit/virt-edit.pod:23 ../libguestfs-1.11.19/edit/virt-edit.pod:23 msgid "" -"A recent feature of the API is the introduction of calls which take optional " -"arguments. In C these are declared 3 ways. The main way is as a call which " -"takes variable arguments (ie. C<...>), as in this example:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1579 -#, no-wrap -msgid "" -" int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" -"\n" +"You must I<not> use C<virt-edit> on live virtual machines. If you do this, " +"you risk disk corruption in the VM. C<virt-edit> tries to stop you from " +"doing this, but doesn't catch all cases." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1581 -msgid "" -"Call this with a list of optional arguments, terminated by C<-1>. So to " -"call with no optional arguments specified:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1584 -#, no-wrap +#: ../edit/virt-edit.pod:29 ../libguestfs-1.11.19/edit/virt-edit.pod:29 msgid "" -" guestfs_add_drive_opts (g, filename, -1);\n" -"\n" +"C<virt-edit> is a command line tool to edit C<file> where each C<file> " +"exists in the named virtual machine (or disk image)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1586 -msgid "With a single optional argument:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1588 -#, no-wrap +#: ../edit/virt-edit.pod:32 ../libguestfs-1.11.19/edit/virt-edit.pod:32 msgid "" -" guestfs_add_drive_opts (g, filename,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n" -" -1);\n" -"\n" +"Multiple filenames can be given, in which case they are each edited in " +"turn. Each filename must be a full path, starting at the root directory " +"(starting with '/')." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1592 -msgid "With two:" +#: ../edit/virt-edit.pod:36 ../libguestfs-1.11.19/edit/virt-edit.pod:36 +msgid "If you want to just view a file, use L<virt-cat(1)>." msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:1594 -#, no-wrap +#. type: textblock +#: ../edit/virt-edit.pod:38 ../libguestfs-1.11.19/edit/virt-edit.pod:38 msgid "" -" guestfs_add_drive_opts (g, filename,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n" -" GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n" -" -1);\n" -"\n" +"For more complex cases you should look at the L<guestfish(1)> tool (see " +"L</USING GUESTFISH> below)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1599 +#: ../edit/virt-edit.pod:41 ../libguestfs-1.11.19/edit/virt-edit.pod:41 msgid "" -"and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " -"happen!" -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1602 -msgid "USING va_list FOR OPTIONAL ARGUMENTS" +"C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do " +"that and much more." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1604 -msgid "" -"The second variant has the same name with the suffix C<_va>, which works the " -"same way but takes a C<va_list>. See the C manual for details. For the " -"example function, this is declared:" +#: ../edit/virt-edit.pod:46 ../libguestfs-1.11.19/edit/virt-edit.pod:46 +msgid "Edit the named files interactively:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1608 +#: ../edit/virt-edit.pod:48 ../libguestfs-1.11.19/edit/virt-edit.pod:48 #, no-wrap msgid "" -" int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" -" va_list args);\n" +" virt-edit -d mydomain /boot/grub/grub.conf\n" "\n" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:1611 -msgid "CONSTRUCTING OPTIONAL ARGUMENTS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1613 -msgid "" -"The third variant is useful where you need to construct these calls. You " -"pass in a structure where you fill in the optional fields. The structure " -"has a bitmask as the first element which you must set to indicate which " -"fields you have filled in. For our example function the structure and call " -"are declared:" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:1619 +#: ../edit/virt-edit.pod:50 ../libguestfs-1.11.19/edit/virt-edit.pod:50 #, no-wrap msgid "" -" struct guestfs_add_drive_opts_argv {\n" -" uint64_t bitmask;\n" -" int readonly;\n" -" const char *format;\n" -" /* ... */\n" -" };\n" -" int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n" -" const struct guestfs_add_drive_opts_argv *optargs);\n" +" virt-edit -d mydomain /etc/passwd\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1628 -msgid "You could call it like this:" +#: ../edit/virt-edit.pod:52 ../libguestfs-1.11.19/edit/virt-edit.pod:52 +msgid "For Windows guests, some Windows paths are understood:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1630 +#: ../edit/virt-edit.pod:54 ../libguestfs-1.11.19/edit/virt-edit.pod:54 #, no-wrap msgid "" -" struct guestfs_add_drive_opts_argv optargs = {\n" -" .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n" -" .readonly = 1,\n" -" .format = \"qcow2\"\n" -" };\n" -" \n" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1637 -#, no-wrap -msgid "" -" guestfs_add_drive_opts_argv (g, filename, &optargs);\n" +" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:2853 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929 ../tools/virt-win-reg.pl:704 -msgid "Notes:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1645 -msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1650 -msgid "You do not need to fill in all fields of the structure." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1654 -msgid "" -"There must be a one-to-one correspondence between fields of the structure " -"that are filled in, and bits set in the bitmask." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1659 -msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1661 -msgid "" -"In other languages, optional arguments are expressed in the way that is " -"natural for that language. We refer you to the language-specific " -"documentation for more details on that." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1665 -msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1667 -msgid "SETTING CALLBACKS TO HANDLE EVENTS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1669 +#: ../edit/virt-edit.pod:56 ../libguestfs-1.11.19/edit/virt-edit.pod:56 msgid "" -"B<Note:> This section documents the generic event mechanism introduced in " -"libguestfs 1.10, which you should use in new code if possible. The old " -"functions C<guestfs_set_log_message_callback>, " -"C<guestfs_set_subprocess_quit_callback>, " -"C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and " -"C<guestfs_set_progress_callback> are no longer documented in this manual " -"page. Because of the ABI guarantee, the old functions continue to work." +"If Perl is installed, you can also edit files non-interactively (see " +"L</NON-INTERACTIVE EDITING> below). To change the init default level to 5:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1678 -msgid "" -"Handles generate events when certain things happen, such as log messages " -"being generated, progress messages during long-running operations, or the " -"handle being closed. The API calls described below let you register a " -"callback to be called when events happen. You can register multiple " -"callbacks (for the same, different or overlapping sets of events), and " -"individually remove callbacks. If callbacks are not removed, then they " -"remain in force until the handle is closed." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1686 -msgid "" -"In the current implementation, events are only generated synchronously: that " -"means that events (and hence callbacks) can only happen while you are in the " -"middle of making another libguestfs call. The callback is called in the " -"same thread." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1691 +#. type: verbatim +#: ../edit/virt-edit.pod:60 ../libguestfs-1.11.19/edit/virt-edit.pod:60 +#, no-wrap msgid "" -"Events may contain a payload, usually nothing (void), an array of 64 bit " -"unsigned integers, or a message buffer. Payloads are discussed later on." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1695 -msgid "CLASSES OF EVENTS" +" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" +"\n" msgstr "" #. type: =item -#: ../src/guestfs.pod:1699 -msgid "GUESTFS_EVENT_CLOSE (payload type: void)" +#: ../edit/virt-edit.pod:81 ../libguestfs-1.11.19/edit/virt-edit.pod:81 +msgid "B<-b> extension" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1702 -msgid "" -"The callback function will be called while the handle is being closed " -"(synchronously from L</guestfs_close>)." +#. type: =item +#: ../edit/virt-edit.pod:83 ../libguestfs-1.11.19/edit/virt-edit.pod:83 +msgid "B<--backup> extension" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1705 +#: ../edit/virt-edit.pod:85 ../libguestfs-1.11.19/edit/virt-edit.pod:85 msgid "" -"Note that libguestfs installs an L<atexit(3)> handler to try to clean up " -"handles that are open when the program exits. This means that this callback " -"might be called indirectly from L<exit(3)>, which can cause unexpected " -"problems in higher-level languages (eg. if your HLL interpreter has already " -"been cleaned up by the time this is called, and if your callback then jumps " -"into some HLL function)." +"Create a backup of the original file I<in the guest disk image>. The backup " +"has the original filename with C<extension> added." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1712 +#: ../edit/virt-edit.pod:88 ../libguestfs-1.11.19/edit/virt-edit.pod:88 msgid "" -"If no callback is registered: the handle is closed without any callback " -"being invoked." +"Usually the first character of C<extension> would be a dot C<.> so you would " +"write:" msgstr "" -#. type: =item -#: ../src/guestfs.pod:1715 -msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1718 +#. type: verbatim +#: ../edit/virt-edit.pod:91 ../libguestfs-1.11.19/edit/virt-edit.pod:91 +#, no-wrap msgid "" -"The callback function will be called when the child process quits, either " -"asynchronously or if killed by L</guestfs_kill_subprocess>. (This " -"corresponds to a transition from any state to the CONFIG state)." +" virt-edit -b .orig [etc]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1722 ../src/guestfs.pod:1731 -msgid "If no callback is registered: the event is ignored." +#: ../edit/virt-edit.pod:93 ../libguestfs-1.11.19/edit/virt-edit.pod:93 +msgid "By default, no backup file is made." msgstr "" #. type: =item -#: ../src/guestfs.pod:1724 -msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1727 -msgid "" -"The callback function will be called when the child process becomes ready " -"first time after it has been launched. (This corresponds to a transition " -"from LAUNCHING to the READY state)." +#: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181 ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74 ../libguestfs-1.11.19/edit/virt-edit.pod:95 ../libguestfs-1.11.19/fish/guestfish.pod:181 ../libguestfs-1.11.19/fuse/guestmount.pod:96 ../libguestfs-1.11.19/inspector/virt-inspector.pod:74 ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78 ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128 +msgid "B<-c URI>" msgstr "" #. type: =item -#: ../src/guestfs.pod:1733 -msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1736 -msgid "" -"Some long-running operations can generate progress messages. If this " -"callback is registered, then it will be called each time a progress message " -"is generated (usually two seconds after the operation started, and three " -"times per second thereafter until it completes, although the frequency may " -"change in future versions)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1742 -msgid "" -"The callback receives in the payload four unsigned 64 bit numbers which are " -"(in order): C<proc_nr>, C<serial>, C<position>, C<total>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1745 -msgid "" -"The units of C<total> are not defined, although for some operations C<total> " -"may relate in some way to the amount of data to be transferred (eg. in bytes " -"or megabytes), and C<position> may be the portion which has been " -"transferred." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1750 -msgid "The only defined and stable parts of the API are:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1756 -msgid "" -"The callback can display to the user some type of progress bar or indicator " -"which shows the ratio of C<position>:C<total>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1761 -msgid "0 E<lt>= C<position> E<lt>= C<total>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1765 -msgid "" -"If any progress notification is sent during a call, then a final progress " -"notification is always sent when C<position> = C<total> (I<unless> the call " -"fails with an error)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1769 -msgid "" -"This is to simplify caller code, so callers can easily set the progress " -"indicator to \"100%\" at the end of the operation, without requiring special " -"code to detect this case." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1775 -msgid "" -"For some calls we are unable to estimate the progress of the call, but we " -"can still generate progress messages to indicate activity. This is known as " -"\"pulse mode\", and is directly supported by certain progress bar " -"implementations (eg. GtkProgressBar)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1780 -msgid "" -"For these calls, zero or more progress messages are generated with " -"C<position = 0> and C<total = 1>, followed by a final message with " -"C<position = total = 1>." +#: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183 ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76 ../libguestfs-1.11.19/edit/virt-edit.pod:97 ../libguestfs-1.11.19/fish/guestfish.pod:183 ../libguestfs-1.11.19/fuse/guestmount.pod:98 ../libguestfs-1.11.19/inspector/virt-inspector.pod:76 ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130 +msgid "B<--connect URI>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1784 +#: ../edit/virt-edit.pod:102 ../libguestfs-1.11.19/edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84 ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134 ../tools/virt-win-reg.pl:135 msgid "" -"As noted above, if the call fails with an error then the final message may " -"not be generated." +"If you specify guest block devices directly, then libvirt is not used at " +"all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1789 +#: ../edit/virt-edit.pod:114 ../libguestfs-1.11.19/edit/virt-edit.pod:114 msgid "" -"The callback also receives the procedure number (C<proc_nr>) and serial " -"number (C<serial>) of the call. These are only useful for debugging " -"protocol issues, and the callback can normally ignore them. The callback " -"may want to print these numbers in error messages or debugging messages." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1795 -msgid "If no callback is registered: progress messages are discarded." +"When prompting for keys and passphrases, virt-edit 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:1797 -msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1800 -msgid "" -"The callback function is called whenever a log message is generated by qemu, " -"the appliance kernel, guestfsd (daemon), or utility programs." +#: ../edit/virt-edit.pod:119 ../libguestfs-1.11.19/edit/virt-edit.pod:119 +msgid "B<-e> EXPR" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1803 -msgid "" -"If the verbose flag (L</guestfs_set_verbose>) is set before launch " -"(L</guestfs_launch>) then additional debug messages are generated." +#. type: =item +#: ../edit/virt-edit.pod:121 ../libguestfs-1.11.19/edit/virt-edit.pod:121 +msgid "B<--expr> EXPR" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1806 ../src/guestfs.pod:1820 +#: ../edit/virt-edit.pod:123 ../libguestfs-1.11.19/edit/virt-edit.pod:123 msgid "" -"If no callback is registered: the messages are discarded unless the verbose " -"flag is set in which case they are sent to stderr. You can override the " -"printing of verbose messages to stderr by setting up a callback." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:1811 -msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" +"Instead of launching the external editor, non-interactively apply the Perl " +"expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE " +"EDITING> below." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1814 +#: ../edit/virt-edit.pod:127 ../libguestfs-1.11.19/edit/virt-edit.pod:127 msgid "" -"The callback function is called whenever a log message is generated by the " -"library part of libguestfs." +"Be careful to properly quote the expression to prevent it from being altered " +"by the shell." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1817 -msgid "" -"If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " -"messages are generated." +#: ../edit/virt-edit.pod:130 ../libguestfs-1.11.19/edit/virt-edit.pod:130 +msgid "Note that this option is only available when Perl 5 is installed." msgstr "" #. type: =item -#: ../src/guestfs.pod:1825 -msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1828 -msgid "" -"The callback function is called whenever a trace message is generated. This " -"only applies if the trace flag (L</guestfs_set_trace>) is set." +#: ../edit/virt-edit.pod:132 ../libguestfs-1.11.19/edit/virt-edit.pod:132 +msgid "B<--format> raw|qcow2|..." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1831 +#. type: verbatim +#: ../edit/virt-edit.pod:143 ../libguestfs-1.11.19/edit/virt-edit.pod:143 +#, no-wrap msgid "" -"If no callback is registered: the messages are sent to stderr. You can " -"override the printing of trace messages to stderr by setting up a callback." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1837 -msgid "guestfs_set_event_callback" +" virt-edit --format=raw -a disk.img file\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1839 +#: ../edit/virt-edit.pod:147 ../libguestfs-1.11.19/edit/virt-edit.pod:147 #, no-wrap msgid "" -" int guestfs_set_event_callback (guestfs_h *g,\n" -" guestfs_event_callback cb,\n" -" uint64_t event_bitmask,\n" -" int flags,\n" -" void *opaque);\n" +" virt-edit --format=raw -a disk.img --format -a another.img file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1845 -msgid "" -"This function registers a callback (C<cb>) for all event classes in the " -"C<event_bitmask>." +#: ../edit/virt-edit.pod:181 ../libguestfs-1.11.19/edit/virt-edit.pod:181 +msgid "Previous versions of virt-edit allowed you to write either:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1848 +#. type: verbatim +#: ../edit/virt-edit.pod:187 ../libguestfs-1.11.19/edit/virt-edit.pod:187 +#, no-wrap msgid "" -"For example, to register for all log message events, you could call this " -"function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>. " -"To register a single callback for all possible classes of events, use " -"C<GUESTFS_EVENT_ALL>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1854 -msgid "C<flags> should always be passed as 0." +" virt-edit guestname file\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1856 -msgid "" -"C<opaque> is an opaque pointer which is passed to the callback. You can use " -"it for any purpose." +#. type: =head1 +#: ../edit/virt-edit.pod:195 ../libguestfs-1.11.19/edit/virt-edit.pod:195 +msgid "NON-INTERACTIVE EDITING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1859 +#: ../edit/virt-edit.pod:197 ../libguestfs-1.11.19/edit/virt-edit.pod:197 msgid "" -"The return value is the event handle (an integer) which you can use to " -"delete the callback (see below)." +"C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system " +"administrator can interactively edit the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1862 +#: ../edit/virt-edit.pod:200 ../libguestfs-1.11.19/edit/virt-edit.pod:200 msgid "" -"If there is an error, this function returns C<-1>, and sets the error in the " -"handle in the usual way (see L</guestfs_last_error> etc.)" +"There are two ways also to use C<virt-edit> from scripts in order to make " +"automated edits to files. (Note that although you I<can> use C<virt-edit> " +"like this, it's less error-prone to write scripts directly using the " +"libguestfs API and Augeas for configuration file editing.)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1865 +#: ../edit/virt-edit.pod:206 ../libguestfs-1.11.19/edit/virt-edit.pod:206 msgid "" -"Callbacks remain in effect until they are deleted, or until the handle is " -"closed." +"The first method is to temporarily set C<$EDITOR> to any script or program " +"you want to run. The script is invoked as C<$EDITOR tmpfile> and it should " +"update C<tmpfile> in place however it likes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1868 +#: ../edit/virt-edit.pod:210 ../libguestfs-1.11.19/edit/virt-edit.pod:210 msgid "" -"In the case where multiple callbacks are registered for a particular event " -"class, all of the callbacks are called. The order in which multiple " -"callbacks are called is not defined." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1872 -msgid "guestfs_delete_event_callback" +"The second method is to use the I<-e> parameter of C<virt-edit> to run a " +"short Perl snippet in the style of L<sed(1)>. For example to replace all " +"instances of C<foo> with C<bar> in a file:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1874 +#: ../edit/virt-edit.pod:214 ../libguestfs-1.11.19/edit/virt-edit.pod:214 #, no-wrap msgid "" -" void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" +" virt-edit -d domname filename -e 's/foo/bar/'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1876 +#: ../edit/virt-edit.pod:216 ../libguestfs-1.11.19/edit/virt-edit.pod:216 msgid "" -"Delete a callback that was previously registered. C<event_handle> should be " -"the integer that was returned by a previous call to " -"C<guestfs_set_event_callback> on the same handle." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1880 -msgid "guestfs_event_callback" +"The full power of Perl regular expressions can be used (see L<perlre(1)>). " +"For example to delete root's password you could do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1882 +#: ../edit/virt-edit.pod:219 ../libguestfs-1.11.19/edit/virt-edit.pod:219 #, no-wrap msgid "" -" typedef void (*guestfs_event_callback) (\n" -" guestfs_h *g,\n" -" void *opaque,\n" -" uint64_t event,\n" -" int event_handle,\n" -" int flags,\n" -" const char *buf, size_t buf_len,\n" -" const uint64_t *array, size_t array_len);\n" +" virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1891 -msgid "This is the type of the event callback function that you have to provide." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:1894 +#: ../edit/virt-edit.pod:221 ../libguestfs-1.11.19/edit/virt-edit.pod:221 msgid "" -"The basic parameters are: the handle (C<g>), the opaque user pointer " -"(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event " -"handle, and C<flags> which in the current API you should ignore." +"What really happens is that the snippet is evaluated as a Perl expression " +"for each line of the file. The line, including the final C<\\n>, is passed " +"in C<$_> and the expression should update C<$_> or leave it unchanged." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1898 +#: ../edit/virt-edit.pod:226 ../libguestfs-1.11.19/edit/virt-edit.pod:226 msgid "" -"The remaining parameters contain the event payload (if any). Each event may " -"contain a payload, which usually relates to the event class, but for future " -"proofing your code should be written to handle any payload for any event " -"class." +"To delete a line, set C<$_> to the empty string. For example, to delete the " +"C<apache> user account from the password file you can do:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:1903 +#. type: verbatim +#: ../edit/virt-edit.pod:229 ../libguestfs-1.11.19/edit/virt-edit.pod:229 +#, no-wrap msgid "" -"C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then " -"there is no message buffer). Note that this message buffer can contain " -"arbitrary 8 bit data, including NUL bytes." +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1907 +#: ../edit/virt-edit.pod:231 ../libguestfs-1.11.19/edit/virt-edit.pod:231 msgid "" -"C<array> and C<array_len> is an array of 64 bit unsigned integers. At the " -"moment this is only used for progress messages." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:1910 -msgid "EXAMPLE: CAPTURING LOG MESSAGES" +"To insert a line, prepend or append it to C<$_>. However appending lines to " +"the end of the file is rather difficult this way since there is no concept " +"of \"last line of the file\" - your expression just doesn't get called " +"again. You might want to use the first method (setting C<$EDITOR>) if you " +"want to do this." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1912 +#: ../edit/virt-edit.pod:237 ../libguestfs-1.11.19/edit/virt-edit.pod:237 msgid "" -"One motivation for the generic event API was to allow GUI programs to " -"capture debug and other messages. In libguestfs E<le> 1.8 these were sent " -"unconditionally to C<stderr>." +"The variable C<$lineno> contains the current line number. As is " +"traditional, the first line in the file is number C<1>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1916 +#: ../edit/virt-edit.pod:240 ../libguestfs-1.11.19/edit/virt-edit.pod:240 msgid "" -"Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " -"C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " -"messages are not events; you must capture error messages separately)." +"The return value from the expression is ignored, but the expression may call " +"C<die> in order to abort the whole program, leaving the original file " +"untouched." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1921 +#: ../edit/virt-edit.pod:244 ../libguestfs-1.11.19/edit/virt-edit.pod:244 msgid "" -"Programs have to set up a callback to capture the classes of events of " -"interest:" +"Remember when matching the end of a line that C<$_> may contain the final " +"C<\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a " +"newline then neither of these. Thus to match or substitute some text at the " +"end of a line, use this regular expression:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1924 +#: ../edit/virt-edit.pod:249 ../libguestfs-1.11.19/edit/virt-edit.pod:249 #, no-wrap msgid "" -" int eh =\n" -" guestfs_set_event_callback\n" -" (g, message_callback,\n" -" GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n" -" GUESTFS_EVENT_TRACE,\n" -" 0, NULL) == -1)\n" -" if (eh == -1) {\n" -" // handle error in the usual way\n" -" }\n" +" /some text(\\r?\\n)?$/\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1934 +#: ../edit/virt-edit.pod:251 ../libguestfs-1.11.19/edit/virt-edit.pod:251 msgid "" -"The callback can then direct messages to the appropriate place. In this " -"example, messages are directed to syslog:" +"Alternately, use the perl C<chomp> function, being careful not to chomp " +"C<$_> itself (since that would remove all newlines from the file):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1937 +#: ../edit/virt-edit.pod:255 ../libguestfs-1.11.19/edit/virt-edit.pod:255 #, no-wrap msgid "" -" static void\n" -" message_callback (\n" -" guestfs_h *g,\n" -" void *opaque,\n" -" uint64_t event,\n" -" int event_handle,\n" -" int flags,\n" -" const char *buf, size_t buf_len,\n" -" const uint64_t *array, size_t array_len)\n" -" {\n" -" const int priority = LOG_USER|LOG_INFO;\n" -" if (buf_len > 0)\n" -" syslog (priority, \"event 0x%lx: %s\", event, buf);\n" -" }\n" +" my $m = $_; chomp $m; $m =~ /some text$/\n" "\n" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1952 -msgid "CANCELLING LONG TRANSFERS" +#: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 ../libguestfs-1.11.19/edit/virt-edit.pod:257 ../libguestfs-1.11.19/fish/guestfish.pod:858 +msgid "WINDOWS PATHS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1954 -msgid "" -"Some operations can be cancelled by the caller while they are in progress. " -"Currently only operations that involve uploading or downloading data can be " -"cancelled (technically: operations that have C<FileIn> or C<FileOut> " -"parameters in the generator)." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:1959 -msgid "guestfs_user_cancel" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:1961 -#, no-wrap +#: ../edit/virt-edit.pod:259 ../libguestfs-1.11.19/edit/virt-edit.pod:259 msgid "" -" void guestfs_user_cancel (guestfs_h *g);\n" -"\n" +"C<virt-edit> has a limited ability to understand Windows drive letters and " +"paths (eg. C<E:\\foo\\bar.txt>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1963 -msgid "C<guestfs_user_cancel> cancels the current upload or download operation." +#: ../edit/virt-edit.pod:262 ../libguestfs-1.11.19/edit/virt-edit.pod:262 +msgid "If and only if the guest is running Windows then:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1966 +#: ../edit/virt-edit.pod:268 ../libguestfs-1.11.19/edit/virt-edit.pod:268 msgid "" -"Unlike most other libguestfs calls, this function is signal safe and thread " -"safe. You can call it from a signal handler or from another thread, without " -"needing to do any locking." +"Drive letter prefixes like C<C:> are resolved against the Windows Registry " +"to the correct filesystem." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1970 +#: ../edit/virt-edit.pod:273 ../libguestfs-1.11.19/edit/virt-edit.pod:273 msgid "" -"The transfer that was in progress (if there is one) will stop shortly " -"afterwards, and will return an error. The errno (see " -"L</guestfs_last_errno>) is set to C<EINTR>, so you can test for this to find " -"out if the operation was cancelled or failed because of another error." +"Any backslash (C<\\>) characters in the path are replaced with forward " +"slashes so that libguestfs can process it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1976 +#: ../edit/virt-edit.pod:278 ../libguestfs-1.11.19/edit/virt-edit.pod:278 msgid "" -"No cleanup is performed: for example, if a file was being uploaded then " -"after cancellation there may be a partially uploaded file. It is the " -"caller's responsibility to clean up if necessary." +"The path is resolved case insensitively to locate the file that should be " +"edited." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1980 -msgid "There are two common places that you might call C<guestfs_user_cancel>." +#: ../edit/virt-edit.pod:283 ../libguestfs-1.11.19/edit/virt-edit.pod:283 +msgid "There are some known shortcomings:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1982 -msgid "" -"In an interactive text-based program, you might call it from a C<SIGINT> " -"signal handler so that pressing C<^C> cancels the current operation. (You " -"also need to call L</guestfs_set_pgroup> so that child processes don't " -"receive the C<^C> signal)." +#: ../edit/virt-edit.pod:289 ../libguestfs-1.11.19/edit/virt-edit.pod:289 +msgid "Some NTFS symbolic links may not be followed correctly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1987 -msgid "" -"In a graphical program, when the main thread is displaying a progress bar " -"with a cancel button, wire up the cancel button to call this function." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:1991 -msgid "PRIVATE DATA AREA" +#: ../edit/virt-edit.pod:293 ../libguestfs-1.11.19/edit/virt-edit.pod:293 +msgid "NTFS junction points that cross filesystems are not followed." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1993 +#: ../edit/virt-edit.pod:299 ../libguestfs-1.11.19/edit/virt-edit.pod:299 msgid "" -"You can attach named pieces of private data to the libguestfs handle, fetch " -"them by name, and walk over them, for the lifetime of the handle. This is " -"called the private data area and is only available from the C API." +"L<guestfish(1)> is a more powerful, lower level tool which you can use when " +"C<virt-edit> doesn't work." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1998 -msgid "To attach a named piece of data, use the following call:" +#: ../edit/virt-edit.pod:302 ../libguestfs-1.11.19/edit/virt-edit.pod:302 +msgid "Using C<virt-edit> is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2000 +#: ../edit/virt-edit.pod:304 ../libguestfs-1.11.19/edit/virt-edit.pod:304 #, no-wrap msgid "" -" void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" +" guestfish --rw -i -d domname edit /file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2002 +#: ../edit/virt-edit.pod:306 ../libguestfs-1.11.19/edit/virt-edit.pod:306 msgid "" -"C<key> is the name to associate with this data, and C<data> is an arbitrary " -"pointer (which can be C<NULL>). Any previous item with the same key is " -"overwritten." +"where C<domname> is the name of the libvirt guest, and C</file> is the full " +"path to the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2006 +#: ../edit/virt-edit.pod:309 ../libguestfs-1.11.19/edit/virt-edit.pod:309 msgid "" -"You can use any C<key> you want, but your key should I<not> start with an " -"underscore character. Keys beginning with an underscore character are " -"reserved for internal libguestfs purposes (eg. for implementing language " -"bindings). It is recommended that you prefix the key with some unique " -"string to avoid collisions with other users." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2012 -msgid "To retrieve the pointer, use:" +"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 edit a file on a disk image " +"directly, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2014 +#: ../edit/virt-edit.pod:314 ../libguestfs-1.11.19/edit/virt-edit.pod:314 #, no-wrap msgid "" -" void *guestfs_get_private (guestfs_h *g, const char *key);\n" +" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2016 +#: ../edit/virt-edit.pod:316 ../libguestfs-1.11.19/edit/virt-edit.pod:316 msgid "" -"This function returns C<NULL> if either no data is found associated with " -"C<key>, or if the user previously set the C<key>'s C<data> pointer to " -"C<NULL>." +"where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within " +"the disk image to edit, and C</file> is the full path to the file." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2020 +#: ../edit/virt-edit.pod:320 ../libguestfs-1.11.19/edit/virt-edit.pod:320 msgid "" -"Libguestfs does not try to look at or interpret the C<data> pointer in any " -"way. As far as libguestfs is concerned, it need not be a valid pointer at " -"all. In particular, libguestfs does I<not> try to free the data when the " -"handle is closed. If the data must be freed, then the caller must either " -"free it before calling L</guestfs_close> or must set up a close callback to " -"do it (see L</GUESTFS_EVENT_CLOSE>)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2027 -msgid "To walk over all entries, use these two functions:" +"C<virt-edit> cannot create new files. Use the guestfish commands C<touch>, " +"C<write> or C<upload> instead:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2029 +#: ../edit/virt-edit.pod:323 ../libguestfs-1.11.19/edit/virt-edit.pod:323 #, no-wrap msgid "" -" void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" +" guestfish --rw -i -d domname touch /newfile\n" "\n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2031 +#: ../edit/virt-edit.pod:325 ../libguestfs-1.11.19/edit/virt-edit.pod:325 #, no-wrap msgid "" -" void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" +" guestfish --rw -i -d domname write /newfile \"new content\"\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2033 -msgid "" -"C<guestfs_first_private> returns the first key, pointer pair (\"first\" does " -"not have any particular meaning -- keys are not returned in any defined " -"order). A pointer to the key is returned in C<*key_rtn> and the " -"corresponding data pointer is returned from the function. C<NULL> is " -"returned if there are no keys stored in the handle." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2039 +#. type: verbatim +#: ../edit/virt-edit.pod:327 ../libguestfs-1.11.19/edit/virt-edit.pod:327 +#, no-wrap msgid "" -"C<guestfs_next_private> returns the next key, pointer pair. The return " -"value of this function is also C<NULL> is there are no further entries to " -"return." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2043 -msgid "Notes about walking over entries:" +" guestfish --rw -i -d domname upload localfile /newfile\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2049 -msgid "You must not call C<guestfs_set_private> while walking over the entries." +#. type: =head1 +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1075 ../libguestfs-1.11.19/edit/virt-edit.pod:329 ../libguestfs-1.11.19/fish/guestfish.pod:1075 ../libguestfs-1.11.19/rescue/virt-rescue.pod:257 ../libguestfs-1.11.19/src/guestfs.pod:2960 ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:82 ../rescue/virt-rescue.pod:257 ../src/guestfs.pod:2960 ../test-tool/libguestfs-test-tool.pod:82 +msgid "ENVIRONMENT VARIABLES" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2054 -msgid "" -"The handle maintains an internal iterator which is reset when you call " -"C<guestfs_first_private>. This internal iterator is invalidated when you " -"call C<guestfs_set_private>." +#. type: =item +#: ../edit/virt-edit.pod:333 ../libguestfs-1.11.19/edit/virt-edit.pod:333 +msgid "C<EDITOR>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2060 -msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:2062 -#, no-wrap +#: ../edit/virt-edit.pod:335 ../libguestfs-1.11.19/edit/virt-edit.pod:335 msgid "" -" guestfs_set_private (g, key, NULL);\n" -"\n" +"If set, this string is used as the editor. It may contain arguments, " +"eg. C<\"emacs -nw\">" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2064 -msgid "then that C<key> is not returned when walking." +#: ../edit/virt-edit.pod:338 ../libguestfs-1.11.19/edit/virt-edit.pod:338 +msgid "If not set, C<vi> is used." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2068 +#: ../edit/virt-edit.pod:351 ../libguestfs-1.11.19/edit/virt-edit.pod:351 msgid "" -"C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, " -"C<guestfs_next_private> or C<guestfs_set_private>." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, " +"L<virt-tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, " +"L<Sys::Virt(3)>, L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2074 -msgid "" -"The following example code shows how to print all keys and data pointers " -"that are associated with the handle C<g>:" +#: ../examples/guestfs-examples.pod:5 ../libguestfs-1.11.19/examples/guestfs-examples.pod:5 +msgid "guestfs-examples - Examples of using libguestfs from C" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2077 +#: ../examples/guestfs-examples.pod:9 ../libguestfs-1.11.19/examples/guestfs-examples.pod:9 ../libguestfs-1.11.19/src/guestfs.pod:9 ../src/guestfs.pod:9 #, no-wrap msgid "" -" const char *key;\n" -" void *data = guestfs_first_private (g, &key);\n" -" while (data != NULL)\n" -" {\n" -" printf (\"key = %s, data = %p\\n\", key, data);\n" -" data = guestfs_next_private (g, &key);\n" -" }\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2085 -msgid "" -"More commonly you are only interested in keys that begin with an " -"application-specific prefix C<foo_>. Modify the loop like so:" +" #include <guestfs.h>\n" +" \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2088 +#: ../examples/guestfs-examples.pod:11 ../libguestfs-1.11.19/examples/guestfs-examples.pod:11 #, no-wrap msgid "" -" const char *key;\n" -" void *data = guestfs_first_private (g, &key);\n" -" while (data != NULL)\n" -" {\n" -" if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n" -" printf (\"key = %s, data = %p\\n\", key, data);\n" -" data = guestfs_next_private (g, &key);\n" -" }\n" +" guestfs_h *g = guestfs_create ();\n" +" guestfs_add_drive_ro (g, \"disk.img\");\n" +" guestfs_launch (g);\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2097 -msgid "" -"If you need to modify keys while walking, then you have to jump back to the " -"beginning of the loop. For example, to delete all keys prefixed with " -"C<foo_>:" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:2101 +#: ../examples/guestfs-examples.pod:15 ../libguestfs-1.11.19/examples/guestfs-examples.pod:15 ../libguestfs-1.11.19/src/guestfs.pod:19 ../src/guestfs.pod:19 #, no-wrap msgid "" -" const char *key;\n" -" void *data;\n" -" again:\n" -" data = guestfs_first_private (g, &key);\n" -" while (data != NULL)\n" -" {\n" -" if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n" -" {\n" -" guestfs_set_private (g, key, NULL);\n" -" /* note that 'key' pointer is now invalid, and so is\n" -" the internal iterator */\n" -" goto again;\n" -" }\n" -" data = guestfs_next_private (g, &key);\n" -" }\n" +" cc prog.c -o prog -lguestfs\n" +"or:\n" +" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2117 +#: ../examples/guestfs-examples.pod:21 ../libguestfs-1.11.19/examples/guestfs-examples.pod:21 msgid "" -"Note that the above loop is guaranteed to terminate because the keys are " -"being deleted, but other manipulations of keys within the loop might not " -"terminate unless you also maintain an indication of which keys have been " -"visited." +"This manual page contains examples of calling libguestfs from the C " +"programming language. If you are not familiar with using libguestfs, you " +"also need to read L<guestfs(3)>." msgstr "" -#. type: =end -#: ../src/guestfs.pod:2122 ../src/guestfs.pod:2127 -msgid "html" +#. type: =head1 +#: ../examples/guestfs-examples.pod:25 ../libguestfs-1.11.19/examples/guestfs-examples.pod:25 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:70 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:31 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:34 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:28 ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31 ../python/examples/guestfs-python.pod:34 ../ruby/examples/guestfs-ruby.pod:28 +msgid "EXAMPLE 1: CREATE A DISK IMAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2124 -msgid "" -"<!-- old anchor for the next section --> <a " -"name=\"state_machine_and_low_level_event_api\"/>" +#: ../examples/guestfs-examples.pod:27 ../libguestfs-1.11.19/examples/guestfs-examples.pod:27 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:72 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:33 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:36 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:30 ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33 ../python/examples/guestfs-python.pod:36 ../ruby/examples/guestfs-ruby.pod:30 +msgid "@EXAMPLE1@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2129 -msgid "ARCHITECTURE" +#: ../examples/guestfs-examples.pod:29 ../libguestfs-1.11.19/examples/guestfs-examples.pod:29 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:74 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:35 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:38 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:32 ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35 ../python/examples/guestfs-python.pod:38 ../ruby/examples/guestfs-ruby.pod:32 +msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2131 -msgid "" -"Internally, libguestfs is implemented by running an appliance (a special " -"type of small virtual machine) using L<qemu(1)>. Qemu runs as a child " -"process of the main program." -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:2135 -#, no-wrap -msgid "" -" ___________________\n" -" / \\\n" -" | main program |\n" -" | |\n" -" | | child process / appliance\n" -" | | __________________________\n" -" | | / qemu \\\n" -" +-------------------+ RPC | +-----------------+ |\n" -" | libguestfs <--------------------> guestfsd | |\n" -" | | | +-----------------+ |\n" -" \\___________________/ | | Linux kernel | |\n" -" | +--^--------------+ |\n" -" \\_________|________________/\n" -" |\n" -" _______v______\n" -" / \\\n" -" | Device or |\n" -" | disk image |\n" -" \\______________/\n" -"\n" +#: ../examples/guestfs-examples.pod:31 ../libguestfs-1.11.19/examples/guestfs-examples.pod:31 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:76 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:37 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:40 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:34 ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37 ../python/examples/guestfs-python.pod:40 ../ruby/examples/guestfs-ruby.pod:34 +msgid "@EXAMPLE2@" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2155 +#: ../examples/guestfs-examples.pod:35 ../libguestfs-1.11.19/examples/guestfs-examples.pod:35 msgid "" -"The library, linked to the main program, creates the child process and hence " -"the appliance in the L</guestfs_launch> function." +"L<guestfs(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, " +"L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, " +"L<http://libguestfs.org/>." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2158 -msgid "" -"Inside the appliance is a Linux kernel and a complete stack of userspace " -"tools (such as LVM and ext2 programs) and a small controlling daemon called " -"L</guestfsd>. The library talks to L</guestfsd> using remote procedure " -"calls (RPC). There is a mostly one-to-one correspondence between libguestfs " -"API calls and RPC calls to the daemon. Lastly the disk image(s) are " -"attached to the qemu process which translates device access by the " -"appliance's Linux kernel into accesses to the image." +#. type: =head1 +#: ../examples/guestfs-examples.pod:43 ../examples/guestfs-recipes.pod:395 ../fish/guestfish.pod:1238 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:380 ../libguestfs-1.11.19/examples/guestfs-examples.pod:43 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:395 ../libguestfs-1.11.19/fish/guestfish.pod:1238 ../libguestfs-1.11.19/fish/virt-copy-in.pod:60 ../libguestfs-1.11.19/fish/virt-copy-out.pod:49 ../libguestfs-1.11.19/fish/virt-tar-in.pod:58 ../libguestfs-1.11.19/fish/virt-tar-out.pod:51 ../libguestfs-1.11.19/fuse/guestmount.pod:314 ../libguestfs-1.11.19/inspector/virt-inspector.pod:380 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:89 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:50 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:52 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:46 ../libguestfs-1.11.19/src/guestfs.pod:3080 ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:93 ../ocaml/examples/guestfs-ocaml.pod:89 ../perl/examples/guestfs-perl.pod:50 ../python/examples/guestfs-python.pod:52 ../ruby/examples/guestfs-ruby.pod:46 ../src/guestfs.pod:3080 ../test-tool/libguestfs-test-tool.pod:93 +msgid "AUTHORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2167 -msgid "" -"A common misunderstanding is that the appliance \"is\" the virtual machine. " -"Although the disk image you are attached to might also be used by some " -"virtual machine, libguestfs doesn't know or care about this. (But you will " -"care if both libguestfs's qemu process and your virtual machine are trying " -"to update the disk image at the same time, since these usually results in " -"massive disk corruption)." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:2174 -msgid "STATE MACHINE" +#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../fish/guestfish.pod:1240 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:316 ../libguestfs-1.11.19/examples/guestfs-examples.pod:45 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:397 ../libguestfs-1.11.19/fish/guestfish.pod:1240 ../libguestfs-1.11.19/fish/virt-copy-in.pod:62 ../libguestfs-1.11.19/fish/virt-copy-out.pod:51 ../libguestfs-1.11.19/fish/virt-tar-in.pod:60 ../libguestfs-1.11.19/fish/virt-tar-out.pod:53 ../libguestfs-1.11.19/fuse/guestmount.pod:316 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:91 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:52 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:54 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:48 ../libguestfs-1.11.19/src/guestfs.pod:3082 ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:95 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3082 ../test-tool/libguestfs-test-tool.pod:95 +msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2176 -msgid "libguestfs uses a state machine to model the child process:" +#: ../examples/guestfs-examples.pod:49 ../libguestfs-1.11.19/examples/guestfs-examples.pod:49 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:95 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:58 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:52 ../ocaml/examples/guestfs-ocaml.pod:95 ../python/examples/guestfs-python.pod:58 ../ruby/examples/guestfs-ruby.pod:52 +msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:2178 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-examples.pod:51 ../examples/guestfs-recipes.pod:403 ../libguestfs-1.11.19/examples/guestfs-examples.pod:51 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:403 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:97 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:58 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:60 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:54 ../ocaml/examples/guestfs-ocaml.pod:97 ../perl/examples/guestfs-perl.pod:58 ../python/examples/guestfs-python.pod:60 ../ruby/examples/guestfs-ruby.pod:54 msgid "" -" |\n" -" guestfs_create\n" -" |\n" -" |\n" -" ____V_____\n" -" / \\\n" -" | CONFIG |\n" -" \\__________/\n" -" ^ ^ ^ \\\n" -" / | \\ \\ guestfs_launch\n" -" / | _\\__V______\n" -" / | / \\\n" -" / | | LAUNCHING |\n" -" / | \\___________/\n" -" / | /\n" -" / | guestfs_launch\n" -" / | /\n" -" ______ / __|____V\n" -" / \\ ------> / \\\n" -" | BUSY | | READY |\n" -" \\______/ <------ \\________/\n" -"\n" +"The examples in this manual page may be freely copied, modified and " +"distributed without any restrictions." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2200 +#: ../examples/guestfs-examples.pod:54 ../examples/guestfs-recipes.pod:406 ../libguestfs-1.11.19/examples/guestfs-examples.pod:54 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:406 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:100 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:61 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:63 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:57 ../libguestfs-1.11.19/src/guestfs.pod:3089 ../ocaml/examples/guestfs-ocaml.pod:100 ../perl/examples/guestfs-perl.pod:61 ../python/examples/guestfs-python.pod:63 ../ruby/examples/guestfs-ruby.pod:57 ../src/guestfs.pod:3089 msgid "" -"The normal transitions are (1) CONFIG (when the handle is created, but there " -"is no child process), (2) LAUNCHING (when the child process is booting up), " -"(3) alternating between READY and BUSY as commands are issued to, and " -"carried out by, the child process." +"This library is free software; you can redistribute it and/or modify it " +"under the terms of the GNU Lesser General Public License as published by the " +"Free Software Foundation; either version 2 of the License, or (at your " +"option) any later version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2205 +#: ../examples/guestfs-examples.pod:59 ../examples/guestfs-recipes.pod:411 ../libguestfs-1.11.19/examples/guestfs-examples.pod:59 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:411 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:105 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:66 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:68 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:62 ../libguestfs-1.11.19/src/guestfs.pod:3094 ../ocaml/examples/guestfs-ocaml.pod:105 ../perl/examples/guestfs-perl.pod:66 ../python/examples/guestfs-python.pod:68 ../ruby/examples/guestfs-ruby.pod:62 ../src/guestfs.pod:3094 msgid "" -"The guest may be killed by L</guestfs_kill_subprocess>, or may die " -"asynchronously at any time (eg. due to some internal error), and that causes " -"the state to transition back to CONFIG." +"This library 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 Lesser General Public License " +"for more details." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2209 +#: ../examples/guestfs-examples.pod:64 ../examples/guestfs-recipes.pod:416 ../libguestfs-1.11.19/examples/guestfs-examples.pod:64 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:416 ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:110 ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:71 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:73 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:67 ../libguestfs-1.11.19/src/guestfs.pod:3099 ../ocaml/examples/guestfs-ocaml.pod:110 ../perl/examples/guestfs-perl.pod:71 ../python/examples/guestfs-python.pod:73 ../ruby/examples/guestfs-ruby.pod:67 ../src/guestfs.pod:3099 msgid "" -"Configuration commands for qemu such as L</guestfs_add_drive> can only be " -"issued when in the CONFIG state." +"You should have received a copy of the GNU Lesser General Public License " +"along with this library; if not, write to the Free Software Foundation, " +"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2212 -msgid "" -"The API offers one call that goes from CONFIG through LAUNCHING to READY. " -"L</guestfs_launch> blocks until the child process is READY to accept " -"commands (or until some failure or timeout). L</guestfs_launch> internally " -"moves the state from CONFIG to LAUNCHING while it is running." +#. type: =end +#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:3 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:12 +msgid "comment" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2218 +#: ../examples/guestfs-recipes.pod:5 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:5 msgid "" -"API actions such as L</guestfs_mount> can only be issued when in the READY " -"state. These API calls block waiting for the command to be carried out " -"(ie. the state to transition to BUSY and then back to READY). There are no " -"non-blocking versions, and no way to issue more than one command per handle " -"at the same time." +"pod2man and pod2html have differing bugs which makes it hard to write URLs " +"here. The only way which works for both sorts of output is to just write " +"the URL directly. Do NOT use L<...> for URLs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2224 +#: ../examples/guestfs-recipes.pod:9 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:9 msgid "" -"Finally, the child process sends asynchronous messages back to the main " -"program, such as kernel log messages. You can register a callback to " -"receive these messages." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:2228 -msgid "INTERNALS" -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2230 -msgid "COMMUNICATION PROTOCOL" +"We break with tradition here and don't use ALL CAPS for the section " +"headings, as this makes them much easier to read." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2232 -msgid "" -"Don't rely on using this protocol directly. This section documents how it " -"currently works, but it may change at any time." +#: ../examples/guestfs-recipes.pod:16 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:16 +msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2235 +#: ../examples/guestfs-recipes.pod:20 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:20 msgid "" -"The protocol used to talk between the library and the daemon running inside " -"the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC " -"1014, RFC 1832, RFC 4506)." +"This page contains recipes for and links to things you can do using " +"libguestfs, L<guestfish(1)> and the virt tools." msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2239 -msgid "" -"The detailed format of structures is in C<src/guestfs_protocol.x> (note: " -"this file is automatically generated)." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:23 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:23 +msgid "Audit a virtual machine for setuid files" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2242 +#: ../examples/guestfs-recipes.pod:25 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:25 msgid "" -"There are two broad cases, ordinary functions that don't have any C<FileIn> " -"and C<FileOut> parameters, which are handled with very simple request/reply " -"messages. Then there are functions that have any C<FileIn> or C<FileOut> " -"parameters, which use the same request and reply messages, but they may also " -"be followed by files sent using a chunked encoding." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:2249 -msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" +"The link below contains a small program which can be used to audit a Linux " +"virtual machine to see what setuid and setgid files it contains." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2251 -msgid "For ordinary functions, the request message is:" +#: ../examples/guestfs-recipes.pod:28 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:28 +msgid "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-files/#content" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:2253 -#, no-wrap -msgid "" -" total length (header + arguments,\n" -" but not including the length word itself)\n" -" struct guestfs_message_header (encoded as XDR)\n" -" struct guestfs_<foo>_args (encoded as XDR)\n" -"\n" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:30 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:30 +msgid "Change the background image in a Windows XP VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2258 +#: ../examples/guestfs-recipes.pod:32 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:32 msgid "" -"The total length field allows the daemon to allocate a fixed size buffer " -"into which it slurps the rest of the message. As a result, the total length " -"is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the " -"effective size of any request is limited to somewhere under this size." +"The links below explain how to use L<guestfish(1)> to change the background " +"image for a user of a Windows XP VM. Unfortunately the technique appears to " +"be substantially different for each version of Windows." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2264 +#: ../examples/guestfs-recipes.pod:37 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:37 msgid "" -"Note also that many functions don't take any arguments, in which case the " -"C<guestfs_I<foo>_args> is completely omitted." +"https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html " +"https://lists.fedoraproject.org/pipermail/virt/2011-May/002658.html" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2267 -msgid "" -"The header contains the procedure number (C<guestfs_proc>) which is how the " -"receiver knows what type of args structure to expect, or none at all." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:40 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:40 +msgid "Cloning a virtual machine (Linux)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2271 +#: ../examples/guestfs-recipes.pod:42 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:42 msgid "" -"For functions that take optional arguments, the optional arguments are " -"encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary " -"arguments. A bitmask in the header indicates which optional arguments are " -"meaningful. The bitmask is also checked to see if it contains bits set " -"which the daemon does not know about (eg. if more optional arguments were " -"added in a later version of the library), and this causes the call to be " -"rejected." +"The guestfish technique described in the link below works well for most " +"Linux VMs. Depending on the Linux distro you may need to change the paths " +"slightly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2279 -msgid "The reply message for ordinary functions is:" +#: ../examples/guestfs-recipes.pod:46 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:46 +msgid "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-vm/#content" msgstr "" -#. type: verbatim -#: ../src/guestfs.pod:2281 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:48 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:48 msgid "" -" total length (header + ret,\n" -" but not including the length word itself)\n" -" struct guestfs_message_header (encoded as XDR)\n" -" struct guestfs_<foo>_ret (encoded as XDR)\n" -"\n" +"Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under " +"discussion." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2286 -msgid "" -"As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " -"functions that return no formal return values." +#: ../examples/guestfs-recipes.pod:51 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:51 +msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2289 -msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:53 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:53 +msgid "Cloning a virtual machine (Windows)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2292 +#: ../examples/guestfs-recipes.pod:55 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:55 msgid "" -"In the case of an error, a flag is set in the header, and the reply message " -"is slightly changed:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:2295 -#, no-wrap -msgid "" -" total length (header + error,\n" -" but not including the length word itself)\n" -" struct guestfs_message_header (encoded as XDR)\n" -" struct guestfs_message_error (encoded as XDR)\n" -"\n" +"It is possible to do a \"sysprep\" using libguestfs alone, although not " +"straightforward. Currently there is code in the Aeolus Oz project which " +"does this (using libguestfs). As part of our review of the virt-clone tool, " +"we may add sysprepping ability." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2300 +#: ../examples/guestfs-recipes.pod:60 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:60 msgid "" -"The C<guestfs_message_error> structure contains the error message as a " -"string." +"https://github.com/clalancette/oz " +"https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:2303 -msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:63 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:63 +msgid "Convert a CD-ROM / DVD / ISO to a tarball" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2305 -msgid "" -"A C<FileIn> parameter indicates that we transfer a file I<into> the guest. " -"The normal request message is sent (see above). However this is followed by " -"a sequence of file chunks." +#: ../examples/guestfs-recipes.pod:65 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:65 +msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2309 +#: ../examples/guestfs-recipes.pod:67 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:67 #, no-wrap msgid "" -" total length (header + arguments,\n" -" but not including the length word itself,\n" -" and not including the chunks)\n" -" struct guestfs_message_header (encoded as XDR)\n" -" struct guestfs_<foo>_args (encoded as XDR)\n" -" sequence of chunks for FileIn param #0\n" -" sequence of chunks for FileIn param #1 etc.\n" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2317 -msgid "The \"sequence of chunks\" is:" +#: ../examples/guestfs-recipes.pod:69 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:69 +msgid "To export just a subdirectory, eg. C</files>, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2319 +#: ../examples/guestfs-recipes.pod:71 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:71 #, no-wrap msgid "" -" length of chunk (not including length word itself)\n" -" struct guestfs_chunk (encoded as XDR)\n" -" length of chunk\n" -" struct guestfs_chunk (encoded as XDR)\n" -" ...\n" -" length of chunk\n" -" struct guestfs_chunk (with data.data_len == 0)\n" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" "\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2327 -msgid "" -"The final chunk has the C<data_len> field set to zero. Additionally a flag " -"is set in the final chunk to indicate either successful completion or early " -"cancellation." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2331 -msgid "" -"At time of writing there are no functions that have more than one FileIn " -"parameter. However this is (theoretically) supported, by sending the " -"sequence of chunks for each FileIn parameter one after another (from left to " -"right)." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2336 -msgid "" -"Both the library (sender) I<and> the daemon (receiver) may cancel the " -"transfer. The library does this by sending a chunk with a special flag set " -"to indicate cancellation. When the daemon sees this, it cancels the whole " -"RPC, does I<not> send any reply, and goes back to reading the next request." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:73 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:73 +msgid "Create empty disk images" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2342 +#: ../examples/guestfs-recipes.pod:75 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:75 msgid "" -"The daemon may also cancel. It does this by writing a special word " -"C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during " -"the transfer, and if it gets it, it will cancel the transfer (it sends a " -"cancel chunk). The special word is chosen so that even if cancellation " -"happens right at the end of the transfer (after the library has finished " -"writing and has started listening for the reply), the \"spurious\" cancel " -"flag will not be confused with the reply message." +"You can use the L<guestfish(1)> I<-N> option to create empty disk images. " +"The useful guide below explains the options available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2351 -msgid "" -"This protocol allows the transfer of arbitrary sized files (no 32 bit " -"limit), and also files where the size is not known in advance (eg. from " -"pipes or sockets). However the chunks are rather small " -"(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need " -"to keep much in memory." +#: ../examples/guestfs-recipes.pod:78 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:78 +msgid "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/#content" msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:2357 -msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:80 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:80 +msgid "Dump raw filesystem content from inside a disk image or VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2359 +#: ../examples/guestfs-recipes.pod:82 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:82 msgid "" -"The protocol for FileOut parameters is exactly the same as for FileIn " -"parameters, but with the roles of daemon and library reversed." +"You can use the L<guestfish(1)> C<download> command to extract the raw " +"filesystem content from any filesystem in a disk image or a VM (even one " +"which is encrypted or buried inside an LV):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2362 +#: ../examples/guestfs-recipes.pod:86 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:86 #, no-wrap msgid "" -" total length (header + ret,\n" -" but not including the length word itself,\n" -" and not including the chunks)\n" -" struct guestfs_message_header (encoded as XDR)\n" -" struct guestfs_<foo>_ret (encoded as XDR)\n" -" sequence of chunks for FileOut param #0\n" -" sequence of chunks for FileOut param #1 etc.\n" +" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" "\n" msgstr "" -#. type: =head3 -#: ../src/guestfs.pod:2370 -msgid "INITIAL MESSAGE" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2372 -msgid "" -"When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) " -"which indicates that the guest and daemon is alive. This is what " -"L</guestfs_launch> waits for." -msgstr "" - -#. type: =head3 -#: ../src/guestfs.pod:2376 -msgid "PROGRESS NOTIFICATION MESSAGES" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2378 -msgid "" -"The daemon may send progress notification messages at any time. These are " -"distinguished by the normal length word being replaced by " -"C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2382 -msgid "" -"The library turns them into progress callbacks (see " -"L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " -"them if not." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2386 -msgid "" -"The daemon self-limits the frequency of progress messages it sends (see " -"C<daemon/proto.c:notify_progress>). Not all calls generate progress " -"messages." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:2390 -msgid "LIBGUESTFS VERSION NUMBERS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2392 -msgid "" -"Since April 2010, libguestfs has started to make separate development and " -"stable releases, along with corresponding branches in our git repository. " -"These separate releases can be identified by version number:" -msgstr "" - #. type: verbatim -#: ../src/guestfs.pod:2397 +#: ../examples/guestfs-recipes.pod:88 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:88 #, no-wrap msgid "" -" even numbers for stable: 1.2.x, 1.4.x, ...\n" -" .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n" -" |\n" -" v\n" -" 1 . 3 . 5\n" -" ^ ^\n" -" | |\n" -" | `-------- sub-version\n" -" |\n" -" `------ always '1' because we don't change the ABI\n" +" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2408 -msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2410 -msgid "" -"As time passes we cherry pick fixes from the development branch and backport " -"those into the stable branch, the effect being that the stable branch should " -"get more stable and less buggy over time. So the stable releases are ideal " -"for people who don't need new features but would just like the software to " -"work." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2416 -msgid "Our criteria for backporting changes are:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2422 -msgid "" -"Documentation changes which don't affect any code are backported unless the " -"documentation refers to a future feature which is not in stable." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2428 -msgid "" -"Bug fixes which are not controversial, fix obvious problems, and have been " -"well tested are backported." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2433 -msgid "" -"Simple rearrangements of code which shouldn't affect how it works get " -"backported. This is so that the code in the two branches doesn't get too " -"far out of step, allowing us to backport future fixes more easily." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2439 -msgid "" -"We I<don't> backport new features, new APIs, new tools etc, except in one " -"exceptional case: the new feature is required in order to implement an " -"important bug fix." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2445 -msgid "" -"A new stable branch starts when we think the new features in development are " -"substantial and compelling enough over the current stable branch to warrant " -"it. When that happens we create new stable and development versions 1.N.0 " -"and 1.(N+1).0 [N is even]. The new dot-oh release won't necessarily be so " -"stable at this point, but by backporting fixes from development, that branch " -"will stabilize over time." +#: ../examples/guestfs-recipes.pod:90 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:90 +msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2453 -msgid "EXTENDING LIBGUESTFS" -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2455 -msgid "ADDING A NEW API ACTION" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2457 -msgid "" -"Large amounts of boilerplate code in libguestfs (RPC, bindings, " -"documentation) are generated, and this makes it easy to extend the " -"libguestfs API." +#: ../examples/guestfs-recipes.pod:92 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:92 +msgid "Edit grub configuration in a VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2461 -msgid "To add a new API action there are two changes:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2467 -msgid "" -"You need to add a description of the call (name, parameters, return type, " -"tests, documentation) to C<generator/generator_actions.ml>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2470 -msgid "" -"There are two sorts of API action, depending on whether the call goes " -"through to the daemon in the appliance, or is serviced entirely by the " -"library (see L</ARCHITECTURE> above). L</guestfs_sync> is an example of the " -"former, since the sync is done in the appliance. L</guestfs_set_trace> is " -"an example of the latter, since a trace flag is maintained in the handle and " -"all tracing is done on the library side." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2478 -msgid "" -"Most new actions are of the first type, and get added to the " -"C<daemon_functions> list. Each function has a unique procedure number used " -"in the RPC protocol which is assigned to that action when we publish " -"libguestfs and cannot be reused. Take the latest procedure number and " -"increment it." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2484 -msgid "" -"For library-only actions of the second type, add to the " -"C<non_daemon_functions> list. Since these functions are serviced by the " -"library and do not travel over the RPC mechanism to the daemon, these " -"functions do not need a procedure number, and so the procedure number is set " -"to C<-1>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2492 -msgid "Implement the action (in C):" +#: ../examples/guestfs-recipes.pod:94 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:94 +msgid "You can use this to:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2494 -msgid "" -"For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " -"C<daemon/> directory." +#: ../examples/guestfs-recipes.pod:100 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:100 +msgid "Fix a virtual machine that does not boot." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2497 -msgid "" -"For library actions, implement the function C<guestfs__E<lt>nameE<gt>> " -"(note: double underscore) in the C<src/> directory." +#: ../examples/guestfs-recipes.pod:104 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:104 +msgid "Change which kernel is used to boot the VM." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2500 -msgid "In either case, use another function as an example of what to do." +#: ../examples/guestfs-recipes.pod:108 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:108 +msgid "Change kernel command line options." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2504 -msgid "After making these changes, use C<make> to compile." +#: ../examples/guestfs-recipes.pod:112 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:112 +msgid "Use L<virt-edit(1)> to edit the grub configuration:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2506 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:114 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:114 +#, no-wrap msgid "" -"Note that you don't need to implement the RPC, language bindings, manual " -"pages or anything else. It's all automatically generated from the OCaml " -"description." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2510 -msgid "ADDING TESTS FOR AN API ACTION" +" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2512 +#: ../examples/guestfs-recipes.pod:116 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:116 msgid "" -"You can supply zero or as many tests as you want per API call. The tests " -"can either be added as part of the API description " -"(C<generator/generator_actions.ml>), or in some rarer cases you may want to " -"drop a script into C<regressions/>. Note that adding a script to " -"C<regressions/> is slower, so if possible use the first method." +"or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like " +"this:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2518 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:119 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:119 +#, no-wrap msgid "" -"The following describes the test environment used when you add an API test " -"in C<generator_actions.ml>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2521 -msgid "The test environment has 4 block devices:" +" virt-rescue -d BrokenGuest\n" +"\n" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2525 -msgid "C</dev/sda> 500MB" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:121 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:121 +msgid "Export any directory from a VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2527 -msgid "General block device for testing." +#: ../examples/guestfs-recipes.pod:123 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:123 +msgid "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2529 -msgid "C</dev/sdb> 50MB" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2531 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:126 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:126 +#, no-wrap msgid "" -"C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " -"operations." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2534 -msgid "C</dev/sdc> 10MB" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2536 -msgid "Used in a few tests where two block devices are needed." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2538 -msgid "C</dev/sdd>" +" virt-copy-out -d Guest /home .\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2540 -msgid "ISO with fixed content (see C<images/test.iso>)." +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:128 ../libguestfs-1.11.19/fish/guestfish-actions.pod:9 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1287 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1929 ../libguestfs-1.11.19/src/guestfs-actions.pod:11 ../libguestfs-1.11.19/src/guestfs-actions.pod:1917 ../libguestfs-1.11.19/src/guestfs-actions.pod:2855 ../libguestfs-1.11.19/src/guestfs.pod:1639 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:2855 ../src/guestfs.pod:1639 ../tools/virt-win-reg.pl:706 +msgid "Notes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2544 +#: ../examples/guestfs-recipes.pod:134 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:134 msgid "" -"To be able to run the tests in a reasonable amount of time, the libguestfs " -"appliance and block devices are reused between tests. So don't try testing " -"L</guestfs_kill_subprocess> :-x" +"The final dot of the command is not a printing error. It means we want to " +"copy out to the current directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2548 -msgid "" -"Each test starts with an initial scenario, selected using one of the " -"C<Init*> expressions, described in C<generator/generator_types.ml>. These " -"initialize the disks mentioned above in a particular way as documented in " -"C<generator_types.ml>. You should not assume anything about the previous " -"contents of other disks that are not initialized." +#: ../examples/guestfs-recipes.pod:139 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:139 +msgid "This creates a directory called C<home> under the current directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2554 +#: ../examples/guestfs-recipes.pod:143 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:143 msgid "" -"You can add a prerequisite clause to any individual test. This is a " -"run-time check, which, if it fails, causes the test to be skipped. Useful " -"if testing a command which might not work on all variations of libguestfs " -"builds. A test that has prerequisite of C<Always> means to run " -"unconditionally." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2560 -msgid "" -"In addition, packagers can skip individual tests by setting environment " -"variables before running C<make check>." +"If the guest is a Windows guest then you can use drive letters and " +"backslashes, but you must prefix the path with C<win:> and quote it to " +"protect it from the shell, like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2563 +#: ../examples/guestfs-recipes.pod:147 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:147 #, no-wrap msgid "" -" SKIP_TEST_<CMD>_<NUM>=1\n" +" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2565 -msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2567 -msgid "or:" +#: ../examples/guestfs-recipes.pod:149 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:149 +msgid "To get the output as a compressed tarball, do:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2569 +#: ../examples/guestfs-recipes.pod:151 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:151 #, no-wrap msgid "" -" SKIP_TEST_<CMD>=1\n" +" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2571 -msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2573 -msgid "Packagers can run only certain tests by setting for example:" -msgstr "" - -#. type: verbatim -#: ../src/guestfs.pod:2575 -#, no-wrap +#: ../examples/guestfs-recipes.pod:153 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:153 msgid "" -" TEST_ONLY=\"vfs_type zerofree\"\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2577 -msgid "" -"See C<capitests/tests.c> for more details of how these environment variables " -"work." +"Although it sounds tempting, this is usually not a reliable way to get a " +"backup from a running guest. See the entry in the FAQ: " +"http://libguestfs.org/FAQ.html#backup" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2580 -msgid "DEBUGGING NEW API ACTIONS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2582 -msgid "Test new actions work before submitting them." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2584 -msgid "You can use guestfish to try out new commands." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:157 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:157 +msgid "Find out which user is using the most space" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2586 +#: ../examples/guestfs-recipes.pod:159 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:159 msgid "" -"Debugging the daemon is a problem because it runs inside a minimal " -"environment. However you can fprintf messages in the daemon to stderr, and " -"they will show up if you use C<guestfish -v>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2590 -msgid "FORMATTING CODE AND OTHER CONVENTIONS" +"This simple script examines a Linux guest to find out which user is using " +"the most space in their home directory:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2592 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:162 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:162 +#, no-wrap msgid "" -"Our C source code generally adheres to some basic code-formatting " -"conventions. The existing code base is not totally consistent on this " -"front, but we do prefer that contributed code be formatted similarly. In " -"short, use spaces-not-TABs for indentation, use 2 spaces for each " -"indentation level, and other than that, follow the K&R style." +" #!/bin/sh -\n" +" \n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2598 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:164 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:164 +#, no-wrap msgid "" -"If you use Emacs, add the following to one of one of your start-up files " -"(e.g., ~/.emacs), to help ensure that you get indentation right:" +" set -e\n" +" \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2601 +#: ../examples/guestfs-recipes.pod:166 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:166 #, no-wrap msgid "" -" ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" -" ;;; Exceptions: Makefile and ChangeLog modes.\n" -" (add-hook 'find-file-hook\n" -" '(lambda () (if (and buffer-file-name\n" -" (string-match \"/libguestfs\\\\>\"\n" -" (buffer-file-name))\n" -" (not (string-equal mode-name \"Change Log\"))\n" -" (not (string-equal mode-name \"Makefile\")))\n" -" (setq indent-tabs-mode nil))))\n" +" vm=\"$1\"\n" +" dir=/home\n" " \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2611 +#: ../examples/guestfs-recipes.pod:169 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:169 #, no-wrap msgid "" -" ;;; When editing C sources in libguestfs, use this style.\n" -" (defun libguestfs-c-mode ()\n" -" \"C mode with adjusted defaults for use with libguestfs.\"\n" -" (interactive)\n" -" (c-set-style \"K&R\")\n" -" (setq c-indent-level 2)\n" -" (setq c-basic-offset 2))\n" -" (add-hook 'c-mode-hook\n" -" '(lambda () (if (string-match \"/libguestfs\\\\>\"\n" -" (buffer-file-name))\n" -" (libguestfs-c-mode))))\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2623 -msgid "Enable warnings when compiling (and fix any problems this finds):" +" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" +" \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2626 +#: ../examples/guestfs-recipes.pod:171 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:171 #, no-wrap msgid "" -" ./configure --enable-gcc-warnings\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2628 -msgid "Useful targets are:" +" for d in $(guestfish --remote ls \"$dir\"); do\n" +" echo -n \"$dir/$d\"\n" +" echo -ne '\\t'\n" +" guestfish --remote du \"$dir/$d\";\n" +" done | sort -nr -k 2\n" +" \n" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2630 +#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:177 ../libguestfs-1.11.19/fish/guestfish.pod:941 #, no-wrap msgid "" -" make syntax-check # checks the syntax of the C code\n" -" make check # runs the test suite\n" +" guestfish --remote exit\n" "\n" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2633 -msgid "DAEMON CUSTOM PRINTF FORMATTERS" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:179 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:179 +msgid "Get DHCP address from a VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2635 +#: ../examples/guestfs-recipes.pod:181 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:181 msgid "" -"In the daemon code we have created custom printf formatters C<%Q> and C<%R>, " -"which are used to do shell quoting." +"The link below explains the many different possible techniques for getting " +"the last assigned DHCP address of a virtual machine." msgstr "" -#. type: =item -#: ../src/guestfs.pod:2640 -msgid "%Q" +#. type: textblock +#: ../examples/guestfs-recipes.pod:184 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:184 +msgid "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-a-virtual-machine-disk-image/#content" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2642 +#: ../examples/guestfs-recipes.pod:186 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:186 msgid "" -"Simple shell quoted string. Any spaces or other shell characters are " -"escaped for you." +"In the libguestfs source examples directory you will find the latest version " +"of the C<virt-dhcp-address.c> program." msgstr "" -#. type: =item -#: ../src/guestfs.pod:2645 -msgid "%R" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2647 -msgid "" -"Same as C<%Q> except the string is treated as a path which is prefixed by " -"the sysroot." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:189 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:189 +msgid "Get the operating system product name string" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2652 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 -msgid "For example:" +#: ../examples/guestfs-recipes.pod:191 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:191 +msgid "Save the following script into a file called C<product-name.sh>:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2654 +#: ../examples/guestfs-recipes.pod:193 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:193 #, no-wrap msgid "" -" asprintf (&cmd, \"cat %R\", path);\n" +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-get-product-name \"$root\"\n" +" guestfish --remote exit\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2656 -msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2658 -msgid "" -"I<Note:> Do I<not> use these when you are passing parameters to the " -"C<command{,r,v,rv}()> functions. These parameters do NOT need to be quoted " -"because they are not passed via the shell (instead, straight to exec). You " -"probably want to use the C<sysroot_path()> function however." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2664 -msgid "SUBMITTING YOUR NEW API ACTIONS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2666 -msgid "" -"Submit patches to the mailing list: " -"L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " -"L<rjones@redhat.com>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2670 -msgid "INTERNATIONALIZATION (I18N) SUPPORT" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2672 -msgid "We support i18n (gettext anyhow) in the library." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2674 -msgid "" -"However many messages come from the daemon, and we don't translate those at " -"the moment. One reason is that the appliance generally has all locale files " -"removed from it, because they take up a lot of space. So we'd have to readd " -"some of those, as well as copying our PO files into the appliance." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2680 -msgid "" -"Debugging messages are never translated, since they are intended for the " -"programmers." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2683 -msgid "SOURCE CODE SUBDIRECTORIES" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2687 ../src/guestfs-actions.pod:6174 ../fish/guestfish-actions.pod:4072 -msgid "C<appliance>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2689 -msgid "The libguestfs appliance, build scripts and so on." +#: ../examples/guestfs-recipes.pod:200 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:200 +msgid "Make the script executable and run it on a named guest:" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2691 -msgid "C<capitests>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2693 -msgid "Automated tests of the C API." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2695 -msgid "C<cat>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2697 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:202 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:202 +#, no-wrap msgid "" -"The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " -"documentation." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2700 -msgid "C<caution>" +" # product-name.sh RHEL60x64\n" +" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2702 +#: ../examples/guestfs-recipes.pod:205 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:205 msgid "" -"Safety and liveness tests of components that libguestfs depends upon (not of " -"libguestfs itself). Mainly this is for qemu and the kernel." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2705 -msgid "C<contrib>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2707 -msgid "Outside contributions, experimental parts." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2709 -msgid "C<daemon>" +"You can also use an XPath query on the L<virt-inspector(1)> XML using the " +"C<xpath> command line tool or from your favourite programming language:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2711 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:209 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:209 +#, no-wrap msgid "" -"The daemon that runs inside the libguestfs appliance and carries out " -"actions." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2714 -msgid "C<df>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2716 -msgid "L<virt-df(1)> command and documentation." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2718 -msgid "C<edit>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2720 -msgid "L<virt-edit(1)> command and documentation." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2722 -msgid "C<examples>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2724 -msgid "C API example code." +" # virt-inspector RHEL60x64 > xml\n" +" # xpath '//product_name' < xml\n" +" Found 1 nodes:\n" +" -- NODE --\n" +" <product_name>Red Hat Enterprise Linux Server release 6.0 " +"(Santiago)</product_name>\n" +"\n" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2726 -msgid "C<fish>" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:215 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:215 +msgid "Get the default boot kernel for a Linux VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2728 +#: ../examples/guestfs-recipes.pod:217 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:217 msgid "" -"L<guestfish(1)>, the command-line shell, and various shell scripts built on " -"top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " -"L<virt-tar-out(1)>." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2732 -msgid "C<fuse>" +"The link below contains a program to print the default boot kernel for a " +"Linux VM." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2734 -msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2736 -msgid "C<generator>" +#: ../examples/guestfs-recipes.pod:220 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:220 +msgid "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-kernel-for-a-vm/#content" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2738 +#: ../examples/guestfs-recipes.pod:222 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:222 msgid "" -"The crucially important generator, used to automatically generate large " -"amounts of boilerplate C code for things like RPC and bindings." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2741 -msgid "C<images>" +"It uses Augeas, and the technique is generally applicable for many different " +"tasks, such as:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2743 -msgid "Files used by the test suite." +#: ../examples/guestfs-recipes.pod:229 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:229 +msgid "listing the user accounts in the guest" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2745 -msgid "Some \"phony\" guest images which we test against." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2747 -msgid "C<inspector>" +#: ../examples/guestfs-recipes.pod:233 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:233 +msgid "what repositories is it configured to use" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2749 -msgid "L<virt-inspector(1)>, the virtual machine image inspector." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2751 -msgid "C<logo>" +#: ../examples/guestfs-recipes.pod:237 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:237 +msgid "what NTP servers does it connect to" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2753 -msgid "Logo used on the website. The fish is called Arthur by the way." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2755 -msgid "C<m4>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2757 -msgid "M4 macros used by autoconf." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2759 -msgid "C<po>" +#: ../examples/guestfs-recipes.pod:241 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:241 +msgid "what were the boot messages last time it booted" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2761 -msgid "Translations of simple gettext strings." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2763 -msgid "C<po-docs>" +#: ../examples/guestfs-recipes.pod:245 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:245 +msgid "listing who was logged in recently" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2765 -msgid "" -"The build infrastructure and PO files for translations of manpages and POD " -"files. Eventually this will be combined with the C<po> directory, but that " -"is rather complicated." +#: ../examples/guestfs-recipes.pod:249 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:249 +msgid "http://augeas.net/" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2769 -msgid "C<regressions>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2771 -msgid "Regression tests." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2773 -msgid "C<rescue>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2775 -msgid "L<virt-rescue(1)> command and documentation." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2777 -msgid "C<src>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2779 -msgid "Source code to the C library." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2781 -msgid "C<tools>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2783 -msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2785 -msgid "C<test-tool>" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:251 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:251 +msgid "Install RPMs in a guest" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2787 +#: ../examples/guestfs-recipes.pod:253 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:253 msgid "" -"Test tool for end users to test if their qemu/kernel combination will work " -"with libguestfs." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2790 -msgid "C<csharp>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2792 -msgid "C<haskell>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2794 -msgid "C<java>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2796 -msgid "C<ocaml>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2798 -msgid "C<php>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2800 -msgid "C<perl>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2802 -msgid "C<python>" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2804 -msgid "C<ruby>" +"The link below contains a method to install RPMs in a guest. In fact the " +"RPMs are just uploaded to the guest along with a \"firstboot\" script that " +"installs them next time the guest is booted. You could use this technique " +"to install vital security updates in an offline guest." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2806 -msgid "Language bindings." +#: ../examples/guestfs-recipes.pod:259 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:259 +msgid "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2810 -msgid "LIMITS" -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2812 -msgid "PROTOCOL LIMITS" +#: ../examples/guestfs-recipes.pod:261 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:261 +msgid "List applications installed in a VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2814 -msgid "" -"Internally libguestfs uses a message-based protocol to pass API calls and " -"their responses to and from a small \"appliance\" (see L</INTERNALS> for " -"plenty more detail about this). The maximum message size used by the " -"protocol is slightly less than 4 MB. For some API calls you may need to be " -"aware of this limit. The API calls which may be affected are individually " -"documented, with a link back to this section of the documentation." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2822 -msgid "" -"A simple call such as L</guestfs_cat> returns its result (the file data) in " -"a simple string. Because this string is at some point internally encoded as " -"a message, the maximum size that it can return is slightly under 4 MB. If " -"the requested file is larger than this then you will get an error." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2828 -msgid "" -"In order to transfer large files into and out of the guest filesystem, you " -"need to use particular calls that support this. The sections L</UPLOADING> " -"and L</DOWNLOADING> document how to do this." +#: ../examples/guestfs-recipes.pod:263 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:263 +msgid "Save the following to a file C<list-apps.sh>:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2832 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:265 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:265 +#, no-wrap msgid "" -"You might also consider mounting the disk image using our FUSE filesystem " -"support (L<guestmount(1)>)." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2835 -msgid "MAXIMUM NUMBER OF DISKS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2837 -msgid "When using virtio disks (the default) the current limit is B<25> disks." +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-list-applications \"$root\"\n" +" guestfish --remote exit\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2840 +#: ../examples/guestfs-recipes.pod:272 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:272 msgid "" -"Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " -"slots. However febootstrap only understands disks with names C</dev/vda> " -"through C</dev/vdz> (26 letters) and it reserves one disk for its own " -"purposes." +"Make the file executable and then you can run it on any named virtual " +"machine:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2845 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:275 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:275 +#, no-wrap msgid "" -"We are working to substantially raise this limit in future versions but it " -"requires complex changes to qemu." +" # list-apps.sh WinGuest\n" +" [0] = {\n" +" app_name: Mozilla Firefox (3.6.12)\n" +" app_display_name: Mozilla Firefox (3.6.12)\n" +" app_epoch: 0\n" +" app_version: 3.6.12 (en-GB)\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\Mozilla Firefox\n" +" app_trans_path:\n" +" app_publisher: Mozilla\n" +" app_url: http://www.mozilla.com/en-GB/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description: Mozilla Firefox\n" +" }\n" +" [1] = {\n" +" app_name: VLC media player\n" +" app_display_name: VLC media player 1.1.5\n" +" app_epoch: 0\n" +" app_version: 1.1.5\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\VideoLAN\\VLC\n" +" app_trans_path:\n" +" app_publisher: VideoLAN\n" +" app_url: http://www.videolan.org/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description:\n" +" }\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2848 +#: ../examples/guestfs-recipes.pod:305 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:305 msgid "" -"In future versions of libguestfs it should also be possible to \"hot plug\" " -"disks (add and remove disks after calling L</guestfs_launch>). This also " -"requires changes to qemu." +"If you want to run the script on disk images (instead of libvirt virtual " +"machines), change C<-d \"$1\"> to C<-a \"$1\">. See also " +"L<virt-inspector(1)>." msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2852 -msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2854 -msgid "Virtio limits the maximum number of partitions per disk to B<15>." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:309 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:309 +msgid "List files and directories in a VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2856 -msgid "" -"This is because it reserves 4 bits for the minor device number (thus " -"C</dev/vda>, and C</dev/vda1> through C</dev/vda15>)." +#: ../examples/guestfs-recipes.pod:311 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:311 +msgid "This involves using the L<guestfish(1)> C<find0> command like this:" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2859 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:313 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:313 +#, no-wrap msgid "" -"If you attach a disk with more than 15 partitions, the extra partitions are " -"ignored by libguestfs." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2862 -msgid "MAXIMUM SIZE OF A DISK" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2864 -msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." +" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs.pod:2866 -msgid "" -"We have tested block devices up to 1 exabyte (2**60 or " -"1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host " -"filesystem." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:315 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:315 +msgid "List services in a Windows VM" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2870 +#: ../examples/guestfs-recipes.pod:317 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:317 msgid "" -"Although libguestfs probably does not impose any limit, the underlying host " -"storage will. If you store disk images on a host ext4 filesystem, then the " -"maximum size will be limited by the maximum ext4 file size (currently 16 " -"TB). If you store disk images as host logical volumes then you are limited " -"by the maximum size of an LV." +"The link below contains a script that can be used to list out the services " +"from a Windows VM, and whether those services run at boot time or are loaded " +"on demand." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2876 -msgid "" -"For the hugest disk image files, we recommend using XFS on the host for " -"storage." +#: ../examples/guestfs-recipes.pod:321 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:321 +msgid "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/#content" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2879 -msgid "MAXIMUM SIZE OF A PARTITION" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:323 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:323 +msgid "Make a disk image sparse" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2881 +#: ../examples/guestfs-recipes.pod:325 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:325 msgid "" -"The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector " -"numbers. Assuming a 512 byte sector size, this means that MBR cannot " -"address a partition located beyond 2 TB on the disk." +"The link below contains some guides for making a disk image sparse (or " +"reintroducing sparseness)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2885 -msgid "" -"It is recommended that you use GPT partitions on disks which are larger than " -"this size. GPT uses 64 bit sector numbers and so can address partitions " -"which are theoretically larger than the largest disk we could support." +#: ../examples/guestfs-recipes.pod:328 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:328 +msgid "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2890 -msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:330 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:330 +msgid "Monitor disk usage over time" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2892 +#: ../examples/guestfs-recipes.pod:332 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:332 msgid "" -"This depends on the filesystem type. libguestfs itself does not impose any " -"known limit. Consult Wikipedia or the filesystem documentation to find out " -"what these limits are." -msgstr "" - -#. type: =head2 -#: ../src/guestfs.pod:2896 -msgid "MAXIMUM UPLOAD AND DOWNLOAD" +"You can use L<virt-df(1)> to monitor disk usage of your guests over time. " +"The link below contains a guide." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2898 -msgid "" -"The API functions L</guestfs_upload>, L</guestfs_download>, " -"L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " -"uploads and downloads." +#: ../examples/guestfs-recipes.pod:335 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:335 +msgid "http://virt-tools.org/learning/advanced-virt-df/" msgstr "" -#. type: =head2 -#: ../src/guestfs.pod:2902 -msgid "INSPECTION LIMITS" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:337 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:337 +msgid "Reading the Windows Event Log from Windows Vista (or later)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2904 +#: ../examples/guestfs-recipes.pod:339 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:339 msgid "" -"The inspection code has several arbitrary limits on things like the size of " -"Windows Registry hive it will read, and the length of product name. These " -"are intended to stop a malicious guest from consuming arbitrary amounts of " -"memory and disk space on the host, and should not be reached in practice. " -"See the source code for more information." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:2910 ../fish/guestfish.pod:1075 ../test-tool/libguestfs-test-tool.pod:82 -msgid "ENVIRONMENT VARIABLES" -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2914 ../fish/guestfish.pod:1106 -msgid "LIBGUESTFS_APPEND" +"L<guestfish(1)> plus the tools described in the link below can be used to " +"read out the Windows Event Log from any virtual machine running Windows " +"Vista or a later version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2916 ../fish/guestfish.pod:1108 -msgid "Pass additional options to the guest kernel." +#: ../examples/guestfs-recipes.pod:343 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:343 +msgid "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2918 ../fish/guestfish.pod:1110 -msgid "LIBGUESTFS_DEBUG" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:345 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:345 +msgid "Remove root password (Linux)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2920 +#: ../examples/guestfs-recipes.pod:347 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:347 msgid "" -"Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " -"effect as calling C<guestfs_set_verbose (g, 1)>." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2923 ../fish/guestfish.pod:1115 -msgid "LIBGUESTFS_MEMSIZE" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2925 ../fish/guestfish.pod:1117 -msgid "Set the memory allocated to the qemu process, in megabytes. For example:" +"Using the L<virt-edit(1)> I<-e> option you can do simple replacements on " +"files. One use is to remove the root password from a Linux guest:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2928 ../fish/guestfish.pod:1120 +#: ../examples/guestfs-recipes.pod:350 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:350 #, no-wrap msgid "" -" LIBGUESTFS_MEMSIZE=700\n" +" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" "\n" msgstr "" -#. type: =item -#: ../src/guestfs.pod:2930 ../fish/guestfish.pod:1122 -msgid "LIBGUESTFS_PATH" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2932 -msgid "" -"Set the path that libguestfs uses to search for a supermin appliance. See " -"the discussion of paths in section L</PATH> above." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2935 ../fish/guestfish.pod:1127 -msgid "LIBGUESTFS_QEMU" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2937 ../fish/guestfish.pod:1129 -msgid "" -"Set the default qemu binary that libguestfs uses. If not set, then the qemu " -"which was found at compile time by the configure script is used." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2941 -msgid "See also L</QEMU WRAPPERS> above." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2943 ../fish/guestfish.pod:1133 -msgid "LIBGUESTFS_TRACE" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2945 -msgid "" -"Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same " -"effect as calling C<guestfs_set_trace (g, 1)>." -msgstr "" - -#. type: =item -#: ../src/guestfs.pod:2948 ../fish/guestfish.pod:1142 -msgid "TMPDIR" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:352 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:352 +msgid "Remove Administrator password (Windows)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2950 ../fish/guestfish.pod:1144 +#: ../examples/guestfs-recipes.pod:354 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:354 msgid "" -"Location of temporary directory, defaults to C</tmp> except for the cached " -"supermin appliance which defaults to C</var/tmp>." +"The link below contains one technique for removing the Administrator " +"password from a Windows VM, or to be more precise, it gives you a command " +"prompt the next time you log in which you can use to bypass any security:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2953 ../fish/guestfish.pod:1147 -msgid "" -"If libguestfs was compiled to use the supermin appliance then the real " -"appliance is cached in this directory, shared between all handles belonging " -"to the same EUID. You can use C<$TMPDIR> to configure another directory to " -"use in case C</var/tmp> is not large enough." +#: ../examples/guestfs-recipes.pod:359 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:359 +msgid "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-administrator-password-with-guestfish/" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2961 ../fish/guestfish.pod:1214 ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:279 ../tools/virt-win-reg.pl:744 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257 -msgid "SEE ALSO" +#: ../examples/guestfs-recipes.pod:361 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:361 +msgid "Unpack a live CD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2963 +#: ../examples/guestfs-recipes.pod:363 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:363 msgid "" -"L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, " -"L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, " -"L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, " -"L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, " -"L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, " -"L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, " -"L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, L<hivex(3)>, " -"L<http://libguestfs.org/>." +"Linux live CDs often contain multiple layers of disk images wrapped like a " +"Russian doll. You can use L<guestfish(1)> to look inside these multiple " +"layers, as outlined in the guide below." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2990 -msgid "" -"Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " -"L<lvm(8)>, L<disktype(1)>." +#: ../examples/guestfs-recipes.pod:367 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:367 +msgid "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-cd/#content" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2997 ../tools/virt-win-reg.pl:759 ../tools/virt-make-fs.pl:553 -msgid "BUGS" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:2999 -msgid "To get a list of bugs against libguestfs use this link:" +#: ../examples/guestfs-recipes.pod:369 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:369 +msgid "Uploading and downloading files" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3001 -msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3003 -msgid "To report a new bug against libguestfs use this link:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3005 -msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3007 -msgid "When reporting a bug, please check:" -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3013 -msgid "That the bug hasn't been reported already." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3017 -msgid "That you are testing a recent version." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3021 -msgid "Describe the bug accurately, and give a way to reproduce it." -msgstr "" - -#. type: textblock -#: ../src/guestfs.pod:3025 +#: ../examples/guestfs-recipes.pod:371 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:371 msgid "" -"Run libguestfs-test-tool and paste the B<complete, unedited> output into the " -"bug report." -msgstr "" - -#. type: =head1 -#: ../src/guestfs.pod:3030 ../fish/guestfish.pod:1238 ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:290 -msgid "AUTHORS" +"The link below contains general tips on uploading (copying in) and " +"downloading (copying out) files from VMs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3032 ../fish/guestfish.pod:1240 ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:292 -msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" +#: ../examples/guestfs-recipes.pod:374 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:374 +msgid "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:3034 ../fish/guestfish.pod:1242 ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:294 ../tools/virt-win-reg.pl:774 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273 -msgid "COPYRIGHT" +#: ../examples/guestfs-recipes.pod:376 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:376 +msgid "Use libguestfs tools on VMware ESX guests" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3036 ../fish/guestfish.pod:1244 ../test-tool/libguestfs-test-tool.pod:99 -msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>" +#: ../examples/guestfs-recipes.pod:378 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:378 +msgid "" +"The link below explains how to use libguestfs, L<guestfish(1)> and the virt " +"tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3039 -msgid "" -"This library is free software; you can redistribute it and/or modify it " -"under the terms of the GNU Lesser General Public License as published by the " -"Free Software Foundation; either version 2 of the License, or (at your " -"option) any later version." +#: ../examples/guestfs-recipes.pod:382 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:382 +msgid "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-guests/#content" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3044 +#: ../examples/guestfs-recipes.pod:386 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:386 msgid "" -"This library 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 Lesser General Public License " -"for more details." +"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, " +"L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-ruby(3)>, " +"L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:3049 -msgid "" -"You should have received a copy of the GNU Lesser General Public License " -"along with this library; if not, write to the Free Software Foundation, " -"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" +#: ../examples/guestfs-recipes.pod:401 ../libguestfs-1.11.19/examples/guestfs-recipes.pod:401 +msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1 -msgid "guestfs_add_cdrom" +#: ../fish/guestfish-actions.pod:1 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1 +msgid "add-cdrom" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3 +#: ../fish/guestfish-actions.pod:3 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3 #, no-wrap msgid "" -" int\n" -" guestfs_add_cdrom (guestfs_h *g,\n" -" const char *filename);\n" +" add-cdrom filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5 +#: ../fish/guestfish-actions.pod:5 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5 ../libguestfs-1.11.19/src/guestfs-actions.pod:7 ../src/guestfs-actions.pod:7 msgid "This function adds a virtual CD-ROM disk image to the guest." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7 +#: ../fish/guestfish-actions.pod:7 ../libguestfs-1.11.19/fish/guestfish-actions.pod:7 ../libguestfs-1.11.19/src/guestfs-actions.pod:9 ../src/guestfs-actions.pod:9 msgid "This is equivalent to the qemu parameter I<-cdrom filename>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:17 +#: ../fish/guestfish-actions.pod:15 ../libguestfs-1.11.19/fish/guestfish-actions.pod:15 msgid "" "This call checks for the existence of C<filename>. This stops you from " "specifying other types of drive which are supported by qemu such as C<nbd:> " -"and C<http:> URLs. To specify those, use the general C<guestfs_config> call " +"and C<http:> URLs. To specify those, use the general L</config> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:24 +#: ../fish/guestfish-actions.pod:22 ../libguestfs-1.11.19/fish/guestfish-actions.pod:22 msgid "" "If you just want to add an ISO file (often you use this as an efficient way " "to transfer large files into the guest), then you should probably use " -"C<guestfs_add_drive_ro> instead." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:858 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1214 ../src/guestfs-actions.pod:1234 ../src/guestfs-actions.pod:1304 ../src/guestfs-actions.pod:1335 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1757 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:2339 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:2544 ../src/guestfs-actions.pod:2579 ../src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3634 ../src/guestfs-actions.pod:3659 ../src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3889 ../src/guestfs-actions.pod:3904 ../src/guestfs-actions.pod:3940 ../src/guestfs-actions.pod:4012 ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4049 ../src/guestfs-actions.pod:4072 ../src/guestfs-actions.pod:4095 ../src/guestfs-actions.pod:4130 ../src/guestfs-actions.pod:4149 ../src/guestfs-actions.pod:4168 ../src/guestfs-actions.pod:4203 ../src/guestfs-actions.pod:4215 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4267 ../src/guestfs-actions.pod:4280 ../src/guestfs-actions.pod:4295 ../src/guestfs-actions.pod:4312 ../src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4425 ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:4489 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4525 ../src/guestfs-actions.pod:4541 ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:4569 ../src/guestfs-actions.pod:4586 ../src/guestfs-actions.pod:4601 ../src/guestfs-actions.pod:4621 ../src/guestfs-actions.pod:4691 ../src/guestfs-actions.pod:4764 ../src/guestfs-actions.pod:4795 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4833 ../src/guestfs-actions.pod:4845 ../src/guestfs-actions.pod:4862 ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:4890 ../src/guestfs-actions.pod:4905 ../src/guestfs-actions.pod:4940 ../src/guestfs-actions.pod:4973 ../src/guestfs-actions.pod:5012 ../src/guestfs-actions.pod:5032 ../src/guestfs-actions.pod:5046 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5112 ../src/guestfs-actions.pod:5158 ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:5248 ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:5300 ../src/guestfs-actions.pod:5318 ../src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5509 ../src/guestfs-actions.pod:5531 ../src/guestfs-actions.pod:5549 ../src/guestfs-actions.pod:5581 ../src/guestfs-actions.pod:5647 ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:5677 ../src/guestfs-actions.pod:5691 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:5999 ../src/guestfs-actions.pod:6018 ../src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6044 ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6070 ../src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6100 ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6140 ../src/guestfs-actions.pod:6159 ../src/guestfs-actions.pod:6189 ../src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:6230 ../src/guestfs-actions.pod:6248 ../src/guestfs-actions.pod:6267 ../src/guestfs-actions.pod:6288 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6324 ../src/guestfs-actions.pod:6343 ../src/guestfs-actions.pod:6369 ../src/guestfs-actions.pod:6393 ../src/guestfs-actions.pod:6412 ../src/guestfs-actions.pod:6436 ../src/guestfs-actions.pod:6455 ../src/guestfs-actions.pod:6470 ../src/guestfs-actions.pod:6489 ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6556 ../src/guestfs-actions.pod:6589 ../src/guestfs-actions.pod:6711 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6844 ../src/guestfs-actions.pod:6857 ../src/guestfs-actions.pod:6870 ../src/guestfs-actions.pod:6892 ../src/guestfs-actions.pod:6905 ../src/guestfs-actions.pod:6918 ../src/guestfs-actions.pod:6931 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:7005 ../src/guestfs-actions.pod:7022 ../src/guestfs-actions.pod:7038 ../src/guestfs-actions.pod:7054 ../src/guestfs-actions.pod:7071 ../src/guestfs-actions.pod:7084 ../src/guestfs-actions.pod:7104 ../src/guestfs-actions.pod:7140 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7195 ../src/guestfs-actions.pod:7208 ../src/guestfs-actions.pod:7226 ../src/guestfs-actions.pod:7260 ../src/guestfs-actions.pod:7296 ../src/guestfs-actions.pod:7412 ../src/guestfs-actions.pod:7427 ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7496 ../src/guestfs-actions.pod:7509 ../src/guestfs-actions.pod:7554 ../src/guestfs-actions.pod:7587 ../src/guestfs-actions.pod:7650 ../src/guestfs-actions.pod:7670 ../src/guestfs-actions.pod:7694 ../src/guestfs-actions.pod:7761 ../src/guestfs-actions.pod:7780 ../src/guestfs-actions.pod:7809 -msgid "This function returns 0 on success or -1 on error." +"L</add-drive-ro> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:275 ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 ../fish/guestfish-actions.pod:177 +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 ../fish/guestfish-actions.pod:177 ../libguestfs-1.11.19/fish/guestfish-actions.pod:28 ../libguestfs-1.11.19/fish/guestfish-actions.pod:163 ../libguestfs-1.11.19/fish/guestfish-actions.pod:177 ../libguestfs-1.11.19/src/guestfs-actions.pod:32 ../libguestfs-1.11.19/src/guestfs-actions.pod:254 ../libguestfs-1.11.19/src/guestfs-actions.pod:275 ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:275 msgid "" "This function is deprecated. In new code, use the C<add_drive_opts> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1513 ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:4626 ../src/guestfs-actions.pod:4945 ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5253 ../src/guestfs-actions.pod:6534 ../src/guestfs-actions.pod:6564 ../src/guestfs-actions.pod:6597 ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:7592 ../src/guestfs-actions.pod:7702 ../src/guestfs-actions.pod:7872 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360 ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292 ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4372 ../fish/guestfish-actions.pod:4394 ../fish/guestfish-actions.pod:4432 ../fish/guestfish-actions.pod:5081 ../fish/guestfish-actions.pod:5179 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360 ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292 ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454 ../fish/guestfish-actions.pod:4355 ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4400 ../fish/guestfish-actions.pod:4438 ../fish/guestfish-actions.pod:5087 ../fish/guestfish-actions.pod:5185 ../libguestfs-1.11.19/fish/guestfish-actions.pod:31 ../libguestfs-1.11.19/fish/guestfish-actions.pod:166 ../libguestfs-1.11.19/fish/guestfish-actions.pod:180 ../libguestfs-1.11.19/fish/guestfish-actions.pod:986 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1346 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1360 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3085 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3292 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3406 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3454 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4355 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4378 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4400 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4438 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5087 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5185 ../libguestfs-1.11.19/src/guestfs-actions.pod:35 ../libguestfs-1.11.19/src/guestfs-actions.pod:257 ../libguestfs-1.11.19/src/guestfs-actions.pod:278 ../libguestfs-1.11.19/src/guestfs-actions.pod:1513 ../libguestfs-1.11.19/src/guestfs-actions.pod:2008 ../libguestfs-1.11.19/src/guestfs-actions.pod:2029 ../libguestfs-1.11.19/src/guestfs-actions.pod:4628 ../libguestfs-1.11.19/src/guestfs-actions.pod:4947 ../libguestfs-1.11.19/src/guestfs-actions.pod:5165 ../libguestfs-1.11.19/src/guestfs-actions.pod:5255 ../libguestfs-1.11.19/src/guestfs-actions.pod:6544 ../libguestfs-1.11.19/src/guestfs-actions.pod:6574 ../libguestfs-1.11.19/src/guestfs-actions.pod:6607 ../libguestfs-1.11.19/src/guestfs-actions.pod:6666 ../libguestfs-1.11.19/src/guestfs-actions.pod:7602 ../libguestfs-1.11.19/src/guestfs-actions.pod:7714 ../libguestfs-1.11.19/src/guestfs-actions.pod:7884 ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1513 ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:4628 ../src/guestfs-actions.pod:4947 ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5255 ../src/guestfs-actions.pod:6544 ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:6607 ../src/guestfs-actions.pod:6666 ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:7714 ../src/guestfs-actions.pod:7884 msgid "" "Deprecated functions will not be removed from the API, but the fact that " "they are deprecated indicates that there are problems with correct use of " "these functions." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1165 ../src/guestfs-actions.pod:1980 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2190 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3641 ../src/guestfs-actions.pod:4949 ../src/guestfs-actions.pod:6209 ../src/guestfs-actions.pod:6326 ../src/guestfs-actions.pod:6457 ../src/guestfs-actions.pod:6948 ../src/guestfs-actions.pod:7073 ../src/guestfs-actions.pod:7596 -msgid "(Added in 0.3)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:41 -msgid "guestfs_add_domain" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:43 -#, no-wrap -msgid "" -" int\n" -" guestfs_add_domain (guestfs_h *g,\n" -" const char *dom,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:35 ../libguestfs-1.11.19/fish/guestfish-actions.pod:35 +msgid "add-domain" msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:832 ../src/guestfs-actions.pod:2824 ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:4959 ../src/guestfs-actions.pod:5176 -msgid "" -"You may supply a list of optional arguments to this call. Use zero or more " -"of the following pairs of parameters, and terminate the list with C<-1> on " -"its own. See L</CALLS WITH OPTIONAL ARGUMENTS>." +#. type: =head2 +#: ../fish/guestfish-actions.pod:37 ../libguestfs-1.11.19/fish/guestfish-actions.pod:37 +msgid "domain" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:53 +#: ../fish/guestfish-actions.pod:39 ../libguestfs-1.11.19/fish/guestfish-actions.pod:39 #, no-wrap msgid "" -" GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n" -" GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n" -" GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n" -" GUESTFS_ADD_DOMAIN_LIVE, int live,\n" -" GUESTFS_ADD_DOMAIN_ALLOWUUID, int allowuuid,\n" +" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] " +"[allowuuid:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:59 +#: ../fish/guestfish-actions.pod:41 ../libguestfs-1.11.19/fish/guestfish-actions.pod:41 msgid "" "This function adds the disk(s) attached to the named libvirt domain C<dom>. " "It works by connecting to libvirt, requesting the domain and domain XML from " -"libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each " -"one." +"libvirt, parsing it for disks, and calling L</add-drive-opts> on each one." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:64 ../fish/guestfish-actions.pod:46 +#: ../fish/guestfish-actions.pod:46 ../libguestfs-1.11.19/fish/guestfish-actions.pod:46 ../libguestfs-1.11.19/src/guestfs-actions.pod:64 ../src/guestfs-actions.pod:64 msgid "" "The number of disks added is returned. This operation is atomic: if an " "error is returned, then no disks are added." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:67 ../fish/guestfish-actions.pod:49 +#: ../fish/guestfish-actions.pod:49 ../libguestfs-1.11.19/fish/guestfish-actions.pod:49 ../libguestfs-1.11.19/src/guestfs-actions.pod:67 ../src/guestfs-actions.pod:67 msgid "" "This function does some minimal checks to make sure the libvirt domain is " "not running (unless C<readonly> is true). In a future version we will try " @@ -5964,7 +3766,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:71 ../fish/guestfish-actions.pod:53 +#: ../fish/guestfish-actions.pod:53 ../libguestfs-1.11.19/fish/guestfish-actions.pod:53 ../libguestfs-1.11.19/src/guestfs-actions.pod:71 ../src/guestfs-actions.pod:71 msgid "" "Disks must be accessible locally. This often means that adding disks from a " "remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail " @@ -5972,7 +3774,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:76 ../fish/guestfish-actions.pod:58 +#: ../fish/guestfish-actions.pod:58 ../libguestfs-1.11.19/fish/guestfish-actions.pod:58 ../libguestfs-1.11.19/src/guestfs-actions.pod:76 ../src/guestfs-actions.pod:76 msgid "" "The optional C<libvirturi> parameter sets the libvirt URI (see " "L<http://libvirt.org/uri.html>). If this is not set then we connect to the " @@ -5981,7 +3783,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:82 ../fish/guestfish-actions.pod:64 +#: ../fish/guestfish-actions.pod:64 ../libguestfs-1.11.19/fish/guestfish-actions.pod:64 ../libguestfs-1.11.19/src/guestfs-actions.pod:82 ../src/guestfs-actions.pod:82 msgid "" "The optional C<live> flag controls whether this call will try to connect to " "a running virtual machine C<guestfsd> process if it sees a suitable " @@ -5991,7 +3793,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:89 ../fish/guestfish-actions.pod:71 +#: ../fish/guestfish-actions.pod:71 ../libguestfs-1.11.19/fish/guestfish-actions.pod:71 ../libguestfs-1.11.19/src/guestfs-actions.pod:89 ../src/guestfs-actions.pod:89 msgid "" "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be " "passed instead of the domain name. The C<dom> string is treated as a UUID " @@ -6000,130 +3802,70 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:94 +#: ../fish/guestfish-actions.pod:76 ../libguestfs-1.11.19/fish/guestfish-actions.pod:76 msgid "" "The other optional parameters are passed directly through to " -"C<guestfs_add_drive_opts>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350 ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:693 ../src/guestfs-actions.pod:724 ../src/guestfs-actions.pod:742 ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:1380 ../src/guestfs-actions.pod:1736 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:2050 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2154 ../src/guestfs-actions.pod:2177 ../src/guestfs-actions.pod:2470 ../src/guestfs-actions.pod:2942 ../src/guestfs-actions.pod:2960 ../src/guestfs-actions.pod:5135 ../src/guestfs-actions.pod:5355 ../src/guestfs-actions.pod:5761 ../src/guestfs-actions.pod:5787 ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7607 ../src/guestfs-actions.pod:7620 ../src/guestfs-actions.pod:7633 -msgid "On error this function returns -1." +"L</add-drive-opts>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:99 -msgid "(Added in 1.7.4)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:101 -msgid "guestfs_add_domain_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:103 -#, no-wrap +#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143 ../fish/guestfish-actions.pod:568 ../fish/guestfish-actions.pod:1968 ../fish/guestfish-actions.pod:3134 ../fish/guestfish-actions.pod:3307 ../fish/guestfish-actions.pod:3442 ../libguestfs-1.11.19/fish/guestfish-actions.pod:79 ../libguestfs-1.11.19/fish/guestfish-actions.pod:143 ../libguestfs-1.11.19/fish/guestfish-actions.pod:568 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1968 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3134 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3307 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3442 msgid "" -" int\n" -" guestfs_add_domain_va (guestfs_h *g,\n" -" const char *dom,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:108 -msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225 ../src/guestfs-actions.pod:871 ../src/guestfs-actions.pod:882 ../src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:2920 ../src/guestfs-actions.pod:4705 ../src/guestfs-actions.pod:4717 ../src/guestfs-actions.pod:4987 ../src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:5225 ../src/guestfs-actions.pod:5236 -msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:112 -msgid "guestfs_add_domain_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:114 -#, no-wrap -msgid "" -" int\n" -" guestfs_add_domain_argv (guestfs_h *g,\n" -" const char *dom,\n" -" const struct guestfs_add_domain_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:119 -msgid "This is the \"argv variant\" of L</guestfs_add_domain>." +"This command has one or more optional arguments. See L</OPTIONAL " +"ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:123 -msgid "guestfs_add_drive" +#: ../fish/guestfish-actions.pod:81 ../libguestfs-1.11.19/fish/guestfish-actions.pod:81 +msgid "add-drive" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:125 +#: ../fish/guestfish-actions.pod:83 ../libguestfs-1.11.19/fish/guestfish-actions.pod:83 #, no-wrap msgid "" -" int\n" -" guestfs_add_drive (guestfs_h *g,\n" -" const char *filename);\n" +" add-drive filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:129 +#: ../fish/guestfish-actions.pod:85 ../libguestfs-1.11.19/fish/guestfish-actions.pod:85 msgid "" -"This function is the equivalent of calling C<guestfs_add_drive_opts> with no " +"This function is the equivalent of calling L</add-drive-opts> with no " "optional parameters, so the disk is added writable, with the format being " "detected automatically." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:133 +#: ../fish/guestfish-actions.pod:89 ../libguestfs-1.11.19/fish/guestfish-actions.pod:89 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " "RHBZ#642934. Specifying the format closes this security hole. Therefore " "you should think about replacing calls to this function with calls to " -"C<guestfs_add_drive_opts>, and specifying the format." +"L</add-drive-opts>, and specifying the format." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:144 -msgid "guestfs_add_drive_opts" +#: ../fish/guestfish-actions.pod:96 ../libguestfs-1.11.19/fish/guestfish-actions.pod:96 +msgid "add-drive-opts" msgstr "" -#. type: verbatim -#: ../src/guestfs-actions.pod:146 -#, no-wrap -msgid "" -" int\n" -" guestfs_add_drive_opts (guestfs_h *g,\n" -" const char *filename,\n" -" ...);\n" -"\n" +#. type: =head2 +#: ../fish/guestfish-actions.pod:98 ../libguestfs-1.11.19/fish/guestfish-actions.pod:98 +msgid "add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:156 +#: ../fish/guestfish-actions.pod:100 ../libguestfs-1.11.19/fish/guestfish-actions.pod:100 #, no-wrap msgid "" -" GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n" -" GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n" -" GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n" +" add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:160 ../fish/guestfish-actions.pod:102 +#: ../fish/guestfish-actions.pod:102 ../libguestfs-1.11.19/fish/guestfish-actions.pod:102 ../libguestfs-1.11.19/src/guestfs-actions.pod:160 ../src/guestfs-actions.pod:160 msgid "" "This function adds a virtual machine disk image C<filename> to libguestfs. " "The first time you call this function, the disk appears as C</dev/sda>, the " @@ -6131,7 +3873,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:107 +#: ../fish/guestfish-actions.pod:107 ../libguestfs-1.11.19/fish/guestfish-actions.pod:107 ../libguestfs-1.11.19/src/guestfs-actions.pod:165 ../src/guestfs-actions.pod:165 msgid "" "You don't necessarily need to be root when using libguestfs. However you " "obviously do need sufficient permissions to access the filename for whatever " @@ -6140,22 +3882,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:113 +#: ../fish/guestfish-actions.pod:113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:113 ../libguestfs-1.11.19/src/guestfs-actions.pod:171 ../src/guestfs-actions.pod:171 msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4653 ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3096 +#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3096 ../libguestfs-1.11.19/fish/guestfish-actions.pod:115 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3096 ../libguestfs-1.11.19/src/guestfs-actions.pod:173 ../libguestfs-1.11.19/src/guestfs-actions.pod:4655 ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4655 msgid "The optional arguments are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:119 +#: ../fish/guestfish-actions.pod:119 ../libguestfs-1.11.19/fish/guestfish-actions.pod:119 ../libguestfs-1.11.19/src/guestfs-actions.pod:177 ../src/guestfs-actions.pod:177 msgid "C<readonly>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:179 ../fish/guestfish-actions.pod:121 +#: ../fish/guestfish-actions.pod:121 ../libguestfs-1.11.19/fish/guestfish-actions.pod:121 ../libguestfs-1.11.19/src/guestfs-actions.pod:179 ../src/guestfs-actions.pod:179 msgid "" "If true then the image is treated as read-only. Writes are still allowed, " "but they are stored in a temporary snapshot overlay which is discarded at " @@ -6163,20 +3905,20 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:125 +#: ../fish/guestfish-actions.pod:125 ../libguestfs-1.11.19/fish/guestfish-actions.pod:125 ../libguestfs-1.11.19/src/guestfs-actions.pod:183 ../src/guestfs-actions.pod:183 msgid "C<format>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:185 +#: ../fish/guestfish-actions.pod:127 ../libguestfs-1.11.19/fish/guestfish-actions.pod:127 msgid "" -"This forces the image format. If you omit this (or use C<guestfs_add_drive> " -"or C<guestfs_add_drive_ro>) then the format is automatically detected. " -"Possible formats include C<raw> and C<qcow2>." +"This forces the image format. If you omit this (or use L</add-drive> or " +"L</add-drive-ro>) then the format is automatically detected. Possible " +"formats include C<raw> and C<qcow2>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:189 ../fish/guestfish-actions.pod:131 +#: ../fish/guestfish-actions.pod:131 ../libguestfs-1.11.19/fish/guestfish-actions.pod:131 ../libguestfs-1.11.19/src/guestfs-actions.pod:189 ../src/guestfs-actions.pod:189 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -6184,319 +3926,219 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:194 ../fish/guestfish-actions.pod:136 +#: ../fish/guestfish-actions.pod:136 ../libguestfs-1.11.19/fish/guestfish-actions.pod:136 ../libguestfs-1.11.19/src/guestfs-actions.pod:194 ../src/guestfs-actions.pod:194 msgid "C<iface>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:196 +#: ../fish/guestfish-actions.pod:138 ../libguestfs-1.11.19/fish/guestfish-actions.pod:138 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " -"C<guestfs_add_drive_with_if> call (q.v.)" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:203 -msgid "(Added in 1.5.23)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:205 -msgid "guestfs_add_drive_opts_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:207 -#, no-wrap -msgid "" -" int\n" -" guestfs_add_drive_opts_va (guestfs_h *g,\n" -" const char *filename,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:212 -msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>." +"L</add-drive-with-if> call (q.v.)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:216 -msgid "guestfs_add_drive_opts_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:218 -#, no-wrap -msgid "" -" int\n" -" guestfs_add_drive_opts_argv (guestfs_h *g,\n" -" const char *filename,\n" -" const struct guestfs_add_drive_opts_argv " -"*optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:223 -msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>." +#: ../fish/guestfish-actions.pod:145 ../libguestfs-1.11.19/fish/guestfish-actions.pod:145 +msgid "add-drive-ro" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:227 -msgid "guestfs_add_drive_ro" +#: ../fish/guestfish-actions.pod:147 ../libguestfs-1.11.19/fish/guestfish-actions.pod:147 +msgid "add-ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:229 +#: ../fish/guestfish-actions.pod:149 ../libguestfs-1.11.19/fish/guestfish-actions.pod:149 #, no-wrap msgid "" -" int\n" -" guestfs_add_drive_ro (guestfs_h *g,\n" -" const char *filename);\n" +" add-drive-ro filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:233 +#: ../fish/guestfish-actions.pod:151 ../libguestfs-1.11.19/fish/guestfish-actions.pod:151 msgid "" -"This function is the equivalent of calling C<guestfs_add_drive_opts> with " -"the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the " -"disk is added read-only, with the format being detected automatically." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:240 -msgid "(Added in 1.0.38)" +"This function is the equivalent of calling L</add-drive-opts> with the " +"optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk " +"is added read-only, with the format being detected automatically." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:242 -msgid "guestfs_add_drive_ro_with_if" +#: ../fish/guestfish-actions.pod:156 ../libguestfs-1.11.19/fish/guestfish-actions.pod:156 +msgid "add-drive-ro-with-if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:244 +#: ../fish/guestfish-actions.pod:158 ../libguestfs-1.11.19/fish/guestfish-actions.pod:158 #, no-wrap msgid "" -" int\n" -" guestfs_add_drive_ro_with_if (guestfs_h *g,\n" -" const char *filename,\n" -" const char *iface);\n" +" add-drive-ro-with-if filename iface\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:249 +#: ../fish/guestfish-actions.pod:160 ../libguestfs-1.11.19/fish/guestfish-actions.pod:160 msgid "" -"This is the same as C<guestfs_add_drive_ro> but it allows you to specify the " -"QEMU interface emulation to use at run time." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282 ../src/guestfs-actions.pod:2429 -msgid "(Added in 1.0.84)" +"This is the same as L</add-drive-ro> but it allows you to specify the QEMU " +"interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:263 -msgid "guestfs_add_drive_with_if" +#: ../fish/guestfish-actions.pod:170 ../libguestfs-1.11.19/fish/guestfish-actions.pod:170 +msgid "add-drive-with-if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:265 +#: ../fish/guestfish-actions.pod:172 ../libguestfs-1.11.19/fish/guestfish-actions.pod:172 #, no-wrap msgid "" -" int\n" -" guestfs_add_drive_with_if (guestfs_h *g,\n" -" const char *filename,\n" -" const char *iface);\n" +" add-drive-with-if filename iface\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:270 +#: ../fish/guestfish-actions.pod:174 ../libguestfs-1.11.19/fish/guestfish-actions.pod:174 msgid "" -"This is the same as C<guestfs_add_drive> but it allows you to specify the " -"QEMU interface emulation to use at run time." +"This is the same as L</add-drive> but it allows you to specify the QEMU " +"interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:284 -msgid "guestfs_aug_clear" +#: ../fish/guestfish-actions.pod:184 ../libguestfs-1.11.19/fish/guestfish-actions.pod:184 +msgid "aug-clear" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:286 +#: ../fish/guestfish-actions.pod:186 ../libguestfs-1.11.19/fish/guestfish-actions.pod:186 #, no-wrap msgid "" -" int\n" -" guestfs_aug_clear (guestfs_h *g,\n" -" const char *augpath);\n" +" aug-clear augpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:290 ../fish/guestfish-actions.pod:188 +#: ../fish/guestfish-actions.pod:188 ../libguestfs-1.11.19/fish/guestfish-actions.pod:188 ../libguestfs-1.11.19/src/guestfs-actions.pod:290 ../src/guestfs-actions.pod:290 msgid "" "Set the value associated with C<path> to C<NULL>. This is the same as the " "L<augtool(1)> C<clear> command." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2179 -msgid "(Added in 1.3.4)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:297 -msgid "guestfs_aug_close" +#: ../fish/guestfish-actions.pod:191 ../libguestfs-1.11.19/fish/guestfish-actions.pod:191 +msgid "aug-close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:299 +#: ../fish/guestfish-actions.pod:193 ../libguestfs-1.11.19/fish/guestfish-actions.pod:193 #, no-wrap msgid "" -" int\n" -" guestfs_aug_close (guestfs_h *g);\n" +" aug-close\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:302 +#: ../fish/guestfish-actions.pod:195 ../libguestfs-1.11.19/fish/guestfish-actions.pod:195 msgid "" "Close the current Augeas handle and free up any resources used by it. After " -"calling this, you have to call C<guestfs_aug_init> again before you can use " -"any other Augeas functions." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366 ../src/guestfs-actions.pod:424 ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:5838 -msgid "(Added in 0.7)" +"calling this, you have to call L</aug-init> again before you can use any " +"other Augeas functions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:311 -msgid "guestfs_aug_defnode" +#: ../fish/guestfish-actions.pod:200 ../libguestfs-1.11.19/fish/guestfish-actions.pod:200 +msgid "aug-defnode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:313 +#: ../fish/guestfish-actions.pod:202 ../libguestfs-1.11.19/fish/guestfish-actions.pod:202 #, no-wrap msgid "" -" struct guestfs_int_bool *\n" -" guestfs_aug_defnode (guestfs_h *g,\n" -" const char *name,\n" -" const char *expr,\n" -" const char *val);\n" +" aug-defnode name expr val\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:319 ../fish/guestfish-actions.pod:204 +#: ../fish/guestfish-actions.pod:204 ../libguestfs-1.11.19/fish/guestfish-actions.pod:204 ../libguestfs-1.11.19/src/guestfs-actions.pod:319 ../src/guestfs-actions.pod:319 msgid "Defines a variable C<name> whose value is the result of evaluating C<expr>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:322 +#: ../fish/guestfish-actions.pod:207 ../libguestfs-1.11.19/fish/guestfish-actions.pod:207 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " -"calling C<guestfs_aug_set> C<expr>, C<value>. C<name> will be the nodeset " +"calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset " "containing that single node." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:326 ../fish/guestfish-actions.pod:211 +#: ../fish/guestfish-actions.pod:211 ../libguestfs-1.11.19/fish/guestfish-actions.pod:211 ../libguestfs-1.11.19/src/guestfs-actions.pod:326 ../src/guestfs-actions.pod:326 msgid "" "On success this returns a pair containing the number of nodes in the " "nodeset, and a boolean flag if a node was created." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:330 -msgid "" -"This function returns a C<struct guestfs_int_bool *>, or NULL if there was " -"an error. I<The caller must call C<guestfs_free_int_bool> after use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:336 -msgid "guestfs_aug_defvar" +#: ../fish/guestfish-actions.pod:215 ../libguestfs-1.11.19/fish/guestfish-actions.pod:215 +msgid "aug-defvar" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:338 +#: ../fish/guestfish-actions.pod:217 ../libguestfs-1.11.19/fish/guestfish-actions.pod:217 #, no-wrap msgid "" -" int\n" -" guestfs_aug_defvar (guestfs_h *g,\n" -" const char *name,\n" -" const char *expr);\n" +" aug-defvar name expr\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:343 ../fish/guestfish-actions.pod:219 +#: ../fish/guestfish-actions.pod:219 ../libguestfs-1.11.19/fish/guestfish-actions.pod:219 ../libguestfs-1.11.19/src/guestfs-actions.pod:343 ../src/guestfs-actions.pod:343 msgid "" "Defines an Augeas variable C<name> whose value is the result of evaluating " "C<expr>. If C<expr> is NULL, then C<name> is undefined." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:347 ../fish/guestfish-actions.pod:223 +#: ../fish/guestfish-actions.pod:223 ../libguestfs-1.11.19/fish/guestfish-actions.pod:223 ../libguestfs-1.11.19/src/guestfs-actions.pod:347 ../src/guestfs-actions.pod:347 msgid "" "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> " "evaluates to something which is not a nodeset." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:354 -msgid "guestfs_aug_get" +#: ../fish/guestfish-actions.pod:226 ../libguestfs-1.11.19/fish/guestfish-actions.pod:226 +msgid "aug-get" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:356 +#: ../fish/guestfish-actions.pod:228 ../libguestfs-1.11.19/fish/guestfish-actions.pod:228 #, no-wrap msgid "" -" char *\n" -" guestfs_aug_get (guestfs_h *g,\n" -" const char *augpath);\n" +" aug-get augpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:360 ../fish/guestfish-actions.pod:230 +#: ../fish/guestfish-actions.pod:230 ../libguestfs-1.11.19/fish/guestfish-actions.pod:230 ../libguestfs-1.11.19/src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:360 msgid "" "Look up the value associated with C<path>. If C<path> matches exactly one " "node, the C<value> is returned." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:922 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1249 ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:2023 ../src/guestfs-actions.pod:2202 ../src/guestfs-actions.pod:2394 ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:2811 ../src/guestfs-actions.pod:3025 ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074 ../src/guestfs-actions.pod:3108 ../src/guestfs-actions.pod:3167 ../src/guestfs-actions.pod:3187 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3834 ../src/guestfs-actions.pod:4187 ../src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:4467 ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:5566 ../src/guestfs-actions.pod:5736 ../src/guestfs-actions.pod:5914 ../src/guestfs-actions.pod:5963 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:6633 ../src/guestfs-actions.pod:6650 ../src/guestfs-actions.pod:6681 ../src/guestfs-actions.pod:7355 ../src/guestfs-actions.pod:7374 ../src/guestfs-actions.pod:7392 ../src/guestfs-actions.pod:7566 ../src/guestfs-actions.pod:7866 -msgid "" -"This function returns a string, or NULL on error. I<The caller must free " -"the returned string after use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:368 -msgid "guestfs_aug_init" +#: ../fish/guestfish-actions.pod:233 ../libguestfs-1.11.19/fish/guestfish-actions.pod:233 +msgid "aug-init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:370 +#: ../fish/guestfish-actions.pod:235 ../libguestfs-1.11.19/fish/guestfish-actions.pod:235 #, no-wrap msgid "" -" int\n" -" guestfs_aug_init (guestfs_h *g,\n" -" const char *root,\n" -" int flags);\n" +" aug-init root flags\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:375 ../fish/guestfish-actions.pod:237 +#: ../fish/guestfish-actions.pod:237 ../libguestfs-1.11.19/fish/guestfish-actions.pod:237 ../libguestfs-1.11.19/src/guestfs-actions.pod:375 ../src/guestfs-actions.pod:375 msgid "" "Create a new Augeas handle for editing configuration files. If there was " "any previous Augeas handle associated with this guestfs session, then it is " @@ -6504,201 +4146,179 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:379 -msgid "You must call this before using any other C<guestfs_aug_*> commands." +#: ../fish/guestfish-actions.pod:241 ../libguestfs-1.11.19/fish/guestfish-actions.pod:241 +msgid "You must call this before using any other L</aug-*> commands." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:382 ../fish/guestfish-actions.pod:244 +#: ../fish/guestfish-actions.pod:244 ../libguestfs-1.11.19/fish/guestfish-actions.pod:244 ../libguestfs-1.11.19/src/guestfs-actions.pod:382 ../src/guestfs-actions.pod:382 msgid "C<root> is the filesystem root. C<root> must not be NULL, use C</> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:247 +#: ../fish/guestfish-actions.pod:247 ../libguestfs-1.11.19/fish/guestfish-actions.pod:247 ../libguestfs-1.11.19/src/guestfs-actions.pod:385 ../src/guestfs-actions.pod:385 msgid "" "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the " "logical I<or> of the following integers:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:253 +#: ../fish/guestfish-actions.pod:253 ../libguestfs-1.11.19/fish/guestfish-actions.pod:253 ../libguestfs-1.11.19/src/guestfs-actions.pod:391 ../src/guestfs-actions.pod:391 msgid "C<AUG_SAVE_BACKUP> = 1" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:393 ../fish/guestfish-actions.pod:255 +#: ../fish/guestfish-actions.pod:255 ../libguestfs-1.11.19/fish/guestfish-actions.pod:255 ../libguestfs-1.11.19/src/guestfs-actions.pod:393 ../src/guestfs-actions.pod:393 msgid "Keep the original file with a C<.augsave> extension." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:395 ../fish/guestfish-actions.pod:257 +#: ../fish/guestfish-actions.pod:257 ../libguestfs-1.11.19/fish/guestfish-actions.pod:257 ../libguestfs-1.11.19/src/guestfs-actions.pod:395 ../src/guestfs-actions.pod:395 msgid "C<AUG_SAVE_NEWFILE> = 2" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:397 ../fish/guestfish-actions.pod:259 +#: ../fish/guestfish-actions.pod:259 ../libguestfs-1.11.19/fish/guestfish-actions.pod:259 ../libguestfs-1.11.19/src/guestfs-actions.pod:397 ../src/guestfs-actions.pod:397 msgid "" "Save changes into a file with extension C<.augnew>, and do not overwrite " "original. Overrides C<AUG_SAVE_BACKUP>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:262 +#: ../fish/guestfish-actions.pod:262 ../libguestfs-1.11.19/fish/guestfish-actions.pod:262 ../libguestfs-1.11.19/src/guestfs-actions.pod:400 ../src/guestfs-actions.pod:400 msgid "C<AUG_TYPE_CHECK> = 4" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:264 +#: ../fish/guestfish-actions.pod:264 ../libguestfs-1.11.19/fish/guestfish-actions.pod:264 ../libguestfs-1.11.19/src/guestfs-actions.pod:402 ../src/guestfs-actions.pod:402 msgid "Typecheck lenses (can be expensive)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:266 +#: ../fish/guestfish-actions.pod:266 ../libguestfs-1.11.19/fish/guestfish-actions.pod:266 ../libguestfs-1.11.19/src/guestfs-actions.pod:404 ../src/guestfs-actions.pod:404 msgid "C<AUG_NO_STDINC> = 8" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:268 +#: ../fish/guestfish-actions.pod:268 ../libguestfs-1.11.19/fish/guestfish-actions.pod:268 ../libguestfs-1.11.19/src/guestfs-actions.pod:406 ../src/guestfs-actions.pod:406 msgid "Do not use standard load path for modules." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:408 ../fish/guestfish-actions.pod:270 +#: ../fish/guestfish-actions.pod:270 ../libguestfs-1.11.19/fish/guestfish-actions.pod:270 ../libguestfs-1.11.19/src/guestfs-actions.pod:408 ../src/guestfs-actions.pod:408 msgid "C<AUG_SAVE_NOOP> = 16" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:410 ../fish/guestfish-actions.pod:272 +#: ../fish/guestfish-actions.pod:272 ../libguestfs-1.11.19/fish/guestfish-actions.pod:272 ../libguestfs-1.11.19/src/guestfs-actions.pod:410 ../src/guestfs-actions.pod:410 msgid "Make save a no-op, just record what would have been changed." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:412 ../fish/guestfish-actions.pod:274 +#: ../fish/guestfish-actions.pod:274 ../libguestfs-1.11.19/fish/guestfish-actions.pod:274 ../libguestfs-1.11.19/src/guestfs-actions.pod:412 ../src/guestfs-actions.pod:412 msgid "C<AUG_NO_LOAD> = 32" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:414 -msgid "Do not load the tree in C<guestfs_aug_init>." +#: ../fish/guestfish-actions.pod:276 ../libguestfs-1.11.19/fish/guestfish-actions.pod:276 +msgid "Do not load the tree in L</aug-init>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:418 -msgid "To close the handle, you can call C<guestfs_aug_close>." +#: ../fish/guestfish-actions.pod:280 ../libguestfs-1.11.19/fish/guestfish-actions.pod:280 +msgid "To close the handle, you can call L</aug-close>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:420 ../fish/guestfish-actions.pod:282 +#: ../fish/guestfish-actions.pod:282 ../libguestfs-1.11.19/fish/guestfish-actions.pod:282 ../libguestfs-1.11.19/src/guestfs-actions.pod:420 ../src/guestfs-actions.pod:420 msgid "To find out more about Augeas, see L<http://augeas.net/>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:426 -msgid "guestfs_aug_insert" +#: ../fish/guestfish-actions.pod:284 ../libguestfs-1.11.19/fish/guestfish-actions.pod:284 +msgid "aug-insert" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:428 +#: ../fish/guestfish-actions.pod:286 ../libguestfs-1.11.19/fish/guestfish-actions.pod:286 #, no-wrap msgid "" -" int\n" -" guestfs_aug_insert (guestfs_h *g,\n" -" const char *augpath,\n" -" const char *label,\n" -" int before);\n" +" aug-insert augpath label true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:434 ../fish/guestfish-actions.pod:288 +#: ../fish/guestfish-actions.pod:288 ../libguestfs-1.11.19/fish/guestfish-actions.pod:288 ../libguestfs-1.11.19/src/guestfs-actions.pod:434 ../src/guestfs-actions.pod:434 msgid "" "Create a new sibling C<label> for C<path>, inserting it into the tree before " "or after C<path> (depending on the boolean flag C<before>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:438 ../fish/guestfish-actions.pod:292 +#: ../fish/guestfish-actions.pod:292 ../libguestfs-1.11.19/fish/guestfish-actions.pod:292 ../libguestfs-1.11.19/src/guestfs-actions.pod:438 ../src/guestfs-actions.pod:438 msgid "" "C<path> must match exactly one existing node in the tree, and C<label> must " "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:446 -msgid "guestfs_aug_load" +#: ../fish/guestfish-actions.pod:296 ../libguestfs-1.11.19/fish/guestfish-actions.pod:296 +msgid "aug-load" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:448 +#: ../fish/guestfish-actions.pod:298 ../libguestfs-1.11.19/fish/guestfish-actions.pod:298 #, no-wrap msgid "" -" int\n" -" guestfs_aug_load (guestfs_h *g);\n" +" aug-load\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:451 ../fish/guestfish-actions.pod:300 +#: ../fish/guestfish-actions.pod:300 ../libguestfs-1.11.19/fish/guestfish-actions.pod:300 ../libguestfs-1.11.19/src/guestfs-actions.pod:451 ../src/guestfs-actions.pod:451 msgid "Load files into the tree." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:453 ../fish/guestfish-actions.pod:302 +#: ../fish/guestfish-actions.pod:302 ../libguestfs-1.11.19/fish/guestfish-actions.pod:302 ../libguestfs-1.11.19/src/guestfs-actions.pod:453 ../src/guestfs-actions.pod:453 msgid "See C<aug_load> in the Augeas documentation for the full gory details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:460 -msgid "guestfs_aug_ls" +#: ../fish/guestfish-actions.pod:305 ../libguestfs-1.11.19/fish/guestfish-actions.pod:305 +msgid "aug-ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:462 +#: ../fish/guestfish-actions.pod:307 ../libguestfs-1.11.19/fish/guestfish-actions.pod:307 #, no-wrap msgid "" -" char **\n" -" guestfs_aug_ls (guestfs_h *g,\n" -" const char *augpath);\n" +" aug-ls augpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:466 +#: ../fish/guestfish-actions.pod:309 ../libguestfs-1.11.19/fish/guestfish-actions.pod:309 msgid "" -"This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and " -"sorting the resulting nodes into alphabetical order." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:485 ../src/guestfs-actions.pod:631 ../src/guestfs-actions.pod:1138 ../src/guestfs-actions.pod:1434 ../src/guestfs-actions.pod:1453 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:1575 ../src/guestfs-actions.pod:1821 ../src/guestfs-actions.pod:2274 ../src/guestfs-actions.pod:2290 ../src/guestfs-actions.pod:2309 ../src/guestfs-actions.pod:2352 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2496 ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:3127 ../src/guestfs-actions.pod:3403 ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3754 ../src/guestfs-actions.pod:3816 ../src/guestfs-actions.pod:3921 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:5096 ../src/guestfs-actions.pod:5708 ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5948 ../src/guestfs-actions.pod:6697 ../src/guestfs-actions.pod:6758 ../src/guestfs-actions.pod:6813 ../src/guestfs-actions.pod:6959 ../src/guestfs-actions.pod:6983 ../src/guestfs-actions.pod:7459 ../src/guestfs-actions.pod:7479 ../src/guestfs-actions.pod:7526 ../src/guestfs-actions.pod:7718 ../src/guestfs-actions.pod:7737 ../src/guestfs-actions.pod:7823 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7888 ../src/guestfs-actions.pod:7907 -msgid "" -"This function returns a NULL-terminated array of strings (like " -"L<environ(3)>), or NULL if there was an error. I<The caller must free the " -"strings and the array after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:473 ../src/guestfs-actions.pod:1063 ../src/guestfs-actions.pod:1081 ../src/guestfs-actions.pod:1491 ../src/guestfs-actions.pod:3481 ../src/guestfs-actions.pod:3512 ../src/guestfs-actions.pod:4170 ../src/guestfs-actions.pod:4220 ../src/guestfs-actions.pod:4407 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:5100 ../src/guestfs-actions.pod:5649 ../src/guestfs-actions.pod:6046 ../src/guestfs-actions.pod:6060 ../src/guestfs-actions.pod:6072 ../src/guestfs-actions.pod:6538 ../src/guestfs-actions.pod:7197 ../src/guestfs-actions.pod:7210 ../src/guestfs-actions.pod:7443 ../src/guestfs-actions.pod:7706 -msgid "(Added in 0.8)" +"This is just a shortcut for listing L</aug-match> C<path/*> and sorting the " +"resulting nodes into alphabetical order." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:475 -msgid "guestfs_aug_match" +#: ../fish/guestfish-actions.pod:312 ../libguestfs-1.11.19/fish/guestfish-actions.pod:312 +msgid "aug-match" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:477 +#: ../fish/guestfish-actions.pod:314 ../libguestfs-1.11.19/fish/guestfish-actions.pod:314 #, no-wrap msgid "" -" char **\n" -" guestfs_aug_match (guestfs_h *g,\n" -" const char *augpath);\n" +" aug-match augpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:481 ../fish/guestfish-actions.pod:316 +#: ../fish/guestfish-actions.pod:316 ../libguestfs-1.11.19/fish/guestfish-actions.pod:316 ../libguestfs-1.11.19/src/guestfs-actions.pod:481 ../src/guestfs-actions.pod:481 msgid "" "Returns a list of paths which match the path expression C<path>. The " "returned paths are sufficiently qualified so that they match exactly one " @@ -6706,125 +4326,114 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:491 -msgid "guestfs_aug_mv" +#: ../fish/guestfish-actions.pod:320 ../libguestfs-1.11.19/fish/guestfish-actions.pod:320 +msgid "aug-mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:493 +#: ../fish/guestfish-actions.pod:322 ../libguestfs-1.11.19/fish/guestfish-actions.pod:322 #, no-wrap msgid "" -" int\n" -" guestfs_aug_mv (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest);\n" +" aug-mv src dest\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:498 ../fish/guestfish-actions.pod:324 +#: ../fish/guestfish-actions.pod:324 ../libguestfs-1.11.19/fish/guestfish-actions.pod:324 ../libguestfs-1.11.19/src/guestfs-actions.pod:498 ../src/guestfs-actions.pod:498 msgid "" "Move the node C<src> to C<dest>. C<src> must match exactly one node. " "C<dest> is overwritten if it exists." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:505 -msgid "guestfs_aug_rm" +#: ../fish/guestfish-actions.pod:327 ../libguestfs-1.11.19/fish/guestfish-actions.pod:327 +msgid "aug-rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:507 +#: ../fish/guestfish-actions.pod:329 ../libguestfs-1.11.19/fish/guestfish-actions.pod:329 #, no-wrap msgid "" -" int\n" -" guestfs_aug_rm (guestfs_h *g,\n" -" const char *augpath);\n" +" aug-rm augpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:511 ../fish/guestfish-actions.pod:331 +#: ../fish/guestfish-actions.pod:331 ../libguestfs-1.11.19/fish/guestfish-actions.pod:331 ../libguestfs-1.11.19/src/guestfs-actions.pod:511 ../src/guestfs-actions.pod:511 msgid "Remove C<path> and all of its children." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:513 ../fish/guestfish-actions.pod:333 +#: ../fish/guestfish-actions.pod:333 ../libguestfs-1.11.19/fish/guestfish-actions.pod:333 ../libguestfs-1.11.19/src/guestfs-actions.pod:513 ../src/guestfs-actions.pod:513 msgid "On success this returns the number of entries which were removed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:519 -msgid "guestfs_aug_save" +#: ../fish/guestfish-actions.pod:335 ../libguestfs-1.11.19/fish/guestfish-actions.pod:335 +msgid "aug-save" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:521 +#: ../fish/guestfish-actions.pod:337 ../libguestfs-1.11.19/fish/guestfish-actions.pod:337 #, no-wrap msgid "" -" int\n" -" guestfs_aug_save (guestfs_h *g);\n" +" aug-save\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:524 ../fish/guestfish-actions.pod:339 +#: ../fish/guestfish-actions.pod:339 ../libguestfs-1.11.19/fish/guestfish-actions.pod:339 ../libguestfs-1.11.19/src/guestfs-actions.pod:524 ../src/guestfs-actions.pod:524 msgid "This writes all pending changes to disk." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:526 +#: ../fish/guestfish-actions.pod:341 ../libguestfs-1.11.19/fish/guestfish-actions.pod:341 msgid "" -"The flags which were passed to C<guestfs_aug_init> affect exactly how files " -"are saved." +"The flags which were passed to L</aug-init> affect exactly how files are " +"saved." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:533 -msgid "guestfs_aug_set" +#: ../fish/guestfish-actions.pod:344 ../libguestfs-1.11.19/fish/guestfish-actions.pod:344 +msgid "aug-set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:535 +#: ../fish/guestfish-actions.pod:346 ../libguestfs-1.11.19/fish/guestfish-actions.pod:346 #, no-wrap msgid "" -" int\n" -" guestfs_aug_set (guestfs_h *g,\n" -" const char *augpath,\n" -" const char *val);\n" +" aug-set augpath val\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:540 ../fish/guestfish-actions.pod:348 +#: ../fish/guestfish-actions.pod:348 ../libguestfs-1.11.19/fish/guestfish-actions.pod:348 ../libguestfs-1.11.19/src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:540 msgid "Set the value associated with C<path> to C<val>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:542 +#: ../fish/guestfish-actions.pod:350 ../libguestfs-1.11.19/fish/guestfish-actions.pod:350 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " -"this call. Instead you must use the C<guestfs_aug_clear> call." +"this call. Instead you must use the L</aug-clear> call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:551 -msgid "guestfs_available" +#: ../fish/guestfish-actions.pod:355 ../libguestfs-1.11.19/fish/guestfish-actions.pod:355 +msgid "available" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:553 +#: ../fish/guestfish-actions.pod:357 ../libguestfs-1.11.19/fish/guestfish-actions.pod:357 #, no-wrap msgid "" -" int\n" -" guestfs_available (guestfs_h *g,\n" -" char *const *groups);\n" +" available 'groups ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:359 +#: ../fish/guestfish-actions.pod:359 ../libguestfs-1.11.19/fish/guestfish-actions.pod:359 ../libguestfs-1.11.19/src/guestfs-actions.pod:557 ../src/guestfs-actions.pod:557 msgid "" "This command is used to check the availability of some groups of " "functionality in the appliance, which not all builds of the libguestfs " @@ -6832,15 +4441,15 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:561 +#: ../fish/guestfish-actions.pod:363 ../libguestfs-1.11.19/fish/guestfish-actions.pod:363 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " -"runtime by calling C<guestfs_available_all_groups>." +"runtime by calling L</available-all-groups>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:566 ../fish/guestfish-actions.pod:368 +#: ../fish/guestfish-actions.pod:368 ../libguestfs-1.11.19/fish/guestfish-actions.pod:368 ../libguestfs-1.11.19/src/guestfs-actions.pod:566 ../src/guestfs-actions.pod:566 msgid "" "The argument C<groups> is a list of group names, eg: C<[\"inotify\", " "\"augeas\"]> would check for the availability of the Linux inotify functions " @@ -6848,43 +4457,43 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:571 ../fish/guestfish-actions.pod:373 +#: ../fish/guestfish-actions.pod:373 ../libguestfs-1.11.19/fish/guestfish-actions.pod:373 ../libguestfs-1.11.19/src/guestfs-actions.pod:571 ../src/guestfs-actions.pod:571 msgid "The command returns no error if I<all> requested groups are available." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:375 +#: ../fish/guestfish-actions.pod:375 ../libguestfs-1.11.19/fish/guestfish-actions.pod:375 ../libguestfs-1.11.19/src/guestfs-actions.pod:573 ../src/guestfs-actions.pod:573 msgid "" "It fails with an error if one or more of the requested groups is unavailable " "in the appliance." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:576 ../fish/guestfish-actions.pod:378 +#: ../fish/guestfish-actions.pod:378 ../libguestfs-1.11.19/fish/guestfish-actions.pod:378 ../libguestfs-1.11.19/src/guestfs-actions.pod:576 ../src/guestfs-actions.pod:576 msgid "" "If an unknown group name is included in the list of groups then an error is " "always returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:579 ../fish/guestfish-actions.pod:381 +#: ../fish/guestfish-actions.pod:381 ../libguestfs-1.11.19/fish/guestfish-actions.pod:381 ../libguestfs-1.11.19/src/guestfs-actions.pod:579 ../src/guestfs-actions.pod:579 msgid "I<Notes:>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:585 -msgid "You must call C<guestfs_launch> before calling this function." +#: ../fish/guestfish-actions.pod:387 ../libguestfs-1.11.19/fish/guestfish-actions.pod:387 +msgid "You must call L</launch> before calling this function." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:389 +#: ../fish/guestfish-actions.pod:389 ../libguestfs-1.11.19/fish/guestfish-actions.pod:389 ../libguestfs-1.11.19/src/guestfs-actions.pod:587 ../src/guestfs-actions.pod:587 msgid "" "The reason is because we don't know what groups are supported by the " "appliance/daemon until it is running and can be queried." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:593 ../fish/guestfish-actions.pod:395 +#: ../fish/guestfish-actions.pod:395 ../libguestfs-1.11.19/fish/guestfish-actions.pod:395 ../libguestfs-1.11.19/src/guestfs-actions.pod:593 ../src/guestfs-actions.pod:593 msgid "" "If a group of functions is available, this does not necessarily mean that " "they will work. You still have to check for errors when calling individual " @@ -6892,7 +4501,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:600 ../fish/guestfish-actions.pod:402 +#: ../fish/guestfish-actions.pod:402 ../libguestfs-1.11.19/fish/guestfish-actions.pod:402 ../libguestfs-1.11.19/src/guestfs-actions.pod:600 ../src/guestfs-actions.pod:600 msgid "" "It is usually the job of distro packagers to build complete functionality " "into the libguestfs appliance. Upstream libguestfs, if built from source " @@ -6900,379 +4509,318 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:607 +#: ../fish/guestfish-actions.pod:409 ../libguestfs-1.11.19/fish/guestfish-actions.pod:409 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " -"find out if the daemon implemented it. See also C<guestfs_version>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:616 ../src/guestfs-actions.pod:1236 -msgid "(Added in 1.0.80)" +"find out if the daemon implemented it. See also L</version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:618 -msgid "guestfs_available_all_groups" +#: ../fish/guestfish-actions.pod:416 ../libguestfs-1.11.19/fish/guestfish-actions.pod:416 +msgid "available-all-groups" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:620 +#: ../fish/guestfish-actions.pod:418 ../libguestfs-1.11.19/fish/guestfish-actions.pod:418 #, no-wrap msgid "" -" char **\n" -" guestfs_available_all_groups (guestfs_h *g);\n" +" available-all-groups\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:623 +#: ../fish/guestfish-actions.pod:420 ../libguestfs-1.11.19/fish/guestfish-actions.pod:420 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " "out which ones the daemon can actually support you have to call " -"C<guestfs_available> on each member of the returned list." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:629 -msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>." +"L</available> on each member of the returned list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:635 -msgid "(Added in 1.3.15)" +#: ../fish/guestfish-actions.pod:426 ../libguestfs-1.11.19/fish/guestfish-actions.pod:426 +msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:637 -msgid "guestfs_base64_in" +#: ../fish/guestfish-actions.pod:428 ../libguestfs-1.11.19/fish/guestfish-actions.pod:428 +msgid "base64-in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:639 +#: ../fish/guestfish-actions.pod:430 ../libguestfs-1.11.19/fish/guestfish-actions.pod:430 #, no-wrap msgid "" -" int\n" -" guestfs_base64_in (guestfs_h *g,\n" -" const char *base64file,\n" -" const char *filename);\n" +" base64-in (base64file|-) filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:644 ../fish/guestfish-actions.pod:432 +#: ../fish/guestfish-actions.pod:432 ../libguestfs-1.11.19/fish/guestfish-actions.pod:432 ../libguestfs-1.11.19/src/guestfs-actions.pod:644 ../src/guestfs-actions.pod:644 msgid "This command uploads base64-encoded data from C<base64file> to C<filename>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:663 -msgid "(Added in 1.3.5)" +#: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444 ../fish/guestfish-actions.pod:693 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:881 ../fish/guestfish-actions.pod:1255 ../fish/guestfish-actions.pod:4658 ../fish/guestfish-actions.pod:4670 ../fish/guestfish-actions.pod:4681 ../fish/guestfish-actions.pod:4692 ../fish/guestfish-actions.pod:4744 ../fish/guestfish-actions.pod:4753 ../fish/guestfish-actions.pod:4807 ../fish/guestfish-actions.pod:4830 ../libguestfs-1.11.19/fish/guestfish-actions.pod:435 ../libguestfs-1.11.19/fish/guestfish-actions.pod:444 ../libguestfs-1.11.19/fish/guestfish-actions.pod:693 ../libguestfs-1.11.19/fish/guestfish-actions.pod:862 ../libguestfs-1.11.19/fish/guestfish-actions.pod:881 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1255 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4658 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4670 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4681 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4692 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4744 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4753 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4807 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4830 +msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:651 -msgid "guestfs_base64_out" +#: ../fish/guestfish-actions.pod:437 ../libguestfs-1.11.19/fish/guestfish-actions.pod:437 +msgid "base64-out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:653 +#: ../fish/guestfish-actions.pod:439 ../libguestfs-1.11.19/fish/guestfish-actions.pod:439 #, no-wrap msgid "" -" int\n" -" guestfs_base64_out (guestfs_h *g,\n" -" const char *filename,\n" -" const char *base64file);\n" +" base64-out filename (base64file|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:658 ../fish/guestfish-actions.pod:441 +#: ../fish/guestfish-actions.pod:441 ../libguestfs-1.11.19/fish/guestfish-actions.pod:441 ../libguestfs-1.11.19/src/guestfs-actions.pod:658 ../src/guestfs-actions.pod:658 msgid "" "This command downloads the contents of C<filename>, writing it out to local " "file C<base64file> encoded as base64." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:665 -msgid "guestfs_blockdev_flushbufs" +#: ../fish/guestfish-actions.pod:446 ../libguestfs-1.11.19/fish/guestfish-actions.pod:446 +msgid "blockdev-flushbufs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:667 +#: ../fish/guestfish-actions.pod:448 ../libguestfs-1.11.19/fish/guestfish-actions.pod:448 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_flushbufs (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-flushbufs device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:671 ../fish/guestfish-actions.pod:450 +#: ../fish/guestfish-actions.pod:450 ../libguestfs-1.11.19/fish/guestfish-actions.pod:450 ../libguestfs-1.11.19/src/guestfs-actions.pod:671 ../src/guestfs-actions.pod:671 msgid "This tells the kernel to flush internal buffers associated with C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:691 ../src/guestfs-actions.pod:706 ../src/guestfs-actions.pod:722 ../src/guestfs-actions.pod:740 ../src/guestfs-actions.pod:759 ../src/guestfs-actions.pod:773 ../src/guestfs-actions.pod:791 ../src/guestfs-actions.pod:805 ../src/guestfs-actions.pod:819 ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464 ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508 ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527 ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543 +#: ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464 ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508 ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527 ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543 ../libguestfs-1.11.19/fish/guestfish-actions.pod:453 ../libguestfs-1.11.19/fish/guestfish-actions.pod:464 ../libguestfs-1.11.19/fish/guestfish-actions.pod:473 ../libguestfs-1.11.19/fish/guestfish-actions.pod:483 ../libguestfs-1.11.19/fish/guestfish-actions.pod:495 ../libguestfs-1.11.19/fish/guestfish-actions.pod:508 ../libguestfs-1.11.19/fish/guestfish-actions.pod:516 ../libguestfs-1.11.19/fish/guestfish-actions.pod:527 ../libguestfs-1.11.19/fish/guestfish-actions.pod:535 ../libguestfs-1.11.19/fish/guestfish-actions.pod:543 ../libguestfs-1.11.19/src/guestfs-actions.pod:674 ../libguestfs-1.11.19/src/guestfs-actions.pod:691 ../libguestfs-1.11.19/src/guestfs-actions.pod:706 ../libguestfs-1.11.19/src/guestfs-actions.pod:722 ../libguestfs-1.11.19/src/guestfs-actions.pod:740 ../libguestfs-1.11.19/src/guestfs-actions.pod:759 ../libguestfs-1.11.19/src/guestfs-actions.pod:773 ../libguestfs-1.11.19/src/guestfs-actions.pod:791 ../libguestfs-1.11.19/src/guestfs-actions.pod:805 ../libguestfs-1.11.19/src/guestfs-actions.pod:819 ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:691 ../src/guestfs-actions.pod:706 ../src/guestfs-actions.pod:722 ../src/guestfs-actions.pod:740 ../src/guestfs-actions.pod:759 ../src/guestfs-actions.pod:773 ../src/guestfs-actions.pod:791 ../src/guestfs-actions.pod:805 ../src/guestfs-actions.pod:819 msgid "This uses the L<blockdev(8)> command." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:678 ../src/guestfs-actions.pod:695 ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:726 ../src/guestfs-actions.pod:744 ../src/guestfs-actions.pod:763 ../src/guestfs-actions.pod:777 ../src/guestfs-actions.pod:795 ../src/guestfs-actions.pod:809 ../src/guestfs-actions.pod:823 -msgid "(Added in 0.9.3)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:680 -msgid "guestfs_blockdev_getbsz" +#: ../fish/guestfish-actions.pod:455 ../libguestfs-1.11.19/fish/guestfish-actions.pod:455 +msgid "blockdev-getbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:682 +#: ../fish/guestfish-actions.pod:457 ../libguestfs-1.11.19/fish/guestfish-actions.pod:457 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_getbsz (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-getbsz device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:686 ../fish/guestfish-actions.pod:459 +#: ../fish/guestfish-actions.pod:459 ../libguestfs-1.11.19/fish/guestfish-actions.pod:459 ../libguestfs-1.11.19/src/guestfs-actions.pod:686 ../src/guestfs-actions.pod:686 msgid "This returns the block size of a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:788 ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524 +#: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524 ../libguestfs-1.11.19/fish/guestfish-actions.pod:461 ../libguestfs-1.11.19/fish/guestfish-actions.pod:524 ../libguestfs-1.11.19/src/guestfs-actions.pod:688 ../libguestfs-1.11.19/src/guestfs-actions.pod:788 ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:788 msgid "" "(Note this is different from both I<size in blocks> and I<filesystem block " "size>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:697 -msgid "guestfs_blockdev_getro" +#: ../fish/guestfish-actions.pod:466 ../libguestfs-1.11.19/fish/guestfish-actions.pod:466 +msgid "blockdev-getro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:699 +#: ../fish/guestfish-actions.pod:468 ../libguestfs-1.11.19/fish/guestfish-actions.pod:468 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_getro (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-getro device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:703 ../fish/guestfish-actions.pod:470 +#: ../fish/guestfish-actions.pod:470 ../libguestfs-1.11.19/fish/guestfish-actions.pod:470 ../libguestfs-1.11.19/src/guestfs-actions.pod:703 ../src/guestfs-actions.pod:703 msgid "" "Returns a boolean indicating if the block device is read-only (true if " "read-only, false if not)." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:708 ../src/guestfs-actions.pod:1474 ../src/guestfs-actions.pod:1489 ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:1989 ../src/guestfs-actions.pod:2061 ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:2140 ../src/guestfs-actions.pod:2165 ../src/guestfs-actions.pod:2188 ../src/guestfs-actions.pod:3224 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3258 ../src/guestfs-actions.pod:3420 ../src/guestfs-actions.pod:3434 ../src/guestfs-actions.pod:3449 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3479 ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3510 ../src/guestfs-actions.pod:3524 ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3551 ../src/guestfs-actions.pod:3566 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3594 ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:5337 -msgid "This function returns a C truth value on success or -1 on error." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:712 -msgid "guestfs_blockdev_getsize64" +#: ../fish/guestfish-actions.pod:475 ../libguestfs-1.11.19/fish/guestfish-actions.pod:475 +msgid "blockdev-getsize64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:714 +#: ../fish/guestfish-actions.pod:477 ../libguestfs-1.11.19/fish/guestfish-actions.pod:477 #, no-wrap msgid "" -" int64_t\n" -" guestfs_blockdev_getsize64 (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-getsize64 device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:718 ../fish/guestfish-actions.pod:479 +#: ../fish/guestfish-actions.pod:479 ../libguestfs-1.11.19/fish/guestfish-actions.pod:479 ../libguestfs-1.11.19/src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:718 msgid "This returns the size of the device in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:720 -msgid "See also C<guestfs_blockdev_getsz>." +#: ../fish/guestfish-actions.pod:481 ../libguestfs-1.11.19/fish/guestfish-actions.pod:481 +msgid "See also L</blockdev-getsz>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:728 -msgid "guestfs_blockdev_getss" +#: ../fish/guestfish-actions.pod:485 ../libguestfs-1.11.19/fish/guestfish-actions.pod:485 +msgid "blockdev-getss" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:730 +#: ../fish/guestfish-actions.pod:487 ../libguestfs-1.11.19/fish/guestfish-actions.pod:487 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_getss (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-getss device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:734 ../fish/guestfish-actions.pod:489 +#: ../fish/guestfish-actions.pod:489 ../libguestfs-1.11.19/fish/guestfish-actions.pod:489 ../libguestfs-1.11.19/src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:734 msgid "" "This returns the size of sectors on a block device. Usually 512, but can be " "larger for modern devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:737 -msgid "" -"(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for " -"that)." +#: ../fish/guestfish-actions.pod:492 ../libguestfs-1.11.19/fish/guestfish-actions.pod:492 +msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:746 -msgid "guestfs_blockdev_getsz" +#: ../fish/guestfish-actions.pod:497 ../libguestfs-1.11.19/fish/guestfish-actions.pod:497 +msgid "blockdev-getsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:748 +#: ../fish/guestfish-actions.pod:499 ../libguestfs-1.11.19/fish/guestfish-actions.pod:499 #, no-wrap msgid "" -" int64_t\n" -" guestfs_blockdev_getsz (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-getsz device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:752 ../fish/guestfish-actions.pod:501 +#: ../fish/guestfish-actions.pod:501 ../libguestfs-1.11.19/fish/guestfish-actions.pod:501 ../libguestfs-1.11.19/src/guestfs-actions.pod:752 ../src/guestfs-actions.pod:752 msgid "" "This returns the size of the device in units of 512-byte sectors (even if " "the sectorsize isn't 512 bytes ... weird)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:755 +#: ../fish/guestfish-actions.pod:504 ../libguestfs-1.11.19/fish/guestfish-actions.pod:504 msgid "" -"See also C<guestfs_blockdev_getss> for the real sector size of the device, " -"and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>." +"See also L</blockdev-getss> for the real sector size of the device, and " +"L</blockdev-getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:765 -msgid "guestfs_blockdev_rereadpt" +#: ../fish/guestfish-actions.pod:510 ../libguestfs-1.11.19/fish/guestfish-actions.pod:510 +msgid "blockdev-rereadpt" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:767 +#: ../fish/guestfish-actions.pod:512 ../libguestfs-1.11.19/fish/guestfish-actions.pod:512 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_rereadpt (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-rereadpt device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:771 ../fish/guestfish-actions.pod:514 +#: ../fish/guestfish-actions.pod:514 ../libguestfs-1.11.19/fish/guestfish-actions.pod:514 ../libguestfs-1.11.19/src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:771 msgid "Reread the partition table on C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:779 -msgid "guestfs_blockdev_setbsz" +#: ../fish/guestfish-actions.pod:518 ../libguestfs-1.11.19/fish/guestfish-actions.pod:518 +msgid "blockdev-setbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:781 +#: ../fish/guestfish-actions.pod:520 ../libguestfs-1.11.19/fish/guestfish-actions.pod:520 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_setbsz (guestfs_h *g,\n" -" const char *device,\n" -" int blocksize);\n" +" blockdev-setbsz device blocksize\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:786 ../fish/guestfish-actions.pod:522 +#: ../fish/guestfish-actions.pod:522 ../libguestfs-1.11.19/fish/guestfish-actions.pod:522 ../libguestfs-1.11.19/src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:786 msgid "This sets the block size of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:797 -msgid "guestfs_blockdev_setro" +#: ../fish/guestfish-actions.pod:529 ../libguestfs-1.11.19/fish/guestfish-actions.pod:529 +msgid "blockdev-setro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:799 +#: ../fish/guestfish-actions.pod:531 ../libguestfs-1.11.19/fish/guestfish-actions.pod:531 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_setro (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-setro device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:803 ../fish/guestfish-actions.pod:533 +#: ../fish/guestfish-actions.pod:533 ../libguestfs-1.11.19/fish/guestfish-actions.pod:533 ../libguestfs-1.11.19/src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:803 msgid "Sets the block device named C<device> to read-only." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:811 -msgid "guestfs_blockdev_setrw" +#: ../fish/guestfish-actions.pod:537 ../libguestfs-1.11.19/fish/guestfish-actions.pod:537 +msgid "blockdev-setrw" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:813 +#: ../fish/guestfish-actions.pod:539 ../libguestfs-1.11.19/fish/guestfish-actions.pod:539 #, no-wrap msgid "" -" int\n" -" guestfs_blockdev_setrw (guestfs_h *g,\n" -" const char *device);\n" +" blockdev-setrw device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:817 ../fish/guestfish-actions.pod:541 +#: ../fish/guestfish-actions.pod:541 ../libguestfs-1.11.19/fish/guestfish-actions.pod:541 ../libguestfs-1.11.19/src/guestfs-actions.pod:817 ../src/guestfs-actions.pod:817 msgid "Sets the block device named C<device> to read-write." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:825 -msgid "guestfs_btrfs_filesystem_resize" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:827 -#, no-wrap -msgid "" -" int\n" -" guestfs_btrfs_filesystem_resize (guestfs_h *g,\n" -" const char *mountpoint,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:545 ../libguestfs-1.11.19/fish/guestfish-actions.pod:545 +msgid "btrfs-filesystem-resize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:837 +#: ../fish/guestfish-actions.pod:547 ../libguestfs-1.11.19/fish/guestfish-actions.pod:547 #, no-wrap msgid "" -" GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n" +" btrfs-filesystem-resize mountpoint [size:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:839 ../fish/guestfish-actions.pod:549 +#: ../fish/guestfish-actions.pod:549 ../libguestfs-1.11.19/fish/guestfish-actions.pod:549 ../libguestfs-1.11.19/src/guestfs-actions.pod:839 ../src/guestfs-actions.pod:839 msgid "This command resizes a btrfs filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:551 +#: ../fish/guestfish-actions.pod:551 ../libguestfs-1.11.19/fish/guestfish-actions.pod:551 ../libguestfs-1.11.19/src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:841 msgid "" "Note that unlike other resize calls, the filesystem has to be mounted and " "the parameter is the mountpoint not the device (this is a requirement of " @@ -7280,92 +4828,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:845 ../src/guestfs-actions.pod:5187 ../fish/guestfish-actions.pod:555 ../fish/guestfish-actions.pod:3417 +#: ../fish/guestfish-actions.pod:555 ../fish/guestfish-actions.pod:3417 ../libguestfs-1.11.19/fish/guestfish-actions.pod:555 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3417 ../libguestfs-1.11.19/src/guestfs-actions.pod:845 ../libguestfs-1.11.19/src/guestfs-actions.pod:5189 ../src/guestfs-actions.pod:845 ../src/guestfs-actions.pod:5189 msgid "The optional parameters are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:849 ../src/guestfs-actions.pod:5191 ../fish/guestfish-actions.pod:559 ../fish/guestfish-actions.pod:3421 +#: ../fish/guestfish-actions.pod:559 ../fish/guestfish-actions.pod:3421 ../libguestfs-1.11.19/fish/guestfish-actions.pod:559 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3421 ../libguestfs-1.11.19/src/guestfs-actions.pod:849 ../libguestfs-1.11.19/src/guestfs-actions.pod:5193 ../src/guestfs-actions.pod:849 ../src/guestfs-actions.pod:5193 msgid "C<size>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:851 ../fish/guestfish-actions.pod:561 +#: ../fish/guestfish-actions.pod:561 ../libguestfs-1.11.19/fish/guestfish-actions.pod:561 ../libguestfs-1.11.19/src/guestfs-actions.pod:851 ../src/guestfs-actions.pod:851 msgid "" "The new size (in bytes) of the filesystem. If omitted, the filesystem is " "resized to the maximum size." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:856 ../fish/guestfish-actions.pod:566 +#: ../fish/guestfish-actions.pod:566 ../libguestfs-1.11.19/fish/guestfish-actions.pod:566 ../libguestfs-1.11.19/src/guestfs-actions.pod:856 ../src/guestfs-actions.pod:856 msgid "See also L<btrfs(8)>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:860 -msgid "(Added in 1.11.17)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:862 -msgid "guestfs_btrfs_filesystem_resize_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:864 -#, no-wrap -msgid "" -" int\n" -" guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n" -" const char *mountpoint,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:869 -msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:873 -msgid "guestfs_btrfs_filesystem_resize_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:875 -#, no-wrap -msgid "" -" int\n" -" guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n" -" const char *mountpoint,\n" -" const struct " -"guestfs_btrfs_filesystem_resize_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:880 -msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:884 -msgid "guestfs_case_sensitive_path" +#: ../fish/guestfish-actions.pod:570 ../libguestfs-1.11.19/fish/guestfish-actions.pod:570 +msgid "case-sensitive-path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:886 +#: ../fish/guestfish-actions.pod:572 ../libguestfs-1.11.19/fish/guestfish-actions.pod:572 #, no-wrap msgid "" -" char *\n" -" guestfs_case_sensitive_path (guestfs_h *g,\n" -" const char *path);\n" +" case-sensitive-path path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:574 +#: ../fish/guestfish-actions.pod:574 ../libguestfs-1.11.19/fish/guestfish-actions.pod:574 ../libguestfs-1.11.19/src/guestfs-actions.pod:890 ../src/guestfs-actions.pod:890 msgid "" "This can be used to resolve case insensitive paths on a filesystem which is " "case sensitive. The use case is to resolve paths which you have read from " @@ -7373,7 +4871,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:579 +#: ../fish/guestfish-actions.pod:579 ../libguestfs-1.11.19/fish/guestfish-actions.pod:579 ../libguestfs-1.11.19/src/guestfs-actions.pod:895 ../src/guestfs-actions.pod:895 msgid "" "The command handles a peculiarity of the Linux ntfs-3g filesystem driver " "(and probably others), which is that although the underlying filesystem is " @@ -7382,7 +4880,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:584 +#: ../fish/guestfish-actions.pod:584 ../libguestfs-1.11.19/fish/guestfish-actions.pod:584 ../libguestfs-1.11.19/src/guestfs-actions.pod:900 ../src/guestfs-actions.pod:900 msgid "" "One consequence of this is that special directories such as C<c:\\windows> " "may appear as C</WINDOWS> or C</windows> (or other things) depending on the " @@ -7391,258 +4889,226 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:590 +#: ../fish/guestfish-actions.pod:590 ../libguestfs-1.11.19/fish/guestfish-actions.pod:590 ../libguestfs-1.11.19/src/guestfs-actions.pod:906 ../src/guestfs-actions.pod:906 msgid "" "Bug or feature? You decide: " "L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:593 +#: ../fish/guestfish-actions.pod:593 ../libguestfs-1.11.19/fish/guestfish-actions.pod:593 ../libguestfs-1.11.19/src/guestfs-actions.pod:909 ../src/guestfs-actions.pod:909 msgid "" "This function resolves the true case of each element in the path and returns " "the case-sensitive path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:912 +#: ../fish/guestfish-actions.pod:596 ../libguestfs-1.11.19/fish/guestfish-actions.pod:596 msgid "" -"Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\") might return " +"Thus L</case-sensitive-path> (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " "how the directories were originally created under Windows)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:601 +#: ../fish/guestfish-actions.pod:601 ../libguestfs-1.11.19/fish/guestfish-actions.pod:601 ../libguestfs-1.11.19/src/guestfs-actions.pod:917 ../src/guestfs-actions.pod:917 msgid "I<Note>: This function does not handle drive names, backslashes etc." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:920 -msgid "See also C<guestfs_realpath>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:925 ../src/guestfs-actions.pod:7377 -msgid "(Added in 1.0.75)" +#: ../fish/guestfish-actions.pod:604 ../libguestfs-1.11.19/fish/guestfish-actions.pod:604 +msgid "See also L</realpath>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:927 -msgid "guestfs_cat" +#: ../fish/guestfish-actions.pod:606 ../libguestfs-1.11.19/fish/guestfish-actions.pod:606 +msgid "cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:929 +#: ../fish/guestfish-actions.pod:608 ../libguestfs-1.11.19/fish/guestfish-actions.pod:608 #, no-wrap msgid "" -" char *\n" -" guestfs_cat (guestfs_h *g,\n" -" const char *path);\n" +" cat path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:933 ../src/guestfs-actions.pod:5824 ../fish/guestfish-actions.pod:610 ../fish/guestfish-actions.pod:3831 +#: ../fish/guestfish-actions.pod:610 ../fish/guestfish-actions.pod:3837 ../libguestfs-1.11.19/fish/guestfish-actions.pod:610 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3837 ../libguestfs-1.11.19/src/guestfs-actions.pod:933 ../libguestfs-1.11.19/src/guestfs-actions.pod:5832 ../src/guestfs-actions.pod:933 ../src/guestfs-actions.pod:5832 msgid "Return the contents of the file named C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:935 +#: ../fish/guestfish-actions.pod:612 ../libguestfs-1.11.19/fish/guestfish-actions.pod:612 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " -"those you need to use the C<guestfs_read_file> or C<guestfs_download> " -"functions which have a more complex interface." +"those you need to use the L</read-file> or L</download> functions which have " +"a more complex interface." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:2294 ../src/guestfs-actions.pod:2313 ../src/guestfs-actions.pod:2356 ../src/guestfs-actions.pod:2380 ../src/guestfs-actions.pod:2397 ../src/guestfs-actions.pod:2426 ../src/guestfs-actions.pod:5606 ../src/guestfs-actions.pod:5632 ../src/guestfs-actions.pod:5763 ../src/guestfs-actions.pod:5789 ../src/guestfs-actions.pod:5813 ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:6817 ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:6987 ../src/guestfs-actions.pod:7652 ../src/guestfs-actions.pod:7672 ../src/guestfs-actions.pod:7696 ../src/guestfs-actions.pod:7722 ../src/guestfs-actions.pod:7741 ../src/guestfs-actions.pod:7827 ../src/guestfs-actions.pod:7846 ../src/guestfs-actions.pod:7892 ../src/guestfs-actions.pod:7911 ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:752 ../fish/guestfish-actions.pod:764 ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1579 ../fish/guestfish-actions.pod:1589 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:3701 ../fish/guestfish-actions.pod:3716 ../fish/guestfish-actions.pod:3792 ../fish/guestfish-actions.pod:3809 ../fish/guestfish-actions.pod:3824 ../fish/guestfish-actions.pod:4493 ../fish/guestfish-actions.pod:4539 ../fish/guestfish-actions.pod:4624 ../fish/guestfish-actions.pod:4639 ../fish/guestfish-actions.pod:5045 ../fish/guestfish-actions.pod:5057 ../fish/guestfish-actions.pod:5075 ../fish/guestfish-actions.pod:5092 ../fish/guestfish-actions.pod:5102 ../fish/guestfish-actions.pod:5151 ../fish/guestfish-actions.pod:5161 ../fish/guestfish-actions.pod:5190 ../fish/guestfish-actions.pod:5200 +#: ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:752 ../fish/guestfish-actions.pod:764 ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1579 ../fish/guestfish-actions.pod:1589 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:3707 ../fish/guestfish-actions.pod:3722 ../fish/guestfish-actions.pod:3798 ../fish/guestfish-actions.pod:3815 ../fish/guestfish-actions.pod:3830 ../fish/guestfish-actions.pod:4499 ../fish/guestfish-actions.pod:4545 ../fish/guestfish-actions.pod:4630 ../fish/guestfish-actions.pod:4645 ../fish/guestfish-actions.pod:5051 ../fish/guestfish-actions.pod:5063 ../fish/guestfish-actions.pod:5081 ../fish/guestfish-actions.pod:5098 ../fish/guestfish-actions.pod:5108 ../fish/guestfish-actions.pod:5157 ../fish/guestfish-actions.pod:5167 ../fish/guestfish-actions.pod:5196 ../fish/guestfish-actions.pod:5206 ../libguestfs-1.11.19/fish/guestfish-actions.pod:617 ../libguestfs-1.11.19/fish/guestfish-actions.pod:752 ../libguestfs-1.11.19/fish/guestfish-actions.pod:764 ../libguestfs-1.11.19/fish/guestfish-actions.pod:940 ../libguestfs-1.11.19/fish/guestfish-actions.pod:950 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1017 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1027 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1219 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1526 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1536 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1564 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1579 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1589 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1608 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3707 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3722 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3798 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3815 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3830 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4499 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4545 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4630 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4645 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5051 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5063 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5081 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5098 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5108 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5157 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5167 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5196 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5206 ../libguestfs-1.11.19/src/guestfs-actions.pod:943 ../libguestfs-1.11.19/src/guestfs-actions.pod:1122 ../libguestfs-1.11.19/src/guestfs-actions.pod:1142 ../libguestfs-1.11.19/src/guestfs-actions.pod:1438 ../libguestfs-1.11.19/src/guestfs-actions.pod:1457 ../libguestfs-1.11.19/src/guestfs-actions.pod:1560 ../libguestfs-1.11.19/src/guestfs-actions.pod:1579 ../libguestfs-1.11.19/src/guestfs-actions.pod:1825 ../libguestfs-1.11.19/src/guestfs-actions.pod:2296 ../libguestfs-1.11.19/src/guestfs-actions.pod:2315 ../libguestfs-1.11.19/src/guestfs-actions.pod:2358 ../libguestfs-1.11.19/src/guestfs-actions.pod:2382 ../libguestfs-1.11.19/src/guestfs-actions.pod:2399 ../libguestfs-1.11.19/src/guestfs-actions.pod:2428 ../libguestfs-1.11.19/src/guestfs-actions.pod:5614 ../libguestfs-1.11.19/src/guestfs-actions.pod:5640 ../libguestfs-1.11.19/src/guestfs-actions.pod:5771 ../libguestfs-1.11.19/src/guestfs-actions.pod:5797 ../libguestfs-1.11.19/src/guestfs-actions.pod:5821 ../libguestfs-1.11.19/src/guestfs-actions.pod:6772 ../libguestfs-1.11.19/src/guestfs-actions.pod:6827 ../libguestfs-1.11.19/src/guestfs-actions.pod:6973 ../libguestfs-1.11.19/src/guestfs-actions.pod:6997 ../libguestfs-1.11.19/src/guestfs-actions.pod:7662 ../libguestfs-1.11.19/src/guestfs-actions.pod:7682 ../libguestfs-1.11.19/src/guestfs-actions.pod:7708 ../libguestfs-1.11.19/src/guestfs-actions.pod:7734 ../libguestfs-1.11.19/src/guestfs-actions.pod:7753 ../libguestfs-1.11.19/src/guestfs-actions.pod:7839 ../libguestfs-1.11.19/src/guestfs-actions.pod:7858 ../libguestfs-1.11.19/src/guestfs-actions.pod:7904 ../libguestfs-1.11.19/src/guestfs-actions.pod:7923 ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:2315 ../src/guestfs-actions.pod:2358 ../src/guestfs-actions.pod:2382 ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2428 ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:5640 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5797 ../src/guestfs-actions.pod:5821 ../src/guestfs-actions.pod:6772 ../src/guestfs-actions.pod:6827 ../src/guestfs-actions.pod:6973 ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7662 ../src/guestfs-actions.pod:7682 ../src/guestfs-actions.pod:7708 ../src/guestfs-actions.pod:7734 ../src/guestfs-actions.pod:7753 ../src/guestfs-actions.pod:7839 ../src/guestfs-actions.pod:7858 ../src/guestfs-actions.pod:7904 ../src/guestfs-actions.pod:7923 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:946 ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3837 ../src/guestfs-actions.pod:3925 ../src/guestfs-actions.pod:4333 ../src/guestfs-actions.pod:4347 ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5726 ../src/guestfs-actions.pod:7530 ../src/guestfs-actions.pod:7544 -msgid "(Added in 0.4)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:948 -msgid "guestfs_checksum" +#: ../fish/guestfish-actions.pod:620 ../libguestfs-1.11.19/fish/guestfish-actions.pod:620 +msgid "checksum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:950 +#: ../fish/guestfish-actions.pod:622 ../libguestfs-1.11.19/fish/guestfish-actions.pod:622 #, no-wrap msgid "" -" char *\n" -" guestfs_checksum (guestfs_h *g,\n" -" const char *csumtype,\n" -" const char *path);\n" +" checksum csumtype path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:955 ../fish/guestfish-actions.pod:624 +#: ../fish/guestfish-actions.pod:624 ../libguestfs-1.11.19/fish/guestfish-actions.pod:624 ../libguestfs-1.11.19/src/guestfs-actions.pod:955 ../src/guestfs-actions.pod:955 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:958 ../fish/guestfish-actions.pod:627 +#: ../fish/guestfish-actions.pod:627 ../libguestfs-1.11.19/fish/guestfish-actions.pod:627 ../libguestfs-1.11.19/src/guestfs-actions.pod:958 ../src/guestfs-actions.pod:958 msgid "" "The type of checksum to compute is given by the C<csumtype> parameter which " "must have one of the following values:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:963 ../fish/guestfish-actions.pod:632 +#: ../fish/guestfish-actions.pod:632 ../libguestfs-1.11.19/fish/guestfish-actions.pod:632 ../libguestfs-1.11.19/src/guestfs-actions.pod:963 ../src/guestfs-actions.pod:963 msgid "C<crc>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:965 ../fish/guestfish-actions.pod:634 +#: ../fish/guestfish-actions.pod:634 ../libguestfs-1.11.19/fish/guestfish-actions.pod:634 ../libguestfs-1.11.19/src/guestfs-actions.pod:965 ../src/guestfs-actions.pod:965 msgid "" "Compute the cyclic redundancy check (CRC) specified by POSIX for the " "C<cksum> command." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:637 +#: ../fish/guestfish-actions.pod:637 ../libguestfs-1.11.19/fish/guestfish-actions.pod:637 ../libguestfs-1.11.19/src/guestfs-actions.pod:968 ../src/guestfs-actions.pod:968 msgid "C<md5>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:970 ../fish/guestfish-actions.pod:639 +#: ../fish/guestfish-actions.pod:639 ../libguestfs-1.11.19/fish/guestfish-actions.pod:639 ../libguestfs-1.11.19/src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:970 msgid "Compute the MD5 hash (using the C<md5sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:972 ../fish/guestfish-actions.pod:641 +#: ../fish/guestfish-actions.pod:641 ../libguestfs-1.11.19/fish/guestfish-actions.pod:641 ../libguestfs-1.11.19/src/guestfs-actions.pod:972 ../src/guestfs-actions.pod:972 msgid "C<sha1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:974 ../fish/guestfish-actions.pod:643 +#: ../fish/guestfish-actions.pod:643 ../libguestfs-1.11.19/fish/guestfish-actions.pod:643 ../libguestfs-1.11.19/src/guestfs-actions.pod:974 ../src/guestfs-actions.pod:974 msgid "Compute the SHA1 hash (using the C<sha1sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:976 ../fish/guestfish-actions.pod:645 +#: ../fish/guestfish-actions.pod:645 ../libguestfs-1.11.19/fish/guestfish-actions.pod:645 ../libguestfs-1.11.19/src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:976 msgid "C<sha224>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:978 ../fish/guestfish-actions.pod:647 +#: ../fish/guestfish-actions.pod:647 ../libguestfs-1.11.19/fish/guestfish-actions.pod:647 ../libguestfs-1.11.19/src/guestfs-actions.pod:978 ../src/guestfs-actions.pod:978 msgid "Compute the SHA224 hash (using the C<sha224sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:980 ../fish/guestfish-actions.pod:649 +#: ../fish/guestfish-actions.pod:649 ../libguestfs-1.11.19/fish/guestfish-actions.pod:649 ../libguestfs-1.11.19/src/guestfs-actions.pod:980 ../src/guestfs-actions.pod:980 msgid "C<sha256>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:982 ../fish/guestfish-actions.pod:651 +#: ../fish/guestfish-actions.pod:651 ../libguestfs-1.11.19/fish/guestfish-actions.pod:651 ../libguestfs-1.11.19/src/guestfs-actions.pod:982 ../src/guestfs-actions.pod:982 msgid "Compute the SHA256 hash (using the C<sha256sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:984 ../fish/guestfish-actions.pod:653 +#: ../fish/guestfish-actions.pod:653 ../libguestfs-1.11.19/fish/guestfish-actions.pod:653 ../libguestfs-1.11.19/src/guestfs-actions.pod:984 ../src/guestfs-actions.pod:984 msgid "C<sha384>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:986 ../fish/guestfish-actions.pod:655 +#: ../fish/guestfish-actions.pod:655 ../libguestfs-1.11.19/fish/guestfish-actions.pod:655 ../libguestfs-1.11.19/src/guestfs-actions.pod:986 ../src/guestfs-actions.pod:986 msgid "Compute the SHA384 hash (using the C<sha384sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:988 ../fish/guestfish-actions.pod:657 +#: ../fish/guestfish-actions.pod:657 ../libguestfs-1.11.19/fish/guestfish-actions.pod:657 ../libguestfs-1.11.19/src/guestfs-actions.pod:988 ../src/guestfs-actions.pod:988 msgid "C<sha512>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:659 +#: ../fish/guestfish-actions.pod:659 ../libguestfs-1.11.19/fish/guestfish-actions.pod:659 ../libguestfs-1.11.19/src/guestfs-actions.pod:990 ../src/guestfs-actions.pod:990 msgid "Compute the SHA512 hash (using the C<sha512sum> program)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:994 ../fish/guestfish-actions.pod:663 +#: ../fish/guestfish-actions.pod:663 ../libguestfs-1.11.19/fish/guestfish-actions.pod:663 ../libguestfs-1.11.19/src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:994 msgid "The checksum is returned as a printable string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:996 -msgid "To get the checksum for a device, use C<guestfs_checksum_device>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:998 -msgid "To get the checksums for many files, use C<guestfs_checksums_out>." +#: ../fish/guestfish-actions.pod:665 ../libguestfs-1.11.19/fish/guestfish-actions.pod:665 +msgid "To get the checksum for a device, use L</checksum-device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1003 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:3436 ../src/guestfs-actions.pod:3465 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:7233 -msgid "(Added in 1.0.2)" +#: ../fish/guestfish-actions.pod:667 ../libguestfs-1.11.19/fish/guestfish-actions.pod:667 +msgid "To get the checksums for many files, use L</checksums-out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1005 -msgid "guestfs_checksum_device" +#: ../fish/guestfish-actions.pod:669 ../libguestfs-1.11.19/fish/guestfish-actions.pod:669 +msgid "checksum-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1007 +#: ../fish/guestfish-actions.pod:671 ../libguestfs-1.11.19/fish/guestfish-actions.pod:671 #, no-wrap msgid "" -" char *\n" -" guestfs_checksum_device (guestfs_h *g,\n" -" const char *csumtype,\n" -" const char *device);\n" +" checksum-device csumtype device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1012 +#: ../fish/guestfish-actions.pod:673 ../libguestfs-1.11.19/fish/guestfish-actions.pod:673 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C<device>. For the types of checksums supported see the " -"C<guestfs_checksum> command." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5357 ../src/guestfs-actions.pod:5533 ../src/guestfs-actions.pod:7142 ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7556 -msgid "(Added in 1.3.2)" +"L</checksum> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1021 -msgid "guestfs_checksums_out" +#: ../fish/guestfish-actions.pod:677 ../libguestfs-1.11.19/fish/guestfish-actions.pod:677 +msgid "checksums-out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1023 +#: ../fish/guestfish-actions.pod:679 ../libguestfs-1.11.19/fish/guestfish-actions.pod:679 #, no-wrap msgid "" -" int\n" -" guestfs_checksums_out (guestfs_h *g,\n" -" const char *csumtype,\n" -" const char *directory,\n" -" const char *sumsfile);\n" +" checksums-out csumtype directory (sumsfile|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1029 ../fish/guestfish-actions.pod:681 +#: ../fish/guestfish-actions.pod:681 ../libguestfs-1.11.19/fish/guestfish-actions.pod:681 ../libguestfs-1.11.19/src/guestfs-actions.pod:1029 ../src/guestfs-actions.pod:1029 msgid "" "This command computes the checksums of all regular files in C<directory> and " "then emits a list of those checksums to the local output file C<sumsfile>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1033 ../fish/guestfish-actions.pod:685 +#: ../fish/guestfish-actions.pod:685 ../libguestfs-1.11.19/fish/guestfish-actions.pod:685 ../libguestfs-1.11.19/src/guestfs-actions.pod:1033 ../src/guestfs-actions.pod:1033 msgid "" "This can be used for verifying the integrity of a virtual machine. However " "to be properly secure you should pay attention to the output of the checksum " @@ -7651,36 +5117,28 @@ msgid "" "more information, see the GNU coreutils info file." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1043 -msgid "(Added in 1.3.7)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1045 -msgid "guestfs_chmod" +#: ../fish/guestfish-actions.pod:695 ../libguestfs-1.11.19/fish/guestfish-actions.pod:695 +msgid "chmod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1047 +#: ../fish/guestfish-actions.pod:697 ../libguestfs-1.11.19/fish/guestfish-actions.pod:697 #, no-wrap msgid "" -" int\n" -" guestfs_chmod (guestfs_h *g,\n" -" int mode,\n" -" const char *path);\n" +" chmod mode path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1052 ../fish/guestfish-actions.pod:699 +#: ../fish/guestfish-actions.pod:699 ../libguestfs-1.11.19/fish/guestfish-actions.pod:699 ../libguestfs-1.11.19/src/guestfs-actions.pod:1052 ../src/guestfs-actions.pod:1052 msgid "" "Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are " "supported." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1055 ../fish/guestfish-actions.pod:702 +#: ../fish/guestfish-actions.pod:702 ../libguestfs-1.11.19/fish/guestfish-actions.pod:702 ../libguestfs-1.11.19/src/guestfs-actions.pod:1055 ../src/guestfs-actions.pod:1055 msgid "" "I<Note>: When using this command from guestfish, C<mode> by default would be " "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not " @@ -7688,34 +5146,30 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1059 ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:4793 ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4831 ../fish/guestfish-actions.pod:706 ../fish/guestfish-actions.pod:3060 ../fish/guestfish-actions.pod:3199 ../fish/guestfish-actions.pod:3209 ../fish/guestfish-actions.pod:3219 +#: ../fish/guestfish-actions.pod:706 ../fish/guestfish-actions.pod:3060 ../fish/guestfish-actions.pod:3199 ../fish/guestfish-actions.pod:3209 ../fish/guestfish-actions.pod:3219 ../libguestfs-1.11.19/fish/guestfish-actions.pod:706 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3060 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3199 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3209 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3219 ../libguestfs-1.11.19/src/guestfs-actions.pod:1059 ../libguestfs-1.11.19/src/guestfs-actions.pod:4586 ../libguestfs-1.11.19/src/guestfs-actions.pod:4795 ../libguestfs-1.11.19/src/guestfs-actions.pod:4814 ../libguestfs-1.11.19/src/guestfs-actions.pod:4833 ../src/guestfs-actions.pod:1059 ../src/guestfs-actions.pod:4586 ../src/guestfs-actions.pod:4795 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4833 msgid "The mode actually set is affected by the umask." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1065 -msgid "guestfs_chown" +#: ../fish/guestfish-actions.pod:708 ../libguestfs-1.11.19/fish/guestfish-actions.pod:708 +msgid "chown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1067 +#: ../fish/guestfish-actions.pod:710 ../libguestfs-1.11.19/fish/guestfish-actions.pod:710 #, no-wrap msgid "" -" int\n" -" guestfs_chown (guestfs_h *g,\n" -" int owner,\n" -" int group,\n" -" const char *path);\n" +" chown owner group path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1073 ../fish/guestfish-actions.pod:712 +#: ../fish/guestfish-actions.pod:712 ../libguestfs-1.11.19/fish/guestfish-actions.pod:712 ../libguestfs-1.11.19/src/guestfs-actions.pod:1073 ../src/guestfs-actions.pod:1073 msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1075 ../src/guestfs-actions.pod:3655 ../fish/guestfish-actions.pod:714 ../fish/guestfish-actions.pod:2495 +#: ../fish/guestfish-actions.pod:714 ../fish/guestfish-actions.pod:2495 ../libguestfs-1.11.19/fish/guestfish-actions.pod:714 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2495 ../libguestfs-1.11.19/src/guestfs-actions.pod:1075 ../libguestfs-1.11.19/src/guestfs-actions.pod:3657 ../src/guestfs-actions.pod:1075 ../src/guestfs-actions.pod:3657 msgid "" "Only numeric uid and gid are supported. If you want to use names, you will " "need to locate and parse the password file yourself (Augeas support makes " @@ -7723,22 +5177,20 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1083 -msgid "guestfs_command" +#: ../fish/guestfish-actions.pod:718 ../libguestfs-1.11.19/fish/guestfish-actions.pod:718 +msgid "command" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1085 +#: ../fish/guestfish-actions.pod:720 ../libguestfs-1.11.19/fish/guestfish-actions.pod:720 #, no-wrap msgid "" -" char *\n" -" guestfs_command (guestfs_h *g,\n" -" char *const *arguments);\n" +" command 'arguments ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:722 +#: ../fish/guestfish-actions.pod:722 ../libguestfs-1.11.19/fish/guestfish-actions.pod:722 ../libguestfs-1.11.19/src/guestfs-actions.pod:1089 ../src/guestfs-actions.pod:1089 msgid "" "This call runs a command from the guest filesystem. The filesystem must be " "mounted, and must contain a compatible operating system (ie. something " @@ -7746,22 +5198,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1094 +#: ../fish/guestfish-actions.pod:727 ../libguestfs-1.11.19/fish/guestfish-actions.pod:727 msgid "" "The single parameter is an argv-style list of arguments. The first element " "is the name of the program to run. Subsequent elements are parameters. The " "list must be non-empty (ie. must contain a program name). Note that the " -"command runs directly, and is I<not> invoked via the shell (see " -"C<guestfs_sh>)." +"command runs directly, and is I<not> invoked via the shell (see L</sh>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1101 ../fish/guestfish-actions.pod:734 +#: ../fish/guestfish-actions.pod:734 ../libguestfs-1.11.19/fish/guestfish-actions.pod:734 ../libguestfs-1.11.19/src/guestfs-actions.pod:1101 ../src/guestfs-actions.pod:1101 msgid "The return value is anything printed to I<stdout> by the command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1104 ../fish/guestfish-actions.pod:737 +#: ../fish/guestfish-actions.pod:737 ../libguestfs-1.11.19/fish/guestfish-actions.pod:737 ../libguestfs-1.11.19/src/guestfs-actions.pod:1104 ../src/guestfs-actions.pod:1104 msgid "" "If the command returns a non-zero exit status, then this function returns an " "error message. The error message string is the content of I<stderr> from " @@ -7769,7 +5220,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1108 ../fish/guestfish-actions.pod:741 +#: ../fish/guestfish-actions.pod:741 ../libguestfs-1.11.19/fish/guestfish-actions.pod:741 ../libguestfs-1.11.19/src/guestfs-actions.pod:1108 ../src/guestfs-actions.pod:1108 msgid "" "The C<$PATH> environment variable will contain at least C</usr/bin> and " "C</bin>. If you require a program from another location, you should provide " @@ -7777,7 +5228,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:746 +#: ../fish/guestfish-actions.pod:746 ../libguestfs-1.11.19/fish/guestfish-actions.pod:746 ../libguestfs-1.11.19/src/guestfs-actions.pod:1113 ../src/guestfs-actions.pod:1113 msgid "" "Shared libraries and data files required by the program must be available on " "filesystems which are mounted in the correct places. It is the caller's " @@ -7785,56 +5236,44 @@ msgid "" "right locations." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1125 ../src/guestfs-actions.pod:1145 ../src/guestfs-actions.pod:1610 -msgid "(Added in 0.9.1)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1127 -msgid "guestfs_command_lines" +#: ../fish/guestfish-actions.pod:755 ../libguestfs-1.11.19/fish/guestfish-actions.pod:755 +msgid "command-lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1129 +#: ../fish/guestfish-actions.pod:757 ../libguestfs-1.11.19/fish/guestfish-actions.pod:757 #, no-wrap msgid "" -" char **\n" -" guestfs_command_lines (guestfs_h *g,\n" -" char *const *arguments);\n" +" command-lines 'arguments ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1133 -msgid "" -"This is the same as C<guestfs_command>, but splits the result into a list of " -"lines." +#: ../fish/guestfish-actions.pod:759 ../libguestfs-1.11.19/fish/guestfish-actions.pod:759 +msgid "This is the same as L</command>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1136 -msgid "See also: C<guestfs_sh_lines>" +#: ../fish/guestfish-actions.pod:762 ../libguestfs-1.11.19/fish/guestfish-actions.pod:762 +msgid "See also: L</sh-lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1147 -msgid "guestfs_config" +#: ../fish/guestfish-actions.pod:767 ../libguestfs-1.11.19/fish/guestfish-actions.pod:767 +msgid "config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1149 +#: ../fish/guestfish-actions.pod:769 ../libguestfs-1.11.19/fish/guestfish-actions.pod:769 #, no-wrap msgid "" -" int\n" -" guestfs_config (guestfs_h *g,\n" -" const char *qemuparam,\n" -" const char *qemuvalue);\n" +" config qemuparam qemuvalue\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1154 ../fish/guestfish-actions.pod:771 +#: ../fish/guestfish-actions.pod:771 ../libguestfs-1.11.19/fish/guestfish-actions.pod:771 ../libguestfs-1.11.19/src/guestfs-actions.pod:1154 ../src/guestfs-actions.pod:1154 msgid "" "This can be used to add arbitrary qemu command line parameters of the form " "I<-param value>. Actually it's not quite arbitrary - we prevent you from " @@ -7842,129 +5281,97 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1159 ../fish/guestfish-actions.pod:776 +#: ../fish/guestfish-actions.pod:776 ../libguestfs-1.11.19/fish/guestfish-actions.pod:776 ../libguestfs-1.11.19/src/guestfs-actions.pod:1159 ../src/guestfs-actions.pod:1159 msgid "The first character of C<param> string must be a C<-> (dash)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1161 ../fish/guestfish-actions.pod:778 +#: ../fish/guestfish-actions.pod:778 ../libguestfs-1.11.19/fish/guestfish-actions.pod:778 ../libguestfs-1.11.19/src/guestfs-actions.pod:1161 ../src/guestfs-actions.pod:1161 msgid "C<value> can be NULL." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1167 -msgid "guestfs_copy_size" +#: ../fish/guestfish-actions.pod:780 ../libguestfs-1.11.19/fish/guestfish-actions.pod:780 +msgid "copy-size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1169 +#: ../fish/guestfish-actions.pod:782 ../libguestfs-1.11.19/fish/guestfish-actions.pod:782 #, no-wrap msgid "" -" int\n" -" guestfs_copy_size (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest,\n" -" int64_t size);\n" +" copy-size src dest size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1175 ../fish/guestfish-actions.pod:784 +#: ../fish/guestfish-actions.pod:784 ../libguestfs-1.11.19/fish/guestfish-actions.pod:784 ../libguestfs-1.11.19/src/guestfs-actions.pod:1175 ../src/guestfs-actions.pod:1175 msgid "" "This command copies exactly C<size> bytes from one source device or file " "C<src> to another destination device or file C<dest>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:787 +#: ../fish/guestfish-actions.pod:787 ../libguestfs-1.11.19/fish/guestfish-actions.pod:787 ../libguestfs-1.11.19/src/guestfs-actions.pod:1178 ../src/guestfs-actions.pod:1178 msgid "" "Note this will fail if the source is too short or if the destination is not " "large enough." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1183 ../src/guestfs-actions.pod:1306 ../src/guestfs-actions.pod:1337 ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:1781 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:7228 ../src/guestfs-actions.pod:7262 ../src/guestfs-actions.pod:7763 ../src/guestfs-actions.pod:7782 -msgid "" -"This long-running command can generate progress notification messages so " -"that the caller can display a progress bar or indicator. To receive these " -"messages, the caller must register a progress event callback. See " -"L<guestfs(3)/GUESTFS_EVENT_PROGRESS>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1188 ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:5739 ../src/guestfs-actions.pod:7463 ../src/guestfs-actions.pod:7483 ../src/guestfs-actions.pod:7569 -msgid "(Added in 1.0.87)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1190 -msgid "guestfs_cp" +#: ../fish/guestfish-actions.pod:790 ../libguestfs-1.11.19/fish/guestfish-actions.pod:790 +msgid "cp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1192 +#: ../fish/guestfish-actions.pod:792 ../libguestfs-1.11.19/fish/guestfish-actions.pod:792 #, no-wrap msgid "" -" int\n" -" guestfs_cp (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest);\n" +" cp src dest\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1197 ../fish/guestfish-actions.pod:794 +#: ../fish/guestfish-actions.pod:794 ../libguestfs-1.11.19/fish/guestfish-actions.pod:794 ../libguestfs-1.11.19/src/guestfs-actions.pod:1197 ../src/guestfs-actions.pod:1197 msgid "" "This copies a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1202 ../src/guestfs-actions.pod:1216 ../src/guestfs-actions.pod:1288 ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:1476 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5583 -msgid "(Added in 1.0.18)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1204 -msgid "guestfs_cp_a" +#: ../fish/guestfish-actions.pod:797 ../libguestfs-1.11.19/fish/guestfish-actions.pod:797 +msgid "cp-a" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1206 +#: ../fish/guestfish-actions.pod:799 ../libguestfs-1.11.19/fish/guestfish-actions.pod:799 #, no-wrap msgid "" -" int\n" -" guestfs_cp_a (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest);\n" +" cp-a src dest\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:801 +#: ../fish/guestfish-actions.pod:801 ../libguestfs-1.11.19/fish/guestfish-actions.pod:801 ../libguestfs-1.11.19/src/guestfs-actions.pod:1211 ../src/guestfs-actions.pod:1211 msgid "" "This copies a file or directory from C<src> to C<dest> recursively using the " "C<cp -a> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1218 -msgid "guestfs_dd" +#: ../fish/guestfish-actions.pod:804 ../libguestfs-1.11.19/fish/guestfish-actions.pod:804 +msgid "dd" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1220 +#: ../fish/guestfish-actions.pod:806 ../libguestfs-1.11.19/fish/guestfish-actions.pod:806 #, no-wrap msgid "" -" int\n" -" guestfs_dd (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest);\n" +" dd src dest\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1225 ../fish/guestfish-actions.pod:808 +#: ../fish/guestfish-actions.pod:808 ../libguestfs-1.11.19/fish/guestfish-actions.pod:808 ../libguestfs-1.11.19/src/guestfs-actions.pod:1225 ../src/guestfs-actions.pod:1225 msgid "" "This command copies from one source device or file C<src> to another " "destination device or file C<dest>. Normally you would use this to copy to " @@ -7972,188 +5379,165 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1230 +#: ../fish/guestfish-actions.pod:813 ../libguestfs-1.11.19/fish/guestfish-actions.pod:813 msgid "" "If the destination is a device, it must be as large or larger than the " "source file or device, otherwise the copy will fail. This command cannot do " -"partial copies (see C<guestfs_copy_size>)." +"partial copies (see L</copy-size>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1238 -msgid "guestfs_df" +#: ../fish/guestfish-actions.pod:817 ../libguestfs-1.11.19/fish/guestfish-actions.pod:817 +msgid "df" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1240 +#: ../fish/guestfish-actions.pod:819 ../libguestfs-1.11.19/fish/guestfish-actions.pod:819 #, no-wrap msgid "" -" char *\n" -" guestfs_df (guestfs_h *g);\n" +" df\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1243 ../fish/guestfish-actions.pod:821 +#: ../fish/guestfish-actions.pod:821 ../libguestfs-1.11.19/fish/guestfish-actions.pod:821 ../libguestfs-1.11.19/src/guestfs-actions.pod:1243 ../src/guestfs-actions.pod:1243 msgid "This command runs the C<df> command to report disk space used." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1245 ../src/guestfs-actions.pod:1262 +#: ../fish/guestfish-actions.pod:823 ../fish/guestfish-actions.pod:834 ../libguestfs-1.11.19/fish/guestfish-actions.pod:823 ../libguestfs-1.11.19/fish/guestfish-actions.pod:834 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " -"intended that you try to parse the output string. Use C<guestfs_statvfs> " -"from programs." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1252 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:2359 ../src/guestfs-actions.pod:2383 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:4470 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:6966 ../src/guestfs-actions.pod:6990 ../src/guestfs-actions.pod:7609 ../src/guestfs-actions.pod:7622 ../src/guestfs-actions.pod:7635 -msgid "(Added in 1.0.54)" +"intended that you try to parse the output string. Use L</statvfs> from " +"programs." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1254 -msgid "guestfs_df_h" +#: ../fish/guestfish-actions.pod:827 ../libguestfs-1.11.19/fish/guestfish-actions.pod:827 +msgid "df-h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1256 +#: ../fish/guestfish-actions.pod:829 ../libguestfs-1.11.19/fish/guestfish-actions.pod:829 #, no-wrap msgid "" -" char *\n" -" guestfs_df_h (guestfs_h *g);\n" +" df-h\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1259 ../fish/guestfish-actions.pod:831 +#: ../fish/guestfish-actions.pod:831 ../libguestfs-1.11.19/fish/guestfish-actions.pod:831 ../libguestfs-1.11.19/src/guestfs-actions.pod:1259 ../src/guestfs-actions.pod:1259 msgid "" "This command runs the C<df -h> command to report disk space used in " "human-readable format." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1271 -msgid "guestfs_dmesg" +#: ../fish/guestfish-actions.pod:838 ../libguestfs-1.11.19/fish/guestfish-actions.pod:838 +msgid "dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1273 +#: ../fish/guestfish-actions.pod:840 ../libguestfs-1.11.19/fish/guestfish-actions.pod:840 #, no-wrap msgid "" -" char *\n" -" guestfs_dmesg (guestfs_h *g);\n" +" dmesg\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1276 ../fish/guestfish-actions.pod:842 +#: ../fish/guestfish-actions.pod:842 ../libguestfs-1.11.19/fish/guestfish-actions.pod:842 ../libguestfs-1.11.19/src/guestfs-actions.pod:1276 ../src/guestfs-actions.pod:1276 msgid "" "This returns the kernel messages (C<dmesg> output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1280 +#: ../fish/guestfish-actions.pod:846 ../libguestfs-1.11.19/fish/guestfish-actions.pod:846 msgid "" "Another way to get the same information is to enable verbose messages with " -"C<guestfs_set_verbose> or by setting the environment variable " -"C<LIBGUESTFS_DEBUG=1> before running the program." +"L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> " +"before running the program." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1290 -msgid "guestfs_download" +#: ../fish/guestfish-actions.pod:851 ../libguestfs-1.11.19/fish/guestfish-actions.pod:851 +msgid "download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1292 +#: ../fish/guestfish-actions.pod:853 ../libguestfs-1.11.19/fish/guestfish-actions.pod:853 #, no-wrap msgid "" -" int\n" -" guestfs_download (guestfs_h *g,\n" -" const char *remotefilename,\n" -" const char *filename);\n" +" download remotefilename (filename|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1322 ../fish/guestfish-actions.pod:855 ../fish/guestfish-actions.pod:868 +#: ../fish/guestfish-actions.pod:855 ../fish/guestfish-actions.pod:868 ../libguestfs-1.11.19/fish/guestfish-actions.pod:855 ../libguestfs-1.11.19/fish/guestfish-actions.pod:868 ../libguestfs-1.11.19/src/guestfs-actions.pod:1297 ../libguestfs-1.11.19/src/guestfs-actions.pod:1322 ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1322 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:7222 ../fish/guestfish-actions.pod:858 ../fish/guestfish-actions.pod:4797 +#: ../fish/guestfish-actions.pod:858 ../fish/guestfish-actions.pod:4803 ../libguestfs-1.11.19/fish/guestfish-actions.pod:858 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4803 ../libguestfs-1.11.19/src/guestfs-actions.pod:1300 ../libguestfs-1.11.19/src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:7232 msgid "C<filename> can also be a named pipe." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1302 -msgid "See also C<guestfs_upload>, C<guestfs_cat>." +#: ../fish/guestfish-actions.pod:860 ../libguestfs-1.11.19/fish/guestfish-actions.pod:860 +msgid "See also L</upload>, L</cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1313 -msgid "guestfs_download_offset" +#: ../fish/guestfish-actions.pod:864 ../libguestfs-1.11.19/fish/guestfish-actions.pod:864 +msgid "download-offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1315 +#: ../fish/guestfish-actions.pod:866 ../libguestfs-1.11.19/fish/guestfish-actions.pod:866 #, no-wrap msgid "" -" int\n" -" guestfs_download_offset (guestfs_h *g,\n" -" const char *remotefilename,\n" -" const char *filename,\n" -" int64_t offset,\n" -" int64_t size);\n" +" download-offset remotefilename (filename|-) offset size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1325 ../fish/guestfish-actions.pod:871 +#: ../fish/guestfish-actions.pod:871 ../libguestfs-1.11.19/fish/guestfish-actions.pod:871 ../libguestfs-1.11.19/src/guestfs-actions.pod:1325 ../src/guestfs-actions.pod:1325 msgid "" "C<remotefilename> is read for C<size> bytes starting at C<offset> (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1328 +#: ../fish/guestfish-actions.pod:874 ../libguestfs-1.11.19/fish/guestfish-actions.pod:874 msgid "" "Note that there is no limit on the amount of data that can be downloaded " -"with this call, unlike with C<guestfs_pread>, and this call always reads the " -"full amount unless an error occurs." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1333 -msgid "See also C<guestfs_download>, C<guestfs_pread>." +"with this call, unlike with L</pread>, and this call always reads the full " +"amount unless an error occurs." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:7267 -msgid "(Added in 1.5.17)" +#: ../fish/guestfish-actions.pod:879 ../libguestfs-1.11.19/fish/guestfish-actions.pod:879 +msgid "See also L</download>, L</pread>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1344 -msgid "guestfs_drop_caches" +#: ../fish/guestfish-actions.pod:883 ../libguestfs-1.11.19/fish/guestfish-actions.pod:883 +msgid "drop-caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1346 +#: ../fish/guestfish-actions.pod:885 ../libguestfs-1.11.19/fish/guestfish-actions.pod:885 #, no-wrap msgid "" -" int\n" -" guestfs_drop_caches (guestfs_h *g,\n" -" int whattodrop);\n" +" drop-caches whattodrop\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1350 ../fish/guestfish-actions.pod:887 +#: ../fish/guestfish-actions.pod:887 ../libguestfs-1.11.19/fish/guestfish-actions.pod:887 ../libguestfs-1.11.19/src/guestfs-actions.pod:1350 ../src/guestfs-actions.pod:1350 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C<whattodrop> tells the kernel what precisely " @@ -8161,41 +5545,39 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1355 ../fish/guestfish-actions.pod:892 +#: ../fish/guestfish-actions.pod:892 ../libguestfs-1.11.19/fish/guestfish-actions.pod:892 ../libguestfs-1.11.19/src/guestfs-actions.pod:1355 ../src/guestfs-actions.pod:1355 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1357 ../fish/guestfish-actions.pod:894 +#: ../fish/guestfish-actions.pod:894 ../libguestfs-1.11.19/fish/guestfish-actions.pod:894 ../libguestfs-1.11.19/src/guestfs-actions.pod:1357 ../src/guestfs-actions.pod:1357 msgid "" "This automatically calls L<sync(2)> before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1364 -msgid "guestfs_du" +#: ../fish/guestfish-actions.pod:897 ../libguestfs-1.11.19/fish/guestfish-actions.pod:897 +msgid "du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1366 +#: ../fish/guestfish-actions.pod:899 ../libguestfs-1.11.19/fish/guestfish-actions.pod:899 #, no-wrap msgid "" -" int64_t\n" -" guestfs_du (guestfs_h *g,\n" -" const char *path);\n" +" du path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1370 ../fish/guestfish-actions.pod:901 +#: ../fish/guestfish-actions.pod:901 ../libguestfs-1.11.19/fish/guestfish-actions.pod:901 ../libguestfs-1.11.19/src/guestfs-actions.pod:1370 ../src/guestfs-actions.pod:1370 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1373 ../fish/guestfish-actions.pod:904 +#: ../fish/guestfish-actions.pod:904 ../libguestfs-1.11.19/fish/guestfish-actions.pod:904 ../libguestfs-1.11.19/src/guestfs-actions.pod:1373 ../src/guestfs-actions.pod:1373 msgid "" "C<path> can be a file or a directory. If C<path> is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -8203,27 +5585,25 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1377 ../fish/guestfish-actions.pod:908 +#: ../fish/guestfish-actions.pod:908 ../libguestfs-1.11.19/fish/guestfish-actions.pod:908 ../libguestfs-1.11.19/src/guestfs-actions.pod:1377 ../src/guestfs-actions.pod:1377 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1389 -msgid "guestfs_e2fsck_f" +#: ../fish/guestfish-actions.pod:911 ../libguestfs-1.11.19/fish/guestfish-actions.pod:911 +msgid "e2fsck-f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1391 +#: ../fish/guestfish-actions.pod:913 ../libguestfs-1.11.19/fish/guestfish-actions.pod:913 #, no-wrap msgid "" -" int\n" -" guestfs_e2fsck_f (guestfs_h *g,\n" -" const char *device);\n" +" e2fsck-f device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1395 ../fish/guestfish-actions.pod:915 +#: ../fish/guestfish-actions.pod:915 ../libguestfs-1.11.19/fish/guestfish-actions.pod:915 ../libguestfs-1.11.19/src/guestfs-actions.pod:1395 ../src/guestfs-actions.pod:1395 msgid "" "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker " "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be " @@ -8231,316 +5611,269 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1399 +#: ../fish/guestfish-actions.pod:919 ../libguestfs-1.11.19/fish/guestfish-actions.pod:919 msgid "" -"This command is only needed because of C<guestfs_resize2fs> (q.v.). " -"Normally you should use C<guestfs_fsck>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1404 -msgid "(Added in 1.0.29)" +"This command is only needed because of L</resize2fs> (q.v.). Normally you " +"should use L</fsck>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1406 -msgid "guestfs_echo_daemon" +#: ../fish/guestfish-actions.pod:922 ../libguestfs-1.11.19/fish/guestfish-actions.pod:922 +msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1408 +#: ../fish/guestfish-actions.pod:924 ../libguestfs-1.11.19/fish/guestfish-actions.pod:924 #, no-wrap msgid "" -" char *\n" -" guestfs_echo_daemon (guestfs_h *g,\n" -" char *const *words);\n" +" echo-daemon 'words ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1412 ../fish/guestfish-actions.pod:926 +#: ../fish/guestfish-actions.pod:926 ../libguestfs-1.11.19/fish/guestfish-actions.pod:926 ../libguestfs-1.11.19/src/guestfs-actions.pod:1412 ../src/guestfs-actions.pod:1412 msgid "" "This command concatenates the list of C<words> passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1415 ../fish/guestfish-actions.pod:929 +#: ../fish/guestfish-actions.pod:929 ../libguestfs-1.11.19/fish/guestfish-actions.pod:929 ../libguestfs-1.11.19/src/guestfs-actions.pod:1415 ../src/guestfs-actions.pod:1415 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1417 -msgid "See also C<guestfs_ping_daemon>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:2167 ../src/guestfs-actions.pod:6438 -msgid "(Added in 1.0.69)" +#: ../fish/guestfish-actions.pod:931 ../libguestfs-1.11.19/fish/guestfish-actions.pod:931 +msgid "See also L</ping-daemon>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1424 -msgid "guestfs_egrep" +#: ../fish/guestfish-actions.pod:933 ../libguestfs-1.11.19/fish/guestfish-actions.pod:933 +msgid "egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1426 +#: ../fish/guestfish-actions.pod:935 ../libguestfs-1.11.19/fish/guestfish-actions.pod:935 #, no-wrap msgid "" -" char **\n" -" guestfs_egrep (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" egrep regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1431 ../fish/guestfish-actions.pod:937 +#: ../fish/guestfish-actions.pod:937 ../libguestfs-1.11.19/fish/guestfish-actions.pod:937 ../libguestfs-1.11.19/src/guestfs-actions.pod:1431 ../src/guestfs-actions.pod:1431 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1441 ../src/guestfs-actions.pod:1460 ../src/guestfs-actions.pod:1517 ../src/guestfs-actions.pod:1563 ../src/guestfs-actions.pod:1582 ../src/guestfs-actions.pod:2297 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2472 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2500 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2568 ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:5917 ../src/guestfs-actions.pod:5966 ../src/guestfs-actions.pod:6834 ../src/guestfs-actions.pod:6846 ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:6872 ../src/guestfs-actions.pod:6894 ../src/guestfs-actions.pod:6907 ../src/guestfs-actions.pod:6920 ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:7725 ../src/guestfs-actions.pod:7744 ../src/guestfs-actions.pod:7830 ../src/guestfs-actions.pod:7849 ../src/guestfs-actions.pod:7895 ../src/guestfs-actions.pod:7914 -msgid "(Added in 1.0.66)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1443 -msgid "guestfs_egrepi" +#: ../fish/guestfish-actions.pod:943 ../libguestfs-1.11.19/fish/guestfish-actions.pod:943 +msgid "egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1445 +#: ../fish/guestfish-actions.pod:945 ../libguestfs-1.11.19/fish/guestfish-actions.pod:945 #, no-wrap msgid "" -" char **\n" -" guestfs_egrepi (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" egrepi regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1450 ../fish/guestfish-actions.pod:947 +#: ../fish/guestfish-actions.pod:947 ../libguestfs-1.11.19/fish/guestfish-actions.pod:947 ../libguestfs-1.11.19/src/guestfs-actions.pod:1450 ../src/guestfs-actions.pod:1450 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1462 -msgid "guestfs_equal" +#: ../fish/guestfish-actions.pod:953 ../libguestfs-1.11.19/fish/guestfish-actions.pod:953 +msgid "equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1464 +#: ../fish/guestfish-actions.pod:955 ../libguestfs-1.11.19/fish/guestfish-actions.pod:955 #, no-wrap msgid "" -" int\n" -" guestfs_equal (guestfs_h *g,\n" -" const char *file1,\n" -" const char *file2);\n" +" equal file1 file2\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1469 ../fish/guestfish-actions.pod:957 +#: ../fish/guestfish-actions.pod:957 ../libguestfs-1.11.19/fish/guestfish-actions.pod:957 ../libguestfs-1.11.19/src/guestfs-actions.pod:1469 ../src/guestfs-actions.pod:1469 msgid "" "This compares the two files C<file1> and C<file2> and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1472 ../fish/guestfish-actions.pod:960 +#: ../fish/guestfish-actions.pod:960 ../libguestfs-1.11.19/fish/guestfish-actions.pod:960 ../libguestfs-1.11.19/src/guestfs-actions.pod:1472 ../src/guestfs-actions.pod:1472 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1478 -msgid "guestfs_exists" +#: ../fish/guestfish-actions.pod:962 ../libguestfs-1.11.19/fish/guestfish-actions.pod:962 +msgid "exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1480 +#: ../fish/guestfish-actions.pod:964 ../libguestfs-1.11.19/fish/guestfish-actions.pod:964 #, no-wrap msgid "" -" int\n" -" guestfs_exists (guestfs_h *g,\n" -" const char *path);\n" +" exists path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1484 ../fish/guestfish-actions.pod:966 +#: ../fish/guestfish-actions.pod:966 ../libguestfs-1.11.19/fish/guestfish-actions.pod:966 ../libguestfs-1.11.19/src/guestfs-actions.pod:1484 ../src/guestfs-actions.pod:1484 msgid "" "This returns C<true> if and only if there is a file, directory (or anything) " "with the given C<path> name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1487 -msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." +#: ../fish/guestfish-actions.pod:969 ../libguestfs-1.11.19/fish/guestfish-actions.pod:969 +msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1493 -msgid "guestfs_fallocate" +#: ../fish/guestfish-actions.pod:971 ../libguestfs-1.11.19/fish/guestfish-actions.pod:971 +msgid "fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1495 +#: ../fish/guestfish-actions.pod:973 ../libguestfs-1.11.19/fish/guestfish-actions.pod:973 #, no-wrap msgid "" -" int\n" -" guestfs_fallocate (guestfs_h *g,\n" -" const char *path,\n" -" int len);\n" +" fallocate path len\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1526 ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:994 +#: ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:994 ../libguestfs-1.11.19/fish/guestfish-actions.pod:975 ../libguestfs-1.11.19/fish/guestfish-actions.pod:994 ../libguestfs-1.11.19/src/guestfs-actions.pod:1500 ../libguestfs-1.11.19/src/guestfs-actions.pod:1526 ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1526 msgid "" "This command preallocates a file (containing zero bytes) named C<path> of " "size C<len> bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1504 ../fish/guestfish-actions.pod:979 +#: ../fish/guestfish-actions.pod:979 ../libguestfs-1.11.19/fish/guestfish-actions.pod:979 ../libguestfs-1.11.19/src/guestfs-actions.pod:1504 ../src/guestfs-actions.pod:1504 msgid "" "Do not confuse this with the guestfish-specific C<alloc> command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1510 ../fish/guestfish-actions.pod:983 +#: ../fish/guestfish-actions.pod:983 ../libguestfs-1.11.19/fish/guestfish-actions.pod:983 ../libguestfs-1.11.19/src/guestfs-actions.pod:1510 ../src/guestfs-actions.pod:1510 msgid "" "This function is deprecated. In new code, use the C<fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1519 -msgid "guestfs_fallocate64" +#: ../fish/guestfish-actions.pod:990 ../libguestfs-1.11.19/fish/guestfish-actions.pod:990 +msgid "fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1521 +#: ../fish/guestfish-actions.pod:992 ../libguestfs-1.11.19/fish/guestfish-actions.pod:992 #, no-wrap msgid "" -" int\n" -" guestfs_fallocate64 (guestfs_h *g,\n" -" const char *path,\n" -" int64_t len);\n" +" fallocate64 path len\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1530 +#: ../fish/guestfish-actions.pod:998 ../libguestfs-1.11.19/fish/guestfish-actions.pod:998 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " -"file use C<guestfs_truncate_size> instead." +"file use L</truncate-size> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1533 +#: ../fish/guestfish-actions.pod:1001 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1001 msgid "" -"The deprecated call C<guestfs_fallocate> does the same, but owing to an " -"oversight it only allowed 30 bit lengths to be specified, effectively " -"limiting the maximum size of files created through that call to 1GB." +"The deprecated call L</fallocate> does the same, but owing to an oversight " +"it only allowed 30 bit lengths to be specified, effectively limiting the " +"maximum size of files created through that call to 1GB." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1538 ../fish/guestfish-actions.pod:1006 +#: ../fish/guestfish-actions.pod:1006 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1006 ../libguestfs-1.11.19/src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1538 msgid "" "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> " "commands which create a file in the host and attach it as a device." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1544 -msgid "(Added in 1.3.17)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1546 -msgid "guestfs_fgrep" +#: ../fish/guestfish-actions.pod:1010 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1010 +msgid "fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1548 +#: ../fish/guestfish-actions.pod:1012 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1012 #, no-wrap msgid "" -" char **\n" -" guestfs_fgrep (guestfs_h *g,\n" -" const char *pattern,\n" -" const char *path);\n" +" fgrep pattern path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1553 ../fish/guestfish-actions.pod:1014 +#: ../fish/guestfish-actions.pod:1014 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1014 ../libguestfs-1.11.19/src/guestfs-actions.pod:1553 ../src/guestfs-actions.pod:1553 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1565 -msgid "guestfs_fgrepi" +#: ../fish/guestfish-actions.pod:1020 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1020 +msgid "fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1567 +#: ../fish/guestfish-actions.pod:1022 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1022 #, no-wrap msgid "" -" char **\n" -" guestfs_fgrepi (guestfs_h *g,\n" -" const char *pattern,\n" -" const char *path);\n" +" fgrepi pattern path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1024 +#: ../fish/guestfish-actions.pod:1024 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1024 ../libguestfs-1.11.19/src/guestfs-actions.pod:1572 ../src/guestfs-actions.pod:1572 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1584 -msgid "guestfs_file" +#: ../fish/guestfish-actions.pod:1030 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1030 +msgid "file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1586 +#: ../fish/guestfish-actions.pod:1032 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1032 #, no-wrap msgid "" -" char *\n" -" guestfs_file (guestfs_h *g,\n" -" const char *path);\n" +" file path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1034 +#: ../fish/guestfish-actions.pod:1034 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1034 ../libguestfs-1.11.19/src/guestfs-actions.pod:1590 ../src/guestfs-actions.pod:1590 msgid "" "This call uses the standard L<file(1)> command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1037 +#: ../fish/guestfish-actions.pod:1037 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1037 ../libguestfs-1.11.19/src/guestfs-actions.pod:1593 ../src/guestfs-actions.pod:1593 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1040 +#: ../fish/guestfish-actions.pod:1040 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1040 ../libguestfs-1.11.19/src/guestfs-actions.pod:1596 ../src/guestfs-actions.pod:1596 msgid "" "The exact command which runs is C<file -zb path>. Note in particular that " "the filename is not prepended to the output (the I<-b> option)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1600 ../fish/guestfish-actions.pod:1044 +#: ../fish/guestfish-actions.pod:1044 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1044 ../libguestfs-1.11.19/src/guestfs-actions.pod:1600 ../src/guestfs-actions.pod:1600 msgid "" "The output depends on the output of the underlying L<file(1)> command and it " "can change in future in ways beyond our control. In other words, the output " @@ -8548,188 +5881,186 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1604 +#: ../fish/guestfish-actions.pod:1048 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1048 msgid "" -"See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, " -"C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>." +"See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> " +"(etc), L</is-zero>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1612 -msgid "guestfs_file_architecture" +#: ../fish/guestfish-actions.pod:1051 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1051 +msgid "file-architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1614 +#: ../fish/guestfish-actions.pod:1053 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1053 #, no-wrap msgid "" -" char *\n" -" guestfs_file_architecture (guestfs_h *g,\n" -" const char *filename);\n" +" file-architecture filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1055 +#: ../fish/guestfish-actions.pod:1055 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1055 ../libguestfs-1.11.19/src/guestfs-actions.pod:1618 ../src/guestfs-actions.pod:1618 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1058 +#: ../fish/guestfish-actions.pod:1058 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1058 ../libguestfs-1.11.19/src/guestfs-actions.pod:1621 ../src/guestfs-actions.pod:1621 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1062 +#: ../fish/guestfish-actions.pod:1062 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1062 ../libguestfs-1.11.19/src/guestfs-actions.pod:1625 ../src/guestfs-actions.pod:1625 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1627 ../fish/guestfish-actions.pod:1064 +#: ../fish/guestfish-actions.pod:1064 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1064 ../libguestfs-1.11.19/src/guestfs-actions.pod:1627 ../src/guestfs-actions.pod:1627 msgid "" "This string is returned for all 32 bit i386, i486, i586, i686 binaries " "irrespective of the precise processor requirements of the binary." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1630 ../fish/guestfish-actions.pod:1067 +#: ../fish/guestfish-actions.pod:1067 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1067 ../libguestfs-1.11.19/src/guestfs-actions.pod:1630 ../src/guestfs-actions.pod:1630 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1069 +#: ../fish/guestfish-actions.pod:1069 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1069 ../libguestfs-1.11.19/src/guestfs-actions.pod:1632 ../src/guestfs-actions.pod:1632 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1634 ../fish/guestfish-actions.pod:1071 +#: ../fish/guestfish-actions.pod:1071 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1071 ../libguestfs-1.11.19/src/guestfs-actions.pod:1634 ../src/guestfs-actions.pod:1634 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1636 ../fish/guestfish-actions.pod:1073 +#: ../fish/guestfish-actions.pod:1073 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1073 ../libguestfs-1.11.19/src/guestfs-actions.pod:1636 ../src/guestfs-actions.pod:1636 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1638 ../fish/guestfish-actions.pod:1075 +#: ../fish/guestfish-actions.pod:1075 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1075 ../libguestfs-1.11.19/src/guestfs-actions.pod:1638 ../src/guestfs-actions.pod:1638 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1640 ../fish/guestfish-actions.pod:1077 +#: ../fish/guestfish-actions.pod:1077 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1077 ../libguestfs-1.11.19/src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1640 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1642 ../fish/guestfish-actions.pod:1079 +#: ../fish/guestfish-actions.pod:1079 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1079 ../libguestfs-1.11.19/src/guestfs-actions.pod:1642 ../src/guestfs-actions.pod:1642 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1644 ../fish/guestfish-actions.pod:1081 +#: ../fish/guestfish-actions.pod:1081 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1081 ../libguestfs-1.11.19/src/guestfs-actions.pod:1644 ../src/guestfs-actions.pod:1644 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1646 ../fish/guestfish-actions.pod:1083 +#: ../fish/guestfish-actions.pod:1083 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1083 ../libguestfs-1.11.19/src/guestfs-actions.pod:1646 ../src/guestfs-actions.pod:1646 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1648 ../fish/guestfish-actions.pod:1085 +#: ../fish/guestfish-actions.pod:1085 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1085 ../libguestfs-1.11.19/src/guestfs-actions.pod:1648 ../src/guestfs-actions.pod:1648 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1087 +#: ../fish/guestfish-actions.pod:1087 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1087 ../libguestfs-1.11.19/src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1650 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1089 +#: ../fish/guestfish-actions.pod:1089 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1089 ../libguestfs-1.11.19/src/guestfs-actions.pod:1652 ../src/guestfs-actions.pod:1652 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1656 ../fish/guestfish-actions.pod:1093 +#: ../fish/guestfish-actions.pod:1093 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1093 ../libguestfs-1.11.19/src/guestfs-actions.pod:1656 ../src/guestfs-actions.pod:1656 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1658 ../fish/guestfish-actions.pod:1095 +#: ../fish/guestfish-actions.pod:1095 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1095 ../libguestfs-1.11.19/src/guestfs-actions.pod:1658 ../src/guestfs-actions.pod:1658 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1664 ../fish/guestfish-actions.pod:1101 +#: ../fish/guestfish-actions.pod:1101 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1101 ../libguestfs-1.11.19/src/guestfs-actions.pod:1664 ../src/guestfs-actions.pod:1664 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1668 ../fish/guestfish-actions.pod:1105 +#: ../fish/guestfish-actions.pod:1105 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1105 ../libguestfs-1.11.19/src/guestfs-actions.pod:1668 ../src/guestfs-actions.pod:1668 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1672 ../fish/guestfish-actions.pod:1109 +#: ../fish/guestfish-actions.pod:1109 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1109 ../libguestfs-1.11.19/src/guestfs-actions.pod:1672 ../src/guestfs-actions.pod:1672 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1676 ../fish/guestfish-actions.pod:1113 +#: ../fish/guestfish-actions.pod:1113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1113 ../libguestfs-1.11.19/src/guestfs-actions.pod:1676 ../src/guestfs-actions.pod:1676 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1678 ../fish/guestfish-actions.pod:1115 +#: ../fish/guestfish-actions.pod:1115 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1115 ../libguestfs-1.11.19/src/guestfs-actions.pod:1678 ../src/guestfs-actions.pod:1678 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1680 ../fish/guestfish-actions.pod:1117 +#: ../fish/guestfish-actions.pod:1117 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1117 ../libguestfs-1.11.19/src/guestfs-actions.pod:1680 ../src/guestfs-actions.pod:1680 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1684 ../fish/guestfish-actions.pod:1121 +#: ../fish/guestfish-actions.pod:1121 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1121 ../libguestfs-1.11.19/src/guestfs-actions.pod:1684 ../src/guestfs-actions.pod:1684 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1688 ../fish/guestfish-actions.pod:1125 +#: ../fish/guestfish-actions.pod:1125 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1125 ../libguestfs-1.11.19/src/guestfs-actions.pod:1688 ../src/guestfs-actions.pod:1688 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1692 ../fish/guestfish-actions.pod:1129 +#: ../fish/guestfish-actions.pod:1129 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1129 ../libguestfs-1.11.19/src/guestfs-actions.pod:1692 ../src/guestfs-actions.pod:1692 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1696 ../fish/guestfish-actions.pod:1133 +#: ../fish/guestfish-actions.pod:1133 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1133 ../libguestfs-1.11.19/src/guestfs-actions.pod:1696 ../src/guestfs-actions.pod:1696 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1702 ../fish/guestfish-actions.pod:1139 +#: ../fish/guestfish-actions.pod:1139 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1139 ../libguestfs-1.11.19/src/guestfs-actions.pod:1702 ../src/guestfs-actions.pod:1702 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1706 ../fish/guestfish-actions.pod:1143 +#: ../fish/guestfish-actions.pod:1143 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1143 ../libguestfs-1.11.19/src/guestfs-actions.pod:1706 ../src/guestfs-actions.pod:1706 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1710 ../fish/guestfish-actions.pod:1147 +#: ../fish/guestfish-actions.pod:1147 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1147 ../libguestfs-1.11.19/src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1710 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1712 ../fish/guestfish-actions.pod:1149 +#: ../fish/guestfish-actions.pod:1149 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1149 ../libguestfs-1.11.19/src/guestfs-actions.pod:1712 ../src/guestfs-actions.pod:1712 msgid "" "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " "compressed code, and are horribly hard to unpack. If you want to find the " @@ -8737,63 +6068,47 @@ msgid "" "kernel module(s) instead." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1885 ../src/guestfs-actions.pod:1902 ../src/guestfs-actions.pod:2601 ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2757 ../src/guestfs-actions.pod:2944 ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:3002 ../src/guestfs-actions.pod:3077 ../src/guestfs-actions.pod:3170 ../src/guestfs-actions.pod:3407 ../src/guestfs-actions.pod:3539 -msgid "(Added in 1.5.3)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1724 -msgid "guestfs_filesize" +#: ../fish/guestfish-actions.pod:1156 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1156 +msgid "filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1726 +#: ../fish/guestfish-actions.pod:1158 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1158 #, no-wrap msgid "" -" int64_t\n" -" guestfs_filesize (guestfs_h *g,\n" -" const char *file);\n" +" filesize file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1730 ../fish/guestfish-actions.pod:1160 +#: ../fish/guestfish-actions.pod:1160 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1160 ../libguestfs-1.11.19/src/guestfs-actions.pod:1730 ../src/guestfs-actions.pod:1730 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1732 +#: ../fish/guestfish-actions.pod:1162 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1162 msgid "" -"To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " -"C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " -"devices, use C<guestfs_blockdev_getsize64>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1738 -msgid "(Added in 1.0.82)" +"To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, " +"L</is-file> etc. To get the size of block devices, use " +"L</blockdev-getsize64>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1740 -msgid "guestfs_fill" +#: ../fish/guestfish-actions.pod:1166 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1166 +msgid "fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1742 +#: ../fish/guestfish-actions.pod:1168 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1168 #, no-wrap msgid "" -" int\n" -" guestfs_fill (guestfs_h *g,\n" -" int c,\n" -" int len,\n" -" const char *path);\n" +" fill c len path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1748 ../fish/guestfish-actions.pod:1170 +#: ../fish/guestfish-actions.pod:1170 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1170 ../libguestfs-1.11.19/src/guestfs-actions.pod:1748 ../src/guestfs-actions.pod:1748 msgid "" "This command creates a new file called C<path>. The initial content of the " "file is C<len> octets of C<c>, where C<c> must be a number in the range " @@ -8801,66 +6116,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1752 +#: ../fish/guestfish-actions.pod:1174 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1174 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " -"C<guestfs_truncate_size>. To create a file with a pattern of repeating " -"bytes use C<guestfs_fill_pattern>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1764 -msgid "(Added in 1.0.79)" +"L</truncate-size>. To create a file with a pattern of repeating bytes use " +"L</fill-pattern>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1766 -msgid "guestfs_fill_pattern" +#: ../fish/guestfish-actions.pod:1179 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1179 +msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1768 +#: ../fish/guestfish-actions.pod:1181 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1181 #, no-wrap msgid "" -" int\n" -" guestfs_fill_pattern (guestfs_h *g,\n" -" const char *pattern,\n" -" int len,\n" -" const char *path);\n" +" fill-pattern pattern len path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1774 +#: ../fish/guestfish-actions.pod:1183 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1183 msgid "" -"This function is like C<guestfs_fill> except that it creates a new file of " -"length C<len> containing the repeating pattern of bytes in C<pattern>. The " -"pattern is truncated if necessary to ensure the length of the file is " -"exactly C<len> bytes." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1786 -msgid "(Added in 1.3.12)" +"This function is like L</fill> except that it creates a new file of length " +"C<len> containing the repeating pattern of bytes in C<pattern>. The pattern " +"is truncated if necessary to ensure the length of the file is exactly C<len> " +"bytes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1788 -msgid "guestfs_find" +#: ../fish/guestfish-actions.pod:1188 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1188 +msgid "find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1790 +#: ../fish/guestfish-actions.pod:1190 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1190 #, no-wrap msgid "" -" char **\n" -" guestfs_find (guestfs_h *g,\n" -" const char *directory);\n" +" find directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1794 ../fish/guestfish-actions.pod:1192 +#: ../fish/guestfish-actions.pod:1192 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1192 ../libguestfs-1.11.19/src/guestfs-actions.pod:1794 ../src/guestfs-actions.pod:1794 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -8869,14 +6168,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1799 ../fish/guestfish-actions.pod:1197 +#: ../fish/guestfish-actions.pod:1197 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1197 ../libguestfs-1.11.19/src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:1799 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1802 ../fish/guestfish-actions.pod:1200 +#: ../fish/guestfish-actions.pod:1200 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1200 ../libguestfs-1.11.19/src/guestfs-actions.pod:1802 ../src/guestfs-actions.pod:1802 #, no-wrap msgid "" " /tmp/a\n" @@ -8886,12 +6185,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1806 -msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" +#: ../fish/guestfish-actions.pod:1204 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1204 +msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1809 ../fish/guestfish-actions.pod:1207 +#: ../fish/guestfish-actions.pod:1207 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1207 ../libguestfs-1.11.19/src/guestfs-actions.pod:1809 ../src/guestfs-actions.pod:1809 #, no-wrap msgid "" " a\n" @@ -8902,43 +6201,35 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1814 ../fish/guestfish-actions.pod:1212 +#: ../fish/guestfish-actions.pod:1212 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1212 ../libguestfs-1.11.19/src/guestfs-actions.pod:1814 ../src/guestfs-actions.pod:1814 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1817 ../fish/guestfish-actions.pod:1215 +#: ../fish/guestfish-actions.pod:1215 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1215 ../libguestfs-1.11.19/src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1817 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1819 -msgid "See also C<guestfs_find0>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1828 ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:6001 -msgid "(Added in 1.0.27)" +#: ../fish/guestfish-actions.pod:1217 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1217 +msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1830 -msgid "guestfs_find0" +#: ../fish/guestfish-actions.pod:1222 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1222 +msgid "find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1832 +#: ../fish/guestfish-actions.pod:1224 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1224 #, no-wrap msgid "" -" int\n" -" guestfs_find0 (guestfs_h *g,\n" -" const char *directory,\n" -" const char *files);\n" +" find0 directory (files|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1837 ../fish/guestfish-actions.pod:1226 +#: ../fish/guestfish-actions.pod:1226 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1226 ../libguestfs-1.11.19/src/guestfs-actions.pod:1837 ../src/guestfs-actions.pod:1837 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -8946,857 +6237,710 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1841 -msgid "" -"This command works the same way as C<guestfs_find> with the following " -"exceptions:" +#: ../fish/guestfish-actions.pod:1230 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1230 +msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1848 ../fish/guestfish-actions.pod:1237 +#: ../fish/guestfish-actions.pod:1237 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1237 ../libguestfs-1.11.19/src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1848 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1241 +#: ../fish/guestfish-actions.pod:1241 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1241 ../libguestfs-1.11.19/src/guestfs-actions.pod:1852 ../src/guestfs-actions.pod:1852 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L<find(1)> option I<-print0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1857 ../fish/guestfish-actions.pod:1246 +#: ../fish/guestfish-actions.pod:1246 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1246 ../libguestfs-1.11.19/src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:1857 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1862 ../fish/guestfish-actions.pod:1251 +#: ../fish/guestfish-actions.pod:1251 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1251 ../libguestfs-1.11.19/src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:1862 msgid "The result list is not sorted." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1868 -msgid "(Added in 1.0.74)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1870 -msgid "guestfs_findfs_label" +#: ../fish/guestfish-actions.pod:1257 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1257 +msgid "findfs-label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1872 +#: ../fish/guestfish-actions.pod:1259 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1259 #, no-wrap msgid "" -" char *\n" -" guestfs_findfs_label (guestfs_h *g,\n" -" const char *label);\n" +" findfs-label label\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1876 ../fish/guestfish-actions.pod:1261 +#: ../fish/guestfish-actions.pod:1261 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1261 ../libguestfs-1.11.19/src/guestfs-actions.pod:1876 ../src/guestfs-actions.pod:1876 msgid "" "This command searches the filesystems and returns the one which has the " "given label. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1880 -msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." +#: ../fish/guestfish-actions.pod:1265 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1265 +msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1887 -msgid "guestfs_findfs_uuid" +#: ../fish/guestfish-actions.pod:1267 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1267 +msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1889 +#: ../fish/guestfish-actions.pod:1269 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1269 #, no-wrap msgid "" -" char *\n" -" guestfs_findfs_uuid (guestfs_h *g,\n" -" const char *uuid);\n" +" findfs-uuid uuid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1893 ../fish/guestfish-actions.pod:1271 +#: ../fish/guestfish-actions.pod:1271 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1271 ../libguestfs-1.11.19/src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:1893 msgid "" "This command searches the filesystems and returns the one which has the " "given UUID. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1897 -msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." +#: ../fish/guestfish-actions.pod:1275 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1275 +msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1904 -msgid "guestfs_fsck" +#: ../fish/guestfish-actions.pod:1277 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1277 +msgid "fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1906 +#: ../fish/guestfish-actions.pod:1279 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1279 #, no-wrap msgid "" -" int\n" -" guestfs_fsck (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device);\n" +" fsck fstype device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1911 ../fish/guestfish-actions.pod:1281 +#: ../fish/guestfish-actions.pod:1281 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1281 ../libguestfs-1.11.19/src/guestfs-actions.pod:1911 ../src/guestfs-actions.pod:1911 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1284 +#: ../fish/guestfish-actions.pod:1284 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1284 ../libguestfs-1.11.19/src/guestfs-actions.pod:1914 ../src/guestfs-actions.pod:1914 msgid "" "The returned integer is the status. See L<fsck(8)> for the list of status " "codes from C<fsck>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1923 ../fish/guestfish-actions.pod:1293 +#: ../fish/guestfish-actions.pod:1293 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1293 ../libguestfs-1.11.19/src/guestfs-actions.pod:1923 ../src/guestfs-actions.pod:1923 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1927 ../fish/guestfish-actions.pod:1297 +#: ../fish/guestfish-actions.pod:1297 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1297 ../libguestfs-1.11.19/src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1927 msgid "" "A non-zero return code can mean \"success\", for example if errors have been " "corrected on the filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1932 ../fish/guestfish-actions.pod:1302 +#: ../fish/guestfish-actions.pod:1302 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1302 ../libguestfs-1.11.19/src/guestfs-actions.pod:1932 ../src/guestfs-actions.pod:1932 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1937 ../fish/guestfish-actions.pod:1307 +#: ../fish/guestfish-actions.pod:1307 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1307 ../libguestfs-1.11.19/src/guestfs-actions.pod:1937 ../src/guestfs-actions.pod:1937 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:7768 -msgid "(Added in 1.0.16)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1943 -msgid "guestfs_get_append" +#: ../fish/guestfish-actions.pod:1309 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1309 +msgid "get-append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1945 +#: ../fish/guestfish-actions.pod:1311 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1311 #, no-wrap msgid "" -" const char *\n" -" guestfs_get_append (guestfs_h *g);\n" +" get-append\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1948 ../fish/guestfish-actions.pod:1313 +#: ../fish/guestfish-actions.pod:1313 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1313 ../libguestfs-1.11.19/src/guestfs-actions.pod:1948 ../src/guestfs-actions.pod:1948 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1951 ../fish/guestfish-actions.pod:1316 +#: ../fish/guestfish-actions.pod:1316 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1316 ../libguestfs-1.11.19/src/guestfs-actions.pod:1951 ../src/guestfs-actions.pod:1951 msgid "If C<NULL> then no options are added." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1953 -msgid "" -"This function returns a string which may be NULL. There is no way to return " -"an error from this function. The string is owned by the guest handle and " -"must I<not> be freed." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1957 ../src/guestfs-actions.pod:5679 ../src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:6620 ../src/guestfs-actions.pod:6636 ../src/guestfs-actions.pod:6660 ../src/guestfs-actions.pod:7414 ../src/guestfs-actions.pod:7429 ../src/guestfs-actions.pod:7811 -msgid "(Added in 1.0.26)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1959 -msgid "guestfs_get_attach_method" +#: ../fish/guestfish-actions.pod:1318 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1318 +msgid "get-attach-method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1961 +#: ../fish/guestfish-actions.pod:1320 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1320 #, no-wrap msgid "" -" char *\n" -" guestfs_get_attach_method (guestfs_h *g);\n" +" get-attach-method\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1964 -msgid "Return the current attach method. See C<guestfs_set_attach_method>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:6191 -msgid "(Added in 1.9.8)" +#: ../fish/guestfish-actions.pod:1322 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1322 +msgid "Return the current attach method. See L</set-attach-method>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1971 -msgid "guestfs_get_autosync" +#: ../fish/guestfish-actions.pod:1324 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1324 +msgid "get-autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1973 +#: ../fish/guestfish-actions.pod:1326 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1326 #, no-wrap msgid "" -" int\n" -" guestfs_get_autosync (guestfs_h *g);\n" +" get-autosync\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1976 ../fish/guestfish-actions.pod:1328 +#: ../fish/guestfish-actions.pod:1328 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1328 ../libguestfs-1.11.19/src/guestfs-actions.pod:1976 ../src/guestfs-actions.pod:1976 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1982 -msgid "guestfs_get_direct" +#: ../fish/guestfish-actions.pod:1330 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1330 +msgid "get-direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1984 +#: ../fish/guestfish-actions.pod:1332 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1332 #, no-wrap msgid "" -" int\n" -" guestfs_get_direct (guestfs_h *g);\n" +" get-direct\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1987 ../fish/guestfish-actions.pod:1334 +#: ../fish/guestfish-actions.pod:1334 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1334 ../libguestfs-1.11.19/src/guestfs-actions.pod:1987 ../src/guestfs-actions.pod:1987 msgid "Return the direct appliance mode flag." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:6232 -msgid "(Added in 1.0.72)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:1993 -msgid "guestfs_get_e2label" +#: ../fish/guestfish-actions.pod:1336 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1336 +msgid "get-e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1995 +#: ../fish/guestfish-actions.pod:1338 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1338 #, no-wrap msgid "" -" char *\n" -" guestfs_get_e2label (guestfs_h *g,\n" -" const char *device);\n" +" get-e2label device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1999 ../fish/guestfish-actions.pod:1340 +#: ../fish/guestfish-actions.pod:1340 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1340 ../libguestfs-1.11.19/src/guestfs-actions.pod:1999 ../src/guestfs-actions.pod:1999 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2005 ../fish/guestfish-actions.pod:1343 +#: ../fish/guestfish-actions.pod:1343 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1343 ../libguestfs-1.11.19/src/guestfs-actions.pod:2005 ../src/guestfs-actions.pod:2005 msgid "" "This function is deprecated. In new code, use the C<vfs_label> call " "instead." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2012 ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:6250 ../src/guestfs-actions.pod:6269 -msgid "(Added in 1.0.15)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2014 -msgid "guestfs_get_e2uuid" +#: ../fish/guestfish-actions.pod:1350 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1350 +msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2016 +#: ../fish/guestfish-actions.pod:1352 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1352 #, no-wrap msgid "" -" char *\n" -" guestfs_get_e2uuid (guestfs_h *g,\n" -" const char *device);\n" +" get-e2uuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2020 ../fish/guestfish-actions.pod:1354 +#: ../fish/guestfish-actions.pod:1354 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1354 ../libguestfs-1.11.19/src/guestfs-actions.pod:2020 ../src/guestfs-actions.pod:2020 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2026 ../fish/guestfish-actions.pod:1357 +#: ../fish/guestfish-actions.pod:1357 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1357 ../libguestfs-1.11.19/src/guestfs-actions.pod:2026 ../src/guestfs-actions.pod:2026 msgid "This function is deprecated. In new code, use the C<vfs_uuid> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2035 -msgid "guestfs_get_memsize" +#: ../fish/guestfish-actions.pod:1364 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1364 +msgid "get-memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2037 +#: ../fish/guestfish-actions.pod:1366 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1366 #, no-wrap msgid "" -" int\n" -" guestfs_get_memsize (guestfs_h *g);\n" +" get-memsize\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2040 ../fish/guestfish-actions.pod:1368 +#: ../fish/guestfish-actions.pod:1368 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1368 ../libguestfs-1.11.19/src/guestfs-actions.pod:2040 ../src/guestfs-actions.pod:2040 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2043 +#: ../fish/guestfish-actions.pod:1371 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1371 msgid "" -"If C<guestfs_set_memsize> was not called on this handle, and if " +"If L</set-memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " "value for memsize." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2137 ../src/guestfs-actions.pod:6285 ../src/guestfs-actions.pod:6409 ../fish/guestfish-actions.pod:1375 ../fish/guestfish-actions.pod:1432 ../fish/guestfish-actions.pod:4157 ../fish/guestfish-actions.pod:4259 +#: ../fish/guestfish-actions.pod:1375 ../fish/guestfish-actions.pod:1432 ../fish/guestfish-actions.pod:4163 ../fish/guestfish-actions.pod:4265 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1375 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1432 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4163 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4265 ../libguestfs-1.11.19/src/guestfs-actions.pod:2047 ../libguestfs-1.11.19/src/guestfs-actions.pod:2139 ../libguestfs-1.11.19/src/guestfs-actions.pod:6293 ../libguestfs-1.11.19/src/guestfs-actions.pod:6419 ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2139 ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6419 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:6290 ../src/guestfs-actions.pod:6568 ../src/guestfs-actions.pod:7183 -msgid "(Added in 1.0.55)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2054 -msgid "guestfs_get_network" +#: ../fish/guestfish-actions.pod:1378 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1378 +msgid "get-network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2056 +#: ../fish/guestfish-actions.pod:1380 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1380 #, no-wrap msgid "" -" int\n" -" guestfs_get_network (guestfs_h *g);\n" +" get-network\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2059 ../fish/guestfish-actions.pod:1382 +#: ../fish/guestfish-actions.pod:1382 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1382 ../libguestfs-1.11.19/src/guestfs-actions.pod:2059 ../src/guestfs-actions.pod:2059 msgid "This returns the enable network flag." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2063 ../src/guestfs-actions.pod:6309 -msgid "(Added in 1.5.4)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2065 -msgid "guestfs_get_path" +#: ../fish/guestfish-actions.pod:1384 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1384 +msgid "get-path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2067 +#: ../fish/guestfish-actions.pod:1386 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1386 #, no-wrap msgid "" -" const char *\n" -" guestfs_get_path (guestfs_h *g);\n" +" get-path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2070 ../fish/guestfish-actions.pod:1388 +#: ../fish/guestfish-actions.pod:1388 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1388 ../libguestfs-1.11.19/src/guestfs-actions.pod:2070 ../src/guestfs-actions.pod:2070 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2072 ../fish/guestfish-actions.pod:1390 +#: ../fish/guestfish-actions.pod:1390 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1390 ../libguestfs-1.11.19/src/guestfs-actions.pod:2072 ../src/guestfs-actions.pod:2072 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default path." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2075 ../src/guestfs-actions.pod:2113 -msgid "" -"This function returns a string, or NULL on error. The string is owned by " -"the guest handle and must I<not> be freed." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2080 -msgid "guestfs_get_pgroup" +#: ../fish/guestfish-actions.pod:1393 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1393 +msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2082 +#: ../fish/guestfish-actions.pod:1395 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1395 #, no-wrap msgid "" -" int\n" -" guestfs_get_pgroup (guestfs_h *g);\n" +" get-pgroup\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2085 ../fish/guestfish-actions.pod:1397 +#: ../fish/guestfish-actions.pod:1397 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1397 ../libguestfs-1.11.19/src/guestfs-actions.pod:2085 ../src/guestfs-actions.pod:2085 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2089 -msgid "guestfs_get_pid" +#: ../fish/guestfish-actions.pod:1399 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1399 +msgid "get-pid" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1401 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1401 +msgid "pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2091 +#: ../fish/guestfish-actions.pod:1403 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1403 #, no-wrap msgid "" -" int\n" -" guestfs_get_pid (guestfs_h *g);\n" +" get-pid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2094 ../fish/guestfish-actions.pod:1405 +#: ../fish/guestfish-actions.pod:1405 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1405 ../libguestfs-1.11.19/src/guestfs-actions.pod:2096 ../src/guestfs-actions.pod:2096 msgid "" "Return the process ID of the qemu subprocess. If there is no qemu " "subprocess, then this will return an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2097 ../fish/guestfish-actions.pod:1408 +#: ../fish/guestfish-actions.pod:1408 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1408 ../libguestfs-1.11.19/src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2099 msgid "This is an internal call used for debugging and testing." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2101 -msgid "(Added in 1.0.56)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2103 -msgid "guestfs_get_qemu" +#: ../fish/guestfish-actions.pod:1410 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1410 +msgid "get-qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2105 +#: ../fish/guestfish-actions.pod:1412 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1412 #, no-wrap msgid "" -" const char *\n" -" guestfs_get_qemu (guestfs_h *g);\n" +" get-qemu\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2108 ../fish/guestfish-actions.pod:1414 +#: ../fish/guestfish-actions.pod:1414 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1414 ../libguestfs-1.11.19/src/guestfs-actions.pod:2110 ../src/guestfs-actions.pod:2110 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2110 ../fish/guestfish-actions.pod:1416 +#: ../fish/guestfish-actions.pod:1416 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1416 ../libguestfs-1.11.19/src/guestfs-actions.pod:2112 ../src/guestfs-actions.pod:2112 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default qemu binary name." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2116 ../src/guestfs-actions.pod:6371 -msgid "(Added in 1.0.6)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2118 -msgid "guestfs_get_recovery_proc" +#: ../fish/guestfish-actions.pod:1419 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1419 +msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2120 +#: ../fish/guestfish-actions.pod:1421 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1421 #, no-wrap msgid "" -" int\n" -" guestfs_get_recovery_proc (guestfs_h *g);\n" +" get-recovery-proc\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2123 ../fish/guestfish-actions.pod:1423 +#: ../fish/guestfish-actions.pod:1423 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1423 ../libguestfs-1.11.19/src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:2125 msgid "Return the recovery process enabled flag." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:3661 ../src/guestfs-actions.pod:3992 ../src/guestfs-actions.pod:4395 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:5609 ../src/guestfs-actions.pod:5952 ../src/guestfs-actions.pod:6395 ../src/guestfs-actions.pod:7086 ../src/guestfs-actions.pod:7106 ../src/guestfs-actions.pod:7298 -msgid "(Added in 1.0.77)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2129 -msgid "guestfs_get_selinux" +#: ../fish/guestfish-actions.pod:1425 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1425 +msgid "get-selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2131 +#: ../fish/guestfish-actions.pod:1427 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1427 #, no-wrap msgid "" -" int\n" -" guestfs_get_selinux (guestfs_h *g);\n" +" get-selinux\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2134 +#: ../fish/guestfish-actions.pod:1429 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1429 msgid "" "This returns the current setting of the selinux flag which is passed to the " -"appliance at boot time. See C<guestfs_set_selinux>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2142 ../src/guestfs-actions.pod:2205 ../src/guestfs-actions.pod:6414 ../src/guestfs-actions.pod:6472 -msgid "(Added in 1.0.67)" +"appliance at boot time. See L</set-selinux>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2144 -msgid "guestfs_get_state" +#: ../fish/guestfish-actions.pod:1435 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1435 +msgid "get-state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2146 +#: ../fish/guestfish-actions.pod:1437 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1437 #, no-wrap msgid "" -" int\n" -" guestfs_get_state (guestfs_h *g);\n" +" get-state\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2149 ../fish/guestfish-actions.pod:1439 +#: ../fish/guestfish-actions.pod:1439 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1439 ../libguestfs-1.11.19/src/guestfs-actions.pod:2151 ../src/guestfs-actions.pod:2151 msgid "" "This returns the current state as an opaque integer. This is only useful " "for printing debug and internal error messages." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2152 ../src/guestfs-actions.pod:3432 ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:3522 ../src/guestfs-actions.pod:3549 ../fish/guestfish-actions.pod:1442 ../fish/guestfish-actions.pod:2362 ../fish/guestfish-actions.pod:2380 ../fish/guestfish-actions.pod:2418 ../fish/guestfish-actions.pod:2434 +#: ../fish/guestfish-actions.pod:1442 ../fish/guestfish-actions.pod:2362 ../fish/guestfish-actions.pod:2380 ../fish/guestfish-actions.pod:2418 ../fish/guestfish-actions.pod:2434 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1442 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2362 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2380 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2418 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2434 ../libguestfs-1.11.19/src/guestfs-actions.pod:2154 ../libguestfs-1.11.19/src/guestfs-actions.pod:3434 ../libguestfs-1.11.19/src/guestfs-actions.pod:3463 ../libguestfs-1.11.19/src/guestfs-actions.pod:3524 ../libguestfs-1.11.19/src/guestfs-actions.pod:3551 ../src/guestfs-actions.pod:2154 ../src/guestfs-actions.pod:3434 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3524 ../src/guestfs-actions.pod:3551 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2158 -msgid "guestfs_get_trace" +#: ../fish/guestfish-actions.pod:1444 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1444 +msgid "get-trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2160 +#: ../fish/guestfish-actions.pod:1446 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1446 #, no-wrap msgid "" -" int\n" -" guestfs_get_trace (guestfs_h *g);\n" +" get-trace\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2163 ../fish/guestfish-actions.pod:1448 +#: ../fish/guestfish-actions.pod:1448 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1448 ../libguestfs-1.11.19/src/guestfs-actions.pod:2165 ../src/guestfs-actions.pod:2165 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2169 -msgid "guestfs_get_umask" +#: ../fish/guestfish-actions.pod:1450 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1450 +msgid "get-umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2171 +#: ../fish/guestfish-actions.pod:1452 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1452 #, no-wrap msgid "" -" int\n" -" guestfs_get_umask (guestfs_h *g);\n" +" get-umask\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2174 +#: ../fish/guestfish-actions.pod:1454 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1454 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " -"set by calling C<guestfs_umask>." +"set by calling L</umask>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2181 -msgid "guestfs_get_verbose" +#: ../fish/guestfish-actions.pod:1457 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1457 +msgid "get-verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2183 +#: ../fish/guestfish-actions.pod:1459 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1459 #, no-wrap msgid "" -" int\n" -" guestfs_get_verbose (guestfs_h *g);\n" +" get-verbose\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2186 ../fish/guestfish-actions.pod:1461 +#: ../fish/guestfish-actions.pod:1461 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1461 ../libguestfs-1.11.19/src/guestfs-actions.pod:2188 ../src/guestfs-actions.pod:2188 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2192 -msgid "guestfs_getcon" +#: ../fish/guestfish-actions.pod:1463 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1463 +msgid "getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2194 +#: ../fish/guestfish-actions.pod:1465 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1465 #, no-wrap msgid "" -" char *\n" -" guestfs_getcon (guestfs_h *g);\n" +" getcon\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2197 ../fish/guestfish-actions.pod:1467 +#: ../fish/guestfish-actions.pod:1467 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1467 ../libguestfs-1.11.19/src/guestfs-actions.pod:2199 ../src/guestfs-actions.pod:2199 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2199 -msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" +#: ../fish/guestfish-actions.pod:1469 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1469 +msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2207 -msgid "guestfs_getxattr" +#: ../fish/guestfish-actions.pod:1472 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1472 +msgid "getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2209 +#: ../fish/guestfish-actions.pod:1474 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1474 #, no-wrap msgid "" -" char *\n" -" guestfs_getxattr (guestfs_h *g,\n" -" const char *path,\n" -" const char *name,\n" -" size_t *size_r);\n" +" getxattr path name\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2215 +#: ../fish/guestfish-actions.pod:1476 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1476 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " -"symlink itself, use C<guestfs_lgetxattr>." +"symlink itself, use L</lgetxattr>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:3675 +#: ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:2507 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1480 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2507 msgid "" "Normally it is better to get all extended attributes from a file in one go " -"by calling C<guestfs_getxattrs>. However some Linux filesystem " -"implementations are buggy and do not provide a way to list out attributes. " -"For these filesystems (notably ntfs-3g) you have to know the names of the " -"extended attributes you want in advance and call this function." +"by calling L</getxattrs>. However some Linux filesystem implementations are " +"buggy and do not provide a way to list out attributes. For these " +"filesystems (notably ntfs-3g) you have to know the names of the extended " +"attributes you want in advance and call this function." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:3682 ../fish/guestfish-actions.pod:1487 ../fish/guestfish-actions.pod:2514 +#: ../fish/guestfish-actions.pod:1487 ../fish/guestfish-actions.pod:2514 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1487 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2514 ../libguestfs-1.11.19/src/guestfs-actions.pod:2228 ../libguestfs-1.11.19/src/guestfs-actions.pod:3684 ../src/guestfs-actions.pod:2228 ../src/guestfs-actions.pod:3684 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C<name>, this returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2229 -msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2231 ../src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2892 ../src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:5602 ../src/guestfs-actions.pod:5628 ../src/guestfs-actions.pod:5809 -msgid "" -"This function returns a buffer, or NULL on error. The size of the returned " -"buffer is written to C<*size_r>. I<The caller must free the returned buffer " -"after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2235 ../src/guestfs-actions.pod:3691 -msgid "(Added in 1.7.24)" +#: ../fish/guestfish-actions.pod:1490 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1490 +msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2237 -msgid "guestfs_getxattrs" +#: ../fish/guestfish-actions.pod:1492 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1492 +msgid "getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2239 +#: ../fish/guestfish-actions.pod:1494 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1494 #, no-wrap msgid "" -" struct guestfs_xattr_list *\n" -" guestfs_getxattrs (guestfs_h *g,\n" -" const char *path);\n" +" getxattrs path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2243 ../fish/guestfish-actions.pod:1496 +#: ../fish/guestfish-actions.pod:1496 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1496 ../libguestfs-1.11.19/src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2245 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2246 ../fish/guestfish-actions.pod:1499 +#: ../fish/guestfish-actions.pod:1499 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1499 ../libguestfs-1.11.19/src/guestfs-actions.pod:2248 ../src/guestfs-actions.pod:2248 msgid "" "At the system call level, this is a combination of the L<listxattr(2)> and " "L<getxattr(2)> calls." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2249 -msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2251 ../src/guestfs-actions.pod:3703 ../src/guestfs-actions.pod:4391 -msgid "" -"This function returns a C<struct guestfs_xattr_list *>, or NULL if there was " -"an error. I<The caller must call C<guestfs_free_xattr_list> after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2255 ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:5982 ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:7876 -msgid "(Added in 1.0.59)" +#: ../fish/guestfish-actions.pod:1502 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1502 +msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2257 -msgid "guestfs_glob_expand" +#: ../fish/guestfish-actions.pod:1504 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1504 +msgid "glob-expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2259 +#: ../fish/guestfish-actions.pod:1506 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1506 #, no-wrap msgid "" -" char **\n" -" guestfs_glob_expand (guestfs_h *g,\n" -" const char *pattern);\n" +" glob-expand pattern\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2263 ../fish/guestfish-actions.pod:1508 +#: ../fish/guestfish-actions.pod:1508 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1508 ../libguestfs-1.11.19/src/guestfs-actions.pod:2265 ../src/guestfs-actions.pod:2265 msgid "" "This command searches for all the pathnames matching C<pattern> according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2267 ../fish/guestfish-actions.pod:1512 +#: ../fish/guestfish-actions.pod:1512 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1512 ../libguestfs-1.11.19/src/guestfs-actions.pod:2269 ../src/guestfs-actions.pod:2269 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2270 ../fish/guestfish-actions.pod:1515 +#: ../fish/guestfish-actions.pod:1515 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1515 ../libguestfs-1.11.19/src/guestfs-actions.pod:2272 ../src/guestfs-actions.pod:2272 msgid "" "It is just a wrapper around the C L<glob(3)> function with flags " "C<GLOB_MARK|GLOB_BRACE>. See that manual page for more details." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:6684 ../src/guestfs-actions.pod:6701 -msgid "(Added in 1.0.50)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2280 -msgid "guestfs_grep" +#: ../fish/guestfish-actions.pod:1519 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1519 +msgid "grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2282 +#: ../fish/guestfish-actions.pod:1521 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1521 #, no-wrap msgid "" -" char **\n" -" guestfs_grep (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" grep regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2287 ../fish/guestfish-actions.pod:1523 +#: ../fish/guestfish-actions.pod:1523 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1523 ../libguestfs-1.11.19/src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2289 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2299 -msgid "guestfs_grepi" +#: ../fish/guestfish-actions.pod:1529 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1529 +msgid "grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2301 +#: ../fish/guestfish-actions.pod:1531 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1531 #, no-wrap msgid "" -" char **\n" -" guestfs_grepi (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" grepi regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2306 ../fish/guestfish-actions.pod:1533 +#: ../fish/guestfish-actions.pod:1533 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1533 ../libguestfs-1.11.19/src/guestfs-actions.pod:2308 ../src/guestfs-actions.pod:2308 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2318 -msgid "guestfs_grub_install" +#: ../fish/guestfish-actions.pod:1539 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1539 +msgid "grub-install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2320 +#: ../fish/guestfish-actions.pod:1541 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1541 #, no-wrap msgid "" -" int\n" -" guestfs_grub_install (guestfs_h *g,\n" -" const char *root,\n" -" const char *device);\n" +" grub-install root device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2325 ../fish/guestfish-actions.pod:1543 +#: ../fish/guestfish-actions.pod:1543 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1543 ../libguestfs-1.11.19/src/guestfs-actions.pod:2327 ../src/guestfs-actions.pod:2327 msgid "" "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with " "the root directory being C<root>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2328 ../fish/guestfish-actions.pod:1546 +#: ../fish/guestfish-actions.pod:1546 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1546 ../libguestfs-1.11.19/src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:2330 msgid "" "Note: If grub-install reports the error \"No suitable drive was found in the " "generated device map.\" it may be that you need to create a " @@ -9806,7 +6950,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2335 ../fish/guestfish-actions.pod:1553 +#: ../fish/guestfish-actions.pod:1553 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1553 ../libguestfs-1.11.19/src/guestfs-actions.pod:2337 ../src/guestfs-actions.pod:2337 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -9814,118 +6958,97 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2337 ../fish/guestfish-actions.pod:1555 +#: ../fish/guestfish-actions.pod:1555 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1555 ../libguestfs-1.11.19/src/guestfs-actions.pod:2339 ../src/guestfs-actions.pod:2339 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2341 -msgid "(Added in 1.0.17)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2343 -msgid "guestfs_head" +#: ../fish/guestfish-actions.pod:1557 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1557 +msgid "head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2345 +#: ../fish/guestfish-actions.pod:1559 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1559 #, no-wrap msgid "" -" char **\n" -" guestfs_head (guestfs_h *g,\n" -" const char *path);\n" +" head path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2349 ../fish/guestfish-actions.pod:1561 +#: ../fish/guestfish-actions.pod:1561 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1561 ../libguestfs-1.11.19/src/guestfs-actions.pod:2351 ../src/guestfs-actions.pod:2351 msgid "" "This command returns up to the first 10 lines of a file as a list of " "strings." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2361 -msgid "guestfs_head_n" +#: ../fish/guestfish-actions.pod:1567 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1567 +msgid "head-n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2363 +#: ../fish/guestfish-actions.pod:1569 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1569 #, no-wrap msgid "" -" char **\n" -" guestfs_head_n (guestfs_h *g,\n" -" int nrlines,\n" -" const char *path);\n" +" head-n nrlines path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2368 ../fish/guestfish-actions.pod:1571 +#: ../fish/guestfish-actions.pod:1571 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1571 ../libguestfs-1.11.19/src/guestfs-actions.pod:2370 ../src/guestfs-actions.pod:2370 msgid "" "If the parameter C<nrlines> is a positive number, this returns the first " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2371 ../fish/guestfish-actions.pod:1574 +#: ../fish/guestfish-actions.pod:1574 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1574 ../libguestfs-1.11.19/src/guestfs-actions.pod:2373 ../src/guestfs-actions.pod:2373 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, excluding the last C<nrlines> lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:6981 ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:4637 +#: ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:4643 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1577 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4643 ../libguestfs-1.11.19/src/guestfs-actions.pod:2376 ../libguestfs-1.11.19/src/guestfs-actions.pod:6991 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:6991 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2385 -msgid "guestfs_hexdump" +#: ../fish/guestfish-actions.pod:1582 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1582 +msgid "hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2387 +#: ../fish/guestfish-actions.pod:1584 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1584 #, no-wrap msgid "" -" char *\n" -" guestfs_hexdump (guestfs_h *g,\n" -" const char *path);\n" +" hexdump path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2391 ../fish/guestfish-actions.pod:1586 +#: ../fish/guestfish-actions.pod:1586 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1586 ../libguestfs-1.11.19/src/guestfs-actions.pod:2393 ../src/guestfs-actions.pod:2393 msgid "" "This runs C<hexdump -C> on the given C<path>. The result is the " "human-readable, canonical hex dump of the file." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:6765 ../src/guestfs-actions.pod:6820 -msgid "(Added in 1.0.22)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2402 -msgid "guestfs_initrd_cat" +#: ../fish/guestfish-actions.pod:1592 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1592 +msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2404 +#: ../fish/guestfish-actions.pod:1594 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1594 #, no-wrap msgid "" -" char *\n" -" guestfs_initrd_cat (guestfs_h *g,\n" -" const char *initrdpath,\n" -" const char *filename,\n" -" size_t *size_r);\n" +" initrd-cat initrdpath filename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2410 ../fish/guestfish-actions.pod:1596 +#: ../fish/guestfish-actions.pod:1596 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1596 ../libguestfs-1.11.19/src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2412 msgid "" "This command unpacks the file C<filename> from the initrd file called " "C<initrdpath>. The filename must be given I<without> the initial C</> " @@ -9933,7 +7056,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2414 ../fish/guestfish-actions.pod:1600 +#: ../fish/guestfish-actions.pod:1600 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1600 ../libguestfs-1.11.19/src/guestfs-actions.pod:2416 ../src/guestfs-actions.pod:2416 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C</init>) contained in a Linux initrd or " @@ -9941,7 +7064,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2418 ../fish/guestfish-actions.pod:1604 +#: ../fish/guestfish-actions.pod:1604 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1604 ../libguestfs-1.11.19/src/guestfs-actions.pod:2420 ../src/guestfs-actions.pod:2420 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -9949,32 +7072,30 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2420 -msgid "See also C<guestfs_initrd_list>." +#: ../fish/guestfish-actions.pod:1606 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1606 +msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2431 -msgid "guestfs_initrd_list" +#: ../fish/guestfish-actions.pod:1611 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1611 +msgid "initrd-list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2433 +#: ../fish/guestfish-actions.pod:1613 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1613 #, no-wrap msgid "" -" char **\n" -" guestfs_initrd_list (guestfs_h *g,\n" -" const char *path);\n" +" initrd-list path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2437 ../fish/guestfish-actions.pod:1615 +#: ../fish/guestfish-actions.pod:1615 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1615 ../libguestfs-1.11.19/src/guestfs-actions.pod:2439 ../src/guestfs-actions.pod:2439 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2439 ../fish/guestfish-actions.pod:1617 +#: ../fish/guestfish-actions.pod:1617 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1617 ../libguestfs-1.11.19/src/guestfs-actions.pod:2441 ../src/guestfs-actions.pod:2441 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -9982,7 +7103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2443 ../fish/guestfish-actions.pod:1621 +#: ../fish/guestfish-actions.pod:1621 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1621 ../libguestfs-1.11.19/src/guestfs-actions.pod:2445 ../src/guestfs-actions.pod:2445 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I<only> support the newer initramfs format (compressed cpio " @@ -9990,56 +7111,52 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2453 -msgid "guestfs_inotify_add_watch" +#: ../fish/guestfish-actions.pod:1625 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1625 +msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2455 +#: ../fish/guestfish-actions.pod:1627 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1627 #, no-wrap msgid "" -" int64_t\n" -" guestfs_inotify_add_watch (guestfs_h *g,\n" -" const char *path,\n" -" int mask);\n" +" inotify-add-watch path mask\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2460 ../fish/guestfish-actions.pod:1629 +#: ../fish/guestfish-actions.pod:1629 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1629 ../libguestfs-1.11.19/src/guestfs-actions.pod:2462 ../src/guestfs-actions.pod:2462 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2462 ../fish/guestfish-actions.pod:1631 +#: ../fish/guestfish-actions.pod:1631 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1631 ../libguestfs-1.11.19/src/guestfs-actions.pod:2464 ../src/guestfs-actions.pod:2464 msgid "" "Note that if C<path> is a directory then events within that directory are " "watched, but this does I<not> happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2466 ../fish/guestfish-actions.pod:1635 +#: ../fish/guestfish-actions.pod:1635 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1635 ../libguestfs-1.11.19/src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2468 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2474 -msgid "guestfs_inotify_close" +#: ../fish/guestfish-actions.pod:1639 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1639 +msgid "inotify-close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2476 +#: ../fish/guestfish-actions.pod:1641 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1641 #, no-wrap msgid "" -" int\n" -" guestfs_inotify_close (guestfs_h *g);\n" +" inotify-close\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2479 ../fish/guestfish-actions.pod:1643 +#: ../fish/guestfish-actions.pod:1643 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1643 ../libguestfs-1.11.19/src/guestfs-actions.pod:2481 ../src/guestfs-actions.pod:2481 msgid "" "This closes the inotify handle which was previously opened by inotify_init. " "It removes all watches, throws away any pending events, and deallocates all " @@ -10047,87 +7164,83 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2487 -msgid "guestfs_inotify_files" +#: ../fish/guestfish-actions.pod:1647 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1647 +msgid "inotify-files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2489 +#: ../fish/guestfish-actions.pod:1649 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1649 #, no-wrap msgid "" -" char **\n" -" guestfs_inotify_files (guestfs_h *g);\n" +" inotify-files\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2492 +#: ../fish/guestfish-actions.pod:1651 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1651 msgid "" -"This function is a helpful wrapper around C<guestfs_inotify_read> which just " +"This function is a helpful wrapper around L</inotify-read> which just " "returns a list of pathnames of objects that were touched. The returned " "pathnames are sorted and deduplicated." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2502 -msgid "guestfs_inotify_init" +#: ../fish/guestfish-actions.pod:1655 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1655 +msgid "inotify-init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2504 +#: ../fish/guestfish-actions.pod:1657 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1657 #, no-wrap msgid "" -" int\n" -" guestfs_inotify_init (guestfs_h *g,\n" -" int maxevents);\n" +" inotify-init maxevents\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2508 ../fish/guestfish-actions.pod:1659 +#: ../fish/guestfish-actions.pod:1659 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1659 ../libguestfs-1.11.19/src/guestfs-actions.pod:2510 ../src/guestfs-actions.pod:2510 msgid "" "This command creates a new inotify handle. The inotify subsystem can be " "used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2512 +#: ../fish/guestfish-actions.pod:1663 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1663 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " -"calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " -"passed as C<0>, then the kernel (or previously set) default is used. For " -"Linux 2.6.29 the default was 16384 events. Beyond this limit, the kernel " -"throws away events, but records the fact that it threw them away by setting " -"a flag C<IN_Q_OVERFLOW> in the returned structure list (see " -"C<guestfs_inotify_read>)." +"calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, " +"then the kernel (or previously set) default is used. For Linux 2.6.29 the " +"default was 16384 events. Beyond this limit, the kernel throws away events, " +"but records the fact that it threw them away by setting a flag " +"C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2522 +#: ../fish/guestfish-actions.pod:1673 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1673 msgid "" "Before any events are generated, you have to add some watches to the " -"internal watch list. See: C<guestfs_inotify_add_watch>, " -"C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>." +"internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and " +"L</inotify-watch-all>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2528 +#: ../fish/guestfish-actions.pod:1679 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1679 msgid "" -"Queued up events should be read periodically by calling " -"C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " -"wrapper around C<guestfs_inotify_read>). If you don't read the events out " -"often enough then you risk the internal queue overflowing." +"Queued up events should be read periodically by calling L</inotify-read> (or " +"L</inotify-files> which is just a helpful wrapper around L</inotify-read>). " +"If you don't read the events out often enough then you risk the internal " +"queue overflowing." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2535 +#: ../fish/guestfish-actions.pod:1686 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1686 msgid "" -"The handle should be closed after use by calling C<guestfs_inotify_close>. " -"This also removes any watches automatically." +"The handle should be closed after use by calling L</inotify-close>. This " +"also removes any watches automatically." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2539 ../fish/guestfish-actions.pod:1690 +#: ../fish/guestfish-actions.pod:1690 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1690 ../libguestfs-1.11.19/src/guestfs-actions.pod:2541 ../src/guestfs-actions.pod:2541 msgid "" "See also L<inotify(7)> for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -10135,33 +7248,32 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2548 -msgid "guestfs_inotify_read" +#: ../fish/guestfish-actions.pod:1695 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1695 +msgid "inotify-read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2550 +#: ../fish/guestfish-actions.pod:1697 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1697 #, no-wrap msgid "" -" struct guestfs_inotify_event_list *\n" -" guestfs_inotify_read (guestfs_h *g);\n" +" inotify-read\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1699 +#: ../fish/guestfish-actions.pod:1699 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1699 ../libguestfs-1.11.19/src/guestfs-actions.pod:2555 ../src/guestfs-actions.pod:2555 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1702 +#: ../fish/guestfish-actions.pod:1702 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1702 ../libguestfs-1.11.19/src/guestfs-actions.pod:2558 ../src/guestfs-actions.pod:2558 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1704 +#: ../fish/guestfish-actions.pod:1704 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1704 ../libguestfs-1.11.19/src/guestfs-actions.pod:2560 ../src/guestfs-actions.pod:2560 msgid "" "I<Note>: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -10169,281 +7281,263 @@ msgid "" "and leave remaining events in the queue." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2564 -msgid "" -"This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " -"there was an error. I<The caller must call " -"C<guestfs_free_inotify_event_list> after use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2570 -msgid "guestfs_inotify_rm_watch" +#: ../fish/guestfish-actions.pod:1710 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1710 +msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2572 +#: ../fish/guestfish-actions.pod:1712 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1712 #, no-wrap msgid "" -" int\n" -" guestfs_inotify_rm_watch (guestfs_h *g,\n" -" int wd);\n" +" inotify-rm-watch wd\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2576 -msgid "" -"Remove a previously defined inotify watch. See " -"C<guestfs_inotify_add_watch>." +#: ../fish/guestfish-actions.pod:1714 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1714 +msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2583 -msgid "guestfs_inspect_get_arch" +#: ../fish/guestfish-actions.pod:1717 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1717 +msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2585 +#: ../fish/guestfish-actions.pod:1719 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1719 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_arch (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-arch root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2589 +#: ../fish/guestfish-actions.pod:1721 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1721 msgid "" "This returns the architecture of the inspected operating system. The " -"possible return values are listed under C<guestfs_file_architecture>." +"possible return values are listed under L</file-architecture>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1725 +#: ../fish/guestfish-actions.pod:1725 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1725 ../libguestfs-1.11.19/src/guestfs-actions.pod:2595 ../src/guestfs-actions.pod:2595 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2596 ../src/guestfs-actions.pod:2686 ../src/guestfs-actions.pod:2790 ../src/guestfs-actions.pod:2809 ../src/guestfs-actions.pod:2940 ../src/guestfs-actions.pod:3023 ../src/guestfs-actions.pod:3051 ../src/guestfs-actions.pod:3072 ../src/guestfs-actions.pod:3125 ../src/guestfs-actions.pod:3165 ../src/guestfs-actions.pod:3185 ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3222 ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3358 ../src/guestfs-actions.pod:3399 ../fish/guestfish-actions.pod:1728 ../fish/guestfish-actions.pod:1811 ../fish/guestfish-actions.pod:1890 ../fish/guestfish-actions.pod:1902 ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2047 ../fish/guestfish-actions.pod:2068 ../fish/guestfish-actions.pod:2082 ../fish/guestfish-actions.pod:2122 ../fish/guestfish-actions.pod:2154 ../fish/guestfish-actions.pod:2167 ../fish/guestfish-actions.pod:2180 ../fish/guestfish-actions.pod:2190 ../fish/guestfish-actions.pod:2200 ../fish/guestfish-actions.pod:2212 ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2342 +#: ../fish/guestfish-actions.pod:1728 ../fish/guestfish-actions.pod:1811 ../fish/guestfish-actions.pod:1890 ../fish/guestfish-actions.pod:1902 ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2047 ../fish/guestfish-actions.pod:2068 ../fish/guestfish-actions.pod:2082 ../fish/guestfish-actions.pod:2122 ../fish/guestfish-actions.pod:2154 ../fish/guestfish-actions.pod:2167 ../fish/guestfish-actions.pod:2180 ../fish/guestfish-actions.pod:2190 ../fish/guestfish-actions.pod:2200 ../fish/guestfish-actions.pod:2212 ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2342 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1728 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1811 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1890 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1902 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1986 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2047 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2068 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2082 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2122 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2154 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2167 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2180 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2190 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2200 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2212 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2308 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2342 ../libguestfs-1.11.19/src/guestfs-actions.pod:2598 ../libguestfs-1.11.19/src/guestfs-actions.pod:2688 ../libguestfs-1.11.19/src/guestfs-actions.pod:2792 ../libguestfs-1.11.19/src/guestfs-actions.pod:2811 ../libguestfs-1.11.19/src/guestfs-actions.pod:2942 ../libguestfs-1.11.19/src/guestfs-actions.pod:3025 ../libguestfs-1.11.19/src/guestfs-actions.pod:3053 ../libguestfs-1.11.19/src/guestfs-actions.pod:3074 ../libguestfs-1.11.19/src/guestfs-actions.pod:3127 ../libguestfs-1.11.19/src/guestfs-actions.pod:3167 ../libguestfs-1.11.19/src/guestfs-actions.pod:3187 ../libguestfs-1.11.19/src/guestfs-actions.pod:3207 ../libguestfs-1.11.19/src/guestfs-actions.pod:3224 ../libguestfs-1.11.19/src/guestfs-actions.pod:3240 ../libguestfs-1.11.19/src/guestfs-actions.pod:3258 ../libguestfs-1.11.19/src/guestfs-actions.pod:3360 ../libguestfs-1.11.19/src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:2811 ../src/guestfs-actions.pod:2942 ../src/guestfs-actions.pod:3025 ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074 ../src/guestfs-actions.pod:3127 ../src/guestfs-actions.pod:3167 ../src/guestfs-actions.pod:3187 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3224 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3258 ../src/guestfs-actions.pod:3360 ../src/guestfs-actions.pod:3401 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2603 -msgid "guestfs_inspect_get_distro" +#: ../fish/guestfish-actions.pod:1730 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1730 +msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2605 +#: ../fish/guestfish-actions.pod:1732 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1732 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_distro (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-distro root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2609 ../fish/guestfish-actions.pod:1734 +#: ../fish/guestfish-actions.pod:1734 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1734 ../libguestfs-1.11.19/src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:2611 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2612 ../fish/guestfish-actions.pod:1737 +#: ../fish/guestfish-actions.pod:1737 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1737 ../libguestfs-1.11.19/src/guestfs-actions.pod:2614 ../src/guestfs-actions.pod:2614 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2616 ../fish/guestfish-actions.pod:1741 +#: ../fish/guestfish-actions.pod:1741 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1741 ../libguestfs-1.11.19/src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:2618 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2618 ../fish/guestfish-actions.pod:1743 +#: ../fish/guestfish-actions.pod:1743 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1743 ../libguestfs-1.11.19/src/guestfs-actions.pod:2620 ../src/guestfs-actions.pod:2620 msgid "Arch Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2620 ../fish/guestfish-actions.pod:1745 +#: ../fish/guestfish-actions.pod:1745 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1745 ../libguestfs-1.11.19/src/guestfs-actions.pod:2622 ../src/guestfs-actions.pod:2622 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2622 ../fish/guestfish-actions.pod:1747 +#: ../fish/guestfish-actions.pod:1747 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1747 ../libguestfs-1.11.19/src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2624 msgid "CentOS." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2624 ../fish/guestfish-actions.pod:1749 +#: ../fish/guestfish-actions.pod:1749 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1749 ../libguestfs-1.11.19/src/guestfs-actions.pod:2626 ../src/guestfs-actions.pod:2626 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2626 ../fish/guestfish-actions.pod:1751 +#: ../fish/guestfish-actions.pod:1751 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1751 ../libguestfs-1.11.19/src/guestfs-actions.pod:2628 ../src/guestfs-actions.pod:2628 msgid "Debian." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2628 ../fish/guestfish-actions.pod:1753 +#: ../fish/guestfish-actions.pod:1753 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1753 ../libguestfs-1.11.19/src/guestfs-actions.pod:2630 ../src/guestfs-actions.pod:2630 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2630 ../fish/guestfish-actions.pod:1755 +#: ../fish/guestfish-actions.pod:1755 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1755 ../libguestfs-1.11.19/src/guestfs-actions.pod:2632 ../src/guestfs-actions.pod:2632 msgid "Fedora." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2632 ../fish/guestfish-actions.pod:1757 +#: ../fish/guestfish-actions.pod:1757 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1757 ../libguestfs-1.11.19/src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2634 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2634 ../fish/guestfish-actions.pod:1759 +#: ../fish/guestfish-actions.pod:1759 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1759 ../libguestfs-1.11.19/src/guestfs-actions.pod:2636 ../src/guestfs-actions.pod:2636 msgid "Gentoo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2636 ../fish/guestfish-actions.pod:1761 +#: ../fish/guestfish-actions.pod:1761 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1761 ../libguestfs-1.11.19/src/guestfs-actions.pod:2638 ../src/guestfs-actions.pod:2638 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2638 ../fish/guestfish-actions.pod:1763 +#: ../fish/guestfish-actions.pod:1763 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1763 ../libguestfs-1.11.19/src/guestfs-actions.pod:2640 ../src/guestfs-actions.pod:2640 msgid "Linux Mint." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2640 ../fish/guestfish-actions.pod:1765 +#: ../fish/guestfish-actions.pod:1765 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1765 ../libguestfs-1.11.19/src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:2642 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2642 ../fish/guestfish-actions.pod:1767 +#: ../fish/guestfish-actions.pod:1767 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1767 ../libguestfs-1.11.19/src/guestfs-actions.pod:2644 ../src/guestfs-actions.pod:2644 msgid "Mandriva." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1769 +#: ../fish/guestfish-actions.pod:1769 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1769 ../libguestfs-1.11.19/src/guestfs-actions.pod:2646 ../src/guestfs-actions.pod:2646 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2646 ../fish/guestfish-actions.pod:1771 +#: ../fish/guestfish-actions.pod:1771 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1771 ../libguestfs-1.11.19/src/guestfs-actions.pod:2648 ../src/guestfs-actions.pod:2648 msgid "MeeGo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1773 +#: ../fish/guestfish-actions.pod:1773 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1773 ../libguestfs-1.11.19/src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:2650 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2650 ../fish/guestfish-actions.pod:1775 +#: ../fish/guestfish-actions.pod:1775 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1775 ../libguestfs-1.11.19/src/guestfs-actions.pod:2652 ../src/guestfs-actions.pod:2652 msgid "Pardus." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2652 ../fish/guestfish-actions.pod:1777 +#: ../fish/guestfish-actions.pod:1777 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1777 ../libguestfs-1.11.19/src/guestfs-actions.pod:2654 ../src/guestfs-actions.pod:2654 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2654 ../fish/guestfish-actions.pod:1779 +#: ../fish/guestfish-actions.pod:1779 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1779 ../libguestfs-1.11.19/src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:2656 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2656 ../fish/guestfish-actions.pod:1781 +#: ../fish/guestfish-actions.pod:1781 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1781 ../libguestfs-1.11.19/src/guestfs-actions.pod:2658 ../src/guestfs-actions.pod:2658 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2658 ../fish/guestfish-actions.pod:1783 +#: ../fish/guestfish-actions.pod:1783 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1783 ../libguestfs-1.11.19/src/guestfs-actions.pod:2660 ../src/guestfs-actions.pod:2660 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2660 ../fish/guestfish-actions.pod:1785 +#: ../fish/guestfish-actions.pod:1785 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1785 ../libguestfs-1.11.19/src/guestfs-actions.pod:2662 ../src/guestfs-actions.pod:2662 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2662 ../fish/guestfish-actions.pod:1787 +#: ../fish/guestfish-actions.pod:1787 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1787 ../libguestfs-1.11.19/src/guestfs-actions.pod:2664 ../src/guestfs-actions.pod:2664 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2664 ../fish/guestfish-actions.pod:1789 +#: ../fish/guestfish-actions.pod:1789 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1789 ../libguestfs-1.11.19/src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:2666 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2666 ../fish/guestfish-actions.pod:1791 +#: ../fish/guestfish-actions.pod:1791 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1791 ../libguestfs-1.11.19/src/guestfs-actions.pod:2668 ../src/guestfs-actions.pod:2668 msgid "Slackware." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2668 ../fish/guestfish-actions.pod:1793 +#: ../fish/guestfish-actions.pod:1793 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1793 ../libguestfs-1.11.19/src/guestfs-actions.pod:2670 ../src/guestfs-actions.pod:2670 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2670 ../fish/guestfish-actions.pod:1795 +#: ../fish/guestfish-actions.pod:1795 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1795 ../libguestfs-1.11.19/src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2672 msgid "Ubuntu." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:1797 ../fish/guestfish-actions.pod:1881 ../fish/guestfish-actions.pod:2145 +#: ../fish/guestfish-actions.pod:1797 ../fish/guestfish-actions.pod:1881 ../fish/guestfish-actions.pod:2145 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1797 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1881 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2145 ../libguestfs-1.11.19/src/guestfs-actions.pod:2674 ../libguestfs-1.11.19/src/guestfs-actions.pod:2783 ../libguestfs-1.11.19/src/guestfs-actions.pod:3158 ../src/guestfs-actions.pod:2674 ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:3158 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2674 ../fish/guestfish-actions.pod:1799 +#: ../fish/guestfish-actions.pod:1799 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1799 ../libguestfs-1.11.19/src/guestfs-actions.pod:2676 ../src/guestfs-actions.pod:2676 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2676 ../src/guestfs-actions.pod:3148 ../fish/guestfish-actions.pod:1801 ../fish/guestfish-actions.pod:2137 +#: ../fish/guestfish-actions.pod:1801 ../fish/guestfish-actions.pod:2137 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1801 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2137 ../libguestfs-1.11.19/src/guestfs-actions.pod:2678 ../libguestfs-1.11.19/src/guestfs-actions.pod:3150 ../src/guestfs-actions.pod:2678 ../src/guestfs-actions.pod:3150 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2678 ../fish/guestfish-actions.pod:1803 +#: ../fish/guestfish-actions.pod:1803 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1803 ../libguestfs-1.11.19/src/guestfs-actions.pod:2680 ../src/guestfs-actions.pod:2680 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2683 ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1887 ../fish/guestfish-actions.pod:2151 +#: ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1887 ../fish/guestfish-actions.pod:2151 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1808 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1887 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2151 ../libguestfs-1.11.19/src/guestfs-actions.pod:2685 ../libguestfs-1.11.19/src/guestfs-actions.pod:2789 ../libguestfs-1.11.19/src/guestfs-actions.pod:3164 ../src/guestfs-actions.pod:2685 ../src/guestfs-actions.pod:2789 ../src/guestfs-actions.pod:3164 msgid "" "Future versions of libguestfs may return other strings here. The caller " "should be prepared to handle any string." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2693 -msgid "guestfs_inspect_get_drive_mappings" +#: ../fish/guestfish-actions.pod:1813 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1813 +msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2695 +#: ../fish/guestfish-actions.pod:1815 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1815 #, no-wrap msgid "" -" char **\n" -" guestfs_inspect_get_drive_mappings (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-drive-mappings root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2699 ../fish/guestfish-actions.pod:1817 +#: ../fish/guestfish-actions.pod:1817 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1817 ../libguestfs-1.11.19/src/guestfs-actions.pod:2701 ../src/guestfs-actions.pod:2701 msgid "" "This call is useful for Windows which uses a primitive system of assigning " "drive letters (like \"C:\") to partitions. This inspection API examines the " @@ -10452,7 +7546,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1823 +#: ../fish/guestfish-actions.pod:1823 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1823 ../libguestfs-1.11.19/src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:2707 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -10462,7 +7556,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2709 ../fish/guestfish-actions.pod:1827 +#: ../fish/guestfish-actions.pod:1827 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1827 ../libguestfs-1.11.19/src/guestfs-actions.pod:2711 ../src/guestfs-actions.pod:2711 msgid "" "Note that keys are drive letters. For Windows, the key is case insensitive " "and just contains the drive letter, without the customary colon separator " @@ -10470,7 +7564,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2713 ../fish/guestfish-actions.pod:1831 +#: ../fish/guestfish-actions.pod:1831 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1831 ../libguestfs-1.11.19/src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2715 msgid "" "In future we may support other operating systems that also used drive " "letters, but the keys for those might not be case insensitive and might be " @@ -10479,57 +7573,41 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2718 ../fish/guestfish-actions.pod:1836 +#: ../fish/guestfish-actions.pod:1836 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1836 ../libguestfs-1.11.19/src/guestfs-actions.pod:2720 ../src/guestfs-actions.pod:2720 msgid "" "For Windows guests, currently only hard drive mappings are returned. " "Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2721 ../fish/guestfish-actions.pod:1839 +#: ../fish/guestfish-actions.pod:1839 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1839 ../libguestfs-1.11.19/src/guestfs-actions.pod:2723 ../src/guestfs-actions.pod:2723 msgid "" "For guests that do not use drive mappings, or if the drive mappings could " "not be determined, this returns an empty hash table." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2724 +#: ../fish/guestfish-actions.pod:1842 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1842 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2728 ../src/guestfs-actions.pod:2996 ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:5076 ../src/guestfs-actions.pod:7122 -msgid "" -"This function returns a NULL-terminated array of strings, or NULL if there " -"was an error. The array of strings will always have length C<2n+1>, where " -"C<n> keys and values alternate, followed by the trailing NULL entry. I<The " -"caller must free the strings and the array after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2734 ../src/guestfs-actions.pod:3190 -msgid "(Added in 1.9.17)" +"L</inspect-get-mountpoints>, L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2736 -msgid "guestfs_inspect_get_filesystems" +#: ../fish/guestfish-actions.pod:1846 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1846 +msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2738 +#: ../fish/guestfish-actions.pod:1848 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1848 #, no-wrap msgid "" -" char **\n" -" guestfs_inspect_get_filesystems (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-filesystems root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2742 ../fish/guestfish-actions.pod:1850 +#: ../fish/guestfish-actions.pod:1850 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1850 ../libguestfs-1.11.19/src/guestfs-actions.pod:2744 ../src/guestfs-actions.pod:2744 msgid "" "This returns a list of all the filesystems that we think are associated with " "this operating system. This includes the root filesystem, other ordinary " @@ -10537,140 +7615,113 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1855 +#: ../fish/guestfish-actions.pod:1855 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1855 ../libguestfs-1.11.19/src/guestfs-actions.pod:2749 ../src/guestfs-actions.pod:2749 msgid "" "In the case of a multi-boot virtual machine, it is possible for a filesystem " "to be shared between operating systems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2750 +#: ../fish/guestfish-actions.pod:1858 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1858 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"C<guestfs_inspect_get_mountpoints>." +"L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2759 -msgid "guestfs_inspect_get_format" +#: ../fish/guestfish-actions.pod:1861 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1861 +msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2761 +#: ../fish/guestfish-actions.pod:1863 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1863 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_format (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-format root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2765 ../fish/guestfish-actions.pod:1865 +#: ../fish/guestfish-actions.pod:1865 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1865 ../libguestfs-1.11.19/src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2767 msgid "" "This returns the format of the inspected operating system. You can use it " "to detect install images, live CDs and similar." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1868 +#: ../fish/guestfish-actions.pod:1868 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1868 ../libguestfs-1.11.19/src/guestfs-actions.pod:2770 ../src/guestfs-actions.pod:2770 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2772 ../fish/guestfish-actions.pod:1872 +#: ../fish/guestfish-actions.pod:1872 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1872 ../libguestfs-1.11.19/src/guestfs-actions.pod:2774 ../src/guestfs-actions.pod:2774 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2774 ../fish/guestfish-actions.pod:1874 +#: ../fish/guestfish-actions.pod:1874 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1874 ../libguestfs-1.11.19/src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:2776 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2776 ../fish/guestfish-actions.pod:1876 +#: ../fish/guestfish-actions.pod:1876 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1876 ../libguestfs-1.11.19/src/guestfs-actions.pod:2778 ../src/guestfs-actions.pod:2778 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2778 ../fish/guestfish-actions.pod:1878 +#: ../fish/guestfish-actions.pod:1878 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1878 ../libguestfs-1.11.19/src/guestfs-actions.pod:2780 ../src/guestfs-actions.pod:2780 msgid "" "The disk image being inspected is not an installed operating system, but a " "I<bootable> install disk, live CD, or similar." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2783 ../fish/guestfish-actions.pod:1883 +#: ../fish/guestfish-actions.pod:1883 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1883 ../libguestfs-1.11.19/src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2785 msgid "The format of this disk image is not known." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2795 ../src/guestfs-actions.pod:3226 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3260 ../src/guestfs-actions.pod:6020 -msgid "(Added in 1.9.4)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2797 -msgid "guestfs_inspect_get_hostname" +#: ../fish/guestfish-actions.pod:1892 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1892 +msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2799 +#: ../fish/guestfish-actions.pod:1894 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1894 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_hostname (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-hostname root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2803 ../fish/guestfish-actions.pod:1896 +#: ../fish/guestfish-actions.pod:1896 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1896 ../libguestfs-1.11.19/src/guestfs-actions.pod:2805 ../src/guestfs-actions.pod:2805 msgid "" "This function returns the hostname of the operating system as found by " "inspection of the guest's configuration files." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2806 ../fish/guestfish-actions.pod:1899 +#: ../fish/guestfish-actions.pod:1899 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1899 ../libguestfs-1.11.19/src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2808 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2814 -msgid "(Added in 1.7.9)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2816 -msgid "guestfs_inspect_get_icon" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2818 -#, no-wrap -msgid "" -" char *\n" -" guestfs_inspect_get_icon (guestfs_h *g,\n" -" const char *root,\n" -" size_t *size_r,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:1904 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1904 +msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2829 +#: ../fish/guestfish-actions.pod:1906 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1906 #, no-wrap msgid "" -" GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" -" GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n" +" inspect-get-icon root [favicon:..] [highquality:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2832 ../fish/guestfish-actions.pod:1908 +#: ../fish/guestfish-actions.pod:1908 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1908 ../libguestfs-1.11.19/src/guestfs-actions.pod:2834 ../src/guestfs-actions.pod:2834 msgid "" "This function returns an icon corresponding to the inspected operating " "system. The icon is returned as a buffer containing a PNG image (re-encoded " @@ -10678,14 +7729,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2836 ../fish/guestfish-actions.pod:1912 +#: ../fish/guestfish-actions.pod:1912 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1912 ../libguestfs-1.11.19/src/guestfs-actions.pod:2838 ../src/guestfs-actions.pod:2838 msgid "" "If it was not possible to get an icon this function returns a zero-length " "(non-NULL) buffer. I<Callers must check for this case>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2839 ../fish/guestfish-actions.pod:1915 +#: ../fish/guestfish-actions.pod:1915 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1915 ../libguestfs-1.11.19/src/guestfs-actions.pod:2841 ../src/guestfs-actions.pod:2841 msgid "" "Libguestfs will start by looking for a file called C</etc/favicon.png> or " "C<C:\\etc\\favicon.png> and if it has the correct format, the contents of " @@ -10694,14 +7745,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2845 ../fish/guestfish-actions.pod:1921 +#: ../fish/guestfish-actions.pod:1921 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1921 ../libguestfs-1.11.19/src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2847 msgid "" "If finding the favicon fails, then we look in other places in the guest for " "a suitable icon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2848 ../fish/guestfish-actions.pod:1924 +#: ../fish/guestfish-actions.pod:1924 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1924 ../libguestfs-1.11.19/src/guestfs-actions.pod:2850 ../src/guestfs-actions.pod:2850 msgid "" "If the optional C<highquality> boolean is true then only high quality icons " "are returned, which means only icons of high resolution with an alpha " @@ -10710,7 +7761,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2859 ../fish/guestfish-actions.pod:1935 +#: ../fish/guestfish-actions.pod:1935 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1935 ../libguestfs-1.11.19/src/guestfs-actions.pod:2861 ../src/guestfs-actions.pod:2861 msgid "" "Unlike most other inspection API calls, the guest's disks must be mounted up " "before you call this, since it needs to read information from the guest " @@ -10718,7 +7769,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2865 ../fish/guestfish-actions.pod:1941 +#: ../fish/guestfish-actions.pod:1941 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1941 ../libguestfs-1.11.19/src/guestfs-actions.pod:2867 ../src/guestfs-actions.pod:2867 msgid "" "B<Security:> The icon data comes from the untrusted guest, and should be " "treated with caution. PNG files have been known to contain exploits. " @@ -10727,7 +7778,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2873 ../fish/guestfish-actions.pod:1949 +#: ../fish/guestfish-actions.pod:1949 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1949 ../libguestfs-1.11.19/src/guestfs-actions.pod:2875 ../src/guestfs-actions.pod:2875 msgid "" "The PNG image returned can be any size. It might not be square. Libguestfs " "tries to return the largest, highest quality icon available. The " @@ -10735,7 +7786,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2880 ../fish/guestfish-actions.pod:1956 +#: ../fish/guestfish-actions.pod:1956 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1956 ../libguestfs-1.11.19/src/guestfs-actions.pod:2882 ../src/guestfs-actions.pod:2882 msgid "" "Extracting icons from Windows guests requires the external C<wrestool> " "program from the C<icoutils> package, and several programs (C<bmptopnm>, " @@ -10744,84 +7795,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2887 ../fish/guestfish-actions.pod:1963 +#: ../fish/guestfish-actions.pod:1963 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1963 ../libguestfs-1.11.19/src/guestfs-actions.pod:2889 ../src/guestfs-actions.pod:2889 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:2896 ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:4975 -msgid "(Added in 1.11.12)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2898 -msgid "guestfs_inspect_get_icon_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2900 -#, no-wrap -msgid "" -" char *\n" -" guestfs_inspect_get_icon_va (guestfs_h *g,\n" -" const char *root,\n" -" size_t *size_r,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2906 -msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:2910 -msgid "guestfs_inspect_get_icon_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:2912 -#, no-wrap -msgid "" -" char *\n" -" guestfs_inspect_get_icon_argv (guestfs_h *g,\n" -" const char *root,\n" -" size_t *size_r,\n" -" const struct guestfs_inspect_get_icon_argv " -"*optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2918 -msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:2922 -msgid "guestfs_inspect_get_major_version" +#: ../fish/guestfish-actions.pod:1970 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1970 +msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2924 +#: ../fish/guestfish-actions.pod:1972 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1972 #, no-wrap msgid "" -" int\n" -" guestfs_inspect_get_major_version (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-major-version root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2928 ../fish/guestfish-actions.pod:1974 +#: ../fish/guestfish-actions.pod:1974 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1974 ../libguestfs-1.11.19/src/guestfs-actions.pod:2930 ../src/guestfs-actions.pod:2930 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2931 ../fish/guestfish-actions.pod:1977 +#: ../fish/guestfish-actions.pod:1977 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1977 ../libguestfs-1.11.19/src/guestfs-actions.pod:2933 ../src/guestfs-actions.pod:2933 msgid "" "Windows uses a consistent versioning scheme which is I<not> reflected in the " "popular public names used by the operating system. Notably the operating " @@ -10831,54 +7830,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2938 ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:1984 ../fish/guestfish-actions.pod:1995 +#: ../fish/guestfish-actions.pod:1984 ../fish/guestfish-actions.pod:1995 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1984 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1995 ../libguestfs-1.11.19/src/guestfs-actions.pod:2940 ../libguestfs-1.11.19/src/guestfs-actions.pod:2957 ../src/guestfs-actions.pod:2940 ../src/guestfs-actions.pod:2957 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2946 -msgid "guestfs_inspect_get_minor_version" +#: ../fish/guestfish-actions.pod:1988 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1988 +msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2948 +#: ../fish/guestfish-actions.pod:1990 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1990 #, no-wrap msgid "" -" int\n" -" guestfs_inspect_get_minor_version (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-minor-version root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2952 ../fish/guestfish-actions.pod:1992 +#: ../fish/guestfish-actions.pod:1992 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1992 ../libguestfs-1.11.19/src/guestfs-actions.pod:2954 ../src/guestfs-actions.pod:2954 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2957 +#: ../fish/guestfish-actions.pod:1997 ../libguestfs-1.11.19/fish/guestfish-actions.pod:1997 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"C<guestfs_inspect_get_major_version>." +"L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2964 -msgid "guestfs_inspect_get_mountpoints" +#: ../fish/guestfish-actions.pod:2000 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2000 +msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2966 +#: ../fish/guestfish-actions.pod:2002 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2002 #, no-wrap msgid "" -" char **\n" -" guestfs_inspect_get_mountpoints (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-mountpoints root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2970 ../fish/guestfish-actions.pod:2004 +#: ../fish/guestfish-actions.pod:2004 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2004 ../libguestfs-1.11.19/src/guestfs-actions.pod:2972 ../src/guestfs-actions.pod:2972 msgid "" "This returns a hash of where we think the filesystems associated with this " "operating system should be mounted. Callers should note that this is at " @@ -10889,7 +7884,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2979 ../fish/guestfish-actions.pod:2013 +#: ../fish/guestfish-actions.pod:2013 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2013 ../libguestfs-1.11.19/src/guestfs-actions.pod:2981 ../src/guestfs-actions.pod:2981 msgid "" "Each element in the returned hashtable has a key which is the path of the " "mountpoint (eg. C</boot>) and a value which is the filesystem that would be " @@ -10897,52 +7892,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2984 ../fish/guestfish-actions.pod:2018 +#: ../fish/guestfish-actions.pod:2018 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2018 ../libguestfs-1.11.19/src/guestfs-actions.pod:2986 ../src/guestfs-actions.pod:2986 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2987 +#: ../fish/guestfish-actions.pod:2021 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2021 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C</>. For " "information about the mapping of drive letters to partitions, see " -"C<guestfs_inspect_get_drive_mappings>." +"L</inspect-get-drive-mappings>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2993 +#: ../fish/guestfish-actions.pod:2027 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2027 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"C<guestfs_inspect_get_filesystems>." +"L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3004 -msgid "guestfs_inspect_get_package_format" +#: ../fish/guestfish-actions.pod:2030 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2030 +msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3006 +#: ../fish/guestfish-actions.pod:2032 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2032 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_package_format (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-package-format root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3010 +#: ../fish/guestfish-actions.pod:2034 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2034 msgid "" -"This function and C<guestfs_inspect_get_package_management> return the " -"package format and package management tool used by the inspected operating " -"system. For example for Fedora these functions would return C<rpm> (package " -"format) and C<yum> (package management)." +"This function and L</inspect-get-package-management> return the package " +"format and package management tool used by the inspected operating system. " +"For example for Fedora these functions would return C<rpm> (package format) " +"and C<yum> (package management)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3016 ../fish/guestfish-actions.pod:2040 +#: ../fish/guestfish-actions.pod:2040 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2040 ../libguestfs-1.11.19/src/guestfs-actions.pod:3018 ../src/guestfs-actions.pod:3018 msgid "" "This returns the string C<unknown> if we could not determine the package " "format I<or> if the operating system does not have a real packaging system " @@ -10950,43 +7943,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3020 ../fish/guestfish-actions.pod:2044 +#: ../fish/guestfish-actions.pod:2044 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2044 ../libguestfs-1.11.19/src/guestfs-actions.pod:3022 ../src/guestfs-actions.pod:3022 msgid "" "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>. " "Future versions of libguestfs may return other strings." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3028 ../src/guestfs-actions.pod:3056 -msgid "(Added in 1.7.5)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3030 -msgid "guestfs_inspect_get_package_management" +#: ../fish/guestfish-actions.pod:2049 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2049 +msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3032 +#: ../fish/guestfish-actions.pod:2051 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2051 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_package_management (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-package-management root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3036 +#: ../fish/guestfish-actions.pod:2053 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2053 msgid "" -"C<guestfs_inspect_get_package_format> and this function return the package " -"format and package management tool used by the inspected operating system. " -"For example for Fedora these functions would return C<rpm> (package format) " -"and C<yum> (package management)." +"L</inspect-get-package-format> and this function return the package format " +"and package management tool used by the inspected operating system. For " +"example for Fedora these functions would return C<rpm> (package format) and " +"C<yum> (package management)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3042 ../fish/guestfish-actions.pod:2059 +#: ../fish/guestfish-actions.pod:2059 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2059 ../libguestfs-1.11.19/src/guestfs-actions.pod:3044 ../src/guestfs-actions.pod:3044 msgid "" "This returns the string C<unknown> if we could not determine the package " "management tool I<or> if the operating system does not have a real packaging " @@ -10994,7 +7980,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3046 ../fish/guestfish-actions.pod:2063 +#: ../fish/guestfish-actions.pod:2063 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2063 ../libguestfs-1.11.19/src/guestfs-actions.pod:3048 ../src/guestfs-actions.pod:3048 msgid "" "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian " "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>. Future versions of " @@ -11002,22 +7988,20 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3058 -msgid "guestfs_inspect_get_product_name" +#: ../fish/guestfish-actions.pod:2070 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2070 +msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3060 +#: ../fish/guestfish-actions.pod:2072 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2072 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_product_name (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-product-name root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3064 ../fish/guestfish-actions.pod:2074 +#: ../fish/guestfish-actions.pod:2074 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2074 ../libguestfs-1.11.19/src/guestfs-actions.pod:3066 ../src/guestfs-actions.pod:3066 msgid "" "This returns the product name of the inspected operating system. The " "product name is generally some freeform string which can be displayed to the " @@ -11025,34 +8009,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3069 ../fish/guestfish-actions.pod:2079 +#: ../fish/guestfish-actions.pod:2079 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2079 ../libguestfs-1.11.19/src/guestfs-actions.pod:3071 ../src/guestfs-actions.pod:3071 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3079 -msgid "guestfs_inspect_get_product_variant" +#: ../fish/guestfish-actions.pod:2084 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2084 +msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3081 +#: ../fish/guestfish-actions.pod:2086 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2086 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_product_variant (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-product-variant root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3085 ../fish/guestfish-actions.pod:2088 +#: ../fish/guestfish-actions.pod:2088 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2088 ../libguestfs-1.11.19/src/guestfs-actions.pod:3087 ../src/guestfs-actions.pod:3087 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3088 ../fish/guestfish-actions.pod:2091 +#: ../fish/guestfish-actions.pod:2091 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2091 ../libguestfs-1.11.19/src/guestfs-actions.pod:3090 ../src/guestfs-actions.pod:3090 msgid "" "For Windows guests, this returns the contents of the Registry key " "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> " @@ -11064,7 +8046,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3097 ../fish/guestfish-actions.pod:2100 +#: ../fish/guestfish-actions.pod:2100 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2100 ../libguestfs-1.11.19/src/guestfs-actions.pod:3099 ../src/guestfs-actions.pod:3099 msgid "" "For enterprise Linux guests, in future we intend this to return the product " "variant such as C<Desktop>, C<Server> and so on. But this is not " @@ -11072,361 +8054,330 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3101 ../fish/guestfish-actions.pod:2104 +#: ../fish/guestfish-actions.pod:2104 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2104 ../libguestfs-1.11.19/src/guestfs-actions.pod:3103 ../src/guestfs-actions.pod:3103 msgid "" "If the product variant could not be determined, then the string C<unknown> " "is returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3104 +#: ../fish/guestfish-actions.pod:2107 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2107 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3111 -msgid "(Added in 1.9.13)" +"L</inspect-get-product-name>, L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3113 -msgid "guestfs_inspect_get_roots" +#: ../fish/guestfish-actions.pod:2111 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2111 +msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3115 +#: ../fish/guestfish-actions.pod:2113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2113 #, no-wrap msgid "" -" char **\n" -" guestfs_inspect_get_roots (guestfs_h *g);\n" +" inspect-get-roots\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3118 +#: ../fish/guestfish-actions.pod:2115 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2115 msgid "" "This function is a convenient way to get the list of root devices, as " -"returned from a previous call to C<guestfs_inspect_os>, but without redoing " -"the whole inspection process." +"returned from a previous call to L</inspect-os>, but without redoing the " +"whole inspection process." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3122 +#: ../fish/guestfish-actions.pod:2119 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2119 msgid "" "This returns an empty list if either no root devices were found or the " -"caller has not called C<guestfs_inspect_os>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3131 -msgid "(Added in 1.7.3)" +"caller has not called L</inspect-os>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3133 -msgid "guestfs_inspect_get_type" +#: ../fish/guestfish-actions.pod:2124 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2124 +msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3135 +#: ../fish/guestfish-actions.pod:2126 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2126 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_type (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-type root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3139 ../fish/guestfish-actions.pod:2128 +#: ../fish/guestfish-actions.pod:2128 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2128 ../libguestfs-1.11.19/src/guestfs-actions.pod:3141 ../src/guestfs-actions.pod:3141 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3144 ../fish/guestfish-actions.pod:2133 +#: ../fish/guestfish-actions.pod:2133 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2133 ../libguestfs-1.11.19/src/guestfs-actions.pod:3146 ../src/guestfs-actions.pod:3146 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3146 ../fish/guestfish-actions.pod:2135 +#: ../fish/guestfish-actions.pod:2135 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2135 ../libguestfs-1.11.19/src/guestfs-actions.pod:3148 ../src/guestfs-actions.pod:3148 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2139 +#: ../fish/guestfish-actions.pod:2139 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2139 ../libguestfs-1.11.19/src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3152 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3152 ../fish/guestfish-actions.pod:2141 +#: ../fish/guestfish-actions.pod:2141 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2141 ../libguestfs-1.11.19/src/guestfs-actions.pod:3154 ../src/guestfs-actions.pod:3154 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3154 ../fish/guestfish-actions.pod:2143 +#: ../fish/guestfish-actions.pod:2143 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2143 ../libguestfs-1.11.19/src/guestfs-actions.pod:3156 ../src/guestfs-actions.pod:3156 msgid "FreeBSD." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2147 +#: ../fish/guestfish-actions.pod:2147 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2147 ../libguestfs-1.11.19/src/guestfs-actions.pod:3160 ../src/guestfs-actions.pod:3160 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3172 -msgid "guestfs_inspect_get_windows_current_control_set" +#: ../fish/guestfish-actions.pod:2156 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2156 +msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3174 +#: ../fish/guestfish-actions.pod:2158 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2158 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-windows-current-control-set root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3178 ../fish/guestfish-actions.pod:2160 +#: ../fish/guestfish-actions.pod:2160 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2160 ../libguestfs-1.11.19/src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:3180 msgid "" "This returns the Windows CurrentControlSet of the inspected guest. The " "CurrentControlSet is a registry key name such as C<ControlSet001>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3181 ../fish/guestfish-actions.pod:2163 +#: ../fish/guestfish-actions.pod:2163 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2163 ../libguestfs-1.11.19/src/guestfs-actions.pod:3183 ../src/guestfs-actions.pod:3183 msgid "" "This call assumes that the guest is Windows and that the Registry could be " "examined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3192 -msgid "guestfs_inspect_get_windows_systemroot" +#: ../fish/guestfish-actions.pod:2169 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2169 +msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3194 +#: ../fish/guestfish-actions.pod:2171 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2171 #, no-wrap msgid "" -" char *\n" -" guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n" -" const char *root);\n" +" inspect-get-windows-systemroot root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3198 ../fish/guestfish-actions.pod:2173 +#: ../fish/guestfish-actions.pod:2173 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2173 ../libguestfs-1.11.19/src/guestfs-actions.pod:3200 ../src/guestfs-actions.pod:3200 msgid "" "This returns the Windows systemroot of the inspected guest. The systemroot " "is a directory path such as C</WINDOWS>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3201 ../fish/guestfish-actions.pod:2176 +#: ../fish/guestfish-actions.pod:2176 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2176 ../libguestfs-1.11.19/src/guestfs-actions.pod:3203 ../src/guestfs-actions.pod:3203 msgid "" "This call assumes that the guest is Windows and that the systemroot could be " "determined by inspection. If this is not the case then an error is " "returned." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3210 -msgid "(Added in 1.5.25)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3212 -msgid "guestfs_inspect_is_live" +#: ../fish/guestfish-actions.pod:2182 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2182 +msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3214 +#: ../fish/guestfish-actions.pod:2184 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2184 #, no-wrap msgid "" -" int\n" -" guestfs_inspect_is_live (guestfs_h *g,\n" -" const char *root);\n" +" inspect-is-live root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3218 +#: ../fish/guestfish-actions.pod:2186 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2186 msgid "" -"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " -"disk), then this returns true if a live image was detected on the disk." +"If L</inspect-get-format> returns C<installer> (this is an install disk), " +"then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3228 -msgid "guestfs_inspect_is_multipart" +#: ../fish/guestfish-actions.pod:2192 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2192 +msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3230 +#: ../fish/guestfish-actions.pod:2194 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2194 #, no-wrap msgid "" -" int\n" -" guestfs_inspect_is_multipart (guestfs_h *g,\n" -" const char *root);\n" +" inspect-is-multipart root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3234 +#: ../fish/guestfish-actions.pod:2196 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2196 msgid "" -"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " -"disk), then this returns true if the disk is part of a set." +"If L</inspect-get-format> returns C<installer> (this is an install disk), " +"then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3244 -msgid "guestfs_inspect_is_netinst" +#: ../fish/guestfish-actions.pod:2202 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2202 +msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3246 +#: ../fish/guestfish-actions.pod:2204 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2204 #, no-wrap msgid "" -" int\n" -" guestfs_inspect_is_netinst (guestfs_h *g,\n" -" const char *root);\n" +" inspect-is-netinst root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3250 +#: ../fish/guestfish-actions.pod:2206 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2206 msgid "" -"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " -"disk), then this returns true if the disk is a network installer, ie. not a " +"If L</inspect-get-format> returns C<installer> (this is an install disk), " +"then this returns true if the disk is a network installer, ie. not a " "self-contained install CD but one which is likely to require network access " "to complete the install." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3262 -msgid "guestfs_inspect_list_applications" +#: ../fish/guestfish-actions.pod:2214 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2214 +msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3264 +#: ../fish/guestfish-actions.pod:2216 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2216 #, no-wrap msgid "" -" struct guestfs_application_list *\n" -" guestfs_inspect_list_applications (guestfs_h *g,\n" -" const char *root);\n" +" inspect-list-applications root\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3268 ../fish/guestfish-actions.pod:2218 +#: ../fish/guestfish-actions.pod:2218 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2218 ../libguestfs-1.11.19/src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3270 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3270 +#: ../fish/guestfish-actions.pod:2220 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2220 msgid "" "I<Note:> This call works differently from other parts of the inspection " -"API. You have to call C<guestfs_inspect_os>, then " -"C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling " -"this. Listing applications is a significantly more difficult operation " -"which requires access to the full filesystem. Also note that unlike the " -"other C<guestfs_inspect_get_*> calls which are just returning data cached in " -"the libguestfs handle, this call actually reads parts of the mounted " -"filesystems during the call." +"API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, " +"then mount up the disks, before calling this. Listing applications is a " +"significantly more difficult operation which requires access to the full " +"filesystem. Also note that unlike the other L</inspect-get-*> calls which " +"are just returning data cached in the libguestfs handle, this call actually " +"reads parts of the mounted filesystems during the call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3280 ../fish/guestfish-actions.pod:2230 +#: ../fish/guestfish-actions.pod:2230 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2230 ../libguestfs-1.11.19/src/guestfs-actions.pod:3282 ../src/guestfs-actions.pod:3282 msgid "" "This returns an empty list if the inspection code was not able to determine " "the list of applications." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3283 ../fish/guestfish-actions.pod:2233 +#: ../fish/guestfish-actions.pod:2233 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2233 ../libguestfs-1.11.19/src/guestfs-actions.pod:3285 ../src/guestfs-actions.pod:3285 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3287 ../fish/guestfish-actions.pod:2237 +#: ../fish/guestfish-actions.pod:2237 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2237 ../libguestfs-1.11.19/src/guestfs-actions.pod:3289 ../src/guestfs-actions.pod:3289 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3289 ../fish/guestfish-actions.pod:2239 +#: ../fish/guestfish-actions.pod:2239 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2239 ../libguestfs-1.11.19/src/guestfs-actions.pod:3291 ../src/guestfs-actions.pod:3291 msgid "" "The name of the application. For Red Hat-derived and Debian-derived Linux " "guests, this is the package name." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3292 ../fish/guestfish-actions.pod:2242 +#: ../fish/guestfish-actions.pod:2242 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2242 ../libguestfs-1.11.19/src/guestfs-actions.pod:3294 ../src/guestfs-actions.pod:3294 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3294 ../fish/guestfish-actions.pod:2244 +#: ../fish/guestfish-actions.pod:2244 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2244 ../libguestfs-1.11.19/src/guestfs-actions.pod:3296 ../src/guestfs-actions.pod:3296 msgid "" "The display name of the application, sometimes localized to the install " "language of the guest operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3297 ../fish/guestfish-actions.pod:2247 +#: ../fish/guestfish-actions.pod:2247 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2247 ../libguestfs-1.11.19/src/guestfs-actions.pod:3299 ../src/guestfs-actions.pod:3299 msgid "" "If unavailable this is returned as an empty string C<\"\">. Callers needing " "to display something can use C<app_name> instead." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3300 ../fish/guestfish-actions.pod:2250 +#: ../fish/guestfish-actions.pod:2250 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2250 ../libguestfs-1.11.19/src/guestfs-actions.pod:3302 ../src/guestfs-actions.pod:3302 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3302 ../fish/guestfish-actions.pod:2252 +#: ../fish/guestfish-actions.pod:2252 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2252 ../libguestfs-1.11.19/src/guestfs-actions.pod:3304 ../src/guestfs-actions.pod:3304 msgid "" "For package managers which use epochs, this contains the epoch of the " "package (an integer). If unavailable, this is returned as C<0>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3305 ../fish/guestfish-actions.pod:2255 +#: ../fish/guestfish-actions.pod:2255 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2255 ../libguestfs-1.11.19/src/guestfs-actions.pod:3307 ../src/guestfs-actions.pod:3307 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3307 ../fish/guestfish-actions.pod:2257 +#: ../fish/guestfish-actions.pod:2257 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2257 ../libguestfs-1.11.19/src/guestfs-actions.pod:3309 ../src/guestfs-actions.pod:3309 msgid "" "The version string of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3310 ../fish/guestfish-actions.pod:2260 +#: ../fish/guestfish-actions.pod:2260 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2260 ../libguestfs-1.11.19/src/guestfs-actions.pod:3312 ../src/guestfs-actions.pod:3312 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3312 ../fish/guestfish-actions.pod:2262 +#: ../fish/guestfish-actions.pod:2262 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2262 ../libguestfs-1.11.19/src/guestfs-actions.pod:3314 ../src/guestfs-actions.pod:3314 msgid "" "The release string of the application or package, for package managers that " "use this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3316 ../fish/guestfish-actions.pod:2266 +#: ../fish/guestfish-actions.pod:2266 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2266 ../libguestfs-1.11.19/src/guestfs-actions.pod:3318 ../src/guestfs-actions.pod:3318 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3318 ../fish/guestfish-actions.pod:2268 +#: ../fish/guestfish-actions.pod:2268 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2268 ../libguestfs-1.11.19/src/guestfs-actions.pod:3320 ../src/guestfs-actions.pod:3320 msgid "" "The installation path of the application (on operating systems such as " "Windows which use installation paths). This path is in the format used by " @@ -11434,111 +8385,97 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3323 ../fish/guestfish-actions.pod:2273 +#: ../fish/guestfish-actions.pod:2273 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2273 ../libguestfs-1.11.19/src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:3325 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3325 ../fish/guestfish-actions.pod:2275 +#: ../fish/guestfish-actions.pod:2275 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2275 ../libguestfs-1.11.19/src/guestfs-actions.pod:3327 ../src/guestfs-actions.pod:3327 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3327 ../fish/guestfish-actions.pod:2277 +#: ../fish/guestfish-actions.pod:2277 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2277 ../libguestfs-1.11.19/src/guestfs-actions.pod:3329 ../src/guestfs-actions.pod:3329 msgid "" "The install path translated into a libguestfs path. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3330 ../fish/guestfish-actions.pod:2280 +#: ../fish/guestfish-actions.pod:2280 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2280 ../libguestfs-1.11.19/src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3332 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3332 ../fish/guestfish-actions.pod:2282 +#: ../fish/guestfish-actions.pod:2282 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2282 ../libguestfs-1.11.19/src/guestfs-actions.pod:3334 ../src/guestfs-actions.pod:3334 msgid "" "The name of the publisher of the application, for package managers that use " "this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3336 ../fish/guestfish-actions.pod:2286 +#: ../fish/guestfish-actions.pod:2286 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2286 ../libguestfs-1.11.19/src/guestfs-actions.pod:3338 ../src/guestfs-actions.pod:3338 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3338 ../fish/guestfish-actions.pod:2288 +#: ../fish/guestfish-actions.pod:2288 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2288 ../libguestfs-1.11.19/src/guestfs-actions.pod:3340 ../src/guestfs-actions.pod:3340 msgid "" "The URL (eg. upstream URL) of the application. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3341 ../fish/guestfish-actions.pod:2291 +#: ../fish/guestfish-actions.pod:2291 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2291 ../libguestfs-1.11.19/src/guestfs-actions.pod:3343 ../src/guestfs-actions.pod:3343 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3343 ../fish/guestfish-actions.pod:2293 +#: ../fish/guestfish-actions.pod:2293 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2293 ../libguestfs-1.11.19/src/guestfs-actions.pod:3345 ../src/guestfs-actions.pod:3345 msgid "" "For packaging systems which support this, the name of the source package. " "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3346 ../fish/guestfish-actions.pod:2296 +#: ../fish/guestfish-actions.pod:2296 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2296 ../libguestfs-1.11.19/src/guestfs-actions.pod:3348 ../src/guestfs-actions.pod:3348 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3348 ../fish/guestfish-actions.pod:2298 +#: ../fish/guestfish-actions.pod:2298 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2298 ../libguestfs-1.11.19/src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3350 msgid "" "A short (usually one line) description of the application or package. If " "unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3351 ../fish/guestfish-actions.pod:2301 +#: ../fish/guestfish-actions.pod:2301 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2301 ../libguestfs-1.11.19/src/guestfs-actions.pod:3353 ../src/guestfs-actions.pod:3353 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3353 ../fish/guestfish-actions.pod:2303 +#: ../fish/guestfish-actions.pod:2303 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2303 ../libguestfs-1.11.19/src/guestfs-actions.pod:3355 ../src/guestfs-actions.pod:3355 msgid "" "A longer description of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3360 -msgid "" -"This function returns a C<struct guestfs_application_list *>, or NULL if " -"there was an error. I<The caller must call C<guestfs_free_application_list> " -"after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3364 -msgid "(Added in 1.7.8)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3366 -msgid "guestfs_inspect_os" +#: ../fish/guestfish-actions.pod:2310 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2310 +msgid "inspect-os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3368 +#: ../fish/guestfish-actions.pod:2312 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2312 #, no-wrap msgid "" -" char **\n" -" guestfs_inspect_os (guestfs_h *g);\n" +" inspect-os\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3371 ../fish/guestfish-actions.pod:2314 +#: ../fish/guestfish-actions.pod:2314 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2314 ../libguestfs-1.11.19/src/guestfs-actions.pod:3373 ../src/guestfs-actions.pod:3373 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -11546,12 +8483,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3375 ../fish/guestfish-actions.pod:2318 +#: ../fish/guestfish-actions.pod:2318 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2318 ../libguestfs-1.11.19/src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3377 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3377 ../fish/guestfish-actions.pod:2320 +#: ../fish/guestfish-actions.pod:2320 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2320 ../libguestfs-1.11.19/src/guestfs-actions.pod:3379 ../src/guestfs-actions.pod:3379 msgid "" "If one operating system was found, then this returns a list with a single " "element, which is the name of the root filesystem of this operating system. " @@ -11561,191 +8498,174 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3384 +#: ../fish/guestfish-actions.pod:2327 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2327 msgid "" -"You can pass the root string(s) returned to other C<guestfs_inspect_get_*> " +"You can pass the root string(s) returned to other L</inspect-get-*> " "functions in order to query further information about each operating system, " "such as the name and version." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3389 +#: ../fish/guestfish-actions.pod:2332 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2332 msgid "" -"This function uses other libguestfs features such as C<guestfs_mount_ro> and " -"C<guestfs_umount_all> in order to mount and unmount filesystems and look at " -"the contents. This should be called with no disks currently mounted. The " +"This function uses other libguestfs features such as L</mount-ro> and " +"L</umount-all> in order to mount and unmount filesystems and look at the " +"contents. This should be called with no disks currently mounted. The " "function may also use Augeas, so any existing Augeas handle will be closed." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3395 ../fish/guestfish-actions.pod:2338 +#: ../fish/guestfish-actions.pod:2338 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2338 ../libguestfs-1.11.19/src/guestfs-actions.pod:3397 ../src/guestfs-actions.pod:3397 msgid "" "This function cannot decrypt encrypted disks. The caller must do that first " "(supplying the necessary keys) if the disk is encrypted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3814 -msgid "See also C<guestfs_list_filesystems>." +#: ../fish/guestfish-actions.pod:2344 ../fish/guestfish-actions.pod:2542 ../fish/guestfish-actions.pod:2601 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2344 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2542 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2601 +msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3409 -msgid "guestfs_is_blockdev" +#: ../fish/guestfish-actions.pod:2346 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2346 +msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3411 +#: ../fish/guestfish-actions.pod:2348 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2348 #, no-wrap msgid "" -" int\n" -" guestfs_is_blockdev (guestfs_h *g,\n" -" const char *path);\n" +" is-blockdev path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3415 ../fish/guestfish-actions.pod:2350 +#: ../fish/guestfish-actions.pod:2350 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2350 ../libguestfs-1.11.19/src/guestfs-actions.pod:3417 ../src/guestfs-actions.pod:3417 msgid "" "This returns C<true> if and only if there is a block device with the given " "C<path> name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3447 ../src/guestfs-actions.pod:3477 ../src/guestfs-actions.pod:3492 ../src/guestfs-actions.pod:3508 ../src/guestfs-actions.pod:3564 ../src/guestfs-actions.pod:3579 -msgid "See also C<guestfs_stat>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3422 ../src/guestfs-actions.pod:3451 ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3568 ../src/guestfs-actions.pod:3583 -msgid "(Added in 1.5.10)" +#: ../fish/guestfish-actions.pod:2353 ../fish/guestfish-actions.pod:2371 ../fish/guestfish-actions.pod:2390 ../fish/guestfish-actions.pod:2399 ../fish/guestfish-actions.pod:2409 ../fish/guestfish-actions.pod:2443 ../fish/guestfish-actions.pod:2452 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2353 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2371 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2390 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2399 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2409 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2443 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2452 +msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3424 -msgid "guestfs_is_busy" +#: ../fish/guestfish-actions.pod:2355 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2355 +msgid "is-busy" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3426 +#: ../fish/guestfish-actions.pod:2357 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2357 #, no-wrap msgid "" -" int\n" -" guestfs_is_busy (guestfs_h *g);\n" +" is-busy\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3429 ../fish/guestfish-actions.pod:2359 +#: ../fish/guestfish-actions.pod:2359 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2359 ../libguestfs-1.11.19/src/guestfs-actions.pod:3431 ../src/guestfs-actions.pod:3431 msgid "" "This returns true iff this handle is busy processing a command (in the " "C<BUSY> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3438 -msgid "guestfs_is_chardev" +#: ../fish/guestfish-actions.pod:2364 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2364 +msgid "is-chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3440 +#: ../fish/guestfish-actions.pod:2366 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2366 #, no-wrap msgid "" -" int\n" -" guestfs_is_chardev (guestfs_h *g,\n" -" const char *path);\n" +" is-chardev path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3444 ../fish/guestfish-actions.pod:2368 +#: ../fish/guestfish-actions.pod:2368 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2368 ../libguestfs-1.11.19/src/guestfs-actions.pod:3446 ../src/guestfs-actions.pod:3446 msgid "" "This returns C<true> if and only if there is a character device with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3453 -msgid "guestfs_is_config" +#: ../fish/guestfish-actions.pod:2373 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2373 +msgid "is-config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3455 +#: ../fish/guestfish-actions.pod:2375 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2375 #, no-wrap msgid "" -" int\n" -" guestfs_is_config (guestfs_h *g);\n" +" is-config\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3458 ../fish/guestfish-actions.pod:2377 +#: ../fish/guestfish-actions.pod:2377 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2377 ../libguestfs-1.11.19/src/guestfs-actions.pod:3460 ../src/guestfs-actions.pod:3460 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3467 -msgid "guestfs_is_dir" +#: ../fish/guestfish-actions.pod:2382 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2382 +msgid "is-dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3469 +#: ../fish/guestfish-actions.pod:2384 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2384 #, no-wrap msgid "" -" int\n" -" guestfs_is_dir (guestfs_h *g,\n" -" const char *path);\n" +" is-dir path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3473 ../fish/guestfish-actions.pod:2386 +#: ../fish/guestfish-actions.pod:2386 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2386 ../libguestfs-1.11.19/src/guestfs-actions.pod:3475 ../src/guestfs-actions.pod:3475 msgid "" "This returns C<true> if and only if there is a directory with the given " "C<path> name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3483 -msgid "guestfs_is_fifo" +#: ../fish/guestfish-actions.pod:2392 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2392 +msgid "is-fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3485 +#: ../fish/guestfish-actions.pod:2394 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2394 #, no-wrap msgid "" -" int\n" -" guestfs_is_fifo (guestfs_h *g,\n" -" const char *path);\n" +" is-fifo path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3489 ../fish/guestfish-actions.pod:2396 +#: ../fish/guestfish-actions.pod:2396 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2396 ../libguestfs-1.11.19/src/guestfs-actions.pod:3491 ../src/guestfs-actions.pod:3491 msgid "" "This returns C<true> if and only if there is a FIFO (named pipe) with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3498 -msgid "guestfs_is_file" +#: ../fish/guestfish-actions.pod:2401 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2401 +msgid "is-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3500 +#: ../fish/guestfish-actions.pod:2403 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2403 #, no-wrap msgid "" -" int\n" -" guestfs_is_file (guestfs_h *g,\n" -" const char *path);\n" +" is-file path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3504 ../fish/guestfish-actions.pod:2405 +#: ../fish/guestfish-actions.pod:2405 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2405 ../libguestfs-1.11.19/src/guestfs-actions.pod:3506 ../src/guestfs-actions.pod:3506 msgid "" "This returns C<true> if and only if there is a regular file with the given " "C<path> name. Note that it returns false for other objects like " @@ -11753,388 +8673,354 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3514 -msgid "guestfs_is_launching" +#: ../fish/guestfish-actions.pod:2411 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2411 +msgid "is-launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3516 +#: ../fish/guestfish-actions.pod:2413 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2413 #, no-wrap msgid "" -" int\n" -" guestfs_is_launching (guestfs_h *g);\n" +" is-launching\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3519 ../fish/guestfish-actions.pod:2415 +#: ../fish/guestfish-actions.pod:2415 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2415 ../libguestfs-1.11.19/src/guestfs-actions.pod:3521 ../src/guestfs-actions.pod:3521 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3528 -msgid "guestfs_is_lv" +#: ../fish/guestfish-actions.pod:2420 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2420 +msgid "is-lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3530 +#: ../fish/guestfish-actions.pod:2422 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2422 #, no-wrap msgid "" -" int\n" -" guestfs_is_lv (guestfs_h *g,\n" -" const char *device);\n" +" is-lv device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3534 ../fish/guestfish-actions.pod:2424 +#: ../fish/guestfish-actions.pod:2424 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2424 ../libguestfs-1.11.19/src/guestfs-actions.pod:3536 ../src/guestfs-actions.pod:3536 msgid "" "This command tests whether C<device> is a logical volume, and returns true " "iff this is the case." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3541 -msgid "guestfs_is_ready" +#: ../fish/guestfish-actions.pod:2427 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2427 +msgid "is-ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3543 +#: ../fish/guestfish-actions.pod:2429 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2429 #, no-wrap msgid "" -" int\n" -" guestfs_is_ready (guestfs_h *g);\n" +" is-ready\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3546 ../fish/guestfish-actions.pod:2431 +#: ../fish/guestfish-actions.pod:2431 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2431 ../libguestfs-1.11.19/src/guestfs-actions.pod:3548 ../src/guestfs-actions.pod:3548 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3555 -msgid "guestfs_is_socket" +#: ../fish/guestfish-actions.pod:2436 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2436 +msgid "is-socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3557 +#: ../fish/guestfish-actions.pod:2438 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2438 #, no-wrap msgid "" -" int\n" -" guestfs_is_socket (guestfs_h *g,\n" -" const char *path);\n" +" is-socket path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3561 ../fish/guestfish-actions.pod:2440 +#: ../fish/guestfish-actions.pod:2440 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2440 ../libguestfs-1.11.19/src/guestfs-actions.pod:3563 ../src/guestfs-actions.pod:3563 msgid "" "This returns C<true> if and only if there is a Unix domain socket with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3570 -msgid "guestfs_is_symlink" +#: ../fish/guestfish-actions.pod:2445 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2445 +msgid "is-symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3572 +#: ../fish/guestfish-actions.pod:2447 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2447 #, no-wrap msgid "" -" int\n" -" guestfs_is_symlink (guestfs_h *g,\n" -" const char *path);\n" +" is-symlink path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3576 ../fish/guestfish-actions.pod:2449 +#: ../fish/guestfish-actions.pod:2449 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2449 ../libguestfs-1.11.19/src/guestfs-actions.pod:3578 ../src/guestfs-actions.pod:3578 msgid "" "This returns C<true> if and only if there is a symbolic link with the given " "C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3585 -msgid "guestfs_is_zero" +#: ../fish/guestfish-actions.pod:2454 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2454 +msgid "is-zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3587 +#: ../fish/guestfish-actions.pod:2456 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2456 #, no-wrap msgid "" -" int\n" -" guestfs_is_zero (guestfs_h *g,\n" -" const char *path);\n" +" is-zero path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3591 ../fish/guestfish-actions.pod:2458 +#: ../fish/guestfish-actions.pod:2458 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2458 ../libguestfs-1.11.19/src/guestfs-actions.pod:3593 ../src/guestfs-actions.pod:3593 msgid "" "This returns true iff the file exists and the file is empty or it contains " "all zero bytes." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3596 ../src/guestfs-actions.pod:3610 -msgid "(Added in 1.11.8)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3598 -msgid "guestfs_is_zero_device" +#: ../fish/guestfish-actions.pod:2461 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2461 +msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3600 +#: ../fish/guestfish-actions.pod:2463 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2463 #, no-wrap msgid "" -" int\n" -" guestfs_is_zero_device (guestfs_h *g,\n" -" const char *device);\n" +" is-zero-device device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3604 ../fish/guestfish-actions.pod:2465 +#: ../fish/guestfish-actions.pod:2465 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2465 ../libguestfs-1.11.19/src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:3606 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3606 ../fish/guestfish-actions.pod:2467 +#: ../fish/guestfish-actions.pod:2467 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2467 ../libguestfs-1.11.19/src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:3608 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3612 -msgid "guestfs_kill_subprocess" +#: ../fish/guestfish-actions.pod:2469 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2469 +msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3614 +#: ../fish/guestfish-actions.pod:2471 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2471 #, no-wrap msgid "" -" int\n" -" guestfs_kill_subprocess (guestfs_h *g);\n" +" kill-subprocess\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3617 ../fish/guestfish-actions.pod:2473 +#: ../fish/guestfish-actions.pod:2473 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2473 ../libguestfs-1.11.19/src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3619 msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3623 -msgid "guestfs_launch" +#: ../fish/guestfish-actions.pod:2475 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2475 +msgid "launch" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:2477 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2477 +msgid "run" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3625 +#: ../fish/guestfish-actions.pod:2479 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2479 #, no-wrap msgid "" -" int\n" -" guestfs_launch (guestfs_h *g);\n" +" launch\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3628 ../fish/guestfish-actions.pod:2481 +#: ../fish/guestfish-actions.pod:2481 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2481 ../libguestfs-1.11.19/src/guestfs-actions.pod:3630 ../src/guestfs-actions.pod:3630 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3631 ../fish/guestfish-actions.pod:2484 +#: ../fish/guestfish-actions.pod:2484 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2484 ../libguestfs-1.11.19/src/guestfs-actions.pod:3633 ../src/guestfs-actions.pod:3633 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3643 -msgid "guestfs_lchown" +#: ../fish/guestfish-actions.pod:2487 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2487 +msgid "lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3645 +#: ../fish/guestfish-actions.pod:2489 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2489 #, no-wrap msgid "" -" int\n" -" guestfs_lchown (guestfs_h *g,\n" -" int owner,\n" -" int group,\n" -" const char *path);\n" +" lchown owner group path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3651 +#: ../fish/guestfish-actions.pod:2491 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2491 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " -"C<guestfs_chown> but if C<path> is a symlink then the link itself is " -"changed, not the target." +"L</chown> but if C<path> is a symlink then the link itself is changed, not " +"the target." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3663 -msgid "guestfs_lgetxattr" +#: ../fish/guestfish-actions.pod:2499 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2499 +msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3665 +#: ../fish/guestfish-actions.pod:2501 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2501 #, no-wrap msgid "" -" char *\n" -" guestfs_lgetxattr (guestfs_h *g,\n" -" const char *path,\n" -" const char *name,\n" -" size_t *size_r);\n" +" lgetxattr path name\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3671 ../fish/guestfish-actions.pod:2503 +#: ../fish/guestfish-actions.pod:2503 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2503 ../libguestfs-1.11.19/src/guestfs-actions.pod:3673 ../src/guestfs-actions.pod:3673 msgid "" "Get a single extended attribute from file C<path> named C<name>. If C<path> " "is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3685 -msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." +#: ../fish/guestfish-actions.pod:2517 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2517 +msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3693 -msgid "guestfs_lgetxattrs" +#: ../fish/guestfish-actions.pod:2519 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2519 +msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3695 +#: ../fish/guestfish-actions.pod:2521 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2521 #, no-wrap msgid "" -" struct guestfs_xattr_list *\n" -" guestfs_lgetxattrs (guestfs_h *g,\n" -" const char *path);\n" +" lgetxattrs path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3699 +#: ../fish/guestfish-actions.pod:2523 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2523 msgid "" -"This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, " -"then it returns the extended attributes of the link itself." +"This is the same as L</getxattrs>, but if C<path> is a symbolic link, then " +"it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3709 -msgid "guestfs_list_9p" +#: ../fish/guestfish-actions.pod:2527 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2527 +msgid "list-9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3711 +#: ../fish/guestfish-actions.pod:2529 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2529 #, no-wrap msgid "" -" char **\n" -" guestfs_list_9p (guestfs_h *g);\n" +" list-9p\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3714 ../fish/guestfish-actions.pod:2531 +#: ../fish/guestfish-actions.pod:2531 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2531 ../libguestfs-1.11.19/src/guestfs-actions.pod:3716 ../src/guestfs-actions.pod:3716 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3723 -msgid "guestfs_list_devices" +#: ../fish/guestfish-actions.pod:2534 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2534 +msgid "list-devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3725 +#: ../fish/guestfish-actions.pod:2536 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2536 #, no-wrap msgid "" -" char **\n" -" guestfs_list_devices (guestfs_h *g);\n" +" list-devices\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3728 ../fish/guestfish-actions.pod:2538 +#: ../fish/guestfish-actions.pod:2538 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2538 ../libguestfs-1.11.19/src/guestfs-actions.pod:3730 ../src/guestfs-actions.pod:3730 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3730 ../fish/guestfish-actions.pod:2540 +#: ../fish/guestfish-actions.pod:2540 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2540 ../libguestfs-1.11.19/src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3732 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3740 -msgid "guestfs_list_dm_devices" +#: ../fish/guestfish-actions.pod:2544 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2544 +msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3742 +#: ../fish/guestfish-actions.pod:2546 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2546 #, no-wrap msgid "" -" char **\n" -" guestfs_list_dm_devices (guestfs_h *g);\n" +" list-dm-devices\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3745 ../fish/guestfish-actions.pod:2548 +#: ../fish/guestfish-actions.pod:2548 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2548 ../libguestfs-1.11.19/src/guestfs-actions.pod:3747 ../src/guestfs-actions.pod:3747 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3747 +#: ../fish/guestfish-actions.pod:2550 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2550 msgid "" "The returned list contains C</dev/mapper/*> devices, eg. ones created by a " -"previous call to C<guestfs_luks_open>." +"previous call to L</luks-open>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3750 +#: ../fish/guestfish-actions.pod:2553 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2553 msgid "" "Device mapper devices which correspond to logical volumes are I<not> " -"returned in this list. Call C<guestfs_lvs> if you want to list logical " -"volumes." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3758 ../src/guestfs-actions.pod:5214 -msgid "(Added in 1.11.15)" +"returned in this list. Call L</lvs> if you want to list logical volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3760 -msgid "guestfs_list_filesystems" +#: ../fish/guestfish-actions.pod:2557 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2557 +msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3762 +#: ../fish/guestfish-actions.pod:2559 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2559 #, no-wrap msgid "" -" char **\n" -" guestfs_list_filesystems (guestfs_h *g);\n" +" list-filesystems\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3765 ../fish/guestfish-actions.pod:2561 +#: ../fish/guestfish-actions.pod:2561 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2561 ../libguestfs-1.11.19/src/guestfs-actions.pod:3767 ../src/guestfs-actions.pod:3767 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -12142,14 +9028,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3769 ../fish/guestfish-actions.pod:2565 +#: ../fish/guestfish-actions.pod:2565 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2565 ../libguestfs-1.11.19/src/guestfs-actions.pod:3771 ../src/guestfs-actions.pod:3771 msgid "" "The return value is a hash, where the keys are the devices containing " "filesystems, and the values are the filesystem types. For example:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3773 ../fish/guestfish-actions.pod:2569 +#: ../fish/guestfish-actions.pod:2569 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2569 ../libguestfs-1.11.19/src/guestfs-actions.pod:3775 ../src/guestfs-actions.pod:3775 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -12160,224 +9046,198 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3778 ../fish/guestfish-actions.pod:2574 +#: ../fish/guestfish-actions.pod:2574 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2574 ../libguestfs-1.11.19/src/guestfs-actions.pod:3780 ../src/guestfs-actions.pod:3780 msgid "" "The value can have the special value \"unknown\", meaning the content of the " "device is undetermined or empty. \"swap\" means a Linux swap partition." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3782 +#: ../fish/guestfish-actions.pod:2578 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2578 msgid "" -"This command runs other libguestfs commands, which might include " -"C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " -"soon after launch and only when nothing is mounted." +"This command runs other libguestfs commands, which might include L</mount> " +"and L</umount>, and therefore you should use this soon after launch and only " +"when nothing is mounted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3786 +#: ../fish/guestfish-actions.pod:2582 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2582 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " "each filesystem found is valid and mountable, and some filesystems might be " "mountable but require special options. Filesystems may not all belong to a " -"single logical operating system (use C<guestfs_inspect_os> to look for " -"OSes)." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3800 ../src/guestfs-actions.pod:5569 -msgid "(Added in 1.5.15)" +"single logical operating system (use L</inspect-os> to look for OSes)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3802 -msgid "guestfs_list_partitions" +#: ../fish/guestfish-actions.pod:2590 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2590 +msgid "list-partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3804 +#: ../fish/guestfish-actions.pod:2592 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2592 #, no-wrap msgid "" -" char **\n" -" guestfs_list_partitions (guestfs_h *g);\n" +" list-partitions\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3807 ../fish/guestfish-actions.pod:2594 +#: ../fish/guestfish-actions.pod:2594 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2594 ../libguestfs-1.11.19/src/guestfs-actions.pod:3809 ../src/guestfs-actions.pod:3809 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3809 ../fish/guestfish-actions.pod:2596 +#: ../fish/guestfish-actions.pod:2596 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2596 ../libguestfs-1.11.19/src/guestfs-actions.pod:3811 ../src/guestfs-actions.pod:3811 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3811 +#: ../fish/guestfish-actions.pod:2598 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2598 msgid "" "This does not return logical volumes. For that you will need to call " -"C<guestfs_lvs>." +"L</lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3822 -msgid "guestfs_ll" +#: ../fish/guestfish-actions.pod:2603 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2603 +msgid "ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3824 +#: ../fish/guestfish-actions.pod:2605 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2605 #, no-wrap msgid "" -" char *\n" -" guestfs_ll (guestfs_h *g,\n" -" const char *directory);\n" +" ll directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3828 ../fish/guestfish-actions.pod:2607 +#: ../fish/guestfish-actions.pod:2607 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2607 ../libguestfs-1.11.19/src/guestfs-actions.pod:3830 ../src/guestfs-actions.pod:3830 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd) in the format of 'ls -la'." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3831 ../fish/guestfish-actions.pod:2610 +#: ../fish/guestfish-actions.pod:2610 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2610 ../libguestfs-1.11.19/src/guestfs-actions.pod:3833 ../src/guestfs-actions.pod:3833 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3839 -msgid "guestfs_ln" +#: ../fish/guestfish-actions.pod:2613 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2613 +msgid "ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3841 +#: ../fish/guestfish-actions.pod:2615 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2615 #, no-wrap msgid "" -" int\n" -" guestfs_ln (guestfs_h *g,\n" -" const char *target,\n" -" const char *linkname);\n" +" ln target linkname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3846 ../fish/guestfish-actions.pod:2617 +#: ../fish/guestfish-actions.pod:2617 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2617 ../libguestfs-1.11.19/src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3848 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3852 -msgid "guestfs_ln_f" +#: ../fish/guestfish-actions.pod:2619 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2619 +msgid "ln-f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3854 +#: ../fish/guestfish-actions.pod:2621 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2621 #, no-wrap msgid "" -" int\n" -" guestfs_ln_f (guestfs_h *g,\n" -" const char *target,\n" -" const char *linkname);\n" +" ln-f target linkname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3859 ../fish/guestfish-actions.pod:2623 +#: ../fish/guestfish-actions.pod:2623 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2623 ../libguestfs-1.11.19/src/guestfs-actions.pod:3861 ../src/guestfs-actions.pod:3861 msgid "" "This command creates a hard link using the C<ln -f> command. The I<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3866 -msgid "guestfs_ln_s" +#: ../fish/guestfish-actions.pod:2626 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2626 +msgid "ln-s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3868 +#: ../fish/guestfish-actions.pod:2628 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2628 #, no-wrap msgid "" -" int\n" -" guestfs_ln_s (guestfs_h *g,\n" -" const char *target,\n" -" const char *linkname);\n" +" ln-s target linkname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3873 ../fish/guestfish-actions.pod:2630 +#: ../fish/guestfish-actions.pod:2630 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2630 ../libguestfs-1.11.19/src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3875 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3879 -msgid "guestfs_ln_sf" +#: ../fish/guestfish-actions.pod:2632 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2632 +msgid "ln-sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3881 +#: ../fish/guestfish-actions.pod:2634 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2634 #, no-wrap msgid "" -" int\n" -" guestfs_ln_sf (guestfs_h *g,\n" -" const char *target,\n" -" const char *linkname);\n" +" ln-sf target linkname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3886 ../fish/guestfish-actions.pod:2636 +#: ../fish/guestfish-actions.pod:2636 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2636 ../libguestfs-1.11.19/src/guestfs-actions.pod:3888 ../src/guestfs-actions.pod:3888 msgid "" "This command creates a symbolic link using the C<ln -sf> command, The I<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3893 -msgid "guestfs_lremovexattr" +#: ../fish/guestfish-actions.pod:2639 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2639 +msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3895 +#: ../fish/guestfish-actions.pod:2641 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2641 #, no-wrap msgid "" -" int\n" -" guestfs_lremovexattr (guestfs_h *g,\n" -" const char *xattr,\n" -" const char *path);\n" +" lremovexattr xattr path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3900 +#: ../fish/guestfish-actions.pod:2643 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2643 msgid "" -"This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic " -"link, then it removes an extended attribute of the link itself." +"This is the same as L</removexattr>, but if C<path> is a symbolic link, then " +"it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3908 -msgid "guestfs_ls" +#: ../fish/guestfish-actions.pod:2647 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2647 +msgid "ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3910 +#: ../fish/guestfish-actions.pod:2649 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2649 #, no-wrap msgid "" -" char **\n" -" guestfs_ls (guestfs_h *g,\n" -" const char *directory);\n" +" ls directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3914 ../fish/guestfish-actions.pod:2651 +#: ../fish/guestfish-actions.pod:2651 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2651 ../libguestfs-1.11.19/src/guestfs-actions.pod:3916 ../src/guestfs-actions.pod:3916 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd). The '.' and '..' entries are not returned, but hidden files are " @@ -12385,107 +9245,85 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3918 +#: ../fish/guestfish-actions.pod:2655 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2655 msgid "" "This command is mostly useful for interactive sessions. Programs should " -"probably use C<guestfs_readdir> instead." +"probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3927 -msgid "guestfs_lsetxattr" +#: ../fish/guestfish-actions.pod:2658 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2658 +msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3929 +#: ../fish/guestfish-actions.pod:2660 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2660 #, no-wrap msgid "" -" int\n" -" guestfs_lsetxattr (guestfs_h *g,\n" -" const char *xattr,\n" -" const char *val,\n" -" int vallen,\n" -" const char *path);\n" +" lsetxattr xattr val vallen path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3936 +#: ../fish/guestfish-actions.pod:2662 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2662 msgid "" -"This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, " -"then it sets an extended attribute of the link itself." +"This is the same as L</setxattr>, but if C<path> is a symbolic link, then it " +"sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3944 -msgid "guestfs_lstat" +#: ../fish/guestfish-actions.pod:2666 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2666 +msgid "lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3946 +#: ../fish/guestfish-actions.pod:2668 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2668 #, no-wrap msgid "" -" struct guestfs_stat *\n" -" guestfs_lstat (guestfs_h *g,\n" -" const char *path);\n" +" lstat path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3950 ../src/guestfs-actions.pod:6721 ../fish/guestfish-actions.pod:2670 ../fish/guestfish-actions.pod:4472 +#: ../fish/guestfish-actions.pod:2670 ../fish/guestfish-actions.pod:4478 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2670 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4478 ../libguestfs-1.11.19/src/guestfs-actions.pod:3952 ../libguestfs-1.11.19/src/guestfs-actions.pod:6731 ../src/guestfs-actions.pod:3952 ../src/guestfs-actions.pod:6731 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3952 +#: ../fish/guestfish-actions.pod:2672 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2672 msgid "" -"This is the same as C<guestfs_stat> except that if C<path> is a symbolic " -"link, then the link is stat-ed, not the file it refers to." +"This is the same as L</stat> except that if C<path> is a symbolic link, then " +"the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3956 ../fish/guestfish-actions.pod:2676 +#: ../fish/guestfish-actions.pod:2676 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2676 ../libguestfs-1.11.19/src/guestfs-actions.pod:3958 ../src/guestfs-actions.pod:3958 msgid "This is the same as the C<lstat(2)> system call." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3958 ../src/guestfs-actions.pod:6725 -msgid "" -"This function returns a C<struct guestfs_stat *>, or NULL if there was an " -"error. I<The caller must call C<guestfs_free_stat> after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:3962 ../src/guestfs-actions.pod:6729 ../src/guestfs-actions.pod:6747 ../src/guestfs-actions.pod:7128 -msgid "(Added in 0.9.2)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3964 -msgid "guestfs_lstatlist" +#: ../fish/guestfish-actions.pod:2678 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2678 +msgid "lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3966 +#: ../fish/guestfish-actions.pod:2680 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2680 #, no-wrap msgid "" -" struct guestfs_stat_list *\n" -" guestfs_lstatlist (guestfs_h *g,\n" -" const char *path,\n" -" char *const *names);\n" +" lstatlist path 'names ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3971 +#: ../fish/guestfish-actions.pod:2682 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2682 msgid "" -"This call allows you to perform the C<guestfs_lstat> operation on multiple " -"files, where all files are in the directory C<path>. C<names> is the list " -"of files from this directory." +"This call allows you to perform the L</lstat> operation on multiple files, " +"where all files are in the directory C<path>. C<names> is the list of files " +"from this directory." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3975 ../fish/guestfish-actions.pod:2686 +#: ../fish/guestfish-actions.pod:2686 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2686 ../libguestfs-1.11.19/src/guestfs-actions.pod:3977 ../src/guestfs-actions.pod:3977 msgid "" "On return you get a list of stat structs, with a one-to-one correspondence " "to the C<names> list. If any name did not exist or could not be lstat'd, " @@ -12493,43 +9331,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3980 +#: ../fish/guestfish-actions.pod:2691 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2691 msgid "" "This call is intended for programs that want to efficiently list a directory " -"contents without making many round-trips. See also C<guestfs_lxattrlist> " -"for a similarly efficient call for getting extended attributes. Very long " +"contents without making many round-trips. See also L</lxattrlist> for a " +"similarly efficient call for getting extended attributes. Very long " "directory listings might cause the protocol message size to be exceeded, " "causing this call to fail. The caller must split up such requests into " "smaller groups of names." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:3988 -msgid "" -"This function returns a C<struct guestfs_stat_list *>, or NULL if there was " -"an error. I<The caller must call C<guestfs_free_stat_list> after use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:3994 -msgid "guestfs_luks_add_key" +#: ../fish/guestfish-actions.pod:2699 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2699 +msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3996 +#: ../fish/guestfish-actions.pod:2701 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2701 #, no-wrap msgid "" -" int\n" -" guestfs_luks_add_key (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" const char *newkey,\n" -" int keyslot);\n" +" luks-add-key device keyslot\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4003 ../fish/guestfish-actions.pod:2703 +#: ../fish/guestfish-actions.pod:2703 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2703 ../libguestfs-1.11.19/src/guestfs-actions.pod:4005 ../src/guestfs-actions.pod:4005 msgid "" "This command adds a new key on LUKS device C<device>. C<key> is any " "existing key, and is used to access the device. C<newkey> is the new key to " @@ -12537,73 +9363,56 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4008 +#: ../fish/guestfish-actions.pod:2708 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2708 msgid "" "Note that if C<keyslot> already contains a key, then this command will " -"fail. You have to use C<guestfs_luks_kill_slot> first to remove that key." +"fail. You have to use L</luks-kill-slot> first to remove that key." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4054 ../src/guestfs-actions.pod:4077 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4151 +#: ../fish/guestfish-actions.pod:2712 ../fish/guestfish-actions.pod:2734 ../fish/guestfish-actions.pod:2747 ../fish/guestfish-actions.pod:2761 ../fish/guestfish-actions.pod:2787 ../fish/guestfish-actions.pod:2797 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2712 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2734 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2747 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2761 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2787 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2797 msgid "" -"This function takes a key or passphrase parameter which could contain " -"sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " -"information." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4018 ../src/guestfs-actions.pod:4058 ../src/guestfs-actions.pod:4081 ../src/guestfs-actions.pod:4101 -msgid "(Added in 1.5.2)" +"This command has one or more key or passphrase parameters. Guestfish will " +"prompt for these separately." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4020 -msgid "guestfs_luks_close" +#: ../fish/guestfish-actions.pod:2715 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2715 +msgid "luks-close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4022 +#: ../fish/guestfish-actions.pod:2717 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2717 #, no-wrap msgid "" -" int\n" -" guestfs_luks_close (guestfs_h *g,\n" -" const char *device);\n" +" luks-close device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4026 +#: ../fish/guestfish-actions.pod:2719 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2719 msgid "" -"This closes a LUKS device that was created earlier by C<guestfs_luks_open> " -"or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the " -"LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the " +"This closes a LUKS device that was created earlier by L</luks-open> or " +"L</luks-open-ro>. The C<device> parameter must be the name of the LUKS " +"mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the " "underlying block device." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4136 ../src/guestfs-actions.pod:4155 ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4253 -msgid "(Added in 1.5.1)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4036 -msgid "guestfs_luks_format" +#: ../fish/guestfish-actions.pod:2725 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2725 +msgid "luks-format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4038 +#: ../fish/guestfish-actions.pod:2727 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2727 #, no-wrap msgid "" -" int\n" -" guestfs_luks_format (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" int keyslot);\n" +" luks-format device keyslot\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4044 ../fish/guestfish-actions.pod:2729 +#: ../fish/guestfish-actions.pod:2729 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2729 ../libguestfs-1.11.19/src/guestfs-actions.pod:4046 ../src/guestfs-actions.pod:4046 msgid "" "This command erases existing data on C<device> and formats the device as a " "LUKS encrypted device. C<key> is the initial key, which is added to key " @@ -12611,99 +9420,86 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:6102 ../src/guestfs-actions.pod:6528 ../src/guestfs-actions.pod:6558 ../src/guestfs-actions.pod:6591 ../src/guestfs-actions.pod:7787 ../fish/guestfish-actions.pod:2737 ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:3498 ../fish/guestfish-actions.pod:4018 ../fish/guestfish-actions.pod:4343 ../fish/guestfish-actions.pod:4366 ../fish/guestfish-actions.pod:4388 ../fish/guestfish-actions.pod:5126 +#: ../fish/guestfish-actions.pod:2737 ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:3498 ../fish/guestfish-actions.pod:4024 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4372 ../fish/guestfish-actions.pod:4394 ../fish/guestfish-actions.pod:5132 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2737 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2750 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2837 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3498 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4024 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4349 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4372 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4394 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5132 ../libguestfs-1.11.19/src/guestfs-actions.pod:4053 ../libguestfs-1.11.19/src/guestfs-actions.pod:4076 ../libguestfs-1.11.19/src/guestfs-actions.pod:4219 ../libguestfs-1.11.19/src/guestfs-actions.pod:5322 ../libguestfs-1.11.19/src/guestfs-actions.pod:6110 ../libguestfs-1.11.19/src/guestfs-actions.pod:6538 ../libguestfs-1.11.19/src/guestfs-actions.pod:6568 ../libguestfs-1.11.19/src/guestfs-actions.pod:6601 ../libguestfs-1.11.19/src/guestfs-actions.pod:7799 ../src/guestfs-actions.pod:4053 ../src/guestfs-actions.pod:4076 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:5322 ../src/guestfs-actions.pod:6110 ../src/guestfs-actions.pod:6538 ../src/guestfs-actions.pod:6568 ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:7799 msgid "" "B<This command is dangerous. Without careful use you can easily destroy all " "your data>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4060 -msgid "guestfs_luks_format_cipher" +#: ../fish/guestfish-actions.pod:2740 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2740 +msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4062 +#: ../fish/guestfish-actions.pod:2742 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2742 #, no-wrap msgid "" -" int\n" -" guestfs_luks_format_cipher (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" int keyslot,\n" -" const char *cipher);\n" +" luks-format-cipher device keyslot cipher\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4069 +#: ../fish/guestfish-actions.pod:2744 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2744 msgid "" -"This command is the same as C<guestfs_luks_format> but it also allows you to " -"set the C<cipher> used." +"This command is the same as L</luks-format> but it also allows you to set " +"the C<cipher> used." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4083 -msgid "guestfs_luks_kill_slot" +#: ../fish/guestfish-actions.pod:2753 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2753 +msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4085 +#: ../fish/guestfish-actions.pod:2755 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2755 #, no-wrap msgid "" -" int\n" -" guestfs_luks_kill_slot (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" int keyslot);\n" +" luks-kill-slot device keyslot\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2757 +#: ../fish/guestfish-actions.pod:2757 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2757 ../libguestfs-1.11.19/src/guestfs-actions.pod:4093 ../src/guestfs-actions.pod:4093 msgid "" "This command deletes the key in key slot C<keyslot> from the encrypted LUKS " "device C<device>. C<key> must be one of the I<other> keys." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4103 -msgid "guestfs_luks_open" +#: ../fish/guestfish-actions.pod:2764 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2764 +msgid "luks-open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4105 +#: ../fish/guestfish-actions.pod:2766 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2766 #, no-wrap msgid "" -" int\n" -" guestfs_luks_open (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" const char *mapname);\n" +" luks-open device mapname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4111 ../fish/guestfish-actions.pod:2768 +#: ../fish/guestfish-actions.pod:2768 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2768 ../libguestfs-1.11.19/src/guestfs-actions.pod:4113 ../src/guestfs-actions.pod:4113 msgid "" "This command opens a block device which has been encrypted according to the " "Linux Unified Key Setup (LUKS) standard." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4114 ../fish/guestfish-actions.pod:2771 +#: ../fish/guestfish-actions.pod:2771 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2771 ../libguestfs-1.11.19/src/guestfs-actions.pod:4116 ../src/guestfs-actions.pod:4116 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4116 ../fish/guestfish-actions.pod:2773 +#: ../fish/guestfish-actions.pod:2773 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2773 ../libguestfs-1.11.19/src/guestfs-actions.pod:4118 ../src/guestfs-actions.pod:4118 msgid "" "The caller must supply one of the keys associated with the LUKS block " "device, in the C<key> parameter." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4119 ../fish/guestfish-actions.pod:2776 +#: ../fish/guestfish-actions.pod:2776 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2776 ../libguestfs-1.11.19/src/guestfs-actions.pod:4121 ../src/guestfs-actions.pod:4121 msgid "" "This creates a new block device called C</dev/mapper/mapname>. Reads and " "writes to this block device are decrypted from and encrypted to the " @@ -12711,83 +9507,72 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4123 +#: ../fish/guestfish-actions.pod:2780 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2780 msgid "" -"If this block device contains LVM volume groups, then calling " -"C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " -"visible." +"If this block device contains LVM volume groups, then calling L</vgscan> " +"followed by L</vg-activate-all> will make them visible." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4127 -msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." +#: ../fish/guestfish-actions.pod:2784 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2784 +msgid "Use L</list-dm-devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4138 -msgid "guestfs_luks_open_ro" +#: ../fish/guestfish-actions.pod:2790 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2790 +msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4140 +#: ../fish/guestfish-actions.pod:2792 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2792 #, no-wrap msgid "" -" int\n" -" guestfs_luks_open_ro (guestfs_h *g,\n" -" const char *device,\n" -" const char *key,\n" -" const char *mapname);\n" +" luks-open-ro device mapname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4146 +#: ../fish/guestfish-actions.pod:2794 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2794 msgid "" -"This is the same as C<guestfs_luks_open> except that a read-only mapping is " +"This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4157 -msgid "guestfs_lvcreate" +#: ../fish/guestfish-actions.pod:2800 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2800 +msgid "lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4159 +#: ../fish/guestfish-actions.pod:2802 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2802 #, no-wrap msgid "" -" int\n" -" guestfs_lvcreate (guestfs_h *g,\n" -" const char *logvol,\n" -" const char *volgroup,\n" -" int mbytes);\n" +" lvcreate logvol volgroup mbytes\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4165 ../fish/guestfish-actions.pod:2804 +#: ../fish/guestfish-actions.pod:2804 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2804 ../libguestfs-1.11.19/src/guestfs-actions.pod:4167 ../src/guestfs-actions.pod:4167 msgid "" "This creates an LVM logical volume called C<logvol> on the volume group " "C<volgroup>, with C<size> megabytes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4172 -msgid "guestfs_lvm_canonical_lv_name" +#: ../fish/guestfish-actions.pod:2807 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2807 +msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4174 +#: ../fish/guestfish-actions.pod:2809 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2809 #, no-wrap msgid "" -" char *\n" -" guestfs_lvm_canonical_lv_name (guestfs_h *g,\n" -" const char *lvname);\n" +" lvm-canonical-lv-name lvname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4178 ../fish/guestfish-actions.pod:2811 +#: ../fish/guestfish-actions.pod:2811 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2811 ../libguestfs-1.11.19/src/guestfs-actions.pod:4180 ../src/guestfs-actions.pod:4180 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, C</dev/mapper/VG-LV> is converted to " @@ -12795,86 +9580,77 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4182 ../fish/guestfish-actions.pod:2815 +#: ../fish/guestfish-actions.pod:2815 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2815 ../libguestfs-1.11.19/src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4184 msgid "" "This command returns an error if the C<lvname> parameter does not refer to a " "logical volume." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4185 -msgid "See also C<guestfs_is_lv>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4190 -msgid "(Added in 1.5.24)" +#: ../fish/guestfish-actions.pod:2818 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2818 +msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4192 -msgid "guestfs_lvm_clear_filter" +#: ../fish/guestfish-actions.pod:2820 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2820 +msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4194 +#: ../fish/guestfish-actions.pod:2822 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2822 #, no-wrap msgid "" -" int\n" -" guestfs_lvm_clear_filter (guestfs_h *g);\n" +" lvm-clear-filter\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4197 +#: ../fish/guestfish-actions.pod:2824 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2824 msgid "" -"This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to " -"see every block device." +"This undoes the effect of L</lvm-set-filter>. LVM will be able to see every " +"block device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4242 ../fish/guestfish-actions.pod:2827 ../fish/guestfish-actions.pod:2858 +#: ../fish/guestfish-actions.pod:2827 ../fish/guestfish-actions.pod:2858 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2827 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2858 ../libguestfs-1.11.19/src/guestfs-actions.pod:4202 ../libguestfs-1.11.19/src/guestfs-actions.pod:4244 ../src/guestfs-actions.pod:4202 ../src/guestfs-actions.pod:4244 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4207 -msgid "guestfs_lvm_remove_all" +#: ../fish/guestfish-actions.pod:2830 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2830 +msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4209 +#: ../fish/guestfish-actions.pod:2832 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2832 #, no-wrap msgid "" -" int\n" -" guestfs_lvm_remove_all (guestfs_h *g);\n" +" lvm-remove-all\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4212 ../fish/guestfish-actions.pod:2834 +#: ../fish/guestfish-actions.pod:2834 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2834 ../libguestfs-1.11.19/src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:4214 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4222 -msgid "guestfs_lvm_set_filter" +#: ../fish/guestfish-actions.pod:2840 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2840 +msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4224 +#: ../fish/guestfish-actions.pod:2842 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2842 #, no-wrap msgid "" -" int\n" -" guestfs_lvm_set_filter (guestfs_h *g,\n" -" char *const *devices);\n" +" lvm-set-filter 'devices ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4228 ../fish/guestfish-actions.pod:2844 +#: ../fish/guestfish-actions.pod:2844 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2844 ../libguestfs-1.11.19/src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4230 msgid "" "This sets the LVM device filter so that LVM will only be able to \"see\" the " "block devices in the list C<devices>, and will ignore all other attached " @@ -12882,7 +9658,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4232 ../fish/guestfish-actions.pod:2848 +#: ../fish/guestfish-actions.pod:2848 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2848 ../libguestfs-1.11.19/src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4234 msgid "" "Where disk image(s) contain duplicate PVs or VGs, this command is useful to " "get LVM to ignore the duplicates, otherwise LVM can get confused. Note also " @@ -12894,118 +9670,97 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2861 +#: ../fish/guestfish-actions.pod:2861 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2861 ../libguestfs-1.11.19/src/guestfs-actions.pod:4247 ../src/guestfs-actions.pod:4247 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4247 ../fish/guestfish-actions.pod:2863 +#: ../fish/guestfish-actions.pod:2863 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2863 ../libguestfs-1.11.19/src/guestfs-actions.pod:4249 ../src/guestfs-actions.pod:4249 msgid "" "You cannot use this if any VG is currently in use (eg. contains a mounted " "filesystem), even if you are not filtering out that VG." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4255 -msgid "guestfs_lvremove" +#: ../fish/guestfish-actions.pod:2867 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2867 +msgid "lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4257 +#: ../fish/guestfish-actions.pod:2869 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2869 #, no-wrap msgid "" -" int\n" -" guestfs_lvremove (guestfs_h *g,\n" -" const char *device);\n" +" lvremove device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:2871 +#: ../fish/guestfish-actions.pod:2871 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2871 ../libguestfs-1.11.19/src/guestfs-actions.pod:4263 ../src/guestfs-actions.pod:4263 msgid "" "Remove an LVM logical volume C<device>, where C<device> is the path to the " "LV, such as C</dev/VG/LV>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2874 +#: ../fish/guestfish-actions.pod:2874 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2874 ../libguestfs-1.11.19/src/guestfs-actions.pod:4266 ../src/guestfs-actions.pod:4266 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, " "C</dev/VG>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:5666 ../src/guestfs-actions.pod:7498 -msgid "(Added in 1.0.13)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4271 -msgid "guestfs_lvrename" +#: ../fish/guestfish-actions.pod:2877 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2877 +msgid "lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4273 +#: ../fish/guestfish-actions.pod:2879 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2879 #, no-wrap msgid "" -" int\n" -" guestfs_lvrename (guestfs_h *g,\n" -" const char *logvol,\n" -" const char *newlogvol);\n" +" lvrename logvol newlogvol\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4278 ../fish/guestfish-actions.pod:2881 +#: ../fish/guestfish-actions.pod:2881 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2881 ../libguestfs-1.11.19/src/guestfs-actions.pod:4280 ../src/guestfs-actions.pod:4280 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:7511 -msgid "(Added in 1.0.83)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4284 -msgid "guestfs_lvresize" +#: ../fish/guestfish-actions.pod:2883 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2883 +msgid "lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4286 +#: ../fish/guestfish-actions.pod:2885 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2885 #, no-wrap msgid "" -" int\n" -" guestfs_lvresize (guestfs_h *g,\n" -" const char *device,\n" -" int mbytes);\n" +" lvresize device mbytes\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4291 ../fish/guestfish-actions.pod:2887 +#: ../fish/guestfish-actions.pod:2887 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2887 ../libguestfs-1.11.19/src/guestfs-actions.pod:4293 ../src/guestfs-actions.pod:4293 msgid "" "This resizes (expands or shrinks) an existing LVM logical volume to " "C<mbytes>. When reducing, data in the reduced part is lost." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4299 -msgid "guestfs_lvresize_free" +#: ../fish/guestfish-actions.pod:2891 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2891 +msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4301 +#: ../fish/guestfish-actions.pod:2893 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2893 #, no-wrap msgid "" -" int\n" -" guestfs_lvresize_free (guestfs_h *g,\n" -" const char *lv,\n" -" int percent);\n" +" lvresize-free lv percent\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4306 ../fish/guestfish-actions.pod:2895 +#: ../fish/guestfish-actions.pod:2895 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2895 ../libguestfs-1.11.19/src/guestfs-actions.pod:4308 ../src/guestfs-actions.pod:4308 msgid "" "This expands an existing logical volume C<lv> so that it fills C<pc>% of the " "remaining free space in the volume group. Commonly you would call this with " @@ -13013,111 +9768,91 @@ msgid "" "remaining free space in the volume group." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4314 -msgid "(Added in 1.3.3)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4316 -msgid "guestfs_lvs" +#: ../fish/guestfish-actions.pod:2901 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2901 +msgid "lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4318 +#: ../fish/guestfish-actions.pod:2903 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2903 #, no-wrap msgid "" -" char **\n" -" guestfs_lvs (guestfs_h *g);\n" +" lvs\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4321 ../fish/guestfish-actions.pod:2905 +#: ../fish/guestfish-actions.pod:2905 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2905 ../libguestfs-1.11.19/src/guestfs-actions.pod:4323 ../src/guestfs-actions.pod:4323 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4324 ../fish/guestfish-actions.pod:2908 +#: ../fish/guestfish-actions.pod:2908 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2908 ../libguestfs-1.11.19/src/guestfs-actions.pod:4326 ../src/guestfs-actions.pod:4326 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4327 -msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." +#: ../fish/guestfish-actions.pod:2911 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2911 +msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4335 -msgid "guestfs_lvs_full" +#: ../fish/guestfish-actions.pod:2913 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2913 +msgid "lvs-full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4337 +#: ../fish/guestfish-actions.pod:2915 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2915 #, no-wrap msgid "" -" struct guestfs_lvm_lv_list *\n" -" guestfs_lvs_full (guestfs_h *g);\n" +" lvs-full\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4340 ../fish/guestfish-actions.pod:2917 +#: ../fish/guestfish-actions.pod:2917 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2917 ../libguestfs-1.11.19/src/guestfs-actions.pod:4342 ../src/guestfs-actions.pod:4342 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command. The \"full\" version includes all fields." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4343 -msgid "" -"This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there " -"was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after " -"use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4349 -msgid "guestfs_lvuuid" +#: ../fish/guestfish-actions.pod:2920 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2920 +msgid "lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4351 +#: ../fish/guestfish-actions.pod:2922 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2922 #, no-wrap msgid "" -" char *\n" -" guestfs_lvuuid (guestfs_h *g,\n" -" const char *device);\n" +" lvuuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4355 ../fish/guestfish-actions.pod:2924 +#: ../fish/guestfish-actions.pod:2924 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2924 ../libguestfs-1.11.19/src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:4357 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4362 -msgid "guestfs_lxattrlist" +#: ../fish/guestfish-actions.pod:2926 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2926 +msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4364 +#: ../fish/guestfish-actions.pod:2928 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2928 #, no-wrap msgid "" -" struct guestfs_xattr_list *\n" -" guestfs_lxattrlist (guestfs_h *g,\n" -" const char *path,\n" -" char *const *names);\n" +" lxattrlist path 'names ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4369 ../fish/guestfish-actions.pod:2930 +#: ../fish/guestfish-actions.pod:2930 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2930 ../libguestfs-1.11.19/src/guestfs-actions.pod:4371 ../src/guestfs-actions.pod:4371 msgid "" "This call allows you to get the extended attributes of multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -13125,7 +9860,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4373 ../fish/guestfish-actions.pod:2934 +#: ../fish/guestfish-actions.pod:2934 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2934 ../libguestfs-1.11.19/src/guestfs-actions.pod:4375 ../src/guestfs-actions.pod:4375 msgid "" "On return you get a flat list of xattr structs which must be interpreted " "sequentially. The first xattr struct always has a zero-length C<attrname>. " @@ -13138,61 +9873,56 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4383 +#: ../fish/guestfish-actions.pod:2944 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2944 msgid "" "This call is intended for programs that want to efficiently list a directory " -"contents without making many round-trips. See also C<guestfs_lstatlist> for " -"a similarly efficient call for getting standard stats. Very long directory " +"contents without making many round-trips. See also L</lstatlist> for a " +"similarly efficient call for getting standard stats. Very long directory " "listings might cause the protocol message size to be exceeded, causing this " "call to fail. The caller must split up such requests into smaller groups of " "names." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4397 -msgid "guestfs_mkdir" +#: ../fish/guestfish-actions.pod:2952 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2952 +msgid "mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4399 +#: ../fish/guestfish-actions.pod:2954 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2954 #, no-wrap msgid "" -" int\n" -" guestfs_mkdir (guestfs_h *g,\n" -" const char *path);\n" +" mkdir path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4403 ../fish/guestfish-actions.pod:2956 +#: ../fish/guestfish-actions.pod:2956 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2956 ../libguestfs-1.11.19/src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4405 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4409 -msgid "guestfs_mkdir_mode" +#: ../fish/guestfish-actions.pod:2958 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2958 +msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4411 +#: ../fish/guestfish-actions.pod:2960 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2960 #, no-wrap msgid "" -" int\n" -" guestfs_mkdir_mode (guestfs_h *g,\n" -" const char *path,\n" -" int mode);\n" +" mkdir-mode path mode\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4416 ../fish/guestfish-actions.pod:2962 +#: ../fish/guestfish-actions.pod:2962 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2962 ../libguestfs-1.11.19/src/guestfs-actions.pod:4418 ../src/guestfs-actions.pod:4418 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4419 ../fish/guestfish-actions.pod:2965 +#: ../fish/guestfish-actions.pod:2965 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2965 ../libguestfs-1.11.19/src/guestfs-actions.pod:4421 ../src/guestfs-actions.pod:4421 msgid "" "For common Linux filesystems, the actual mode which is set will be C<mode & " "~umask & 01777>. Non-native-Linux filesystems may interpret the mode in " @@ -13200,49 +9930,45 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4423 -msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" +#: ../fish/guestfish-actions.pod:2969 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2969 +msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4429 -msgid "guestfs_mkdir_p" +#: ../fish/guestfish-actions.pod:2971 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2971 +msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4431 +#: ../fish/guestfish-actions.pod:2973 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2973 #, no-wrap msgid "" -" int\n" -" guestfs_mkdir_p (guestfs_h *g,\n" -" const char *path);\n" +" mkdir-p path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4435 ../fish/guestfish-actions.pod:2975 +#: ../fish/guestfish-actions.pod:2975 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2975 ../libguestfs-1.11.19/src/guestfs-actions.pod:4437 ../src/guestfs-actions.pod:4437 msgid "" "Create a directory named C<path>, creating any parent directories as " "necessary. This is like the C<mkdir -p> shell command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4442 -msgid "guestfs_mkdtemp" +#: ../fish/guestfish-actions.pod:2978 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2978 +msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4444 +#: ../fish/guestfish-actions.pod:2980 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2980 #, no-wrap msgid "" -" char *\n" -" guestfs_mkdtemp (guestfs_h *g,\n" -" const char *template);\n" +" mkdtemp template\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4448 ../fish/guestfish-actions.pod:2982 +#: ../fish/guestfish-actions.pod:2982 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2982 ../libguestfs-1.11.19/src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4450 msgid "" "This command creates a temporary directory. The C<template> parameter " "should be a full pathname for the temporary directory name with the final " @@ -13250,61 +9976,56 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4453 ../fish/guestfish-actions.pod:2987 +#: ../fish/guestfish-actions.pod:2987 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2987 ../libguestfs-1.11.19/src/guestfs-actions.pod:4455 ../src/guestfs-actions.pod:4455 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4456 ../fish/guestfish-actions.pod:2990 +#: ../fish/guestfish-actions.pod:2990 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2990 ../libguestfs-1.11.19/src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:4458 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4459 ../fish/guestfish-actions.pod:2993 +#: ../fish/guestfish-actions.pod:2993 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2993 ../libguestfs-1.11.19/src/guestfs-actions.pod:4461 ../src/guestfs-actions.pod:4461 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4462 ../fish/guestfish-actions.pod:2996 +#: ../fish/guestfish-actions.pod:2996 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2996 ../libguestfs-1.11.19/src/guestfs-actions.pod:4464 ../src/guestfs-actions.pod:4464 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4465 ../fish/guestfish-actions.pod:2999 +#: ../fish/guestfish-actions.pod:2999 ../libguestfs-1.11.19/fish/guestfish-actions.pod:2999 ../libguestfs-1.11.19/src/guestfs-actions.pod:4467 ../src/guestfs-actions.pod:4467 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4472 -msgid "guestfs_mke2fs_J" +#: ../fish/guestfish-actions.pod:3001 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3001 +msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4474 +#: ../fish/guestfish-actions.pod:3003 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3003 #, no-wrap msgid "" -" int\n" -" guestfs_mke2fs_J (guestfs_h *g,\n" -" const char *fstype,\n" -" int blocksize,\n" -" const char *device,\n" -" const char *journal);\n" +" mke2fs-J fstype blocksize device journal\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4481 ../fish/guestfish-actions.pod:3005 +#: ../fish/guestfish-actions.pod:3005 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3005 ../libguestfs-1.11.19/src/guestfs-actions.pod:4483 ../src/guestfs-actions.pod:4483 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "C<journal>. It is equivalent to the command:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4485 ../fish/guestfish-actions.pod:3009 +#: ../fish/guestfish-actions.pod:3009 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3009 ../libguestfs-1.11.19/src/guestfs-actions.pod:4487 ../src/guestfs-actions.pod:4487 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -13312,100 +10033,82 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4487 -msgid "See also C<guestfs_mke2journal>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4491 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4543 ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:4630 ../src/guestfs-actions.pod:4907 -msgid "(Added in 1.0.68)" +#: ../fish/guestfish-actions.pod:3011 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3011 +msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4493 -msgid "guestfs_mke2fs_JL" +#: ../fish/guestfish-actions.pod:3013 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3013 +msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4495 +#: ../fish/guestfish-actions.pod:3015 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3015 #, no-wrap msgid "" -" int\n" -" guestfs_mke2fs_JL (guestfs_h *g,\n" -" const char *fstype,\n" -" int blocksize,\n" -" const char *device,\n" -" const char *label);\n" +" mke2fs-JL fstype blocksize device label\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4502 ../fish/guestfish-actions.pod:3017 +#: ../fish/guestfish-actions.pod:3017 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3017 ../libguestfs-1.11.19/src/guestfs-actions.pod:4504 ../src/guestfs-actions.pod:4504 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal labeled C<label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4505 -msgid "See also C<guestfs_mke2journal_L>." +#: ../fish/guestfish-actions.pod:3020 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3020 +msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4511 -msgid "guestfs_mke2fs_JU" +#: ../fish/guestfish-actions.pod:3022 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3022 +msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4513 +#: ../fish/guestfish-actions.pod:3024 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3024 #, no-wrap msgid "" -" int\n" -" guestfs_mke2fs_JU (guestfs_h *g,\n" -" const char *fstype,\n" -" int blocksize,\n" -" const char *device,\n" -" const char *uuid);\n" +" mke2fs-JU fstype blocksize device uuid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4520 ../fish/guestfish-actions.pod:3026 +#: ../fish/guestfish-actions.pod:3026 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3026 ../libguestfs-1.11.19/src/guestfs-actions.pod:4522 ../src/guestfs-actions.pod:4522 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal with UUID C<uuid>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4523 -msgid "See also C<guestfs_mke2journal_U>." +#: ../fish/guestfish-actions.pod:3029 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3029 +msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4529 -msgid "guestfs_mke2journal" +#: ../fish/guestfish-actions.pod:3031 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3031 +msgid "mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4531 +#: ../fish/guestfish-actions.pod:3033 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3033 #, no-wrap msgid "" -" int\n" -" guestfs_mke2journal (guestfs_h *g,\n" -" int blocksize,\n" -" const char *device);\n" +" mke2journal blocksize device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4536 ../fish/guestfish-actions.pod:3035 +#: ../fish/guestfish-actions.pod:3035 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3035 ../libguestfs-1.11.19/src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:4538 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4539 ../fish/guestfish-actions.pod:3038 +#: ../fish/guestfish-actions.pod:3038 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3038 ../libguestfs-1.11.19/src/guestfs-actions.pod:4541 ../src/guestfs-actions.pod:4541 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -13413,176 +10116,144 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4545 -msgid "guestfs_mke2journal_L" +#: ../fish/guestfish-actions.pod:3040 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3040 +msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4547 +#: ../fish/guestfish-actions.pod:3042 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3042 #, no-wrap msgid "" -" int\n" -" guestfs_mke2journal_L (guestfs_h *g,\n" -" int blocksize,\n" -" const char *label,\n" -" const char *device);\n" +" mke2journal-L blocksize label device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4553 ../fish/guestfish-actions.pod:3044 +#: ../fish/guestfish-actions.pod:3044 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3044 ../libguestfs-1.11.19/src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:4555 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4559 -msgid "guestfs_mke2journal_U" +#: ../fish/guestfish-actions.pod:3046 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3046 +msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4561 +#: ../fish/guestfish-actions.pod:3048 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3048 #, no-wrap msgid "" -" int\n" -" guestfs_mke2journal_U (guestfs_h *g,\n" -" int blocksize,\n" -" const char *uuid,\n" -" const char *device);\n" +" mke2journal-U blocksize uuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4567 ../fish/guestfish-actions.pod:3050 +#: ../fish/guestfish-actions.pod:3050 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3050 ../libguestfs-1.11.19/src/guestfs-actions.pod:4569 ../src/guestfs-actions.pod:4569 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4573 -msgid "guestfs_mkfifo" +#: ../fish/guestfish-actions.pod:3052 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3052 +msgid "mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4575 +#: ../fish/guestfish-actions.pod:3054 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3054 #, no-wrap msgid "" -" int\n" -" guestfs_mkfifo (guestfs_h *g,\n" -" int mode,\n" -" const char *path);\n" +" mkfifo mode path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4580 +#: ../fish/guestfish-actions.pod:3056 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3056 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " -"is just a convenient wrapper around C<guestfs_mknod>." +"is just a convenient wrapper around L</mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4590 -msgid "guestfs_mkfs" +#: ../fish/guestfish-actions.pod:3062 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3062 +msgid "mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4592 +#: ../fish/guestfish-actions.pod:3064 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3064 #, no-wrap msgid "" -" int\n" -" guestfs_mkfs (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device);\n" +" mkfs fstype device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3066 +#: ../fish/guestfish-actions.pod:3066 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3066 ../libguestfs-1.11.19/src/guestfs-actions.pod:4599 ../src/guestfs-actions.pod:4599 msgid "" "This creates a filesystem on C<device> (usually a partition or LVM logical " "volume). The filesystem type is C<fstype>, for example C<ext3>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4605 -msgid "guestfs_mkfs_b" +#: ../fish/guestfish-actions.pod:3070 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3070 +msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4607 +#: ../fish/guestfish-actions.pod:3072 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3072 #, no-wrap msgid "" -" int\n" -" guestfs_mkfs_b (guestfs_h *g,\n" -" const char *fstype,\n" -" int blocksize,\n" -" const char *device);\n" +" mkfs-b fstype blocksize device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4613 +#: ../fish/guestfish-actions.pod:3074 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3074 msgid "" -"This call is similar to C<guestfs_mkfs>, but it allows you to control the " -"block size of the resulting filesystem. Supported block sizes depend on the " +"This call is similar to L</mkfs>, but it allows you to control the block " +"size of the resulting filesystem. Supported block sizes depend on the " "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4618 ../src/guestfs-actions.pod:4663 ../fish/guestfish-actions.pod:3079 ../fish/guestfish-actions.pod:3106 +#: ../fish/guestfish-actions.pod:3079 ../fish/guestfish-actions.pod:3106 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3079 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3106 ../libguestfs-1.11.19/src/guestfs-actions.pod:4620 ../libguestfs-1.11.19/src/guestfs-actions.pod:4665 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4665 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4623 ../fish/guestfish-actions.pod:3082 +#: ../fish/guestfish-actions.pod:3082 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3082 ../libguestfs-1.11.19/src/guestfs-actions.pod:4625 ../src/guestfs-actions.pod:4625 msgid "" "This function is deprecated. In new code, use the C<mkfs_opts> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4632 -msgid "guestfs_mkfs_opts" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4634 -#, no-wrap -msgid "" -" int\n" -" guestfs_mkfs_opts (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:3089 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3089 +msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4645 +#: ../fish/guestfish-actions.pod:3091 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3091 #, no-wrap msgid "" -" GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" -" GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n" -" GUESTFS_MKFS_OPTS_INODE, int inode,\n" -" GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n" +" mkfs-opts fstype device [blocksize:..] [features:..] [inode:..] " +"[sectorsize:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4650 ../fish/guestfish-actions.pod:3093 +#: ../fish/guestfish-actions.pod:3093 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3093 ../libguestfs-1.11.19/src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4652 msgid "" "This function creates a filesystem on C<device>. The filesystem type is " "C<fstype>, for example C<ext3>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4657 ../fish/guestfish-actions.pod:3100 +#: ../fish/guestfish-actions.pod:3100 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3100 ../libguestfs-1.11.19/src/guestfs-actions.pod:4659 ../src/guestfs-actions.pod:4659 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4659 ../fish/guestfish-actions.pod:3102 +#: ../fish/guestfish-actions.pod:3102 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3102 ../libguestfs-1.11.19/src/guestfs-actions.pod:4661 ../src/guestfs-actions.pod:4661 msgid "" "The filesystem block size. Supported block sizes depend on the filesystem " "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 " @@ -13590,132 +10261,80 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4666 ../fish/guestfish-actions.pod:3109 +#: ../fish/guestfish-actions.pod:3109 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3109 ../libguestfs-1.11.19/src/guestfs-actions.pod:4668 ../src/guestfs-actions.pod:4668 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4668 ../fish/guestfish-actions.pod:3111 +#: ../fish/guestfish-actions.pod:3111 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3111 ../libguestfs-1.11.19/src/guestfs-actions.pod:4670 ../src/guestfs-actions.pod:4670 msgid "C<features>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4670 ../fish/guestfish-actions.pod:3113 +#: ../fish/guestfish-actions.pod:3113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3113 ../libguestfs-1.11.19/src/guestfs-actions.pod:4672 ../src/guestfs-actions.pod:4672 msgid "This passes the I<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4672 ../fish/guestfish-actions.pod:3115 +#: ../fish/guestfish-actions.pod:3115 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3115 ../libguestfs-1.11.19/src/guestfs-actions.pod:4674 ../src/guestfs-actions.pod:4674 msgid "" "For certain filesystem types, this allows extra filesystem features to be " "selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4676 ../fish/guestfish-actions.pod:3119 +#: ../fish/guestfish-actions.pod:3119 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3119 ../libguestfs-1.11.19/src/guestfs-actions.pod:4678 ../src/guestfs-actions.pod:4678 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4679 ../fish/guestfish-actions.pod:3122 +#: ../fish/guestfish-actions.pod:3122 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3122 ../libguestfs-1.11.19/src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4681 msgid "C<inode>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4681 ../fish/guestfish-actions.pod:3124 +#: ../fish/guestfish-actions.pod:3124 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3124 ../libguestfs-1.11.19/src/guestfs-actions.pod:4683 ../src/guestfs-actions.pod:4683 msgid "" "This passes the I<-I> parameter to the external L<mke2fs(8)> program which " "sets the inode size (only for ext2/3/4 filesystems at present)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4684 ../fish/guestfish-actions.pod:3127 +#: ../fish/guestfish-actions.pod:3127 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3127 ../libguestfs-1.11.19/src/guestfs-actions.pod:4686 ../src/guestfs-actions.pod:4686 msgid "C<sectorsize>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4686 ../fish/guestfish-actions.pod:3129 +#: ../fish/guestfish-actions.pod:3129 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3129 ../libguestfs-1.11.19/src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:4688 msgid "" "This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which " "sets sector size for ufs filesystem." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:4693 -msgid "(Added in 1.7.19)" -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:4695 -msgid "guestfs_mkfs_opts_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4697 -#, no-wrap -msgid "" -" int\n" -" guestfs_mkfs_opts_va (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4703 -msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:4707 -msgid "guestfs_mkfs_opts_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4709 -#, no-wrap -msgid "" -" int\n" -" guestfs_mkfs_opts_argv (guestfs_h *g,\n" -" const char *fstype,\n" -" const char *device,\n" -" const struct guestfs_mkfs_opts_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4715 -msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:4719 -msgid "guestfs_mkmountpoint" +#: ../fish/guestfish-actions.pod:3136 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3136 +msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4721 +#: ../fish/guestfish-actions.pod:3138 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3138 #, no-wrap msgid "" -" int\n" -" guestfs_mkmountpoint (guestfs_h *g,\n" -" const char *exemptpath);\n" +" mkmountpoint exemptpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4725 +#: ../fish/guestfish-actions.pod:3140 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3140 msgid "" -"C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " -"that can be used to create extra mountpoints before mounting the first " -"filesystem." +"L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used " +"to create extra mountpoints before mounting the first filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4729 ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3144 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3144 ../libguestfs-1.11.19/src/guestfs-actions.pod:4731 ../src/guestfs-actions.pod:4731 msgid "" "These calls are I<only> necessary in some very limited circumstances, mainly " "the case where you want to mount a mix of unrelated and/or read-only " @@ -13723,7 +10342,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4733 ../fish/guestfish-actions.pod:3148 +#: ../fish/guestfish-actions.pod:3148 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3148 ../libguestfs-1.11.19/src/guestfs-actions.pod:4735 ../src/guestfs-actions.pod:4735 msgid "" "For example, live CDs often contain a \"Russian doll\" nest of filesystems, " "an ISO outer layer, with a squashfs image inside, with an ext2/3 image " @@ -13731,7 +10350,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4738 ../fish/guestfish-actions.pod:3153 +#: ../fish/guestfish-actions.pod:3153 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3153 ../libguestfs-1.11.19/src/guestfs-actions.pod:4740 ../src/guestfs-actions.pod:4740 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -13746,72 +10365,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4747 ../fish/guestfish-actions.pod:3162 +#: ../fish/guestfish-actions.pod:3162 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3162 ../libguestfs-1.11.19/src/guestfs-actions.pod:4749 ../src/guestfs-actions.pod:4749 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4749 +#: ../fish/guestfish-actions.pod:3164 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3164 msgid "" -"C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You " -"may get unexpected errors if you try to mix these calls. It is safest to " -"manually unmount filesystems and remove mountpoints after use." +"L</mkmountpoint> is not compatible with L</umount-all>. You may get " +"unexpected errors if you try to mix these calls. It is safest to manually " +"unmount filesystems and remove mountpoints after use." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4753 +#: ../fish/guestfish-actions.pod:3168 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3168 msgid "" -"C<guestfs_umount_all> unmounts filesystems by sorting the paths longest " -"first, so for this to work for manual mountpoints, you must ensure that the " -"innermost mountpoints have the longest pathnames, as in the example code " -"above." +"L</umount-all> unmounts filesystems by sorting the paths longest first, so " +"for this to work for manual mountpoints, you must ensure that the innermost " +"mountpoints have the longest pathnames, as in the example code above." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4758 ../fish/guestfish-actions.pod:3173 +#: ../fish/guestfish-actions.pod:3173 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3173 ../libguestfs-1.11.19/src/guestfs-actions.pod:4760 ../src/guestfs-actions.pod:4760 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4760 +#: ../fish/guestfish-actions.pod:3175 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3175 msgid "" -"Autosync [see C<guestfs_set_autosync>, this is set by default on handles] " -"can cause C<guestfs_umount_all> to be called when the handle is closed which " -"can also trigger these issues." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:5082 ../src/guestfs-actions.pod:6086 -msgid "(Added in 1.0.62)" +"Autosync [see L</set-autosync>, this is set by default on handles] can cause " +"L</umount-all> to be called when the handle is closed which can also trigger " +"these issues." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4768 -msgid "guestfs_mknod" +#: ../fish/guestfish-actions.pod:3179 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3179 +msgid "mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4770 +#: ../fish/guestfish-actions.pod:3181 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3181 #, no-wrap msgid "" -" int\n" -" guestfs_mknod (guestfs_h *g,\n" -" int mode,\n" -" int devmajor,\n" -" int devminor,\n" -" const char *path);\n" +" mknod mode devmajor devminor path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4777 ../fish/guestfish-actions.pod:3183 +#: ../fish/guestfish-actions.pod:3183 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3183 ../libguestfs-1.11.19/src/guestfs-actions.pod:4779 ../src/guestfs-actions.pod:4779 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4780 ../fish/guestfish-actions.pod:3186 +#: ../fish/guestfish-actions.pod:3186 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3186 ../libguestfs-1.11.19/src/guestfs-actions.pod:4782 ../src/guestfs-actions.pod:4782 msgid "" "The C<mode> parameter should be the mode, using the standard constants. " "C<devmajor> and C<devminor> are the device major and minor numbers, only " @@ -13819,111 +10427,96 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4785 +#: ../fish/guestfish-actions.pod:3191 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3191 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " "regular file). These constants are available in the standard Linux header " -"files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or " -"C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in " -"the appropriate constant for you." +"files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are " +"wrappers around this command which bitwise OR in the appropriate constant " +"for you." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4799 -msgid "guestfs_mknod_b" +#: ../fish/guestfish-actions.pod:3201 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3201 +msgid "mknod-b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4801 +#: ../fish/guestfish-actions.pod:3203 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3203 #, no-wrap msgid "" -" int\n" -" guestfs_mknod_b (guestfs_h *g,\n" -" int mode,\n" -" int devmajor,\n" -" int devminor,\n" -" const char *path);\n" +" mknod-b mode devmajor devminor path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4808 +#: ../fish/guestfish-actions.pod:3205 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3205 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " -"wrapper around C<guestfs_mknod>." +"wrapper around L</mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4818 -msgid "guestfs_mknod_c" +#: ../fish/guestfish-actions.pod:3211 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3211 +msgid "mknod-c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4820 +#: ../fish/guestfish-actions.pod:3213 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3213 #, no-wrap msgid "" -" int\n" -" guestfs_mknod_c (guestfs_h *g,\n" -" int mode,\n" -" int devmajor,\n" -" int devminor,\n" -" const char *path);\n" +" mknod-c mode devmajor devminor path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4827 +#: ../fish/guestfish-actions.pod:3215 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3215 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " -"wrapper around C<guestfs_mknod>." +"wrapper around L</mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4837 -msgid "guestfs_mkswap" +#: ../fish/guestfish-actions.pod:3221 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3221 +msgid "mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4839 +#: ../fish/guestfish-actions.pod:3223 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3223 #, no-wrap msgid "" -" int\n" -" guestfs_mkswap (guestfs_h *g,\n" -" const char *device);\n" +" mkswap device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4843 ../fish/guestfish-actions.pod:3225 +#: ../fish/guestfish-actions.pod:3225 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3225 ../libguestfs-1.11.19/src/guestfs-actions.pod:4845 ../src/guestfs-actions.pod:4845 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4849 -msgid "guestfs_mkswap_L" +#: ../fish/guestfish-actions.pod:3227 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3227 +msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4851 +#: ../fish/guestfish-actions.pod:3229 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3229 #, no-wrap msgid "" -" int\n" -" guestfs_mkswap_L (guestfs_h *g,\n" -" const char *label,\n" -" const char *device);\n" +" mkswap-L label device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4856 ../fish/guestfish-actions.pod:3231 +#: ../fish/guestfish-actions.pod:3231 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3231 ../libguestfs-1.11.19/src/guestfs-actions.pod:4858 ../src/guestfs-actions.pod:4858 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4858 ../fish/guestfish-actions.pod:3233 +#: ../fish/guestfish-actions.pod:3233 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3233 ../libguestfs-1.11.19/src/guestfs-actions.pod:4860 ../src/guestfs-actions.pod:4860 msgid "" "Note that you cannot attach a swap label to a block device " "(eg. C</dev/sda>), just to a partition. This appears to be a limitation of " @@ -13931,98 +10524,88 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4866 -msgid "guestfs_mkswap_U" +#: ../fish/guestfish-actions.pod:3237 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3237 +msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4868 +#: ../fish/guestfish-actions.pod:3239 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3239 #, no-wrap msgid "" -" int\n" -" guestfs_mkswap_U (guestfs_h *g,\n" -" const char *uuid,\n" -" const char *device);\n" +" mkswap-U uuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4873 ../fish/guestfish-actions.pod:3241 +#: ../fish/guestfish-actions.pod:3241 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3241 ../libguestfs-1.11.19/src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:4875 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4879 -msgid "guestfs_mkswap_file" +#: ../fish/guestfish-actions.pod:3243 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3243 +msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4881 +#: ../fish/guestfish-actions.pod:3245 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3245 #, no-wrap msgid "" -" int\n" -" guestfs_mkswap_file (guestfs_h *g,\n" -" const char *path);\n" +" mkswap-file path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4885 ../fish/guestfish-actions.pod:3247 +#: ../fish/guestfish-actions.pod:3247 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3247 ../libguestfs-1.11.19/src/guestfs-actions.pod:4887 ../src/guestfs-actions.pod:4887 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4887 +#: ../fish/guestfish-actions.pod:3249 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3249 msgid "" "This command just writes a swap file signature to an existing file. To " -"create the file itself, use something like C<guestfs_fallocate>." +"create the file itself, use something like L</fallocate>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4894 -msgid "guestfs_modprobe" +#: ../fish/guestfish-actions.pod:3252 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3252 +msgid "modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4896 +#: ../fish/guestfish-actions.pod:3254 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3254 #, no-wrap msgid "" -" int\n" -" guestfs_modprobe (guestfs_h *g,\n" -" const char *modulename);\n" +" modprobe modulename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4900 ../fish/guestfish-actions.pod:3256 +#: ../fish/guestfish-actions.pod:3256 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3256 ../libguestfs-1.11.19/src/guestfs-actions.pod:4902 ../src/guestfs-actions.pod:4902 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4902 ../fish/guestfish-actions.pod:3258 +#: ../fish/guestfish-actions.pod:3258 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3258 ../libguestfs-1.11.19/src/guestfs-actions.pod:4904 ../src/guestfs-actions.pod:4904 msgid "" "The kernel module must have been whitelisted when libguestfs was built (see " "C<appliance/kmod.whitelist.in> in the source)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4909 -msgid "guestfs_mount" +#: ../fish/guestfish-actions.pod:3261 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3261 +msgid "mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4911 +#: ../fish/guestfish-actions.pod:3263 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3263 #, no-wrap msgid "" -" int\n" -" guestfs_mount (guestfs_h *g,\n" -" const char *device,\n" -" const char *mountpoint);\n" +" mount device mountpoint\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4916 ../fish/guestfish-actions.pod:3265 +#: ../fish/guestfish-actions.pod:3265 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3265 ../libguestfs-1.11.19/src/guestfs-actions.pod:4918 ../src/guestfs-actions.pod:4918 msgid "" "Mount a guest disk at a position in the filesystem. Block devices are named " "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest. If " @@ -14031,7 +10614,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4922 ../fish/guestfish-actions.pod:3271 +#: ../fish/guestfish-actions.pod:3271 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3271 ../libguestfs-1.11.19/src/guestfs-actions.pod:4924 ../src/guestfs-actions.pod:4924 msgid "" "The rules are the same as for L<mount(2)>: A filesystem must first be " "mounted on C</> before others can be mounted. Other filesystems can only be " @@ -14039,65 +10622,53 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4927 ../fish/guestfish-actions.pod:3276 +#: ../fish/guestfish-actions.pod:3276 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3276 ../libguestfs-1.11.19/src/guestfs-actions.pod:4929 ../src/guestfs-actions.pod:4929 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4930 +#: ../fish/guestfish-actions.pod:3279 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3279 msgid "" "B<Important note:> When you use this call, the filesystem options C<sync> " "and C<noatime> are set implicitly. This was originally done because we " "thought it would improve reliability, but it turns out that I<-o sync> has a " "very large negative performance impact and negligible effect on " -"reliability. Therefore we recommend that you avoid using C<guestfs_mount> " -"in any code that needs performance, and instead use C<guestfs_mount_options> " -"(use an empty string for the first parameter if you don't want any options)." +"reliability. Therefore we recommend that you avoid using L</mount> in any " +"code that needs performance, and instead use L</mount-options> (use an empty " +"string for the first parameter if you don't want any options)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4942 ../fish/guestfish-actions.pod:3289 +#: ../fish/guestfish-actions.pod:3289 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3289 ../libguestfs-1.11.19/src/guestfs-actions.pod:4944 ../src/guestfs-actions.pod:4944 msgid "" "This function is deprecated. In new code, use the C<mount_options> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4951 -msgid "guestfs_mount_9p" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4953 -#, no-wrap -msgid "" -" int\n" -" guestfs_mount_9p (guestfs_h *g,\n" -" const char *mounttag,\n" -" const char *mountpoint,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:3296 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3296 +msgid "mount-9p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4964 +#: ../fish/guestfish-actions.pod:3298 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3298 #, no-wrap msgid "" -" GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" +" mount-9p mounttag mountpoint [options:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4966 ../fish/guestfish-actions.pod:3300 +#: ../fish/guestfish-actions.pod:3300 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3300 ../libguestfs-1.11.19/src/guestfs-actions.pod:4968 ../src/guestfs-actions.pod:4968 msgid "" "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory " "C<mountpoint>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4969 ../fish/guestfish-actions.pod:3303 +#: ../fish/guestfish-actions.pod:3303 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3303 ../libguestfs-1.11.19/src/guestfs-actions.pod:4971 ../src/guestfs-actions.pod:4971 msgid "" "If required, C<trans=virtio> will be automatically added to the options. " "Any other options required can be passed in the optional C<options> " @@ -14105,67 +10676,20 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4977 -msgid "guestfs_mount_9p_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4979 -#, no-wrap -msgid "" -" int\n" -" guestfs_mount_9p_va (guestfs_h *g,\n" -" const char *mounttag,\n" -" const char *mountpoint,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4985 -msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:4989 -msgid "guestfs_mount_9p_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:4991 -#, no-wrap -msgid "" -" int\n" -" guestfs_mount_9p_argv (guestfs_h *g,\n" -" const char *mounttag,\n" -" const char *mountpoint,\n" -" const struct guestfs_mount_9p_argv *optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:4997 -msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:5001 -msgid "guestfs_mount_loop" +#: ../fish/guestfish-actions.pod:3309 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3309 +msgid "mount-loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5003 +#: ../fish/guestfish-actions.pod:3311 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3311 #, no-wrap msgid "" -" int\n" -" guestfs_mount_loop (guestfs_h *g,\n" -" const char *file,\n" -" const char *mountpoint);\n" +" mount-loop file mountpoint\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5008 ../fish/guestfish-actions.pod:3313 +#: ../fish/guestfish-actions.pod:3313 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3313 ../libguestfs-1.11.19/src/guestfs-actions.pod:5010 ../src/guestfs-actions.pod:5010 msgid "" "This command lets you mount C<file> (a filesystem image in a file) on a " "mount point. It is entirely equivalent to the command C<mount -o loop file " @@ -14173,184 +10697,158 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5016 -msgid "guestfs_mount_options" +#: ../fish/guestfish-actions.pod:3317 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3317 +msgid "mount-options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5018 +#: ../fish/guestfish-actions.pod:3319 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3319 #, no-wrap msgid "" -" int\n" -" guestfs_mount_options (guestfs_h *g,\n" -" const char *options,\n" -" const char *device,\n" -" const char *mountpoint);\n" +" mount-options options device mountpoint\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5024 +#: ../fish/guestfish-actions.pod:3321 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3321 msgid "" -"This is the same as the C<guestfs_mount> command, but it allows you to set " -"the mount options as for the L<mount(8)> I<-o> flag." +"This is the same as the L</mount> command, but it allows you to set the " +"mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5028 ../fish/guestfish-actions.pod:3325 +#: ../fish/guestfish-actions.pod:3325 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3325 ../libguestfs-1.11.19/src/guestfs-actions.pod:5030 ../src/guestfs-actions.pod:5030 msgid "" "If the C<options> parameter is an empty string, then no options are passed " "(all options default to whatever the filesystem uses)." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5065 -msgid "(Added in 1.0.10)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:5036 -msgid "guestfs_mount_ro" +#: ../fish/guestfish-actions.pod:3329 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3329 +msgid "mount-ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5038 +#: ../fish/guestfish-actions.pod:3331 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3331 #, no-wrap msgid "" -" int\n" -" guestfs_mount_ro (guestfs_h *g,\n" -" const char *device,\n" -" const char *mountpoint);\n" +" mount-ro device mountpoint\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5043 +#: ../fish/guestfish-actions.pod:3333 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3333 msgid "" -"This is the same as the C<guestfs_mount> command, but it mounts the " -"filesystem with the read-only (I<-o ro>) flag." +"This is the same as the L</mount> command, but it mounts the filesystem with " +"the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5050 -msgid "guestfs_mount_vfs" +#: ../fish/guestfish-actions.pod:3336 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3336 +msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5052 +#: ../fish/guestfish-actions.pod:3338 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3338 #, no-wrap msgid "" -" int\n" -" guestfs_mount_vfs (guestfs_h *g,\n" -" const char *options,\n" -" const char *vfstype,\n" -" const char *device,\n" -" const char *mountpoint);\n" +" mount-vfs options vfstype device mountpoint\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5059 +#: ../fish/guestfish-actions.pod:3340 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3340 msgid "" -"This is the same as the C<guestfs_mount> command, but it allows you to set " -"both the mount options and the vfstype as for the L<mount(8)> I<-o> and " -"I<-t> flags." +"This is the same as the L</mount> command, but it allows you to set both the " +"mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5067 -msgid "guestfs_mountpoints" +#: ../fish/guestfish-actions.pod:3344 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3344 +msgid "mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5069 +#: ../fish/guestfish-actions.pod:3346 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3346 #, no-wrap msgid "" -" char **\n" -" guestfs_mountpoints (guestfs_h *g);\n" +" mountpoints\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5072 +#: ../fish/guestfish-actions.pod:3348 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3348 msgid "" -"This call is similar to C<guestfs_mounts>. That call returns a list of " -"devices. This one returns a hash table (map) of device name to directory " -"where the device is mounted." +"This call is similar to L</mounts>. That call returns a list of devices. " +"This one returns a hash table (map) of device name to directory where the " +"device is mounted." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5084 -msgid "guestfs_mounts" +#: ../fish/guestfish-actions.pod:3352 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3352 +msgid "mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5086 +#: ../fish/guestfish-actions.pod:3354 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3354 #, no-wrap msgid "" -" char **\n" -" guestfs_mounts (guestfs_h *g);\n" +" mounts\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5089 ../fish/guestfish-actions.pod:3356 +#: ../fish/guestfish-actions.pod:3356 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3356 ../libguestfs-1.11.19/src/guestfs-actions.pod:5091 ../src/guestfs-actions.pod:5091 msgid "" "This returns the list of currently mounted filesystems. It returns the list " "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5092 ../fish/guestfish-actions.pod:3359 +#: ../fish/guestfish-actions.pod:3359 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3359 ../libguestfs-1.11.19/src/guestfs-actions.pod:5094 ../src/guestfs-actions.pod:5094 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5094 -msgid "See also: C<guestfs_mountpoints>" +#: ../fish/guestfish-actions.pod:3361 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3361 +msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5102 -msgid "guestfs_mv" +#: ../fish/guestfish-actions.pod:3363 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3363 +msgid "mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5104 +#: ../fish/guestfish-actions.pod:3365 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3365 #, no-wrap msgid "" -" int\n" -" guestfs_mv (guestfs_h *g,\n" -" const char *src,\n" -" const char *dest);\n" +" mv src dest\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5109 ../fish/guestfish-actions.pod:3367 +#: ../fish/guestfish-actions.pod:3367 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3367 ../libguestfs-1.11.19/src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5111 msgid "" "This moves a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5116 -msgid "guestfs_ntfs_3g_probe" +#: ../fish/guestfish-actions.pod:3370 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3370 +msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5118 +#: ../fish/guestfish-actions.pod:3372 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3372 #, no-wrap msgid "" -" int\n" -" guestfs_ntfs_3g_probe (guestfs_h *g,\n" -" int rw,\n" -" const char *device);\n" +" ntfs-3g-probe true|false device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5123 ../fish/guestfish-actions.pod:3374 +#: ../fish/guestfish-actions.pod:3374 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3374 ../libguestfs-1.11.19/src/guestfs-actions.pod:5125 ../src/guestfs-actions.pod:5125 msgid "" "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS " "C<device> for mountability. (Not all NTFS volumes can be mounted " @@ -14358,7 +10856,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5127 ../fish/guestfish-actions.pod:3378 +#: ../fish/guestfish-actions.pod:3378 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3378 ../libguestfs-1.11.19/src/guestfs-actions.pod:5129 ../src/guestfs-actions.pod:5129 msgid "" "C<rw> is a boolean flag. Set it to true if you want to test if the volume " "can be mounted read-write. Set it to false if you want to test if the " @@ -14366,41 +10864,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5131 ../fish/guestfish-actions.pod:3382 +#: ../fish/guestfish-actions.pod:3382 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3382 ../libguestfs-1.11.19/src/guestfs-actions.pod:5133 ../src/guestfs-actions.pod:5133 msgid "" "The return value is an integer which C<0> if the operation would succeed, or " "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:5137 -msgid "(Added in 1.0.43)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:5139 -msgid "guestfs_ntfsresize" +#: ../fish/guestfish-actions.pod:3386 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3386 +msgid "ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5141 +#: ../fish/guestfish-actions.pod:3388 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3388 #, no-wrap msgid "" -" int\n" -" guestfs_ntfsresize (guestfs_h *g,\n" -" const char *device);\n" +" ntfsresize device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5145 ../src/guestfs-actions.pod:5184 ../fish/guestfish-actions.pod:3390 ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3390 ../fish/guestfish-actions.pod:3414 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3390 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3414 ../libguestfs-1.11.19/src/guestfs-actions.pod:5147 ../libguestfs-1.11.19/src/guestfs-actions.pod:5186 ../src/guestfs-actions.pod:5147 ../src/guestfs-actions.pod:5186 msgid "" "This command resizes an NTFS filesystem, expanding or shrinking it to the " "size of the underlying device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5148 ../fish/guestfish-actions.pod:3393 +#: ../fish/guestfish-actions.pod:3393 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3393 ../libguestfs-1.11.19/src/guestfs-actions.pod:5150 ../src/guestfs-actions.pod:5150 msgid "" "I<Note:> After the resize operation, the filesystem is marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " @@ -14411,170 +10902,101 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5156 ../src/guestfs-actions.pod:5210 ../fish/guestfish-actions.pod:3401 ../fish/guestfish-actions.pod:3440 +#: ../fish/guestfish-actions.pod:3401 ../fish/guestfish-actions.pod:3440 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3401 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3440 ../libguestfs-1.11.19/src/guestfs-actions.pod:5158 ../libguestfs-1.11.19/src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:5158 ../src/guestfs-actions.pod:5212 msgid "See also L<ntfsresize(8)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5160 ../src/guestfs-actions.pod:5250 ../fish/guestfish-actions.pod:3403 ../fish/guestfish-actions.pod:3451 +#: ../fish/guestfish-actions.pod:3403 ../fish/guestfish-actions.pod:3451 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3403 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3451 ../libguestfs-1.11.19/src/guestfs-actions.pod:5162 ../libguestfs-1.11.19/src/guestfs-actions.pod:5252 ../src/guestfs-actions.pod:5162 ../src/guestfs-actions.pod:5252 msgid "" "This function is deprecated. In new code, use the C<ntfsresize_opts> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5169 -msgid "guestfs_ntfsresize_opts" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:5171 -#, no-wrap -msgid "" -" int\n" -" guestfs_ntfsresize_opts (guestfs_h *g,\n" -" const char *device,\n" -" ...);\n" -"\n" +#: ../fish/guestfish-actions.pod:3410 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3410 +msgid "ntfsresize-opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5181 +#: ../fish/guestfish-actions.pod:3412 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3412 #, no-wrap msgid "" -" GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" -" GUESTFS_NTFSRESIZE_OPTS_FORCE, int force,\n" +" ntfsresize-opts device [size:..] [force:..]\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5193 ../fish/guestfish-actions.pod:3423 +#: ../fish/guestfish-actions.pod:3423 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3423 ../libguestfs-1.11.19/src/guestfs-actions.pod:5195 ../src/guestfs-actions.pod:5195 msgid "" "The new size (in bytes) of the filesystem. If omitted, the filesystem is " "resized to fit the container (eg. partition)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5196 ../fish/guestfish-actions.pod:3426 +#: ../fish/guestfish-actions.pod:3426 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3426 ../libguestfs-1.11.19/src/guestfs-actions.pod:5198 ../src/guestfs-actions.pod:5198 msgid "C<force>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5198 ../fish/guestfish-actions.pod:3428 +#: ../fish/guestfish-actions.pod:3428 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3428 ../libguestfs-1.11.19/src/guestfs-actions.pod:5200 ../src/guestfs-actions.pod:5200 msgid "" "If this option is true, then force the resize of the filesystem even if the " "filesystem is marked as requiring a consistency check." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5201 +#: ../fish/guestfish-actions.pod:3431 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3431 msgid "" "After the resize operation, the filesystem is always marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " "this check and clear this condition. If you I<don't> set the C<force> " -"option then it is not possible to call C<guestfs_ntfsresize_opts> multiple " -"times on a single filesystem without booting into Windows between each " -"resize." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:5216 -msgid "guestfs_ntfsresize_opts_va" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:5218 -#, no-wrap -msgid "" -" int\n" -" guestfs_ntfsresize_opts_va (guestfs_h *g,\n" -" const char *device,\n" -" va_list args);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5223 -msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:5227 -msgid "guestfs_ntfsresize_opts_argv" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:5229 -#, no-wrap -msgid "" -" int\n" -" guestfs_ntfsresize_opts_argv (guestfs_h *g,\n" -" const char *device,\n" -" const struct guestfs_ntfsresize_opts_argv " -"*optargs);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5234 -msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." +"option then it is not possible to call L</ntfsresize-opts> multiple times on " +"a single filesystem without booting into Windows between each resize." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5238 -msgid "guestfs_ntfsresize_size" +#: ../fish/guestfish-actions.pod:3444 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3444 +msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5240 +#: ../fish/guestfish-actions.pod:3446 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3446 #, no-wrap msgid "" -" int\n" -" guestfs_ntfsresize_size (guestfs_h *g,\n" -" const char *device,\n" -" int64_t size);\n" +" ntfsresize-size device size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5245 +#: ../fish/guestfish-actions.pod:3448 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3448 msgid "" -"This command is the same as C<guestfs_ntfsresize> except that it allows you " -"to specify the new size (in bytes) explicitly." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5693 ../src/guestfs-actions.pod:5766 ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:7655 -msgid "(Added in 1.3.14)" +"This command is the same as L</ntfsresize> except that it allows you to " +"specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5259 -msgid "guestfs_part_add" +#: ../fish/guestfish-actions.pod:3458 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3458 +msgid "part-add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5261 +#: ../fish/guestfish-actions.pod:3460 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3460 #, no-wrap msgid "" -" int\n" -" guestfs_part_add (guestfs_h *g,\n" -" const char *device,\n" -" const char *prlogex,\n" -" int64_t startsect,\n" -" int64_t endsect);\n" +" part-add device prlogex startsect endsect\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5268 +#: ../fish/guestfish-actions.pod:3462 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3462 msgid "" "This command adds a partition to C<device>. If there is no partition table " -"on the device, call C<guestfs_part_init> first." +"on the device, call L</part-init> first." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5271 ../fish/guestfish-actions.pod:3465 +#: ../fish/guestfish-actions.pod:3465 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3465 ../libguestfs-1.11.19/src/guestfs-actions.pod:5273 ../src/guestfs-actions.pod:5273 msgid "" "The C<prlogex> parameter is the type of partition. Normally you should pass " "C<p> or C<primary> here, but MBR partition tables also support C<l> (or " @@ -14582,7 +11004,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5276 ../fish/guestfish-actions.pod:3470 +#: ../fish/guestfish-actions.pod:3470 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3470 ../libguestfs-1.11.19/src/guestfs-actions.pod:5278 ../src/guestfs-actions.pod:5278 msgid "" "C<startsect> and C<endsect> are the start and end of the partition in " "I<sectors>. C<endsect> may be negative, which means it counts backwards " @@ -14590,183 +11012,160 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5280 +#: ../fish/guestfish-actions.pod:3474 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3474 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " -"C<guestfs_part_disk> to do that." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5323 ../src/guestfs-actions.pod:5376 ../src/guestfs-actions.pod:5454 ../src/guestfs-actions.pod:5492 ../src/guestfs-actions.pod:5511 ../src/guestfs-actions.pod:5551 -msgid "(Added in 1.0.78)" +"L</part-disk> to do that." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5287 -msgid "guestfs_part_del" +#: ../fish/guestfish-actions.pod:3477 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3477 +msgid "part-del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5289 +#: ../fish/guestfish-actions.pod:3479 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3479 #, no-wrap msgid "" -" int\n" -" guestfs_part_del (guestfs_h *g,\n" -" const char *device,\n" -" int partnum);\n" +" part-del device partnum\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5294 ../fish/guestfish-actions.pod:3481 +#: ../fish/guestfish-actions.pod:3481 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3481 ../libguestfs-1.11.19/src/guestfs-actions.pod:5296 ../src/guestfs-actions.pod:5296 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5296 ../fish/guestfish-actions.pod:3483 +#: ../fish/guestfish-actions.pod:3483 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3483 ../libguestfs-1.11.19/src/guestfs-actions.pod:5298 ../src/guestfs-actions.pod:5298 msgid "" "Note that in the case of MBR partitioning, deleting an extended partition " "also deletes any logical partitions it contains." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5304 -msgid "guestfs_part_disk" +#: ../fish/guestfish-actions.pod:3487 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3487 +msgid "part-disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5306 +#: ../fish/guestfish-actions.pod:3489 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3489 #, no-wrap msgid "" -" int\n" -" guestfs_part_disk (guestfs_h *g,\n" -" const char *device,\n" -" const char *parttype);\n" +" part-disk device parttype\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5311 +#: ../fish/guestfish-actions.pod:3491 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3491 msgid "" -"This command is simply a combination of C<guestfs_part_init> followed by " -"C<guestfs_part_add> to create a single primary partition covering the whole " -"disk." +"This command is simply a combination of L</part-init> followed by " +"L</part-add> to create a single primary partition covering the whole disk." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5315 +#: ../fish/guestfish-actions.pod:3495 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3495 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " -"possible values are described in C<guestfs_part_init>." +"possible values are described in L</part-init>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5325 -msgid "guestfs_part_get_bootable" +#: ../fish/guestfish-actions.pod:3501 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3501 +msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5327 +#: ../fish/guestfish-actions.pod:3503 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3503 #, no-wrap msgid "" -" int\n" -" guestfs_part_get_bootable (guestfs_h *g,\n" -" const char *device,\n" -" int partnum);\n" +" part-get-bootable device partnum\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5332 ../fish/guestfish-actions.pod:3505 +#: ../fish/guestfish-actions.pod:3505 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3505 ../libguestfs-1.11.19/src/guestfs-actions.pod:5334 ../src/guestfs-actions.pod:5334 msgid "" "This command returns true if the partition C<partnum> on C<device> has the " "bootable flag set." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5335 -msgid "See also C<guestfs_part_set_bootable>." +#: ../fish/guestfish-actions.pod:3508 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3508 +msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5341 -msgid "guestfs_part_get_mbr_id" +#: ../fish/guestfish-actions.pod:3510 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3510 +msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5343 +#: ../fish/guestfish-actions.pod:3512 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3512 #, no-wrap msgid "" -" int\n" -" guestfs_part_get_mbr_id (guestfs_h *g,\n" -" const char *device,\n" -" int partnum);\n" +" part-get-mbr-id device partnum\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5348 ../fish/guestfish-actions.pod:3514 +#: ../fish/guestfish-actions.pod:3514 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3514 ../libguestfs-1.11.19/src/guestfs-actions.pod:5350 ../src/guestfs-actions.pod:5350 msgid "" "Returns the MBR type byte (also known as the ID byte) from the numbered " "partition C<partnum>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5351 ../src/guestfs-actions.pod:5527 +#: ../fish/guestfish-actions.pod:3517 ../fish/guestfish-actions.pod:3661 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3517 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3661 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " -"C<guestfs_part_get_parttype>)." +"L</part-get-parttype>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5359 -msgid "guestfs_part_get_parttype" +#: ../fish/guestfish-actions.pod:3521 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3521 +msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5361 +#: ../fish/guestfish-actions.pod:3523 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3523 #, no-wrap msgid "" -" char *\n" -" guestfs_part_get_parttype (guestfs_h *g,\n" -" const char *device);\n" +" part-get-parttype device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5365 ../fish/guestfish-actions.pod:3525 +#: ../fish/guestfish-actions.pod:3525 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3525 ../libguestfs-1.11.19/src/guestfs-actions.pod:5367 ../src/guestfs-actions.pod:5367 msgid "" "This command examines the partition table on C<device> and returns the " "partition table type (format) being used." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5368 +#: ../fish/guestfish-actions.pod:3528 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3528 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " -"possible, although unusual. See C<guestfs_part_init> for a full list." +"possible, although unusual. See L</part-init> for a full list." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5378 -msgid "guestfs_part_init" +#: ../fish/guestfish-actions.pod:3533 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3533 +msgid "part-init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5380 +#: ../fish/guestfish-actions.pod:3535 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3535 #, no-wrap msgid "" -" int\n" -" guestfs_part_init (guestfs_h *g,\n" -" const char *device,\n" -" const char *parttype);\n" +" part-init device parttype\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3537 +#: ../fish/guestfish-actions.pod:3537 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3537 ../libguestfs-1.11.19/src/guestfs-actions.pod:5387 ../src/guestfs-actions.pod:5387 msgid "" "This creates an empty partition table on C<device> of one of the partition " "types listed below. Usually C<parttype> should be either C<msdos> or C<gpt> " @@ -14774,29 +11173,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5389 +#: ../fish/guestfish-actions.pod:3541 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3541 msgid "" "Initially there are no partitions. Following this, you should call " -"C<guestfs_part_add> for each partition required." +"L</part-add> for each partition required." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5392 ../fish/guestfish-actions.pod:3544 +#: ../fish/guestfish-actions.pod:3544 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3544 ../libguestfs-1.11.19/src/guestfs-actions.pod:5394 ../src/guestfs-actions.pod:5394 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5396 ../fish/guestfish-actions.pod:3548 -msgid "B<efi> | B<gpt>" +#: ../fish/guestfish-actions.pod:3548 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3548 ../libguestfs-1.11.19/src/guestfs-actions.pod:5398 ../src/guestfs-actions.pod:5398 +msgid "B<efi>" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3550 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3550 ../libguestfs-1.11.19/src/guestfs-actions.pod:5400 ../src/guestfs-actions.pod:5400 +msgid "B<gpt>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5398 ../fish/guestfish-actions.pod:3550 +#: ../fish/guestfish-actions.pod:3552 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3552 ../libguestfs-1.11.19/src/guestfs-actions.pod:5402 ../src/guestfs-actions.pod:5402 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5400 ../fish/guestfish-actions.pod:3552 +#: ../fish/guestfish-actions.pod:3554 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3554 ../libguestfs-1.11.19/src/guestfs-actions.pod:5404 ../src/guestfs-actions.pod:5404 msgid "" "This is recommended for >= 2 TB partitions that will be accessed from Linux " "and Intel-based Mac OS X. It also has limited backwards compatibility with " @@ -14804,12 +11208,17 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5404 ../fish/guestfish-actions.pod:3556 -msgid "B<mbr> | B<msdos>" +#: ../fish/guestfish-actions.pod:3558 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3558 ../libguestfs-1.11.19/src/guestfs-actions.pod:5408 ../src/guestfs-actions.pod:5408 +msgid "B<mbr>" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3560 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3560 ../libguestfs-1.11.19/src/guestfs-actions.pod:5410 ../src/guestfs-actions.pod:5410 +msgid "B<msdos>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5406 ../fish/guestfish-actions.pod:3558 +#: ../fish/guestfish-actions.pod:3562 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3562 ../libguestfs-1.11.19/src/guestfs-actions.pod:5412 ../src/guestfs-actions.pod:5412 msgid "" "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and " "Windows. This partition type will B<only> work for device sizes up to 2 " @@ -14817,193 +11226,184 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5413 ../fish/guestfish-actions.pod:3565 +#: ../fish/guestfish-actions.pod:3569 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3569 ../libguestfs-1.11.19/src/guestfs-actions.pod:5419 ../src/guestfs-actions.pod:5419 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5418 ../fish/guestfish-actions.pod:3570 +#: ../fish/guestfish-actions.pod:3574 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3574 ../libguestfs-1.11.19/src/guestfs-actions.pod:5424 ../src/guestfs-actions.pod:5424 msgid "B<aix>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5420 ../fish/guestfish-actions.pod:3572 +#: ../fish/guestfish-actions.pod:3576 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3576 ../libguestfs-1.11.19/src/guestfs-actions.pod:5426 ../src/guestfs-actions.pod:5426 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5422 ../fish/guestfish-actions.pod:3574 -msgid "B<amiga> | B<rdb>" +#: ../fish/guestfish-actions.pod:3578 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3578 ../libguestfs-1.11.19/src/guestfs-actions.pod:5428 ../src/guestfs-actions.pod:5428 +msgid "B<amiga>" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3580 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3580 ../libguestfs-1.11.19/src/guestfs-actions.pod:5430 ../src/guestfs-actions.pod:5430 +msgid "B<rdb>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5424 ../fish/guestfish-actions.pod:3576 +#: ../fish/guestfish-actions.pod:3582 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3582 ../libguestfs-1.11.19/src/guestfs-actions.pod:5432 ../src/guestfs-actions.pod:5432 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5426 ../fish/guestfish-actions.pod:3578 +#: ../fish/guestfish-actions.pod:3584 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3584 ../libguestfs-1.11.19/src/guestfs-actions.pod:5434 ../src/guestfs-actions.pod:5434 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5428 ../fish/guestfish-actions.pod:3580 +#: ../fish/guestfish-actions.pod:3586 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3586 ../libguestfs-1.11.19/src/guestfs-actions.pod:5436 ../src/guestfs-actions.pod:5436 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5430 ../fish/guestfish-actions.pod:3582 +#: ../fish/guestfish-actions.pod:3588 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3588 ../libguestfs-1.11.19/src/guestfs-actions.pod:5438 ../src/guestfs-actions.pod:5438 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5432 ../fish/guestfish-actions.pod:3584 +#: ../fish/guestfish-actions.pod:3590 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3590 ../libguestfs-1.11.19/src/guestfs-actions.pod:5440 ../src/guestfs-actions.pod:5440 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5434 ../fish/guestfish-actions.pod:3586 +#: ../fish/guestfish-actions.pod:3592 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3592 ../libguestfs-1.11.19/src/guestfs-actions.pod:5442 ../src/guestfs-actions.pod:5442 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5436 ../fish/guestfish-actions.pod:3588 +#: ../fish/guestfish-actions.pod:3594 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3594 ../libguestfs-1.11.19/src/guestfs-actions.pod:5444 ../src/guestfs-actions.pod:5444 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5438 ../fish/guestfish-actions.pod:3590 +#: ../fish/guestfish-actions.pod:3596 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3596 ../libguestfs-1.11.19/src/guestfs-actions.pod:5446 ../src/guestfs-actions.pod:5446 msgid "B<mac>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3592 +#: ../fish/guestfish-actions.pod:3598 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3598 ../libguestfs-1.11.19/src/guestfs-actions.pod:5448 ../src/guestfs-actions.pod:5448 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5442 ../fish/guestfish-actions.pod:3594 +#: ../fish/guestfish-actions.pod:3600 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3600 ../libguestfs-1.11.19/src/guestfs-actions.pod:5450 ../src/guestfs-actions.pod:5450 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5444 ../fish/guestfish-actions.pod:3596 +#: ../fish/guestfish-actions.pod:3602 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3602 ../libguestfs-1.11.19/src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5452 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5446 ../fish/guestfish-actions.pod:3598 +#: ../fish/guestfish-actions.pod:3604 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3604 ../libguestfs-1.11.19/src/guestfs-actions.pod:5454 ../src/guestfs-actions.pod:5454 msgid "B<sun>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5448 ../fish/guestfish-actions.pod:3600 +#: ../fish/guestfish-actions.pod:3606 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3606 ../libguestfs-1.11.19/src/guestfs-actions.pod:5456 ../src/guestfs-actions.pod:5456 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5456 -msgid "guestfs_part_list" +#: ../fish/guestfish-actions.pod:3610 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3610 +msgid "part-list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5458 +#: ../fish/guestfish-actions.pod:3612 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3612 #, no-wrap msgid "" -" struct guestfs_partition_list *\n" -" guestfs_part_list (guestfs_h *g,\n" -" const char *device);\n" +" part-list device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5462 ../fish/guestfish-actions.pod:3608 +#: ../fish/guestfish-actions.pod:3614 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3614 ../libguestfs-1.11.19/src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5470 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5465 ../fish/guestfish-actions.pod:3611 +#: ../fish/guestfish-actions.pod:3617 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3617 ../libguestfs-1.11.19/src/guestfs-actions.pod:5473 ../src/guestfs-actions.pod:5473 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5469 ../fish/guestfish-actions.pod:3615 +#: ../fish/guestfish-actions.pod:3621 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3621 ../libguestfs-1.11.19/src/guestfs-actions.pod:5477 ../src/guestfs-actions.pod:5477 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5471 ../fish/guestfish-actions.pod:3617 +#: ../fish/guestfish-actions.pod:3623 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3623 ../libguestfs-1.11.19/src/guestfs-actions.pod:5479 ../src/guestfs-actions.pod:5479 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5473 ../fish/guestfish-actions.pod:3619 +#: ../fish/guestfish-actions.pod:3625 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3625 ../libguestfs-1.11.19/src/guestfs-actions.pod:5481 ../src/guestfs-actions.pod:5481 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5475 +#: ../fish/guestfish-actions.pod:3627 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3627 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " -"the device's sector size, see C<guestfs_blockdev_getss>." +"the device's sector size, see L</blockdev-getss>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5478 ../fish/guestfish-actions.pod:3624 +#: ../fish/guestfish-actions.pod:3630 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3630 ../libguestfs-1.11.19/src/guestfs-actions.pod:5486 ../src/guestfs-actions.pod:5486 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5480 ../fish/guestfish-actions.pod:3626 +#: ../fish/guestfish-actions.pod:3632 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3632 ../libguestfs-1.11.19/src/guestfs-actions.pod:5488 ../src/guestfs-actions.pod:5488 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5482 ../fish/guestfish-actions.pod:3628 +#: ../fish/guestfish-actions.pod:3634 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3634 ../libguestfs-1.11.19/src/guestfs-actions.pod:5490 ../src/guestfs-actions.pod:5490 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5484 ../fish/guestfish-actions.pod:3630 +#: ../fish/guestfish-actions.pod:3636 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3636 ../libguestfs-1.11.19/src/guestfs-actions.pod:5492 ../src/guestfs-actions.pod:5492 msgid "Size of the partition in bytes." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:5488 -msgid "" -"This function returns a C<struct guestfs_partition_list *>, or NULL if there " -"was an error. I<The caller must call C<guestfs_free_partition_list> after " -"use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:5494 -msgid "guestfs_part_set_bootable" +#: ../fish/guestfish-actions.pod:3640 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3640 +msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5496 +#: ../fish/guestfish-actions.pod:3642 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3642 #, no-wrap msgid "" -" int\n" -" guestfs_part_set_bootable (guestfs_h *g,\n" -" const char *device,\n" -" int partnum,\n" -" int bootable);\n" +" part-set-bootable device partnum true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5502 ../fish/guestfish-actions.pod:3638 +#: ../fish/guestfish-actions.pod:3644 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3644 ../libguestfs-1.11.19/src/guestfs-actions.pod:5510 ../src/guestfs-actions.pod:5510 msgid "" "This sets the bootable flag on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5505 ../fish/guestfish-actions.pod:3641 +#: ../fish/guestfish-actions.pod:3647 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3647 ../libguestfs-1.11.19/src/guestfs-actions.pod:5513 ../src/guestfs-actions.pod:5513 msgid "" "The bootable flag is used by some operating systems (notably Windows) to " "determine which partition to boot from. It is by no means universally " @@ -15011,24 +11411,20 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5513 -msgid "guestfs_part_set_mbr_id" +#: ../fish/guestfish-actions.pod:3651 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3651 +msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5515 +#: ../fish/guestfish-actions.pod:3653 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3653 #, no-wrap msgid "" -" int\n" -" guestfs_part_set_mbr_id (guestfs_h *g,\n" -" const char *device,\n" -" int partnum,\n" -" int idbyte);\n" +" part-set-mbr-id device partnum idbyte\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5521 ../fish/guestfish-actions.pod:3649 +#: ../fish/guestfish-actions.pod:3655 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3655 ../libguestfs-1.11.19/src/guestfs-actions.pod:5529 ../src/guestfs-actions.pod:5529 msgid "" "Sets the MBR type byte (also known as the ID byte) of the numbered partition " "C<partnum> to C<idbyte>. Note that the type bytes quoted in most " @@ -15037,81 +11433,74 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5535 -msgid "guestfs_part_set_name" +#: ../fish/guestfish-actions.pod:3665 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3665 +msgid "part-set-name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5537 +#: ../fish/guestfish-actions.pod:3667 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3667 #, no-wrap msgid "" -" int\n" -" guestfs_part_set_name (guestfs_h *g,\n" -" const char *device,\n" -" int partnum,\n" -" const char *name);\n" +" part-set-name device partnum name\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3663 +#: ../fish/guestfish-actions.pod:3669 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3669 ../libguestfs-1.11.19/src/guestfs-actions.pod:5551 ../src/guestfs-actions.pod:5551 msgid "" "This sets the partition name on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5546 ../fish/guestfish-actions.pod:3666 +#: ../fish/guestfish-actions.pod:3672 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3672 ../libguestfs-1.11.19/src/guestfs-actions.pod:5554 ../src/guestfs-actions.pod:5554 msgid "" "The partition name can only be set on certain types of partition table. " "This works on C<gpt> but not on C<mbr> partitions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5553 -msgid "guestfs_part_to_dev" +#: ../fish/guestfish-actions.pod:3675 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3675 +msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5555 +#: ../fish/guestfish-actions.pod:3677 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3677 #, no-wrap msgid "" -" char *\n" -" guestfs_part_to_dev (guestfs_h *g,\n" -" const char *partition);\n" +" part-to-dev partition\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5559 ../fish/guestfish-actions.pod:3673 +#: ../fish/guestfish-actions.pod:3679 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3679 ../libguestfs-1.11.19/src/guestfs-actions.pod:5567 ../src/guestfs-actions.pod:5567 msgid "" "This function takes a partition name (eg. \"/dev/sdb1\") and removes the " "partition number, returning the device name (eg. \"/dev/sdb\")." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5563 +#: ../fish/guestfish-actions.pod:3683 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3683 msgid "" "The named partition must exist, for example as a string returned from " -"C<guestfs_list_partitions>." +"L</list-partitions>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5571 -msgid "guestfs_ping_daemon" +#: ../fish/guestfish-actions.pod:3686 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3686 +msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5573 +#: ../fish/guestfish-actions.pod:3688 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3688 #, no-wrap msgid "" -" int\n" -" guestfs_ping_daemon (guestfs_h *g);\n" +" ping-daemon\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5576 ../fish/guestfish-actions.pod:3684 +#: ../fish/guestfish-actions.pod:3690 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3690 ../libguestfs-1.11.19/src/guestfs-actions.pod:5584 ../src/guestfs-actions.pod:5584 msgid "" "This is a test probe into the guestfs daemon running inside the qemu " "subprocess. Calling this function checks that the daemon responds to the " @@ -15120,123 +11509,104 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5585 -msgid "guestfs_pread" +#: ../fish/guestfish-actions.pod:3695 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3695 +msgid "pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5587 +#: ../fish/guestfish-actions.pod:3697 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3697 #, no-wrap msgid "" -" char *\n" -" guestfs_pread (guestfs_h *g,\n" -" const char *path,\n" -" int count,\n" -" int64_t offset,\n" -" size_t *size_r);\n" +" pread path count offset\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5594 ../fish/guestfish-actions.pod:3693 +#: ../fish/guestfish-actions.pod:3699 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3699 ../libguestfs-1.11.19/src/guestfs-actions.pod:5602 ../src/guestfs-actions.pod:5602 msgid "" "This command lets you read part of a file. It reads C<count> bytes of the " "file, starting at C<offset>, from file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5597 ../src/guestfs-actions.pod:5623 ../fish/guestfish-actions.pod:3696 ../fish/guestfish-actions.pod:3711 +#: ../fish/guestfish-actions.pod:3702 ../fish/guestfish-actions.pod:3717 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3702 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3717 ../libguestfs-1.11.19/src/guestfs-actions.pod:5605 ../libguestfs-1.11.19/src/guestfs-actions.pod:5631 ../src/guestfs-actions.pod:5605 ../src/guestfs-actions.pod:5631 msgid "" "This may read fewer bytes than requested. For further details see the " "L<pread(2)> system call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5600 -msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." +#: ../fish/guestfish-actions.pod:3705 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3705 +msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5611 -msgid "guestfs_pread_device" +#: ../fish/guestfish-actions.pod:3710 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3710 +msgid "pread-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5613 +#: ../fish/guestfish-actions.pod:3712 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3712 #, no-wrap msgid "" -" char *\n" -" guestfs_pread_device (guestfs_h *g,\n" -" const char *device,\n" -" int count,\n" -" int64_t offset,\n" -" size_t *size_r);\n" +" pread-device device count offset\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5620 ../fish/guestfish-actions.pod:3708 +#: ../fish/guestfish-actions.pod:3714 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3714 ../libguestfs-1.11.19/src/guestfs-actions.pod:5628 ../src/guestfs-actions.pod:5628 msgid "" "This command lets you read part of a file. It reads C<count> bytes of " "C<device>, starting at C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5626 -msgid "See also C<guestfs_pread>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5635 -msgid "(Added in 1.5.21)" +#: ../fish/guestfish-actions.pod:3720 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3720 +msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5637 -msgid "guestfs_pvcreate" +#: ../fish/guestfish-actions.pod:3725 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3725 +msgid "pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5639 +#: ../fish/guestfish-actions.pod:3727 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3727 #, no-wrap msgid "" -" int\n" -" guestfs_pvcreate (guestfs_h *g,\n" -" const char *device);\n" +" pvcreate device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5643 ../fish/guestfish-actions.pod:3723 +#: ../fish/guestfish-actions.pod:3729 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3729 ../libguestfs-1.11.19/src/guestfs-actions.pod:5651 ../src/guestfs-actions.pod:5651 msgid "" "This creates an LVM physical volume on the named C<device>, where C<device> " "should usually be a partition name such as C</dev/sda1>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5651 -msgid "guestfs_pvremove" +#: ../fish/guestfish-actions.pod:3733 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3733 +msgid "pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5653 +#: ../fish/guestfish-actions.pod:3735 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3735 #, no-wrap msgid "" -" int\n" -" guestfs_pvremove (guestfs_h *g,\n" -" const char *device);\n" +" pvremove device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5657 ../fish/guestfish-actions.pod:3731 +#: ../fish/guestfish-actions.pod:3737 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3737 ../libguestfs-1.11.19/src/guestfs-actions.pod:5665 ../src/guestfs-actions.pod:5665 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5660 ../fish/guestfish-actions.pod:3734 +#: ../fish/guestfish-actions.pod:3740 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3740 ../libguestfs-1.11.19/src/guestfs-actions.pod:5668 ../src/guestfs-actions.pod:5668 msgid "" "The implementation uses the C<pvremove> command which refuses to wipe " "physical volumes that contain any volume groups, so you have to remove those " @@ -15244,159 +11614,137 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5668 -msgid "guestfs_pvresize" +#: ../fish/guestfish-actions.pod:3744 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3744 +msgid "pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5670 +#: ../fish/guestfish-actions.pod:3746 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3746 #, no-wrap msgid "" -" int\n" -" guestfs_pvresize (guestfs_h *g,\n" -" const char *device);\n" +" pvresize device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5674 ../fish/guestfish-actions.pod:3742 +#: ../fish/guestfish-actions.pod:3748 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3748 ../libguestfs-1.11.19/src/guestfs-actions.pod:5682 ../src/guestfs-actions.pod:5682 msgid "" "This resizes (expands or shrinks) an existing LVM physical volume to match " "the new size of the underlying device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5681 -msgid "guestfs_pvresize_size" +#: ../fish/guestfish-actions.pod:3751 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3751 +msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5683 +#: ../fish/guestfish-actions.pod:3753 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3753 #, no-wrap msgid "" -" int\n" -" guestfs_pvresize_size (guestfs_h *g,\n" -" const char *device,\n" -" int64_t size);\n" +" pvresize-size device size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5688 +#: ../fish/guestfish-actions.pod:3755 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3755 msgid "" -"This command is the same as C<guestfs_pvresize> except that it allows you to " +"This command is the same as L</pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5695 -msgid "guestfs_pvs" +#: ../fish/guestfish-actions.pod:3758 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3758 +msgid "pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5697 +#: ../fish/guestfish-actions.pod:3760 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3760 #, no-wrap msgid "" -" char **\n" -" guestfs_pvs (guestfs_h *g);\n" +" pvs\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5700 ../fish/guestfish-actions.pod:3756 +#: ../fish/guestfish-actions.pod:3762 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3762 ../libguestfs-1.11.19/src/guestfs-actions.pod:5708 ../src/guestfs-actions.pod:5708 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5703 ../fish/guestfish-actions.pod:3759 +#: ../fish/guestfish-actions.pod:3765 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3765 ../libguestfs-1.11.19/src/guestfs-actions.pod:5711 ../src/guestfs-actions.pod:5711 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5706 -msgid "See also C<guestfs_pvs_full>." +#: ../fish/guestfish-actions.pod:3768 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3768 +msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5714 -msgid "guestfs_pvs_full" +#: ../fish/guestfish-actions.pod:3770 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3770 +msgid "pvs-full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5716 +#: ../fish/guestfish-actions.pod:3772 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3772 #, no-wrap msgid "" -" struct guestfs_lvm_pv_list *\n" -" guestfs_pvs_full (guestfs_h *g);\n" +" pvs-full\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5719 ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3774 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3774 ../libguestfs-1.11.19/src/guestfs-actions.pod:5727 ../src/guestfs-actions.pod:5727 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command. The \"full\" version includes all fields." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:5722 -msgid "" -"This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there " -"was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after " -"use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:5728 -msgid "guestfs_pvuuid" +#: ../fish/guestfish-actions.pod:3777 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3777 +msgid "pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5730 +#: ../fish/guestfish-actions.pod:3779 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3779 #, no-wrap msgid "" -" char *\n" -" guestfs_pvuuid (guestfs_h *g,\n" -" const char *device);\n" +" pvuuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5734 ../fish/guestfish-actions.pod:3775 +#: ../fish/guestfish-actions.pod:3781 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3781 ../libguestfs-1.11.19/src/guestfs-actions.pod:5742 ../src/guestfs-actions.pod:5742 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5741 -msgid "guestfs_pwrite" +#: ../fish/guestfish-actions.pod:3783 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3783 +msgid "pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5743 +#: ../fish/guestfish-actions.pod:3785 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3785 #, no-wrap msgid "" -" int\n" -" guestfs_pwrite (guestfs_h *g,\n" -" const char *path,\n" -" const char *content,\n" -" size_t content_size,\n" -" int64_t offset);\n" +" pwrite path content offset\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5750 ../fish/guestfish-actions.pod:3781 +#: ../fish/guestfish-actions.pod:3787 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3787 ../libguestfs-1.11.19/src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5758 msgid "" "This command writes to part of a file. It writes the data buffer C<content> " "to the file C<path> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5753 ../fish/guestfish-actions.pod:3784 +#: ../fish/guestfish-actions.pod:3790 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3790 ../libguestfs-1.11.19/src/guestfs-actions.pod:5761 ../src/guestfs-actions.pod:5761 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested. The return value is the " @@ -15406,37 +11754,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5759 -msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." +#: ../fish/guestfish-actions.pod:3796 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3796 +msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5768 -msgid "guestfs_pwrite_device" +#: ../fish/guestfish-actions.pod:3801 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3801 +msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5770 +#: ../fish/guestfish-actions.pod:3803 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3803 #, no-wrap msgid "" -" int\n" -" guestfs_pwrite_device (guestfs_h *g,\n" -" const char *device,\n" -" const char *content,\n" -" size_t content_size,\n" -" int64_t offset);\n" +" pwrite-device device content offset\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5777 ../fish/guestfish-actions.pod:3799 +#: ../fish/guestfish-actions.pod:3805 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3805 ../libguestfs-1.11.19/src/guestfs-actions.pod:5785 ../src/guestfs-actions.pod:5785 msgid "" "This command writes to part of a device. It writes the data buffer " "C<content> to C<device> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5780 ../fish/guestfish-actions.pod:3802 +#: ../fish/guestfish-actions.pod:3808 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3808 ../libguestfs-1.11.19/src/guestfs-actions.pod:5788 ../src/guestfs-actions.pod:5788 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested (although short writes to disk " @@ -15444,102 +11787,85 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5785 -msgid "See also C<guestfs_pwrite>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5792 -msgid "(Added in 1.5.20)" +#: ../fish/guestfish-actions.pod:3813 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3813 +msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5794 -msgid "guestfs_read_file" +#: ../fish/guestfish-actions.pod:3818 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3818 +msgid "read-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5796 +#: ../fish/guestfish-actions.pod:3820 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3820 #, no-wrap msgid "" -" char *\n" -" guestfs_read_file (guestfs_h *g,\n" -" const char *path,\n" -" size_t *size_r);\n" +" read-file path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5801 ../fish/guestfish-actions.pod:3816 +#: ../fish/guestfish-actions.pod:3822 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3822 ../libguestfs-1.11.19/src/guestfs-actions.pod:5809 ../src/guestfs-actions.pod:5809 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5804 +#: ../fish/guestfish-actions.pod:3825 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3825 msgid "" -"Unlike C<guestfs_cat>, this function can correctly handle files that contain " -"embedded ASCII NUL characters. However unlike C<guestfs_download>, this " -"function is limited in the total size of file that can be handled." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5816 -msgid "(Added in 1.0.63)" +"Unlike L</cat>, this function can correctly handle files that contain " +"embedded ASCII NUL characters. However unlike L</download>, this function " +"is limited in the total size of file that can be handled." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5818 -msgid "guestfs_read_lines" +#: ../fish/guestfish-actions.pod:3833 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3833 +msgid "read-lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5820 +#: ../fish/guestfish-actions.pod:3835 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3835 #, no-wrap msgid "" -" char **\n" -" guestfs_read_lines (guestfs_h *g,\n" -" const char *path);\n" +" read-lines path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5826 ../fish/guestfish-actions.pod:3833 +#: ../fish/guestfish-actions.pod:3839 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3839 ../libguestfs-1.11.19/src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5834 msgid "" "The file contents are returned as a list of lines. Trailing C<LF> and " "C<CRLF> character sequences are I<not> returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5829 +#: ../fish/guestfish-actions.pod:3842 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3842 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " -"those you need to use the C<guestfs_read_file> function which has a more " -"complex interface." +"those you need to use the L</read-file> function which has a more complex " +"interface." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5840 -msgid "guestfs_readdir" +#: ../fish/guestfish-actions.pod:3847 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3847 +msgid "readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5842 +#: ../fish/guestfish-actions.pod:3849 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3849 #, no-wrap msgid "" -" struct guestfs_dirent_list *\n" -" guestfs_readdir (guestfs_h *g,\n" -" const char *dir);\n" +" readdir dir\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5846 ../fish/guestfish-actions.pod:3845 +#: ../fish/guestfish-actions.pod:3851 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3851 ../libguestfs-1.11.19/src/guestfs-actions.pod:5854 ../src/guestfs-actions.pod:5854 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5848 ../fish/guestfish-actions.pod:3847 +#: ../fish/guestfish-actions.pod:3853 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3853 ../libguestfs-1.11.19/src/guestfs-actions.pod:5856 ../src/guestfs-actions.pod:5856 msgid "" "All entries in the directory are returned, including C<.> and C<..>. The " "entries are I<not> sorted, but returned in the same order as the underlying " @@ -15547,156 +11873,143 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5852 ../fish/guestfish-actions.pod:3851 +#: ../fish/guestfish-actions.pod:3857 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3857 ../libguestfs-1.11.19/src/guestfs-actions.pod:5860 ../src/guestfs-actions.pod:5860 msgid "" "Also this call returns basic file type information about each file. The " "C<ftyp> field will contain one of the following characters:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5857 ../fish/guestfish-actions.pod:3856 +#: ../fish/guestfish-actions.pod:3862 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3862 ../libguestfs-1.11.19/src/guestfs-actions.pod:5865 ../src/guestfs-actions.pod:5865 msgid "'b'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5859 ../fish/guestfish-actions.pod:3858 +#: ../fish/guestfish-actions.pod:3864 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3864 ../libguestfs-1.11.19/src/guestfs-actions.pod:5867 ../src/guestfs-actions.pod:5867 msgid "Block special" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5861 ../fish/guestfish-actions.pod:3860 +#: ../fish/guestfish-actions.pod:3866 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3866 ../libguestfs-1.11.19/src/guestfs-actions.pod:5869 ../src/guestfs-actions.pod:5869 msgid "'c'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5863 ../fish/guestfish-actions.pod:3862 +#: ../fish/guestfish-actions.pod:3868 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3868 ../libguestfs-1.11.19/src/guestfs-actions.pod:5871 ../src/guestfs-actions.pod:5871 msgid "Char special" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5865 ../fish/guestfish-actions.pod:3864 +#: ../fish/guestfish-actions.pod:3870 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3870 ../libguestfs-1.11.19/src/guestfs-actions.pod:5873 ../src/guestfs-actions.pod:5873 msgid "'d'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5867 ../fish/guestfish-actions.pod:3866 +#: ../fish/guestfish-actions.pod:3872 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3872 ../libguestfs-1.11.19/src/guestfs-actions.pod:5875 ../src/guestfs-actions.pod:5875 msgid "Directory" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5869 ../fish/guestfish-actions.pod:3868 +#: ../fish/guestfish-actions.pod:3874 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3874 ../libguestfs-1.11.19/src/guestfs-actions.pod:5877 ../src/guestfs-actions.pod:5877 msgid "'f'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5871 ../fish/guestfish-actions.pod:3870 +#: ../fish/guestfish-actions.pod:3876 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3876 ../libguestfs-1.11.19/src/guestfs-actions.pod:5879 ../src/guestfs-actions.pod:5879 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5873 ../fish/guestfish-actions.pod:3872 +#: ../fish/guestfish-actions.pod:3878 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3878 ../libguestfs-1.11.19/src/guestfs-actions.pod:5881 ../src/guestfs-actions.pod:5881 msgid "'l'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5875 ../fish/guestfish-actions.pod:3874 +#: ../fish/guestfish-actions.pod:3880 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3880 ../libguestfs-1.11.19/src/guestfs-actions.pod:5883 ../src/guestfs-actions.pod:5883 msgid "Symbolic link" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5877 ../fish/guestfish-actions.pod:3876 +#: ../fish/guestfish-actions.pod:3882 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3882 ../libguestfs-1.11.19/src/guestfs-actions.pod:5885 ../src/guestfs-actions.pod:5885 msgid "'r'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5879 ../fish/guestfish-actions.pod:3878 +#: ../fish/guestfish-actions.pod:3884 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3884 ../libguestfs-1.11.19/src/guestfs-actions.pod:5887 ../src/guestfs-actions.pod:5887 msgid "Regular file" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5881 ../fish/guestfish-actions.pod:3880 +#: ../fish/guestfish-actions.pod:3886 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3886 ../libguestfs-1.11.19/src/guestfs-actions.pod:5889 ../src/guestfs-actions.pod:5889 msgid "'s'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5883 ../fish/guestfish-actions.pod:3882 +#: ../fish/guestfish-actions.pod:3888 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3888 ../libguestfs-1.11.19/src/guestfs-actions.pod:5891 ../src/guestfs-actions.pod:5891 msgid "Socket" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5885 ../fish/guestfish-actions.pod:3884 +#: ../fish/guestfish-actions.pod:3890 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3890 ../libguestfs-1.11.19/src/guestfs-actions.pod:5893 ../src/guestfs-actions.pod:5893 msgid "'u'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5887 ../fish/guestfish-actions.pod:3886 +#: ../fish/guestfish-actions.pod:3892 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3892 ../libguestfs-1.11.19/src/guestfs-actions.pod:5895 ../src/guestfs-actions.pod:5895 msgid "Unknown file type" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5889 ../fish/guestfish-actions.pod:3888 +#: ../fish/guestfish-actions.pod:3894 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3894 ../libguestfs-1.11.19/src/guestfs-actions.pod:5897 ../src/guestfs-actions.pod:5897 msgid "'?'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5891 ../fish/guestfish-actions.pod:3890 +#: ../fish/guestfish-actions.pod:3896 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3896 ../libguestfs-1.11.19/src/guestfs-actions.pod:5899 ../src/guestfs-actions.pod:5899 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5896 +#: ../fish/guestfish-actions.pod:3901 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3901 msgid "" "This function is primarily intended for use by programs. To get a simple " -"list of names, use C<guestfs_ls>. To get a printable directory for human " -"consumption, use C<guestfs_ll>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:5900 -msgid "" -"This function returns a C<struct guestfs_dirent_list *>, or NULL if there " -"was an error. I<The caller must call C<guestfs_free_dirent_list> after " -"use>." +"list of names, use L</ls>. To get a printable directory for human " +"consumption, use L</ll>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5906 -msgid "guestfs_readlink" +#: ../fish/guestfish-actions.pod:3905 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3905 +msgid "readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5908 +#: ../fish/guestfish-actions.pod:3907 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3907 #, no-wrap msgid "" -" char *\n" -" guestfs_readlink (guestfs_h *g,\n" -" const char *path);\n" +" readlink path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5912 ../fish/guestfish-actions.pod:3903 +#: ../fish/guestfish-actions.pod:3909 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3909 ../libguestfs-1.11.19/src/guestfs-actions.pod:5920 ../src/guestfs-actions.pod:5920 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5919 -msgid "guestfs_readlinklist" +#: ../fish/guestfish-actions.pod:3911 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3911 +msgid "readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5921 +#: ../fish/guestfish-actions.pod:3913 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3913 #, no-wrap msgid "" -" char **\n" -" guestfs_readlinklist (guestfs_h *g,\n" -" const char *path,\n" -" char *const *names);\n" +" readlinklist path 'names ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5926 ../fish/guestfish-actions.pod:3909 +#: ../fish/guestfish-actions.pod:3915 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3915 ../libguestfs-1.11.19/src/guestfs-actions.pod:5934 ../src/guestfs-actions.pod:5934 msgid "" "This call allows you to do a C<readlink> operation on multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -15704,14 +12017,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5930 ../fish/guestfish-actions.pod:3913 +#: ../fish/guestfish-actions.pod:3919 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3919 ../libguestfs-1.11.19/src/guestfs-actions.pod:5938 ../src/guestfs-actions.pod:5938 msgid "" "On return you get a list of strings, with a one-to-one correspondence to the " "C<names> list. Each string is the value of the symbolic link." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5934 ../fish/guestfish-actions.pod:3917 +#: ../fish/guestfish-actions.pod:3923 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3923 ../libguestfs-1.11.19/src/guestfs-actions.pod:5942 ../src/guestfs-actions.pod:5942 msgid "" "If the C<readlink(2)> operation fails on any name, then the corresponding " "result string is the empty string C<\"\">. However the whole operation is " @@ -15721,7 +12034,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5941 ../fish/guestfish-actions.pod:3924 +#: ../fish/guestfish-actions.pod:3930 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3930 ../libguestfs-1.11.19/src/guestfs-actions.pod:5949 ../src/guestfs-actions.pod:5949 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -15730,385 +12043,365 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5954 -msgid "guestfs_realpath" +#: ../fish/guestfish-actions.pod:3937 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3937 +msgid "realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5956 +#: ../fish/guestfish-actions.pod:3939 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3939 #, no-wrap msgid "" -" char *\n" -" guestfs_realpath (guestfs_h *g,\n" -" const char *path);\n" +" realpath path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5960 ../fish/guestfish-actions.pod:3935 +#: ../fish/guestfish-actions.pod:3941 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3941 ../libguestfs-1.11.19/src/guestfs-actions.pod:5968 ../src/guestfs-actions.pod:5968 msgid "" "Return the canonicalized absolute pathname of C<path>. The returned path " "has no C<.>, C<..> or symbolic link path elements." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5968 -msgid "guestfs_removexattr" +#: ../fish/guestfish-actions.pod:3944 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3944 +msgid "removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5970 +#: ../fish/guestfish-actions.pod:3946 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3946 #, no-wrap msgid "" -" int\n" -" guestfs_removexattr (guestfs_h *g,\n" -" const char *xattr,\n" -" const char *path);\n" +" removexattr xattr path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5975 ../fish/guestfish-actions.pod:3942 +#: ../fish/guestfish-actions.pod:3948 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3948 ../libguestfs-1.11.19/src/guestfs-actions.pod:5983 ../src/guestfs-actions.pod:5983 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5978 -msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." +#: ../fish/guestfish-actions.pod:3951 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3951 +msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5984 -msgid "guestfs_resize2fs" +#: ../fish/guestfish-actions.pod:3953 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3953 +msgid "resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5986 +#: ../fish/guestfish-actions.pod:3955 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3955 #, no-wrap msgid "" -" int\n" -" guestfs_resize2fs (guestfs_h *g,\n" -" const char *device);\n" +" resize2fs device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5990 ../fish/guestfish-actions.pod:3951 +#: ../fish/guestfish-actions.pod:3957 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3957 ../libguestfs-1.11.19/src/guestfs-actions.pod:5998 ../src/guestfs-actions.pod:5998 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5993 +#: ../fish/guestfish-actions.pod:3960 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3960 msgid "" -"I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the " -"C<device> before calling this command. For unknown reasons C<resize2fs> " -"sometimes gives an error about this and sometimes not. In any case, it is " -"always safe to call C<guestfs_e2fsck_f> before calling this function." +"I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> " +"before calling this command. For unknown reasons C<resize2fs> sometimes " +"gives an error about this and sometimes not. In any case, it is always safe " +"to call L</e2fsck-f> before calling this function." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6003 -msgid "guestfs_resize2fs_M" +#: ../fish/guestfish-actions.pod:3966 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3966 +msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6005 +#: ../fish/guestfish-actions.pod:3968 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3968 #, no-wrap msgid "" -" int\n" -" guestfs_resize2fs_M (guestfs_h *g,\n" -" const char *device);\n" +" resize2fs-M device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6009 +#: ../fish/guestfish-actions.pod:3970 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3970 msgid "" -"This command is the same as C<guestfs_resize2fs>, but the filesystem is " -"resized to its minimum size. This works like the I<-M> option to the " -"C<resize2fs> command." +"This command is the same as L</resize2fs>, but the filesystem is resized to " +"its minimum size. This works like the I<-M> option to the C<resize2fs> " +"command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6013 +#: ../fish/guestfish-actions.pod:3974 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3974 msgid "" -"To get the resulting size of the filesystem you should call " -"C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. " -"These two numbers, multiplied together, give the resulting size of the " -"minimal filesystem in bytes." +"To get the resulting size of the filesystem you should call L</tune2fs-l> " +"and read the C<Block size> and C<Block count> values. These two numbers, " +"multiplied together, give the resulting size of the minimal filesystem in " +"bytes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6022 -msgid "guestfs_resize2fs_size" +#: ../fish/guestfish-actions.pod:3979 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3979 +msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6024 +#: ../fish/guestfish-actions.pod:3981 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3981 #, no-wrap msgid "" -" int\n" -" guestfs_resize2fs_size (guestfs_h *g,\n" -" const char *device,\n" -" int64_t size);\n" +" resize2fs-size device size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6029 +#: ../fish/guestfish-actions.pod:3983 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3983 msgid "" -"This command is the same as C<guestfs_resize2fs> except that it allows you " -"to specify the new size (in bytes) explicitly." +"This command is the same as L</resize2fs> except that it allows you to " +"specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6036 -msgid "guestfs_rm" +#: ../fish/guestfish-actions.pod:3986 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3986 +msgid "rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6038 +#: ../fish/guestfish-actions.pod:3988 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3988 #, no-wrap msgid "" -" int\n" -" guestfs_rm (guestfs_h *g,\n" -" const char *path);\n" +" rm path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6042 ../fish/guestfish-actions.pod:3984 +#: ../fish/guestfish-actions.pod:3990 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3990 ../libguestfs-1.11.19/src/guestfs-actions.pod:6050 ../src/guestfs-actions.pod:6050 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6048 -msgid "guestfs_rm_rf" +#: ../fish/guestfish-actions.pod:3992 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3992 +msgid "rm-rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6050 +#: ../fish/guestfish-actions.pod:3994 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3994 #, no-wrap msgid "" -" int\n" -" guestfs_rm_rf (guestfs_h *g,\n" -" const char *path);\n" +" rm-rf path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6054 ../fish/guestfish-actions.pod:3990 +#: ../fish/guestfish-actions.pod:3996 ../libguestfs-1.11.19/fish/guestfish-actions.pod:3996 ../libguestfs-1.11.19/src/guestfs-actions.pod:6062 ../src/guestfs-actions.pod:6062 msgid "" "Remove the file or directory C<path>, recursively removing the contents if " "its a directory. This is like the C<rm -rf> shell command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6062 -msgid "guestfs_rmdir" +#: ../fish/guestfish-actions.pod:4000 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4000 +msgid "rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6064 +#: ../fish/guestfish-actions.pod:4002 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4002 #, no-wrap msgid "" -" int\n" -" guestfs_rmdir (guestfs_h *g,\n" -" const char *path);\n" +" rmdir path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6068 ../fish/guestfish-actions.pod:3998 +#: ../fish/guestfish-actions.pod:4004 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4004 ../libguestfs-1.11.19/src/guestfs-actions.pod:6076 ../src/guestfs-actions.pod:6076 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6074 -msgid "guestfs_rmmountpoint" +#: ../fish/guestfish-actions.pod:4006 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4006 +msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6076 +#: ../fish/guestfish-actions.pod:4008 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4008 #, no-wrap msgid "" -" int\n" -" guestfs_rmmountpoint (guestfs_h *g,\n" -" const char *exemptpath);\n" +" rmmountpoint exemptpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6080 +#: ../fish/guestfish-actions.pod:4010 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4010 msgid "" "This calls removes a mountpoint that was previously created with " -"C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." +"L</mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6088 -msgid "guestfs_scrub_device" +#: ../fish/guestfish-actions.pod:4014 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4014 +msgid "scrub-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6090 +#: ../fish/guestfish-actions.pod:4016 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4016 #, no-wrap msgid "" -" int\n" -" guestfs_scrub_device (guestfs_h *g,\n" -" const char *device);\n" +" scrub-device device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6094 ../fish/guestfish-actions.pod:4012 +#: ../fish/guestfish-actions.pod:4018 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4018 ../libguestfs-1.11.19/src/guestfs-actions.pod:6102 ../src/guestfs-actions.pod:6102 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6097 ../src/guestfs-actions.pod:6118 ../src/guestfs-actions.pod:6137 ../fish/guestfish-actions.pod:4015 ../fish/guestfish-actions.pod:4030 ../fish/guestfish-actions.pod:4043 +#: ../fish/guestfish-actions.pod:4021 ../fish/guestfish-actions.pod:4036 ../fish/guestfish-actions.pod:4049 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4021 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4036 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4049 ../libguestfs-1.11.19/src/guestfs-actions.pod:6105 ../libguestfs-1.11.19/src/guestfs-actions.pod:6126 ../libguestfs-1.11.19/src/guestfs-actions.pod:6145 ../src/guestfs-actions.pod:6105 ../src/guestfs-actions.pod:6126 ../src/guestfs-actions.pod:6145 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6105 ../src/guestfs-actions.pod:6123 ../src/guestfs-actions.pod:6142 -msgid "(Added in 1.0.52)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:6107 -msgid "guestfs_scrub_file" +#: ../fish/guestfish-actions.pod:4027 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4027 +msgid "scrub-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6109 +#: ../fish/guestfish-actions.pod:4029 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4029 #, no-wrap msgid "" -" int\n" -" guestfs_scrub_file (guestfs_h *g,\n" -" const char *file);\n" +" scrub-file file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6113 ../fish/guestfish-actions.pod:4025 +#: ../fish/guestfish-actions.pod:4031 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4031 ../libguestfs-1.11.19/src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6121 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6116 ../fish/guestfish-actions.pod:4028 +#: ../fish/guestfish-actions.pod:4034 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4034 ../libguestfs-1.11.19/src/guestfs-actions.pod:6124 ../src/guestfs-actions.pod:6124 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6125 -msgid "guestfs_scrub_freespace" +#: ../fish/guestfish-actions.pod:4039 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4039 +msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6127 +#: ../fish/guestfish-actions.pod:4041 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4041 #, no-wrap msgid "" -" int\n" -" guestfs_scrub_freespace (guestfs_h *g,\n" -" const char *dir);\n" +" scrub-freespace dir\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6131 +#: ../fish/guestfish-actions.pod:4043 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4043 msgid "" "This command creates the directory C<dir> and then fills it with files until " -"the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, " -"and deletes them. The intention is to scrub any free space on the partition " +"the filesystem is full, and scrubs the files as for L</scrub-file>, and " +"deletes them. The intention is to scrub any free space on the partition " "containing C<dir>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6144 -msgid "guestfs_set_append" +#: ../fish/guestfish-actions.pod:4052 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4052 +msgid "set-append" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4054 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4054 +msgid "append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6146 +#: ../fish/guestfish-actions.pod:4056 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4056 #, no-wrap msgid "" -" int\n" -" guestfs_set_append (guestfs_h *g,\n" -" const char *append);\n" +" set-append append\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6150 ../fish/guestfish-actions.pod:4052 +#: ../fish/guestfish-actions.pod:4058 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4058 ../libguestfs-1.11.19/src/guestfs-actions.pod:6158 ../src/guestfs-actions.pod:6158 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6153 ../fish/guestfish-actions.pod:4055 +#: ../fish/guestfish-actions.pod:4061 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4061 ../libguestfs-1.11.19/src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6161 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6156 ../fish/guestfish-actions.pod:4058 +#: ../fish/guestfish-actions.pod:4064 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4064 ../libguestfs-1.11.19/src/guestfs-actions.pod:6164 ../src/guestfs-actions.pod:6164 msgid "" "Setting C<append> to C<NULL> means I<no> additional options are passed " "(libguestfs always adds a few of its own)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6163 -msgid "guestfs_set_attach_method" +#: ../fish/guestfish-actions.pod:4067 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4067 +msgid "set-attach-method" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4069 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4069 +msgid "attach-method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6165 +#: ../fish/guestfish-actions.pod:4071 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4071 #, no-wrap msgid "" -" int\n" -" guestfs_set_attach_method (guestfs_h *g,\n" -" const char *attachmethod);\n" +" set-attach-method attachmethod\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6169 ../fish/guestfish-actions.pod:4067 +#: ../fish/guestfish-actions.pod:4073 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4073 ../libguestfs-1.11.19/src/guestfs-actions.pod:6177 ../src/guestfs-actions.pod:6177 msgid "" "Set the method that libguestfs uses to connect to the back end guestfsd " "daemon. Possible methods are:" msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:4078 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4078 ../libguestfs-1.11.19/src/guestfs-actions.pod:6182 ../libguestfs-1.11.19/src/guestfs.pod:2687 ../src/guestfs-actions.pod:6182 ../src/guestfs.pod:2687 +msgid "C<appliance>" +msgstr "" + #. type: textblock -#: ../src/guestfs-actions.pod:6176 ../fish/guestfish-actions.pod:4074 +#: ../fish/guestfish-actions.pod:4080 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4080 ../libguestfs-1.11.19/src/guestfs-actions.pod:6184 ../src/guestfs-actions.pod:6184 msgid "" "Launch an appliance and connect to it. This is the ordinary method and the " "default." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6179 ../fish/guestfish-actions.pod:4077 +#: ../fish/guestfish-actions.pod:4083 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4083 ../libguestfs-1.11.19/src/guestfs-actions.pod:6187 ../src/guestfs-actions.pod:6187 msgid "C<unix:I<path>>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6181 ../fish/guestfish-actions.pod:4079 +#: ../fish/guestfish-actions.pod:4085 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4085 ../libguestfs-1.11.19/src/guestfs-actions.pod:6189 ../src/guestfs-actions.pod:6189 msgid "Connect to the Unix domain socket I<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6183 ../fish/guestfish-actions.pod:4081 +#: ../fish/guestfish-actions.pod:4087 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4087 ../libguestfs-1.11.19/src/guestfs-actions.pod:6191 ../src/guestfs-actions.pod:6191 msgid "" "This method lets you connect to an existing daemon or (using virtio-serial) " "to a live guest. For more information, see L<guestfs(3)/ATTACHING TO " @@ -16116,22 +12409,25 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6193 -msgid "guestfs_set_autosync" +#: ../fish/guestfish-actions.pod:4093 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4093 +msgid "set-autosync" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4095 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4095 +msgid "autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6195 +#: ../fish/guestfish-actions.pod:4097 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4097 #, no-wrap msgid "" -" int\n" -" guestfs_set_autosync (guestfs_h *g,\n" -" int autosync);\n" +" set-autosync true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6199 ../fish/guestfish-actions.pod:4093 +#: ../fish/guestfish-actions.pod:4099 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4099 ../libguestfs-1.11.19/src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:6207 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -16139,100 +12435,96 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6204 ../fish/guestfish-actions.pod:4098 +#: ../fish/guestfish-actions.pod:4104 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4104 ../libguestfs-1.11.19/src/guestfs-actions.pod:6212 ../src/guestfs-actions.pod:6212 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6211 -msgid "guestfs_set_direct" +#: ../fish/guestfish-actions.pod:4107 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4107 +msgid "set-direct" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4109 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4109 +msgid "direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6213 +#: ../fish/guestfish-actions.pod:4111 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4111 #, no-wrap msgid "" -" int\n" -" guestfs_set_direct (guestfs_h *g,\n" -" int direct);\n" +" set-direct true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6217 ../fish/guestfish-actions.pod:4107 +#: ../fish/guestfish-actions.pod:4113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4113 ../libguestfs-1.11.19/src/guestfs-actions.pod:6225 ../src/guestfs-actions.pod:6225 msgid "" "If the direct appliance mode flag is enabled, then stdin and stdout are " "passed directly through to the appliance once it is launched." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6221 +#: ../fish/guestfish-actions.pod:4117 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4117 msgid "" "One consequence of this is that log messages aren't caught by the library " -"and handled by C<guestfs_set_log_message_callback>, but go straight to " -"stdout." +"and handled by L</set-log-message-callback>, but go straight to stdout." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6225 ../fish/guestfish-actions.pod:4115 +#: ../fish/guestfish-actions.pod:4121 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4121 ../libguestfs-1.11.19/src/guestfs-actions.pod:6233 ../src/guestfs-actions.pod:6233 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6228 ../fish/guestfish-actions.pod:4118 +#: ../fish/guestfish-actions.pod:4124 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4124 ../libguestfs-1.11.19/src/guestfs-actions.pod:6236 ../src/guestfs-actions.pod:6236 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6234 -msgid "guestfs_set_e2label" +#: ../fish/guestfish-actions.pod:4126 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4126 +msgid "set-e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6236 +#: ../fish/guestfish-actions.pod:4128 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4128 #, no-wrap msgid "" -" int\n" -" guestfs_set_e2label (guestfs_h *g,\n" -" const char *device,\n" -" const char *label);\n" +" set-e2label device label\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6241 ../fish/guestfish-actions.pod:4124 +#: ../fish/guestfish-actions.pod:4130 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4130 ../libguestfs-1.11.19/src/guestfs-actions.pod:6249 ../src/guestfs-actions.pod:6249 msgid "" "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to " "C<label>. Filesystem labels are limited to 16 characters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6245 +#: ../fish/guestfish-actions.pod:4134 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4134 msgid "" -"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " -"the existing label on a filesystem." +"You can use either L</tune2fs-l> or L</get-e2label> to return the existing " +"label on a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6252 -msgid "guestfs_set_e2uuid" +#: ../fish/guestfish-actions.pod:4137 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4137 +msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6254 +#: ../fish/guestfish-actions.pod:4139 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4139 #, no-wrap msgid "" -" int\n" -" guestfs_set_e2uuid (guestfs_h *g,\n" -" const char *device,\n" -" const char *uuid);\n" +" set-e2uuid device uuid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6259 ../fish/guestfish-actions.pod:4135 +#: ../fish/guestfish-actions.pod:4141 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4141 ../libguestfs-1.11.19/src/guestfs-actions.pod:6267 ../src/guestfs-actions.pod:6267 msgid "" "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to " "C<uuid>. The format of the UUID and alternatives such as C<clear>, " @@ -16240,184 +12532,192 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6264 +#: ../fish/guestfish-actions.pod:4146 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4146 msgid "" -"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " -"the existing UUID of a filesystem." +"You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing " +"UUID of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6271 -msgid "guestfs_set_memsize" +#: ../fish/guestfish-actions.pod:4149 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4149 +msgid "set-memsize" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4151 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4151 +msgid "memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6273 +#: ../fish/guestfish-actions.pod:4153 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4153 #, no-wrap msgid "" -" int\n" -" guestfs_set_memsize (guestfs_h *g,\n" -" int memsize);\n" +" set-memsize memsize\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6277 +#: ../fish/guestfish-actions.pod:4155 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4155 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " -"This only has any effect if called before C<guestfs_launch>." +"This only has any effect if called before L</launch>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6281 ../fish/guestfish-actions.pod:4153 +#: ../fish/guestfish-actions.pod:4159 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4159 ../libguestfs-1.11.19/src/guestfs-actions.pod:6289 ../src/guestfs-actions.pod:6289 msgid "" "You can also change this by setting the environment variable " "C<LIBGUESTFS_MEMSIZE> before the handle is created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6292 -msgid "guestfs_set_network" +#: ../fish/guestfish-actions.pod:4166 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4166 +msgid "set-network" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4168 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4168 +msgid "network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6294 +#: ../fish/guestfish-actions.pod:4170 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4170 #, no-wrap msgid "" -" int\n" -" guestfs_set_network (guestfs_h *g,\n" -" int network);\n" +" set-network true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6298 ../fish/guestfish-actions.pod:4166 +#: ../fish/guestfish-actions.pod:4172 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4172 ../libguestfs-1.11.19/src/guestfs-actions.pod:6306 ../src/guestfs-actions.pod:6306 msgid "" "If C<network> is true, then the network is enabled in the libguestfs " "appliance. The default is false." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6301 ../fish/guestfish-actions.pod:4169 +#: ../fish/guestfish-actions.pod:4175 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4175 ../libguestfs-1.11.19/src/guestfs-actions.pod:6309 ../src/guestfs-actions.pod:6309 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6304 -msgid "" -"You must call this before calling C<guestfs_launch>, otherwise it has no " -"effect." +#: ../fish/guestfish-actions.pod:4178 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4178 +msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6311 -msgid "guestfs_set_path" +#: ../fish/guestfish-actions.pod:4181 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4181 +msgid "set-path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6313 +#: ../fish/guestfish-actions.pod:4185 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4185 #, no-wrap msgid "" -" int\n" -" guestfs_set_path (guestfs_h *g,\n" -" const char *searchpath);\n" +" set-path searchpath\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6317 ../fish/guestfish-actions.pod:4181 +#: ../fish/guestfish-actions.pod:4187 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4187 ../libguestfs-1.11.19/src/guestfs-actions.pod:6325 ../src/guestfs-actions.pod:6325 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6319 ../fish/guestfish-actions.pod:4183 +#: ../fish/guestfish-actions.pod:4189 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4189 ../libguestfs-1.11.19/src/guestfs-actions.pod:6327 ../src/guestfs-actions.pod:6327 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6322 ../fish/guestfish-actions.pod:4186 +#: ../fish/guestfish-actions.pod:4192 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4192 ../libguestfs-1.11.19/src/guestfs-actions.pod:6330 ../src/guestfs-actions.pod:6330 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6328 -msgid "guestfs_set_pgroup" +#: ../fish/guestfish-actions.pod:4194 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4194 +msgid "set-pgroup" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4196 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4196 +msgid "pgroup" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6330 +#: ../fish/guestfish-actions.pod:4198 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4198 #, no-wrap msgid "" -" int\n" -" guestfs_set_pgroup (guestfs_h *g,\n" -" int pgroup);\n" +" set-pgroup true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6334 ../fish/guestfish-actions.pod:4194 +#: ../fish/guestfish-actions.pod:4200 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4200 ../libguestfs-1.11.19/src/guestfs-actions.pod:6342 ../src/guestfs-actions.pod:6342 msgid "" "If C<pgroup> is true, child processes are placed into their own process " "group." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6337 ../fish/guestfish-actions.pod:4197 +#: ../fish/guestfish-actions.pod:4203 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4203 ../libguestfs-1.11.19/src/guestfs-actions.pod:6345 ../src/guestfs-actions.pod:6345 msgid "" "The practical upshot of this is that signals like C<SIGINT> (from users " "pressing C<^C>) won't be received by the child process." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6340 ../fish/guestfish-actions.pod:4200 +#: ../fish/guestfish-actions.pod:4206 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4206 ../libguestfs-1.11.19/src/guestfs-actions.pod:6348 ../src/guestfs-actions.pod:6348 msgid "" "The default for this flag is false, because usually you want C<^C> to kill " "the subprocess." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6345 -msgid "guestfs_set_qemu" +#: ../fish/guestfish-actions.pod:4209 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4209 +msgid "set-qemu" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4211 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4211 +msgid "qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6347 +#: ../fish/guestfish-actions.pod:4213 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4213 #, no-wrap msgid "" -" int\n" -" guestfs_set_qemu (guestfs_h *g,\n" -" const char *qemu);\n" +" set-qemu qemu\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6351 ../fish/guestfish-actions.pod:4209 +#: ../fish/guestfish-actions.pod:4215 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4215 ../libguestfs-1.11.19/src/guestfs-actions.pod:6361 ../src/guestfs-actions.pod:6361 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6353 ../fish/guestfish-actions.pod:4211 +#: ../fish/guestfish-actions.pod:4217 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4217 ../libguestfs-1.11.19/src/guestfs-actions.pod:6363 ../src/guestfs-actions.pod:6363 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6356 ../fish/guestfish-actions.pod:4214 +#: ../fish/guestfish-actions.pod:4220 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4220 ../libguestfs-1.11.19/src/guestfs-actions.pod:6366 ../src/guestfs-actions.pod:6366 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6359 ../fish/guestfish-actions.pod:4217 +#: ../fish/guestfish-actions.pod:4223 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4223 ../libguestfs-1.11.19/src/guestfs-actions.pod:6369 ../src/guestfs-actions.pod:6369 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6361 ../fish/guestfish-actions.pod:4219 +#: ../fish/guestfish-actions.pod:4225 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4225 ../libguestfs-1.11.19/src/guestfs-actions.pod:6371 ../src/guestfs-actions.pod:6371 msgid "" "Note that you should call this function as early as possible after creating " "the handle. This is because some pre-launch operations depend on testing " @@ -16428,38 +12728,40 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6373 -msgid "guestfs_set_recovery_proc" +#: ../fish/guestfish-actions.pod:4233 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4233 +msgid "set-recovery-proc" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4235 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4235 +msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6375 +#: ../fish/guestfish-actions.pod:4237 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4237 #, no-wrap msgid "" -" int\n" -" guestfs_set_recovery_proc (guestfs_h *g,\n" -" int recoveryproc);\n" +" set-recovery-proc true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6379 +#: ../fish/guestfish-actions.pod:4239 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4239 msgid "" -"If this is called with the parameter C<false> then C<guestfs_launch> does " -"not create a recovery process. The purpose of the recovery process is to " -"stop runaway qemu processes in the case where the main program aborts " -"abruptly." +"If this is called with the parameter C<false> then L</launch> does not " +"create a recovery process. The purpose of the recovery process is to stop " +"runaway qemu processes in the case where the main program aborts abruptly." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6384 +#: ../fish/guestfish-actions.pod:4244 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4244 msgid "" -"This only has any effect if called before C<guestfs_launch>, and the default " -"is true." +"This only has any effect if called before L</launch>, and the default is " +"true." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6387 ../fish/guestfish-actions.pod:4241 +#: ../fish/guestfish-actions.pod:4247 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4247 ../libguestfs-1.11.19/src/guestfs-actions.pod:6397 ../src/guestfs-actions.pod:6397 msgid "" "About the only time when you would want to disable this is if the main " "process will fork itself into the background (\"daemonize\" itself). In " @@ -16468,201 +12770,197 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6397 -msgid "guestfs_set_selinux" +#: ../fish/guestfish-actions.pod:4253 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4253 +msgid "set-selinux" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4255 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4255 +msgid "selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6399 +#: ../fish/guestfish-actions.pod:4257 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4257 #, no-wrap msgid "" -" int\n" -" guestfs_set_selinux (guestfs_h *g,\n" -" int selinux);\n" +" set-selinux true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6403 ../fish/guestfish-actions.pod:4253 +#: ../fish/guestfish-actions.pod:4259 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4259 ../libguestfs-1.11.19/src/guestfs-actions.pod:6413 ../src/guestfs-actions.pod:6413 msgid "" "This sets the selinux flag that is passed to the appliance at boot time. " "The default is C<selinux=0> (disabled)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6406 ../fish/guestfish-actions.pod:4256 +#: ../fish/guestfish-actions.pod:4262 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4262 ../libguestfs-1.11.19/src/guestfs-actions.pod:6416 ../src/guestfs-actions.pod:6416 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6416 -msgid "guestfs_set_trace" +#: ../fish/guestfish-actions.pod:4268 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4268 +msgid "set-trace" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4270 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4270 +msgid "trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6418 +#: ../fish/guestfish-actions.pod:4272 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4272 #, no-wrap msgid "" -" int\n" -" guestfs_set_trace (guestfs_h *g,\n" -" int trace);\n" +" set-trace true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6422 ../fish/guestfish-actions.pod:4268 +#: ../fish/guestfish-actions.pod:4274 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4274 ../libguestfs-1.11.19/src/guestfs-actions.pod:6432 ../src/guestfs-actions.pod:6432 msgid "" "If the command trace flag is set to 1, then libguestfs calls, parameters and " "return values are traced." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6425 ../fish/guestfish-actions.pod:4271 +#: ../fish/guestfish-actions.pod:4277 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4277 ../libguestfs-1.11.19/src/guestfs-actions.pod:6435 ../src/guestfs-actions.pod:6435 msgid "" "If you want to trace C API calls into libguestfs (and other libraries) then " "possibly a better way is to use the external ltrace(1) command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6429 ../fish/guestfish-actions.pod:4275 +#: ../fish/guestfish-actions.pod:4281 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4281 ../libguestfs-1.11.19/src/guestfs-actions.pod:6439 ../src/guestfs-actions.pod:6439 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6432 +#: ../fish/guestfish-actions.pod:4284 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4284 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " -"callback to send them somewhere else (see C<guestfs_set_event_callback>)." +"callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6440 -msgid "guestfs_set_verbose" +#: ../fish/guestfish-actions.pod:4288 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4288 +msgid "set-verbose" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4290 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4290 +msgid "verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6442 +#: ../fish/guestfish-actions.pod:4292 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4292 #, no-wrap msgid "" -" int\n" -" guestfs_set_verbose (guestfs_h *g,\n" -" int verbose);\n" +" set-verbose true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6446 ../fish/guestfish-actions.pod:4288 +#: ../fish/guestfish-actions.pod:4294 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4294 ../libguestfs-1.11.19/src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:6456 msgid "If C<verbose> is true, this turns on verbose messages." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6448 ../fish/guestfish-actions.pod:4290 +#: ../fish/guestfish-actions.pod:4296 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4296 ../libguestfs-1.11.19/src/guestfs-actions.pod:6458 ../src/guestfs-actions.pod:6458 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6451 +#: ../fish/guestfish-actions.pod:4299 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4299 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " -"callback to send them somewhere else (see C<guestfs_set_event_callback>)." +"callback to send them somewhere else (see L</set-event-callback>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6459 -msgid "guestfs_setcon" +#: ../fish/guestfish-actions.pod:4303 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4303 +msgid "setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6461 +#: ../fish/guestfish-actions.pod:4305 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4305 #, no-wrap msgid "" -" int\n" -" guestfs_setcon (guestfs_h *g,\n" -" const char *context);\n" +" setcon context\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6465 ../fish/guestfish-actions.pod:4301 +#: ../fish/guestfish-actions.pod:4307 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4307 ../libguestfs-1.11.19/src/guestfs-actions.pod:6475 ../src/guestfs-actions.pod:6475 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6468 ../fish/guestfish-actions.pod:4304 +#: ../fish/guestfish-actions.pod:4310 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4310 ../libguestfs-1.11.19/src/guestfs-actions.pod:6478 ../src/guestfs-actions.pod:6478 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6474 -msgid "guestfs_setxattr" +#: ../fish/guestfish-actions.pod:4312 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4312 +msgid "setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6476 +#: ../fish/guestfish-actions.pod:4314 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4314 #, no-wrap msgid "" -" int\n" -" guestfs_setxattr (guestfs_h *g,\n" -" const char *xattr,\n" -" const char *val,\n" -" int vallen,\n" -" const char *path);\n" +" setxattr xattr val vallen path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6483 ../fish/guestfish-actions.pod:4310 +#: ../fish/guestfish-actions.pod:4316 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4316 ../libguestfs-1.11.19/src/guestfs-actions.pod:6493 ../src/guestfs-actions.pod:6493 msgid "" "This call sets the extended attribute named C<xattr> of the file C<path> to " "the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6487 -msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." +#: ../fish/guestfish-actions.pod:4320 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4320 +msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6493 -msgid "guestfs_sfdisk" +#: ../fish/guestfish-actions.pod:4322 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4322 +msgid "sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6495 +#: ../fish/guestfish-actions.pod:4324 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4324 #, no-wrap msgid "" -" int\n" -" guestfs_sfdisk (guestfs_h *g,\n" -" const char *device,\n" -" int cyls,\n" -" int heads,\n" -" int sectors,\n" -" char *const *lines);\n" +" sfdisk device cyls heads sectors 'lines ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6503 ../fish/guestfish-actions.pod:4320 +#: ../fish/guestfish-actions.pod:4326 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4326 ../libguestfs-1.11.19/src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6513 msgid "" "This is a direct interface to the L<sfdisk(8)> program for creating " "partitions on block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4323 +#: ../fish/guestfish-actions.pod:4329 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4329 ../libguestfs-1.11.19/src/guestfs-actions.pod:6516 ../src/guestfs-actions.pod:6516 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6508 ../fish/guestfish-actions.pod:4325 +#: ../fish/guestfish-actions.pod:4331 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4331 ../libguestfs-1.11.19/src/guestfs-actions.pod:6518 ../src/guestfs-actions.pod:6518 msgid "" "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and " "sectors on the device, which are passed directly to sfdisk as the I<-C>, " @@ -16673,14 +12971,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6516 ../fish/guestfish-actions.pod:4333 +#: ../fish/guestfish-actions.pod:4339 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4339 ../libguestfs-1.11.19/src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6526 msgid "" "C<lines> is a list of lines that we feed to C<sfdisk>. For more information " "refer to the L<sfdisk(8)> manpage." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6519 ../fish/guestfish-actions.pod:4336 +#: ../fish/guestfish-actions.pod:4342 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4342 ../libguestfs-1.11.19/src/guestfs-actions.pod:6529 ../src/guestfs-actions.pod:6529 msgid "" "To create a single partition occupying the whole disk, you would pass " "C<lines> as a single element list, when the single element being the string " @@ -16688,198 +12986,178 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6523 -msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" +#: ../fish/guestfish-actions.pod:4346 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4346 +msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6531 ../src/guestfs-actions.pod:6561 ../src/guestfs-actions.pod:6594 ../fish/guestfish-actions.pod:4346 ../fish/guestfish-actions.pod:4369 ../fish/guestfish-actions.pod:4391 +#: ../fish/guestfish-actions.pod:4352 ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4397 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4352 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4375 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4397 ../libguestfs-1.11.19/src/guestfs-actions.pod:6541 ../libguestfs-1.11.19/src/guestfs-actions.pod:6571 ../libguestfs-1.11.19/src/guestfs-actions.pod:6604 ../src/guestfs-actions.pod:6541 ../src/guestfs-actions.pod:6571 ../src/guestfs-actions.pod:6604 msgid "This function is deprecated. In new code, use the C<part_add> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6540 -msgid "guestfs_sfdiskM" +#: ../fish/guestfish-actions.pod:4359 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4359 +msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6542 +#: ../fish/guestfish-actions.pod:4361 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4361 #, no-wrap msgid "" -" int\n" -" guestfs_sfdiskM (guestfs_h *g,\n" -" const char *device,\n" -" char *const *lines);\n" +" sfdiskM device 'lines ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6547 +#: ../fish/guestfish-actions.pod:4363 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4363 msgid "" -"This is a simplified interface to the C<guestfs_sfdisk> command, where " -"partition sizes are specified in megabytes only (rounded to the nearest " -"cylinder) and you don't need to specify the cyls, heads and sectors " -"parameters which were rarely if ever used anyway." +"This is a simplified interface to the L</sfdisk> command, where partition " +"sizes are specified in megabytes only (rounded to the nearest cylinder) and " +"you don't need to specify the cyls, heads and sectors parameters which were " +"rarely if ever used anyway." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6553 -msgid "" -"See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " -"C<guestfs_part_disk>" +#: ../fish/guestfish-actions.pod:4369 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4369 +msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6570 -msgid "guestfs_sfdisk_N" +#: ../fish/guestfish-actions.pod:4382 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4382 +msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6572 +#: ../fish/guestfish-actions.pod:4384 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4384 #, no-wrap msgid "" -" int\n" -" guestfs_sfdisk_N (guestfs_h *g,\n" -" const char *device,\n" -" int partnum,\n" -" int cyls,\n" -" int heads,\n" -" int sectors,\n" -" const char *line);\n" +" sfdisk-N device partnum cyls heads sectors line\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6581 ../fish/guestfish-actions.pod:4380 +#: ../fish/guestfish-actions.pod:4386 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4386 ../libguestfs-1.11.19/src/guestfs-actions.pod:6591 ../src/guestfs-actions.pod:6591 msgid "" "This runs L<sfdisk(8)> option to modify just the single partition C<n> " "(note: C<n> counts from 1)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6584 +#: ../fish/guestfish-actions.pod:4389 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4389 msgid "" -"For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " -"for the cyls/heads/sectors parameters." +"For other parameters, see L</sfdisk>. You should usually pass C<0> for the " +"cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6587 -msgid "See also: C<guestfs_part_add>" +#: ../fish/guestfish-actions.pod:4392 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4392 +msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6603 -msgid "guestfs_sfdisk_disk_geometry" +#: ../fish/guestfish-actions.pod:4404 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4404 +msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6605 +#: ../fish/guestfish-actions.pod:4406 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4406 #, no-wrap msgid "" -" char *\n" -" guestfs_sfdisk_disk_geometry (guestfs_h *g,\n" -" const char *device);\n" +" sfdisk-disk-geometry device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6609 +#: ../fish/guestfish-actions.pod:4408 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4408 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " "this can be different from the kernel's idea of the geometry (see " -"C<guestfs_sfdisk_kernel_geometry>)." +"L</sfdisk-kernel-geometry>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6614 ../src/guestfs-actions.pod:6630 ../fish/guestfish-actions.pod:4407 ../fish/guestfish-actions.pod:4416 +#: ../fish/guestfish-actions.pod:4413 ../fish/guestfish-actions.pod:4422 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4413 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4422 ../libguestfs-1.11.19/src/guestfs-actions.pod:6624 ../libguestfs-1.11.19/src/guestfs-actions.pod:6640 ../src/guestfs-actions.pod:6624 ../src/guestfs-actions.pod:6640 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6622 -msgid "guestfs_sfdisk_kernel_geometry" +#: ../fish/guestfish-actions.pod:4416 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4416 +msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6624 +#: ../fish/guestfish-actions.pod:4418 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4418 #, no-wrap msgid "" -" char *\n" -" guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n" -" const char *device);\n" +" sfdisk-kernel-geometry device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6628 ../fish/guestfish-actions.pod:4414 +#: ../fish/guestfish-actions.pod:4420 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4420 ../libguestfs-1.11.19/src/guestfs-actions.pod:6638 ../src/guestfs-actions.pod:6638 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6638 -msgid "guestfs_sfdisk_l" +#: ../fish/guestfish-actions.pod:4425 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4425 +msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6640 +#: ../fish/guestfish-actions.pod:4427 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4427 #, no-wrap msgid "" -" char *\n" -" guestfs_sfdisk_l (guestfs_h *g,\n" -" const char *device);\n" +" sfdisk-l device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6644 ../fish/guestfish-actions.pod:4423 +#: ../fish/guestfish-actions.pod:4429 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4429 ../libguestfs-1.11.19/src/guestfs-actions.pod:6654 ../src/guestfs-actions.pod:6654 msgid "" "This displays the partition table on C<device>, in the human-readable output " "of the L<sfdisk(8)> command. It is not intended to be parsed." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6648 -msgid "See also: C<guestfs_part_list>" +#: ../fish/guestfish-actions.pod:4433 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4433 +msgid "See also: L</part-list>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6653 ../fish/guestfish-actions.pod:4429 +#: ../fish/guestfish-actions.pod:4435 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4435 ../libguestfs-1.11.19/src/guestfs-actions.pod:6663 ../src/guestfs-actions.pod:6663 msgid "" "This function is deprecated. In new code, use the C<part_list> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6662 -msgid "guestfs_sh" +#: ../fish/guestfish-actions.pod:4442 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4442 +msgid "sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6664 +#: ../fish/guestfish-actions.pod:4444 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4444 #, no-wrap msgid "" -" char *\n" -" guestfs_sh (guestfs_h *g,\n" -" const char *command);\n" +" sh command\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6668 ../fish/guestfish-actions.pod:4440 +#: ../fish/guestfish-actions.pod:4446 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4446 ../libguestfs-1.11.19/src/guestfs-actions.pod:6678 ../src/guestfs-actions.pod:6678 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6671 -msgid "This is like C<guestfs_command>, but passes the command to:" +#: ../fish/guestfish-actions.pod:4449 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4449 +msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6673 ../fish/guestfish-actions.pod:4445 +#: ../fish/guestfish-actions.pod:4451 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4451 ../libguestfs-1.11.19/src/guestfs-actions.pod:6683 ../src/guestfs-actions.pod:6683 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -16887,106 +13165,91 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6675 ../fish/guestfish-actions.pod:4447 +#: ../fish/guestfish-actions.pod:4453 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4453 ../libguestfs-1.11.19/src/guestfs-actions.pod:6685 ../src/guestfs-actions.pod:6685 msgid "" "Depending on the guest's shell, this usually results in wildcards being " "expanded, shell expressions being interpolated and so on." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6679 -msgid "All the provisos about C<guestfs_command> apply to this call." +#: ../fish/guestfish-actions.pod:4457 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4457 +msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6686 -msgid "guestfs_sh_lines" +#: ../fish/guestfish-actions.pod:4459 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4459 +msgid "sh-lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6688 +#: ../fish/guestfish-actions.pod:4461 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4461 #, no-wrap msgid "" -" char **\n" -" guestfs_sh_lines (guestfs_h *g,\n" -" const char *command);\n" +" sh-lines command\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6692 -msgid "" -"This is the same as C<guestfs_sh>, but splits the result into a list of " -"lines." +#: ../fish/guestfish-actions.pod:4463 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4463 +msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6695 -msgid "See also: C<guestfs_command_lines>" +#: ../fish/guestfish-actions.pod:4466 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4466 +msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6703 -msgid "guestfs_sleep" +#: ../fish/guestfish-actions.pod:4468 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4468 +msgid "sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6705 +#: ../fish/guestfish-actions.pod:4470 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4470 #, no-wrap msgid "" -" int\n" -" guestfs_sleep (guestfs_h *g,\n" -" int secs);\n" +" sleep secs\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6709 ../fish/guestfish-actions.pod:4466 +#: ../fish/guestfish-actions.pod:4472 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4472 ../libguestfs-1.11.19/src/guestfs-actions.pod:6719 ../src/guestfs-actions.pod:6719 msgid "Sleep for C<secs> seconds." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6713 -msgid "(Added in 1.0.41)" -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:6715 ../src/guestfs-structs.pod:109 -msgid "guestfs_stat" +#: ../fish/guestfish-actions.pod:4474 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4474 +msgid "stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6717 +#: ../fish/guestfish-actions.pod:4476 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4476 #, no-wrap msgid "" -" struct guestfs_stat *\n" -" guestfs_stat (guestfs_h *g,\n" -" const char *path);\n" +" stat path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6723 ../fish/guestfish-actions.pod:4474 +#: ../fish/guestfish-actions.pod:4480 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4480 ../libguestfs-1.11.19/src/guestfs-actions.pod:6733 ../src/guestfs-actions.pod:6733 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6731 ../src/guestfs-structs.pod:135 -msgid "guestfs_statvfs" +#: ../fish/guestfish-actions.pod:4482 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4482 +msgid "statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6733 +#: ../fish/guestfish-actions.pod:4484 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4484 #, no-wrap msgid "" -" struct guestfs_statvfs *\n" -" guestfs_statvfs (guestfs_h *g,\n" -" const char *path);\n" +" statvfs path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6737 ../fish/guestfish-actions.pod:4480 +#: ../fish/guestfish-actions.pod:4486 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4486 ../libguestfs-1.11.19/src/guestfs-actions.pod:6747 ../src/guestfs-actions.pod:6747 msgid "" "Returns file system statistics for any mounted file system. C<path> should " "be a file or directory in the mounted file system (typically it is the mount " @@ -16994,247 +13257,225 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6741 ../fish/guestfish-actions.pod:4484 +#: ../fish/guestfish-actions.pod:4490 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4490 ../libguestfs-1.11.19/src/guestfs-actions.pod:6751 ../src/guestfs-actions.pod:6751 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:6743 -msgid "" -"This function returns a C<struct guestfs_statvfs *>, or NULL if there was an " -"error. I<The caller must call C<guestfs_free_statvfs> after use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:6749 -msgid "guestfs_strings" +#: ../fish/guestfish-actions.pod:4492 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4492 +msgid "strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6751 +#: ../fish/guestfish-actions.pod:4494 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4494 #, no-wrap msgid "" -" char **\n" -" guestfs_strings (guestfs_h *g,\n" -" const char *path);\n" +" strings path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6755 ../fish/guestfish-actions.pod:4490 +#: ../fish/guestfish-actions.pod:4496 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4496 ../libguestfs-1.11.19/src/guestfs-actions.pod:6765 ../src/guestfs-actions.pod:6765 msgid "" "This runs the L<strings(1)> command on a file and returns the list of " "printable strings found." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6767 -msgid "guestfs_strings_e" +#: ../fish/guestfish-actions.pod:4502 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4502 +msgid "strings-e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6769 +#: ../fish/guestfish-actions.pod:4504 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4504 #, no-wrap msgid "" -" char **\n" -" guestfs_strings_e (guestfs_h *g,\n" -" const char *encoding,\n" -" const char *path);\n" +" strings-e encoding path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6774 +#: ../fish/guestfish-actions.pod:4506 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4506 msgid "" -"This is like the C<guestfs_strings> command, but allows you to specify the " -"encoding of strings that are looked for in the source file C<path>." +"This is like the L</strings> command, but allows you to specify the encoding " +"of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6778 ../fish/guestfish-actions.pod:4504 +#: ../fish/guestfish-actions.pod:4510 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4510 ../libguestfs-1.11.19/src/guestfs-actions.pod:6788 ../src/guestfs-actions.pod:6788 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6782 ../fish/guestfish-actions.pod:4508 +#: ../fish/guestfish-actions.pod:4514 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4514 ../libguestfs-1.11.19/src/guestfs-actions.pod:6792 ../src/guestfs-actions.pod:6792 msgid "s" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6784 +#: ../fish/guestfish-actions.pod:4516 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4516 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " -"ISO-8859-X (this is what C<guestfs_strings> uses)." +"ISO-8859-X (this is what L</strings> uses)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6787 ../fish/guestfish-actions.pod:4513 +#: ../fish/guestfish-actions.pod:4519 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4519 ../libguestfs-1.11.19/src/guestfs-actions.pod:6797 ../src/guestfs-actions.pod:6797 msgid "S" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6789 ../fish/guestfish-actions.pod:4515 +#: ../fish/guestfish-actions.pod:4521 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4521 ../libguestfs-1.11.19/src/guestfs-actions.pod:6799 ../src/guestfs-actions.pod:6799 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6791 ../fish/guestfish-actions.pod:4517 +#: ../fish/guestfish-actions.pod:4523 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4523 ../libguestfs-1.11.19/src/guestfs-actions.pod:6801 ../src/guestfs-actions.pod:6801 msgid "b" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6793 ../fish/guestfish-actions.pod:4519 +#: ../fish/guestfish-actions.pod:4525 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4525 ../libguestfs-1.11.19/src/guestfs-actions.pod:6803 ../src/guestfs-actions.pod:6803 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6796 ../fish/guestfish-actions.pod:4522 +#: ../fish/guestfish-actions.pod:4528 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4528 ../libguestfs-1.11.19/src/guestfs-actions.pod:6806 ../src/guestfs-actions.pod:6806 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6798 ../fish/guestfish-actions.pod:4524 +#: ../fish/guestfish-actions.pod:4530 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4530 ../libguestfs-1.11.19/src/guestfs-actions.pod:6808 ../src/guestfs-actions.pod:6808 msgid "" "16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for " "examining binaries in Windows guests." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6801 ../fish/guestfish-actions.pod:4527 +#: ../fish/guestfish-actions.pod:4533 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4533 ../libguestfs-1.11.19/src/guestfs-actions.pod:6811 ../src/guestfs-actions.pod:6811 msgid "B" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6803 ../fish/guestfish-actions.pod:4529 +#: ../fish/guestfish-actions.pod:4535 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4535 ../libguestfs-1.11.19/src/guestfs-actions.pod:6813 ../src/guestfs-actions.pod:6813 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6805 ../fish/guestfish-actions.pod:4531 +#: ../fish/guestfish-actions.pod:4537 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4537 ../libguestfs-1.11.19/src/guestfs-actions.pod:6815 ../src/guestfs-actions.pod:6815 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6807 ../fish/guestfish-actions.pod:4533 +#: ../fish/guestfish-actions.pod:4539 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4539 ../libguestfs-1.11.19/src/guestfs-actions.pod:6817 ../src/guestfs-actions.pod:6817 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6811 ../fish/guestfish-actions.pod:4537 +#: ../fish/guestfish-actions.pod:4543 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4543 ../libguestfs-1.11.19/src/guestfs-actions.pod:6821 ../src/guestfs-actions.pod:6821 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6822 -msgid "guestfs_swapoff_device" +#: ../fish/guestfish-actions.pod:4548 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4548 +msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6824 +#: ../fish/guestfish-actions.pod:4550 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4550 #, no-wrap msgid "" -" int\n" -" guestfs_swapoff_device (guestfs_h *g,\n" -" const char *device);\n" +" swapoff-device device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6828 +#: ../fish/guestfish-actions.pod:4552 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4552 msgid "" "This command disables the libguestfs appliance swap device or partition " -"named C<device>. See C<guestfs_swapon_device>." +"named C<device>. See L</swapon-device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6836 -msgid "guestfs_swapoff_file" +#: ../fish/guestfish-actions.pod:4556 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4556 +msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6838 +#: ../fish/guestfish-actions.pod:4558 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4558 #, no-wrap msgid "" -" int\n" -" guestfs_swapoff_file (guestfs_h *g,\n" -" const char *file);\n" +" swapoff-file file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6842 ../fish/guestfish-actions.pod:4554 +#: ../fish/guestfish-actions.pod:4560 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4560 ../libguestfs-1.11.19/src/guestfs-actions.pod:6852 ../src/guestfs-actions.pod:6852 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6848 -msgid "guestfs_swapoff_label" +#: ../fish/guestfish-actions.pod:4562 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4562 +msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6850 +#: ../fish/guestfish-actions.pod:4564 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4564 #, no-wrap msgid "" -" int\n" -" guestfs_swapoff_label (guestfs_h *g,\n" -" const char *label);\n" +" swapoff-label label\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6854 ../fish/guestfish-actions.pod:4560 +#: ../fish/guestfish-actions.pod:4566 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4566 ../libguestfs-1.11.19/src/guestfs-actions.pod:6864 ../src/guestfs-actions.pod:6864 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6861 -msgid "guestfs_swapoff_uuid" +#: ../fish/guestfish-actions.pod:4569 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4569 +msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6863 +#: ../fish/guestfish-actions.pod:4571 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4571 #, no-wrap msgid "" -" int\n" -" guestfs_swapoff_uuid (guestfs_h *g,\n" -" const char *uuid);\n" +" swapoff-uuid uuid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6867 ../fish/guestfish-actions.pod:4567 +#: ../fish/guestfish-actions.pod:4573 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4573 ../libguestfs-1.11.19/src/guestfs-actions.pod:6877 ../src/guestfs-actions.pod:6877 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6874 -msgid "guestfs_swapon_device" +#: ../fish/guestfish-actions.pod:4576 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4576 +msgid "swapon-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6876 +#: ../fish/guestfish-actions.pod:4578 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4578 #, no-wrap msgid "" -" int\n" -" guestfs_swapon_device (guestfs_h *g,\n" -" const char *device);\n" +" swapon-device device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6880 +#: ../fish/guestfish-actions.pod:4580 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4580 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " -"commands, for example those run using C<guestfs_command> or C<guestfs_sh>." +"commands, for example those run using L</command> or L</sh>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6885 ../fish/guestfish-actions.pod:4579 +#: ../fish/guestfish-actions.pod:4585 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4585 ../libguestfs-1.11.19/src/guestfs-actions.pod:6895 ../src/guestfs-actions.pod:6895 msgid "" "Note that you should not swap to existing guest swap partitions unless you " "know what you are doing. They may contain hibernation information, or other " @@ -17244,285 +13485,250 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6896 -msgid "guestfs_swapon_file" +#: ../fish/guestfish-actions.pod:4592 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4592 +msgid "swapon-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6898 +#: ../fish/guestfish-actions.pod:4594 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4594 #, no-wrap msgid "" -" int\n" -" guestfs_swapon_file (guestfs_h *g,\n" -" const char *file);\n" +" swapon-file file\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6902 -msgid "" -"This command enables swap to a file. See C<guestfs_swapon_device> for other " -"notes." +#: ../fish/guestfish-actions.pod:4596 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4596 +msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6909 -msgid "guestfs_swapon_label" +#: ../fish/guestfish-actions.pod:4599 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4599 +msgid "swapon-label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6911 +#: ../fish/guestfish-actions.pod:4601 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4601 #, no-wrap msgid "" -" int\n" -" guestfs_swapon_label (guestfs_h *g,\n" -" const char *label);\n" +" swapon-label label\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6915 +#: ../fish/guestfish-actions.pod:4603 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4603 msgid "" "This command enables swap to a labeled swap partition. See " -"C<guestfs_swapon_device> for other notes." +"L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6922 -msgid "guestfs_swapon_uuid" +#: ../fish/guestfish-actions.pod:4606 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4606 +msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6924 +#: ../fish/guestfish-actions.pod:4608 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4608 #, no-wrap msgid "" -" int\n" -" guestfs_swapon_uuid (guestfs_h *g,\n" -" const char *uuid);\n" +" swapon-uuid uuid\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6928 +#: ../fish/guestfish-actions.pod:4610 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4610 msgid "" "This command enables swap to a swap partition with the given UUID. See " -"C<guestfs_swapon_device> for other notes." +"L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6935 -msgid "guestfs_sync" +#: ../fish/guestfish-actions.pod:4613 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4613 +msgid "sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6937 +#: ../fish/guestfish-actions.pod:4615 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4615 #, no-wrap msgid "" -" int\n" -" guestfs_sync (guestfs_h *g);\n" +" sync\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6940 ../fish/guestfish-actions.pod:4611 +#: ../fish/guestfish-actions.pod:4617 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4617 ../libguestfs-1.11.19/src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:6950 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6943 ../fish/guestfish-actions.pod:4614 +#: ../fish/guestfish-actions.pod:4620 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4620 ../libguestfs-1.11.19/src/guestfs-actions.pod:6953 ../src/guestfs-actions.pod:6953 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6950 -msgid "guestfs_tail" +#: ../fish/guestfish-actions.pod:4623 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4623 +msgid "tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6952 +#: ../fish/guestfish-actions.pod:4625 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4625 #, no-wrap msgid "" -" char **\n" -" guestfs_tail (guestfs_h *g,\n" -" const char *path);\n" +" tail path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6956 ../fish/guestfish-actions.pod:4621 +#: ../fish/guestfish-actions.pod:4627 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4627 ../libguestfs-1.11.19/src/guestfs-actions.pod:6966 ../src/guestfs-actions.pod:6966 msgid "This command returns up to the last 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6968 -msgid "guestfs_tail_n" +#: ../fish/guestfish-actions.pod:4633 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4633 +msgid "tail-n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6970 +#: ../fish/guestfish-actions.pod:4635 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4635 #, no-wrap msgid "" -" char **\n" -" guestfs_tail_n (guestfs_h *g,\n" -" int nrlines,\n" -" const char *path);\n" +" tail-n nrlines path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6975 ../fish/guestfish-actions.pod:4631 +#: ../fish/guestfish-actions.pod:4637 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4637 ../libguestfs-1.11.19/src/guestfs-actions.pod:6985 ../src/guestfs-actions.pod:6985 msgid "" "If the parameter C<nrlines> is a positive number, this returns the last " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6978 ../fish/guestfish-actions.pod:4634 +#: ../fish/guestfish-actions.pod:4640 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4640 ../libguestfs-1.11.19/src/guestfs-actions.pod:6988 ../src/guestfs-actions.pod:6988 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, starting with the C<-nrlines>th line." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6992 -msgid "guestfs_tar_in" +#: ../fish/guestfish-actions.pod:4648 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4648 +msgid "tar-in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6994 +#: ../fish/guestfish-actions.pod:4650 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4650 #, no-wrap msgid "" -" int\n" -" guestfs_tar_in (guestfs_h *g,\n" -" const char *tarfile,\n" -" const char *directory);\n" +" tar-in (tarfile|-) directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6999 ../fish/guestfish-actions.pod:4646 +#: ../fish/guestfish-actions.pod:4652 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4652 ../libguestfs-1.11.19/src/guestfs-actions.pod:7009 ../src/guestfs-actions.pod:7009 msgid "" "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7002 -msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7007 ../src/guestfs-actions.pod:7024 ../src/guestfs-actions.pod:7040 ../src/guestfs-actions.pod:7056 -msgid "(Added in 1.0.3)" +#: ../fish/guestfish-actions.pod:4655 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4655 +msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7009 -msgid "guestfs_tar_out" +#: ../fish/guestfish-actions.pod:4660 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4660 +msgid "tar-out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7011 +#: ../fish/guestfish-actions.pod:4662 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4662 #, no-wrap msgid "" -" int\n" -" guestfs_tar_out (guestfs_h *g,\n" -" const char *directory,\n" -" const char *tarfile);\n" +" tar-out directory (tarfile|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7016 ../fish/guestfish-actions.pod:4658 +#: ../fish/guestfish-actions.pod:4664 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4664 ../libguestfs-1.11.19/src/guestfs-actions.pod:7026 ../src/guestfs-actions.pod:7026 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7019 -msgid "" -"To download a compressed tarball, use C<guestfs_tgz_out> or " -"C<guestfs_txz_out>." +#: ../fish/guestfish-actions.pod:4667 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4667 +msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7026 -msgid "guestfs_tgz_in" +#: ../fish/guestfish-actions.pod:4672 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4672 +msgid "tgz-in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7028 +#: ../fish/guestfish-actions.pod:4674 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4674 #, no-wrap msgid "" -" int\n" -" guestfs_tgz_in (guestfs_h *g,\n" -" const char *tarball,\n" -" const char *directory);\n" +" tgz-in (tarball|-) directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7033 ../fish/guestfish-actions.pod:4670 +#: ../fish/guestfish-actions.pod:4676 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4676 ../libguestfs-1.11.19/src/guestfs-actions.pod:7043 ../src/guestfs-actions.pod:7043 msgid "" "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7036 -msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." +#: ../fish/guestfish-actions.pod:4679 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4679 +msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7042 -msgid "guestfs_tgz_out" +#: ../fish/guestfish-actions.pod:4683 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4683 +msgid "tgz-out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7044 +#: ../fish/guestfish-actions.pod:4685 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4685 #, no-wrap msgid "" -" int\n" -" guestfs_tgz_out (guestfs_h *g,\n" -" const char *directory,\n" -" const char *tarball);\n" +" tgz-out directory (tarball|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7049 ../fish/guestfish-actions.pod:4681 +#: ../fish/guestfish-actions.pod:4687 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4687 ../libguestfs-1.11.19/src/guestfs-actions.pod:7059 ../src/guestfs-actions.pod:7059 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7052 -msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." +#: ../fish/guestfish-actions.pod:4690 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4690 +msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7058 -msgid "guestfs_touch" +#: ../fish/guestfish-actions.pod:4694 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4694 +msgid "touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7060 +#: ../fish/guestfish-actions.pod:4696 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4696 #, no-wrap msgid "" -" int\n" -" guestfs_touch (guestfs_h *g,\n" -" const char *path);\n" +" touch path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4692 +#: ../fish/guestfish-actions.pod:4698 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4698 ../libguestfs-1.11.19/src/guestfs-actions.pod:7074 ../src/guestfs-actions.pod:7074 msgid "" "Touch acts like the L<touch(1)> command. It can be used to update the " "timestamps on a file, or, if the file does not exist, to create a new " @@ -17530,90 +13736,83 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7068 ../fish/guestfish-actions.pod:4696 +#: ../fish/guestfish-actions.pod:4702 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4702 ../libguestfs-1.11.19/src/guestfs-actions.pod:7078 ../src/guestfs-actions.pod:7078 msgid "" "This command only works on regular files, and will fail on other file types " "such as directories, symbolic links, block special etc." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7075 -msgid "guestfs_truncate" +#: ../fish/guestfish-actions.pod:4705 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4705 +msgid "truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7077 +#: ../fish/guestfish-actions.pod:4707 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4707 #, no-wrap msgid "" -" int\n" -" guestfs_truncate (guestfs_h *g,\n" -" const char *path);\n" +" truncate path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7081 ../fish/guestfish-actions.pod:4703 +#: ../fish/guestfish-actions.pod:4709 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4709 ../libguestfs-1.11.19/src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:7091 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7088 -msgid "guestfs_truncate_size" +#: ../fish/guestfish-actions.pod:4712 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4712 +msgid "truncate-size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7090 +#: ../fish/guestfish-actions.pod:4714 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4714 #, no-wrap msgid "" -" int\n" -" guestfs_truncate_size (guestfs_h *g,\n" -" const char *path,\n" -" int64_t size);\n" +" truncate-size path size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7095 ../fish/guestfish-actions.pod:4710 +#: ../fish/guestfish-actions.pod:4716 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4716 ../libguestfs-1.11.19/src/guestfs-actions.pod:7105 ../src/guestfs-actions.pod:7105 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7098 +#: ../fish/guestfish-actions.pod:4719 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4719 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " "blocks are not allocated for the file until you write to it). To create a " -"non-sparse file of zeroes, use C<guestfs_fallocate64> instead." +"non-sparse file of zeroes, use L</fallocate64> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7108 -msgid "guestfs_tune2fs_l" +#: ../fish/guestfish-actions.pod:4725 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4725 +msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7110 +#: ../fish/guestfish-actions.pod:4727 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4727 #, no-wrap msgid "" -" char **\n" -" guestfs_tune2fs_l (guestfs_h *g,\n" -" const char *device);\n" +" tune2fs-l device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7114 ../fish/guestfish-actions.pod:4723 +#: ../fish/guestfish-actions.pod:4729 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4729 ../libguestfs-1.11.19/src/guestfs-actions.pod:7124 ../src/guestfs-actions.pod:7124 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7117 ../fish/guestfish-actions.pod:4726 +#: ../fish/guestfish-actions.pod:4732 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4732 ../libguestfs-1.11.19/src/guestfs-actions.pod:7127 ../src/guestfs-actions.pod:7127 msgid "" "It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage " "for more details. The list of fields returned isn't clearly defined, and " @@ -17622,75 +13821,67 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7130 -msgid "guestfs_txz_in" +#: ../fish/guestfish-actions.pod:4737 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4737 +msgid "txz-in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7132 +#: ../fish/guestfish-actions.pod:4739 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4739 #, no-wrap msgid "" -" int\n" -" guestfs_txz_in (guestfs_h *g,\n" -" const char *tarball,\n" -" const char *directory);\n" +" txz-in (tarball|-) directory\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7137 ../fish/guestfish-actions.pod:4735 +#: ../fish/guestfish-actions.pod:4741 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4741 ../libguestfs-1.11.19/src/guestfs-actions.pod:7147 ../src/guestfs-actions.pod:7147 msgid "" "This command uploads and unpacks local file C<tarball> (an I<xz compressed> " "tar file) into C<directory>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7144 -msgid "guestfs_txz_out" +#: ../fish/guestfish-actions.pod:4746 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4746 +msgid "txz-out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7146 +#: ../fish/guestfish-actions.pod:4748 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4748 #, no-wrap msgid "" -" int\n" -" guestfs_txz_out (guestfs_h *g,\n" -" const char *directory,\n" -" const char *tarball);\n" +" txz-out directory (tarball|-)\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7151 ../fish/guestfish-actions.pod:4744 +#: ../fish/guestfish-actions.pod:4750 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4750 ../libguestfs-1.11.19/src/guestfs-actions.pod:7161 ../src/guestfs-actions.pod:7161 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball> (as an xz compressed tar archive)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7158 -msgid "guestfs_umask" +#: ../fish/guestfish-actions.pod:4755 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4755 +msgid "umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7160 +#: ../fish/guestfish-actions.pod:4757 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4757 #, no-wrap msgid "" -" int\n" -" guestfs_umask (guestfs_h *g,\n" -" int mask);\n" +" umask mask\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7164 ../fish/guestfish-actions.pod:4753 +#: ../fish/guestfish-actions.pod:4759 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4759 ../libguestfs-1.11.19/src/guestfs-actions.pod:7174 ../src/guestfs-actions.pod:7174 msgid "" "This function sets the mask used for creating new files and device nodes to " "C<mask & 0777>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7167 ../fish/guestfish-actions.pod:4756 +#: ../fish/guestfish-actions.pod:4762 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4762 ../libguestfs-1.11.19/src/guestfs-actions.pod:7177 ../src/guestfs-actions.pod:7177 msgid "" "Typical umask values would be C<022> which creates new files with " "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates " @@ -17698,7 +13889,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7172 ../fish/guestfish-actions.pod:4761 +#: ../fish/guestfish-actions.pod:4767 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4767 ../libguestfs-1.11.19/src/guestfs-actions.pod:7182 ../src/guestfs-actions.pod:7182 msgid "" "The default umask is C<022>. This is important because it means that " "directories and device nodes will be created with C<0644> or C<0755> mode " @@ -17706,108 +13897,106 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7176 -msgid "" -"See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " -"C<guestfs_mkdir>." +#: ../fish/guestfish-actions.pod:4771 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4771 +msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7179 ../fish/guestfish-actions.pod:4768 +#: ../fish/guestfish-actions.pod:4774 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4774 ../libguestfs-1.11.19/src/guestfs-actions.pod:7189 ../src/guestfs-actions.pod:7189 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7185 -msgid "guestfs_umount" +#: ../fish/guestfish-actions.pod:4776 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4776 +msgid "umount" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4778 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4778 +msgid "unmount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7187 +#: ../fish/guestfish-actions.pod:4780 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4780 #, no-wrap msgid "" -" int\n" -" guestfs_umount (guestfs_h *g,\n" -" const char *pathordevice);\n" +" umount pathordevice\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7191 ../fish/guestfish-actions.pod:4776 +#: ../fish/guestfish-actions.pod:4782 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4782 ../libguestfs-1.11.19/src/guestfs-actions.pod:7201 ../src/guestfs-actions.pod:7201 msgid "" "This unmounts the given filesystem. The filesystem may be specified either " "by its mountpoint (path) or the device which contains the filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7199 -msgid "guestfs_umount_all" +#: ../fish/guestfish-actions.pod:4786 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4786 +msgid "umount-all" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:4788 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4788 +msgid "unmount-all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7201 +#: ../fish/guestfish-actions.pod:4790 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4790 #, no-wrap msgid "" -" int\n" -" guestfs_umount_all (guestfs_h *g);\n" +" umount-all\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7204 ../fish/guestfish-actions.pod:4786 +#: ../fish/guestfish-actions.pod:4792 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4792 ../libguestfs-1.11.19/src/guestfs-actions.pod:7214 ../src/guestfs-actions.pod:7214 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7206 ../fish/guestfish-actions.pod:4788 +#: ../fish/guestfish-actions.pod:4794 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4794 ../libguestfs-1.11.19/src/guestfs-actions.pod:7216 ../src/guestfs-actions.pod:7216 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7212 -msgid "guestfs_upload" +#: ../fish/guestfish-actions.pod:4796 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4796 +msgid "upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7214 +#: ../fish/guestfish-actions.pod:4798 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4798 #, no-wrap msgid "" -" int\n" -" guestfs_upload (guestfs_h *g,\n" -" const char *filename,\n" -" const char *remotefilename);\n" +" upload (filename|-) remotefilename\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7219 ../src/guestfs-actions.pod:7243 ../fish/guestfish-actions.pod:4794 ../fish/guestfish-actions.pod:4807 +#: ../fish/guestfish-actions.pod:4800 ../fish/guestfish-actions.pod:4813 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4800 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4813 ../libguestfs-1.11.19/src/guestfs-actions.pod:7229 ../libguestfs-1.11.19/src/guestfs-actions.pod:7253 ../src/guestfs-actions.pod:7229 ../src/guestfs-actions.pod:7253 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7224 -msgid "See also C<guestfs_download>." +#: ../fish/guestfish-actions.pod:4805 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4805 +msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7235 -msgid "guestfs_upload_offset" +#: ../fish/guestfish-actions.pod:4809 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4809 +msgid "upload-offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7237 +#: ../fish/guestfish-actions.pod:4811 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4811 #, no-wrap msgid "" -" int\n" -" guestfs_upload_offset (guestfs_h *g,\n" -" const char *filename,\n" -" const char *remotefilename,\n" -" int64_t offset);\n" +" upload-offset (filename|-) remotefilename offset\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7246 ../fish/guestfish-actions.pod:4810 +#: ../fish/guestfish-actions.pod:4816 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4816 ../libguestfs-1.11.19/src/guestfs-actions.pod:7256 ../src/guestfs-actions.pod:7256 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -17817,58 +14006,52 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7253 +#: ../fish/guestfish-actions.pod:4823 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4823 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " -"this call, unlike with C<guestfs_pwrite>, and this call always writes the " -"full amount unless an error occurs." +"this call, unlike with L</pwrite>, and this call always writes the full " +"amount unless an error occurs." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7258 -msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." +#: ../fish/guestfish-actions.pod:4828 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4828 +msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7269 -msgid "guestfs_utimens" +#: ../fish/guestfish-actions.pod:4832 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4832 +msgid "utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7271 +#: ../fish/guestfish-actions.pod:4834 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4834 #, no-wrap msgid "" -" int\n" -" guestfs_utimens (guestfs_h *g,\n" -" const char *path,\n" -" int64_t atsecs,\n" -" int64_t atnsecs,\n" -" int64_t mtsecs,\n" -" int64_t mtnsecs);\n" +" utimens path atsecs atnsecs mtsecs mtnsecs\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7279 ../fish/guestfish-actions.pod:4830 +#: ../fish/guestfish-actions.pod:4836 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4836 ../libguestfs-1.11.19/src/guestfs-actions.pod:7289 ../src/guestfs-actions.pod:7289 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7282 ../fish/guestfish-actions.pod:4833 +#: ../fish/guestfish-actions.pod:4839 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4839 ../libguestfs-1.11.19/src/guestfs-actions.pod:7292 ../src/guestfs-actions.pod:7292 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7285 ../fish/guestfish-actions.pod:4836 +#: ../fish/guestfish-actions.pod:4842 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4842 ../libguestfs-1.11.19/src/guestfs-actions.pod:7295 ../src/guestfs-actions.pod:7295 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7288 ../fish/guestfish-actions.pod:4839 +#: ../fish/guestfish-actions.pod:4845 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4845 ../libguestfs-1.11.19/src/guestfs-actions.pod:7298 ../src/guestfs-actions.pod:7298 msgid "" "If the C<*nsecs> field contains the special value C<-1> then the " "corresponding timestamp is set to the current time. (The C<*secs> field is " @@ -17876,7 +14059,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7292 ../fish/guestfish-actions.pod:4843 +#: ../fish/guestfish-actions.pod:4849 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4849 ../libguestfs-1.11.19/src/guestfs-actions.pod:7302 ../src/guestfs-actions.pod:7302 msgid "" "If the C<*nsecs> field contains the special value C<-2> then the " "corresponding timestamp is left unchanged. (The C<*secs> field is ignored " @@ -17884,26 +14067,25 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7300 ../src/guestfs-structs.pod:175 -msgid "guestfs_version" +#: ../fish/guestfish-actions.pod:4853 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4853 +msgid "version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7302 +#: ../fish/guestfish-actions.pod:4855 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4855 #, no-wrap msgid "" -" struct guestfs_version *\n" -" guestfs_version (guestfs_h *g);\n" +" version\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7305 ../fish/guestfish-actions.pod:4851 +#: ../fish/guestfish-actions.pod:4857 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4857 ../libguestfs-1.11.19/src/guestfs-actions.pod:7315 ../src/guestfs-actions.pod:7315 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7308 ../fish/guestfish-actions.pod:4854 +#: ../fish/guestfish-actions.pod:4860 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4860 ../libguestfs-1.11.19/src/guestfs-actions.pod:7318 ../src/guestfs-actions.pod:7318 msgid "" "Note that because of dynamic linking this is not necessarily the version of " "libguestfs that you compiled against. You can compile the program, and then " @@ -17912,7 +14094,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7313 ../fish/guestfish-actions.pod:4859 +#: ../fish/guestfish-actions.pod:4865 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4865 ../libguestfs-1.11.19/src/guestfs-actions.pod:7323 ../src/guestfs-actions.pod:7323 msgid "" "This call was added in version C<1.0.58>. In previous versions of " "libguestfs there was no way to get the version number. From C code you can " @@ -17921,7 +14103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7319 ../fish/guestfish-actions.pod:4865 +#: ../fish/guestfish-actions.pod:4871 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4871 ../libguestfs-1.11.19/src/guestfs-actions.pod:7329 ../src/guestfs-actions.pod:7329 msgid "" "The call returns a structure with four elements. The first three (C<major>, " "C<minor> and C<release>) are numbers and correspond to the usual version " @@ -17930,95 +14112,74 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7325 ../fish/guestfish-actions.pod:4871 +#: ../fish/guestfish-actions.pod:4877 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4877 ../libguestfs-1.11.19/src/guestfs-actions.pod:7335 ../src/guestfs-actions.pod:7335 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7328 ../fish/guestfish-actions.pod:4874 +#: ../fish/guestfish-actions.pod:4880 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4880 ../libguestfs-1.11.19/src/guestfs-actions.pod:7338 ../src/guestfs-actions.pod:7338 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7330 +#: ../fish/guestfish-actions.pod:4882 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4882 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " "earlier versions, making this an unreliable way to test for features. Use " -"C<guestfs_available> instead." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7336 -msgid "" -"This function returns a C<struct guestfs_version *>, or NULL if there was an " -"error. I<The caller must call C<guestfs_free_version> after use>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7340 -msgid "(Added in 1.0.58)" +"L</available> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7342 -msgid "guestfs_vfs_label" +#: ../fish/guestfish-actions.pod:4888 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4888 +msgid "vfs-label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7344 +#: ../fish/guestfish-actions.pod:4890 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4890 #, no-wrap msgid "" -" char *\n" -" guestfs_vfs_label (guestfs_h *g,\n" -" const char *device);\n" +" vfs-label device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7348 ../fish/guestfish-actions.pod:4886 +#: ../fish/guestfish-actions.pod:4892 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4892 ../libguestfs-1.11.19/src/guestfs-actions.pod:7358 ../src/guestfs-actions.pod:7358 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7351 ../fish/guestfish-actions.pod:4889 +#: ../fish/guestfish-actions.pod:4895 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4895 ../libguestfs-1.11.19/src/guestfs-actions.pod:7361 ../src/guestfs-actions.pod:7361 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7353 -msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7358 ../src/guestfs-actions.pod:7395 -msgid "(Added in 1.3.18)" +#: ../fish/guestfish-actions.pod:4897 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4897 +msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7360 -msgid "guestfs_vfs_type" +#: ../fish/guestfish-actions.pod:4899 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4899 +msgid "vfs-type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7362 +#: ../fish/guestfish-actions.pod:4901 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4901 #, no-wrap msgid "" -" char *\n" -" guestfs_vfs_type (guestfs_h *g,\n" -" const char *device);\n" +" vfs-type device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7366 ../fish/guestfish-actions.pod:4897 +#: ../fish/guestfish-actions.pod:4903 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4903 ../libguestfs-1.11.19/src/guestfs-actions.pod:7376 ../src/guestfs-actions.pod:7376 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7369 ../fish/guestfish-actions.pod:4900 +#: ../fish/guestfish-actions.pod:4906 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4906 ../libguestfs-1.11.19/src/guestfs-actions.pod:7379 ../src/guestfs-actions.pod:7379 msgid "" "For most filesystems, the result is the name of the Linux VFS module which " "would be used to mount this filesystem if you mounted it without specifying " @@ -18026,607 +14187,510 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7379 -msgid "guestfs_vfs_uuid" +#: ../fish/guestfish-actions.pod:4911 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4911 +msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7381 +#: ../fish/guestfish-actions.pod:4913 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4913 #, no-wrap msgid "" -" char *\n" -" guestfs_vfs_uuid (guestfs_h *g,\n" -" const char *device);\n" +" vfs-uuid device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7385 ../fish/guestfish-actions.pod:4909 +#: ../fish/guestfish-actions.pod:4915 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4915 ../libguestfs-1.11.19/src/guestfs-actions.pod:7395 ../src/guestfs-actions.pod:7395 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7388 ../fish/guestfish-actions.pod:4912 +#: ../fish/guestfish-actions.pod:4918 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4918 ../libguestfs-1.11.19/src/guestfs-actions.pod:7398 ../src/guestfs-actions.pod:7398 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7390 -msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." +#: ../fish/guestfish-actions.pod:4920 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4920 +msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7397 -msgid "guestfs_vg_activate" +#: ../fish/guestfish-actions.pod:4922 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4922 +msgid "vg-activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7399 +#: ../fish/guestfish-actions.pod:4924 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4924 #, no-wrap msgid "" -" int\n" -" guestfs_vg_activate (guestfs_h *g,\n" -" int activate,\n" -" char *const *volgroups);\n" +" vg-activate true|false 'volgroups ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7404 ../fish/guestfish-actions.pod:4920 +#: ../fish/guestfish-actions.pod:4926 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4926 ../libguestfs-1.11.19/src/guestfs-actions.pod:7414 ../src/guestfs-actions.pod:7414 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7407 ../fish/guestfish-actions.pod:4923 +#: ../fish/guestfish-actions.pod:4929 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4929 ../libguestfs-1.11.19/src/guestfs-actions.pod:7417 ../src/guestfs-actions.pod:7417 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7409 ../fish/guestfish-actions.pod:4925 +#: ../fish/guestfish-actions.pod:4931 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4931 ../libguestfs-1.11.19/src/guestfs-actions.pod:7419 ../src/guestfs-actions.pod:7419 msgid "" "Note that if C<volgroups> is an empty list then B<all> volume groups are " "activated or deactivated." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7416 -msgid "guestfs_vg_activate_all" +#: ../fish/guestfish-actions.pod:4934 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4934 +msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7418 +#: ../fish/guestfish-actions.pod:4936 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4936 #, no-wrap msgid "" -" int\n" -" guestfs_vg_activate_all (guestfs_h *g,\n" -" int activate);\n" +" vg-activate-all true|false\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7422 ../fish/guestfish-actions.pod:4932 +#: ../fish/guestfish-actions.pod:4938 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4938 ../libguestfs-1.11.19/src/guestfs-actions.pod:7432 ../src/guestfs-actions.pod:7432 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7425 ../fish/guestfish-actions.pod:4935 +#: ../fish/guestfish-actions.pod:4941 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4941 ../libguestfs-1.11.19/src/guestfs-actions.pod:7435 ../src/guestfs-actions.pod:7435 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7431 -msgid "guestfs_vgcreate" +#: ../fish/guestfish-actions.pod:4943 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4943 +msgid "vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7433 +#: ../fish/guestfish-actions.pod:4945 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4945 #, no-wrap msgid "" -" int\n" -" guestfs_vgcreate (guestfs_h *g,\n" -" const char *volgroup,\n" -" char *const *physvols);\n" +" vgcreate volgroup 'physvols ...'\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7438 ../fish/guestfish-actions.pod:4941 +#: ../fish/guestfish-actions.pod:4947 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4947 ../libguestfs-1.11.19/src/guestfs-actions.pod:7448 ../src/guestfs-actions.pod:7448 msgid "" "This creates an LVM volume group called C<volgroup> from the non-empty list " "of physical volumes C<physvols>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7445 -msgid "guestfs_vglvuuids" +#: ../fish/guestfish-actions.pod:4950 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4950 +msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7447 +#: ../fish/guestfish-actions.pod:4952 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4952 #, no-wrap msgid "" -" char **\n" -" guestfs_vglvuuids (guestfs_h *g,\n" -" const char *vgname);\n" +" vglvuuids vgname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7451 ../fish/guestfish-actions.pod:4948 +#: ../fish/guestfish-actions.pod:4954 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4954 ../libguestfs-1.11.19/src/guestfs-actions.pod:7461 ../src/guestfs-actions.pod:7461 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the logical " "volumes created in this volume group." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7454 +#: ../fish/guestfish-actions.pod:4957 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4957 msgid "" -"You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " -"associate logical volumes and volume groups." +"You can use this along with L</lvs> and L</lvuuid> calls to associate " +"logical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7457 -msgid "See also C<guestfs_vgpvuuids>." +#: ../fish/guestfish-actions.pod:4960 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4960 +msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7465 -msgid "guestfs_vgpvuuids" +#: ../fish/guestfish-actions.pod:4962 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4962 +msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7467 +#: ../fish/guestfish-actions.pod:4964 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4964 #, no-wrap msgid "" -" char **\n" -" guestfs_vgpvuuids (guestfs_h *g,\n" -" const char *vgname);\n" +" vgpvuuids vgname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7471 ../fish/guestfish-actions.pod:4960 +#: ../fish/guestfish-actions.pod:4966 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4966 ../libguestfs-1.11.19/src/guestfs-actions.pod:7481 ../src/guestfs-actions.pod:7481 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the physical " "volumes that this volume group resides on." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7474 +#: ../fish/guestfish-actions.pod:4969 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4969 msgid "" -"You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " -"associate physical volumes and volume groups." +"You can use this along with L</pvs> and L</pvuuid> calls to associate " +"physical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7477 -msgid "See also C<guestfs_vglvuuids>." +#: ../fish/guestfish-actions.pod:4972 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4972 +msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7485 -msgid "guestfs_vgremove" +#: ../fish/guestfish-actions.pod:4974 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4974 +msgid "vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7487 +#: ../fish/guestfish-actions.pod:4976 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4976 #, no-wrap msgid "" -" int\n" -" guestfs_vgremove (guestfs_h *g,\n" -" const char *vgname);\n" +" vgremove vgname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7491 ../fish/guestfish-actions.pod:4972 +#: ../fish/guestfish-actions.pod:4978 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4978 ../libguestfs-1.11.19/src/guestfs-actions.pod:7501 ../src/guestfs-actions.pod:7501 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7493 ../fish/guestfish-actions.pod:4974 +#: ../fish/guestfish-actions.pod:4980 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4980 ../libguestfs-1.11.19/src/guestfs-actions.pod:7503 ../src/guestfs-actions.pod:7503 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7500 -msgid "guestfs_vgrename" +#: ../fish/guestfish-actions.pod:4983 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4983 +msgid "vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7502 +#: ../fish/guestfish-actions.pod:4985 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4985 #, no-wrap msgid "" -" int\n" -" guestfs_vgrename (guestfs_h *g,\n" -" const char *volgroup,\n" -" const char *newvolgroup);\n" +" vgrename volgroup newvolgroup\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7507 ../fish/guestfish-actions.pod:4981 +#: ../fish/guestfish-actions.pod:4987 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4987 ../libguestfs-1.11.19/src/guestfs-actions.pod:7517 ../src/guestfs-actions.pod:7517 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7513 -msgid "guestfs_vgs" +#: ../fish/guestfish-actions.pod:4989 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4989 +msgid "vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7515 +#: ../fish/guestfish-actions.pod:4991 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4991 #, no-wrap msgid "" -" char **\n" -" guestfs_vgs (guestfs_h *g);\n" +" vgs\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7518 ../fish/guestfish-actions.pod:4987 +#: ../fish/guestfish-actions.pod:4993 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4993 ../libguestfs-1.11.19/src/guestfs-actions.pod:7528 ../src/guestfs-actions.pod:7528 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7521 ../fish/guestfish-actions.pod:4990 +#: ../fish/guestfish-actions.pod:4996 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4996 ../libguestfs-1.11.19/src/guestfs-actions.pod:7531 ../src/guestfs-actions.pod:7531 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7524 -msgid "See also C<guestfs_vgs_full>." +#: ../fish/guestfish-actions.pod:4999 ../libguestfs-1.11.19/fish/guestfish-actions.pod:4999 +msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7532 -msgid "guestfs_vgs_full" +#: ../fish/guestfish-actions.pod:5001 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5001 +msgid "vgs-full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7534 +#: ../fish/guestfish-actions.pod:5003 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5003 #, no-wrap msgid "" -" struct guestfs_lvm_vg_list *\n" -" guestfs_vgs_full (guestfs_h *g);\n" +" vgs-full\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7537 ../fish/guestfish-actions.pod:4999 +#: ../fish/guestfish-actions.pod:5005 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5005 ../libguestfs-1.11.19/src/guestfs-actions.pod:7547 ../src/guestfs-actions.pod:7547 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command. The \"full\" version includes all fields." msgstr "" -#. type: textblock -#: ../src/guestfs-actions.pod:7540 -msgid "" -"This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there " -"was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after " -"use>." -msgstr "" - #. type: =head2 -#: ../src/guestfs-actions.pod:7546 -msgid "guestfs_vgscan" +#: ../fish/guestfish-actions.pod:5008 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5008 +msgid "vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7548 +#: ../fish/guestfish-actions.pod:5010 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5010 #, no-wrap msgid "" -" int\n" -" guestfs_vgscan (guestfs_h *g);\n" +" vgscan\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7551 ../fish/guestfish-actions.pod:5006 +#: ../fish/guestfish-actions.pod:5012 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5012 ../libguestfs-1.11.19/src/guestfs-actions.pod:7561 ../src/guestfs-actions.pod:7561 msgid "" "This rescans all block devices and rebuilds the list of LVM physical " "volumes, volume groups and logical volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7558 -msgid "guestfs_vguuid" +#: ../fish/guestfish-actions.pod:5015 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5015 +msgid "vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7560 +#: ../fish/guestfish-actions.pod:5017 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5017 #, no-wrap msgid "" -" char *\n" -" guestfs_vguuid (guestfs_h *g,\n" -" const char *vgname);\n" +" vguuid vgname\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7564 ../fish/guestfish-actions.pod:5013 +#: ../fish/guestfish-actions.pod:5019 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5019 ../libguestfs-1.11.19/src/guestfs-actions.pod:7574 ../src/guestfs-actions.pod:7574 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7571 -msgid "guestfs_wait_ready" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-actions.pod:7573 -#, no-wrap -msgid "" -" int\n" -" guestfs_wait_ready (guestfs_h *g);\n" -"\n" -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7576 -msgid "This function is a no op." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7578 -msgid "" -"In versions of the API E<lt> 1.0.71 you had to call this function just after " -"calling C<guestfs_launch> to wait for the launch to complete. However this " -"is no longer necessary because C<guestfs_launch> now does the waiting." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7583 -msgid "" -"If you see any calls to this function in code then you can just remove them, " -"unless you want to retain compatibility with older versions of the API." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7589 -msgid "This function is deprecated. In new code, use the C<launch> call instead." -msgstr "" - -#. type: =head2 -#: ../src/guestfs-actions.pod:7598 -msgid "guestfs_wc_c" +#: ../fish/guestfish-actions.pod:5021 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5021 +msgid "wc-c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7600 +#: ../fish/guestfish-actions.pod:5023 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5023 #, no-wrap msgid "" -" int\n" -" guestfs_wc_c (guestfs_h *g,\n" -" const char *path);\n" +" wc-c path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7604 ../fish/guestfish-actions.pod:5019 +#: ../fish/guestfish-actions.pod:5025 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5025 ../libguestfs-1.11.19/src/guestfs-actions.pod:7614 ../src/guestfs-actions.pod:7614 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7611 -msgid "guestfs_wc_l" +#: ../fish/guestfish-actions.pod:5028 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5028 +msgid "wc-l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7613 +#: ../fish/guestfish-actions.pod:5030 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5030 #, no-wrap msgid "" -" int\n" -" guestfs_wc_l (guestfs_h *g,\n" -" const char *path);\n" +" wc-l path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7617 ../fish/guestfish-actions.pod:5026 +#: ../fish/guestfish-actions.pod:5032 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5032 ../libguestfs-1.11.19/src/guestfs-actions.pod:7627 ../src/guestfs-actions.pod:7627 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7624 -msgid "guestfs_wc_w" +#: ../fish/guestfish-actions.pod:5035 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5035 +msgid "wc-w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7626 +#: ../fish/guestfish-actions.pod:5037 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5037 #, no-wrap msgid "" -" int\n" -" guestfs_wc_w (guestfs_h *g,\n" -" const char *path);\n" +" wc-w path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7630 ../fish/guestfish-actions.pod:5033 +#: ../fish/guestfish-actions.pod:5039 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5039 ../libguestfs-1.11.19/src/guestfs-actions.pod:7640 ../src/guestfs-actions.pod:7640 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7637 -msgid "guestfs_write" +#: ../fish/guestfish-actions.pod:5042 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5042 +msgid "write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7639 +#: ../fish/guestfish-actions.pod:5044 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5044 #, no-wrap msgid "" -" int\n" -" guestfs_write (guestfs_h *g,\n" -" const char *path,\n" -" const char *content,\n" -" size_t content_size);\n" +" write path content\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7645 ../fish/guestfish-actions.pod:5040 +#: ../fish/guestfish-actions.pod:5046 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5046 ../libguestfs-1.11.19/src/guestfs-actions.pod:7655 ../src/guestfs-actions.pod:7655 msgid "" "This call creates a file called C<path>. The content of the file is the " "string C<content> (which can contain any 8 bit data)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7648 -msgid "See also C<guestfs_write_append>." +#: ../fish/guestfish-actions.pod:5049 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5049 +msgid "See also L</write-append>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7657 -msgid "guestfs_write_append" +#: ../fish/guestfish-actions.pod:5054 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5054 +msgid "write-append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7659 +#: ../fish/guestfish-actions.pod:5056 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5056 #, no-wrap msgid "" -" int\n" -" guestfs_write_append (guestfs_h *g,\n" -" const char *path,\n" -" const char *content,\n" -" size_t content_size);\n" +" write-append path content\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7665 ../fish/guestfish-actions.pod:5052 +#: ../fish/guestfish-actions.pod:5058 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5058 ../libguestfs-1.11.19/src/guestfs-actions.pod:7675 ../src/guestfs-actions.pod:7675 msgid "" "This call appends C<content> to the end of file C<path>. If C<path> does " "not exist, then a new file is created." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7668 -msgid "See also C<guestfs_write>." +#: ../fish/guestfish-actions.pod:5061 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5061 +msgid "See also L</write>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7675 -msgid "guestfs_write_file" +#: ../fish/guestfish-actions.pod:5066 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5066 +msgid "write-file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7677 +#: ../fish/guestfish-actions.pod:5068 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5068 #, no-wrap msgid "" -" int\n" -" guestfs_write_file (guestfs_h *g,\n" -" const char *path,\n" -" const char *content,\n" -" int size);\n" +" write-file path content size\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7683 ../fish/guestfish-actions.pod:5064 +#: ../fish/guestfish-actions.pod:5070 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5070 ../libguestfs-1.11.19/src/guestfs-actions.pod:7695 ../src/guestfs-actions.pod:7695 msgid "" "This call creates a file called C<path>. The contents of the file is the " "string C<content> (which can contain any 8 bit data), with length C<size>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7687 ../fish/guestfish-actions.pod:5068 +#: ../fish/guestfish-actions.pod:5074 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5074 ../libguestfs-1.11.19/src/guestfs-actions.pod:7699 ../src/guestfs-actions.pod:7699 msgid "" "As a special case, if C<size> is C<0> then the length is calculated using " "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7691 ../fish/guestfish-actions.pod:5072 +#: ../fish/guestfish-actions.pod:5078 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5078 ../libguestfs-1.11.19/src/guestfs-actions.pod:7703 ../src/guestfs-actions.pod:7703 msgid "" "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does " "I<not> work, even if the length is specified." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7699 ../fish/guestfish-actions.pod:5078 +#: ../fish/guestfish-actions.pod:5084 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5084 ../libguestfs-1.11.19/src/guestfs-actions.pod:7711 ../src/guestfs-actions.pod:7711 msgid "This function is deprecated. In new code, use the C<write> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7708 -msgid "guestfs_zegrep" +#: ../fish/guestfish-actions.pod:5091 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5091 +msgid "zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7710 +#: ../fish/guestfish-actions.pod:5093 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5093 #, no-wrap msgid "" -" char **\n" -" guestfs_zegrep (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" zegrep regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7715 ../fish/guestfish-actions.pod:5089 +#: ../fish/guestfish-actions.pod:5095 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5095 ../libguestfs-1.11.19/src/guestfs-actions.pod:7727 ../src/guestfs-actions.pod:7727 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7727 -msgid "guestfs_zegrepi" +#: ../fish/guestfish-actions.pod:5101 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5101 +msgid "zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7729 +#: ../fish/guestfish-actions.pod:5103 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5103 #, no-wrap msgid "" -" char **\n" -" guestfs_zegrepi (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" zegrepi regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7734 ../fish/guestfish-actions.pod:5099 +#: ../fish/guestfish-actions.pod:5105 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5105 ../libguestfs-1.11.19/src/guestfs-actions.pod:7746 ../src/guestfs-actions.pod:7746 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7746 -msgid "guestfs_zero" +#: ../fish/guestfish-actions.pod:5111 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5111 +msgid "zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7748 +#: ../fish/guestfish-actions.pod:5113 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5113 #, no-wrap msgid "" -" int\n" -" guestfs_zero (guestfs_h *g,\n" -" const char *device);\n" +" zero device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7752 ../fish/guestfish-actions.pod:5109 +#: ../fish/guestfish-actions.pod:5115 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5115 ../libguestfs-1.11.19/src/guestfs-actions.pod:7764 ../src/guestfs-actions.pod:7764 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7754 ../fish/guestfish-actions.pod:5111 +#: ../fish/guestfish-actions.pod:5117 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5117 ../libguestfs-1.11.19/src/guestfs-actions.pod:7766 ../src/guestfs-actions.pod:7766 msgid "" "How many blocks are zeroed isn't specified (but it's I<not> enough to " "securely wipe the device). It should be sufficient to remove any partition " @@ -18634,56 +14698,45 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7758 -msgid "" -"See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " -"C<guestfs_is_zero_device>" +#: ../fish/guestfish-actions.pod:5121 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5121 +msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7770 -msgid "guestfs_zero_device" +#: ../fish/guestfish-actions.pod:5124 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5124 +msgid "zero-device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7772 +#: ../fish/guestfish-actions.pod:5126 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5126 #, no-wrap msgid "" -" int\n" -" guestfs_zero_device (guestfs_h *g,\n" -" const char *device);\n" +" zero-device device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7776 +#: ../fish/guestfish-actions.pod:5128 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5128 msgid "" -"This command writes zeroes over the entire C<device>. Compare with " -"C<guestfs_zero> which just zeroes the first few blocks of a device." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:7790 -msgid "(Added in 1.3.1)" +"This command writes zeroes over the entire C<device>. Compare with L</zero> " +"which just zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7792 -msgid "guestfs_zerofree" +#: ../fish/guestfish-actions.pod:5135 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5135 +msgid "zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7794 +#: ../fish/guestfish-actions.pod:5137 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5137 #, no-wrap msgid "" -" int\n" -" guestfs_zerofree (guestfs_h *g,\n" -" const char *device);\n" +" zerofree device\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7798 ../fish/guestfish-actions.pod:5133 +#: ../fish/guestfish-actions.pod:5139 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5139 ../libguestfs-1.11.19/src/guestfs-actions.pod:7810 ../src/guestfs-actions.pod:7810 msgid "" "This runs the I<zerofree> program on C<device>. This program claims to zero " "unused inodes and disk blocks on an ext2/3 filesystem, thus making it " @@ -18691,846 +14744,636 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7803 ../fish/guestfish-actions.pod:5138 +#: ../fish/guestfish-actions.pod:5144 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5144 ../libguestfs-1.11.19/src/guestfs-actions.pod:7815 ../src/guestfs-actions.pod:7815 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7806 ../fish/guestfish-actions.pod:5141 +#: ../fish/guestfish-actions.pod:5147 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5147 ../libguestfs-1.11.19/src/guestfs-actions.pod:7818 ../src/guestfs-actions.pod:7818 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7813 -msgid "guestfs_zfgrep" +#: ../fish/guestfish-actions.pod:5150 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5150 +msgid "zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7815 +#: ../fish/guestfish-actions.pod:5152 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5152 #, no-wrap msgid "" -" char **\n" -" guestfs_zfgrep (guestfs_h *g,\n" -" const char *pattern,\n" -" const char *path);\n" +" zfgrep pattern path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7820 ../fish/guestfish-actions.pod:5148 +#: ../fish/guestfish-actions.pod:5154 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5154 ../libguestfs-1.11.19/src/guestfs-actions.pod:7832 ../src/guestfs-actions.pod:7832 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7832 -msgid "guestfs_zfgrepi" +#: ../fish/guestfish-actions.pod:5160 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5160 +msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7834 +#: ../fish/guestfish-actions.pod:5162 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5162 #, no-wrap msgid "" -" char **\n" -" guestfs_zfgrepi (guestfs_h *g,\n" -" const char *pattern,\n" -" const char *path);\n" +" zfgrepi pattern path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7839 ../fish/guestfish-actions.pod:5158 +#: ../fish/guestfish-actions.pod:5164 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5164 ../libguestfs-1.11.19/src/guestfs-actions.pod:7851 ../src/guestfs-actions.pod:7851 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7851 -msgid "guestfs_zfile" +#: ../fish/guestfish-actions.pod:5170 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5170 +msgid "zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7853 +#: ../fish/guestfish-actions.pod:5172 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5172 #, no-wrap msgid "" -" char *\n" -" guestfs_zfile (guestfs_h *g,\n" -" const char *meth,\n" -" const char *path);\n" +" zfile meth path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7858 ../fish/guestfish-actions.pod:5168 +#: ../fish/guestfish-actions.pod:5174 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5174 ../libguestfs-1.11.19/src/guestfs-actions.pod:7870 ../src/guestfs-actions.pod:7870 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7861 ../fish/guestfish-actions.pod:5171 +#: ../fish/guestfish-actions.pod:5177 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5177 ../libguestfs-1.11.19/src/guestfs-actions.pod:7873 ../src/guestfs-actions.pod:7873 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7863 -msgid "" -"Since 1.0.63, use C<guestfs_file> instead which can now process compressed " -"files." +#: ../fish/guestfish-actions.pod:5179 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5179 +msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7869 ../fish/guestfish-actions.pod:5176 +#: ../fish/guestfish-actions.pod:5182 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5182 ../libguestfs-1.11.19/src/guestfs-actions.pod:7881 ../src/guestfs-actions.pod:7881 msgid "This function is deprecated. In new code, use the C<file> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7878 -msgid "guestfs_zgrep" +#: ../fish/guestfish-actions.pod:5189 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5189 +msgid "zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7880 +#: ../fish/guestfish-actions.pod:5191 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5191 #, no-wrap msgid "" -" char **\n" -" guestfs_zgrep (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" zgrep regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7885 ../fish/guestfish-actions.pod:5187 +#: ../fish/guestfish-actions.pod:5193 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5193 ../libguestfs-1.11.19/src/guestfs-actions.pod:7897 ../src/guestfs-actions.pod:7897 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7897 -msgid "guestfs_zgrepi" +#: ../fish/guestfish-actions.pod:5199 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5199 +msgid "zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7899 +#: ../fish/guestfish-actions.pod:5201 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5201 #, no-wrap msgid "" -" char **\n" -" guestfs_zgrepi (guestfs_h *g,\n" -" const char *regex,\n" -" const char *path);\n" +" zgrepi regex path\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7904 ../fish/guestfish-actions.pod:5197 +#: ../fish/guestfish-actions.pod:5203 ../libguestfs-1.11.19/fish/guestfish-actions.pod:5203 ../libguestfs-1.11.19/src/guestfs-actions.pod:7916 ../src/guestfs-actions.pod:7916 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:3 -msgid "B<augeas>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:1 ../libguestfs-1.11.19/fish/guestfish-commands.pod:1 +msgid "alloc" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:5 -msgid "" -"The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> " -"L</guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> " -"L</guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> " -"L</guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> " -"L</guestfs_aug_rm> L</guestfs_aug_save> L</guestfs_aug_set>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:3 ../libguestfs-1.11.19/fish/guestfish-commands.pod:3 +msgid "allocate" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:21 -msgid "B<btrfs>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:5 ../libguestfs-1.11.19/fish/guestfish-commands.pod:5 +#, no-wrap +msgid "" +" alloc filename size\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:23 -msgid "The following functions: L</guestfs_btrfs_filesystem_resize>" -msgstr "" - -#. type: =item -#: ../src/guestfs-availability.pod:26 -msgid "B<inotify>" +#: ../fish/guestfish-commands.pod:7 ../libguestfs-1.11.19/fish/guestfish-commands.pod:7 +msgid "" +"This creates an empty (zeroed) file of the given size, and then adds so it " +"can be further examined." msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:28 -msgid "" -"The following functions: L</guestfs_inotify_add_watch> " -"L</guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> " -"L</guestfs_inotify_read> L</guestfs_inotify_rm_watch>" +#: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:182 ../libguestfs-1.11.19/fish/guestfish-commands.pod:10 ../libguestfs-1.11.19/fish/guestfish-commands.pod:182 +msgid "For more advanced image creation, see L<qemu-img(1)> utility." msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:36 -msgid "B<linuxfsuuid>" +#. type: textblock +#: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:184 ../libguestfs-1.11.19/fish/guestfish-commands.pod:12 ../libguestfs-1.11.19/fish/guestfish-commands.pod:184 +msgid "Size can be specified using standard suffixes, eg. C<1M>." msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:38 +#: ../fish/guestfish-commands.pod:14 ../libguestfs-1.11.19/fish/guestfish-commands.pod:14 msgid "" -"The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> " -"L</guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>" +"To create a sparse file, use L</sparse> instead. To create a prepared disk " +"image, see L</PREPARED DISK IMAGES>." msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:45 -msgid "B<linuxmodules>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:17 ../libguestfs-1.11.19/fish/guestfish-commands.pod:17 +msgid "copy-in" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:47 -msgid "The following functions: L</guestfs_modprobe>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:19 ../libguestfs-1.11.19/fish/guestfish-commands.pod:19 +#, no-wrap +msgid "" +" copy-in local [local ...] /remotedir\n" +"\n" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:50 -msgid "B<linuxxattrs>" +#. type: textblock +#: ../fish/guestfish-commands.pod:21 ../libguestfs-1.11.19/fish/guestfish-commands.pod:21 +msgid "" +"C<copy-in> copies local files or directories recursively into the disk " +"image, placing them in the directory called C</remotedir> (which must " +"exist). This guestfish meta-command turns into a sequence of L</tar-in> and " +"other commands as necessary." msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:52 +#: ../fish/guestfish-commands.pod:26 ../libguestfs-1.11.19/fish/guestfish-commands.pod:26 msgid "" -"The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> " -"L</guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> " -"L</guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> " -"L</guestfs_setxattr>" +"Multiple local files and directories can be specified, but the last " +"parameter must always be a remote directory. Wildcards cannot be used." msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:63 -msgid "B<luks>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:30 ../libguestfs-1.11.19/fish/guestfish-commands.pod:30 +msgid "copy-out" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:65 +#. type: verbatim +#: ../fish/guestfish-commands.pod:32 ../libguestfs-1.11.19/fish/guestfish-commands.pod:32 +#, no-wrap msgid "" -"The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> " -"L</guestfs_luks_format> L</guestfs_luks_format_cipher> " -"L</guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>" +" copy-out remote [remote ...] localdir\n" +"\n" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:74 -msgid "B<lvm2>" +#. type: textblock +#: ../fish/guestfish-commands.pod:34 ../libguestfs-1.11.19/fish/guestfish-commands.pod:34 +msgid "" +"C<copy-out> copies remote files or directories recursively out of the disk " +"image, placing them on the host disk in a local directory called C<localdir> " +"(which must exist). This guestfish meta-command turns into a sequence of " +"L</download>, L</tar-out> and other commands as necessary." msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:76 +#: ../fish/guestfish-commands.pod:40 ../libguestfs-1.11.19/fish/guestfish-commands.pod:40 msgid "" -"The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> " -"L</guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> " -"L</guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> " -"L</guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> " -"L</guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> " -"L</guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> " -"L</guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> " -"L</guestfs_vgs_full>" +"Multiple remote files and directories can be specified, but the last " +"parameter must always be a local directory. To download to the current " +"directory, use C<.> as in:" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:99 -msgid "B<mknod>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:44 ../libguestfs-1.11.19/fish/guestfish-commands.pod:44 +#, no-wrap +msgid "" +" copy-out /home .\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:101 +#: ../fish/guestfish-commands.pod:46 ../libguestfs-1.11.19/fish/guestfish-commands.pod:46 msgid "" -"The following functions: L</guestfs_mkfifo> L</guestfs_mknod> " -"L</guestfs_mknod_b> L</guestfs_mknod_c>" +"Wildcards cannot be used in the ordinary command, but you can use them with " +"the help of L</glob> like this:" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:107 -msgid "B<ntfs3g>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:49 ../libguestfs-1.11.19/fish/guestfish-commands.pod:49 +#, no-wrap +msgid "" +" glob copy-out /home/* .\n" +"\n" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:109 -msgid "The following functions: L</guestfs_ntfs_3g_probe>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:51 ../libguestfs-1.11.19/fish/guestfish-commands.pod:51 +msgid "display" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:112 -msgid "B<ntfsprogs>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:53 ../libguestfs-1.11.19/fish/guestfish-commands.pod:53 +#, no-wrap +msgid "" +" display filename\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:114 +#: ../fish/guestfish-commands.pod:55 ../libguestfs-1.11.19/fish/guestfish-commands.pod:55 msgid "" -"The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> " -"L</guestfs_ntfsresize_size>" -msgstr "" - -#. type: =item -#: ../src/guestfs-availability.pod:119 -msgid "B<realpath>" +"Use C<display> (a graphical display program) to display an image file. It " +"downloads the file, and runs C<display> on it." msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:121 -msgid "The following functions: L</guestfs_realpath>" -msgstr "" - -#. type: =item -#: ../src/guestfs-availability.pod:124 -msgid "B<scrub>" +#: ../fish/guestfish-commands.pod:58 ../libguestfs-1.11.19/fish/guestfish-commands.pod:58 +msgid "" +"To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE> " +"environment variable. For example to use the GNOME display program:" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:126 +#. type: verbatim +#: ../fish/guestfish-commands.pod:61 ../libguestfs-1.11.19/fish/guestfish-commands.pod:61 +#, no-wrap msgid "" -"The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> " -"L</guestfs_scrub_freespace>" +" export GUESTFISH_DISPLAY_IMAGE=eog\n" +"\n" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:131 -msgid "B<selinux>" +#. type: textblock +#: ../fish/guestfish-commands.pod:63 ../libguestfs-1.11.19/fish/guestfish-commands.pod:63 +msgid "See also L<display(1)>." msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:133 -msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:65 ../libguestfs-1.11.19/fish/guestfish-commands.pod:65 +msgid "echo" msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:137 -msgid "B<xz>" +#. type: verbatim +#: ../fish/guestfish-commands.pod:67 ../libguestfs-1.11.19/fish/guestfish-commands.pod:67 +#, no-wrap +msgid "" +" echo [params ...]\n" +"\n" msgstr "" #. type: textblock -#: ../src/guestfs-availability.pod:139 -msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>" +#: ../fish/guestfish-commands.pod:69 ../libguestfs-1.11.19/fish/guestfish-commands.pod:69 +msgid "This echos the parameters to the terminal." msgstr "" -#. type: =item -#: ../src/guestfs-availability.pod:143 -msgid "B<zerofree>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:71 ../libguestfs-1.11.19/fish/guestfish-commands.pod:71 +msgid "edit" msgstr "" -#. type: textblock -#: ../src/guestfs-availability.pod:145 -msgid "The following functions: L</guestfs_zerofree>" +#. type: =head2 +#: ../fish/guestfish-commands.pod:73 ../libguestfs-1.11.19/fish/guestfish-commands.pod:73 +msgid "vi" msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:1 -msgid "guestfs_int_bool" +#: ../fish/guestfish-commands.pod:75 ../libguestfs-1.11.19/fish/guestfish-commands.pod:75 +msgid "emacs" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:3 +#: ../fish/guestfish-commands.pod:77 ../libguestfs-1.11.19/fish/guestfish-commands.pod:77 #, no-wrap msgid "" -" struct guestfs_int_bool {\n" -" int32_t i;\n" -" int32_t b;\n" -" };\n" -" \n" +" edit filename\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:8 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:79 ../libguestfs-1.11.19/fish/guestfish-commands.pod:79 msgid "" -" struct guestfs_int_bool_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_int_bool *val; /* Elements. */\n" -" };\n" -" \n" +"This is used to edit a file. It downloads the file, edits it locally using " +"your editor, then uploads the result." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:13 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:82 ../libguestfs-1.11.19/fish/guestfish-commands.pod:82 msgid "" -" void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n" -" void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n" -"\n" +"The editor is C<$EDITOR>. However if you use the alternate commands C<vi> " +"or C<emacs> you will get those corresponding editors." msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:16 -msgid "guestfs_lvm_pv" +#: ../fish/guestfish-commands.pod:86 ../libguestfs-1.11.19/fish/guestfish-commands.pod:86 +msgid "glob" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:18 +#: ../fish/guestfish-commands.pod:88 ../libguestfs-1.11.19/fish/guestfish-commands.pod:88 #, no-wrap msgid "" -" struct guestfs_lvm_pv {\n" -" char *pv_name;\n" -" /* The next field is NOT nul-terminated, be careful when printing it: " -"*/\n" -" char pv_uuid[32];\n" -" char *pv_fmt;\n" -" uint64_t pv_size;\n" -" uint64_t dev_size;\n" -" uint64_t pv_free;\n" -" uint64_t pv_used;\n" -" char *pv_attr;\n" -" int64_t pv_pe_count;\n" -" int64_t pv_pe_alloc_count;\n" -" char *pv_tags;\n" -" uint64_t pe_start;\n" -" int64_t pv_mda_count;\n" -" uint64_t pv_mda_free;\n" -" };\n" -" \n" +" glob command args...\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:36 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:90 ../libguestfs-1.11.19/fish/guestfish-commands.pod:90 msgid "" -" struct guestfs_lvm_pv_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_lvm_pv *val; /* Elements. */\n" -" };\n" -" \n" +"Expand wildcards in any paths in the args list, and run C<command> " +"repeatedly on each matching path." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:41 -#, no-wrap -msgid "" -" void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n" -" void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n" -"\n" +#. type: textblock +#: ../fish/guestfish-commands.pod:93 ../libguestfs-1.11.19/fish/guestfish-commands.pod:93 +msgid "See L</WILDCARDS AND GLOBBING>." msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:44 -msgid "guestfs_lvm_vg" +#: ../fish/guestfish-commands.pod:95 ../libguestfs-1.11.19/fish/guestfish-commands.pod:95 +msgid "hexedit" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:46 +#: ../fish/guestfish-commands.pod:97 ../libguestfs-1.11.19/fish/guestfish-commands.pod:97 #, no-wrap msgid "" -" struct guestfs_lvm_vg {\n" -" char *vg_name;\n" -" /* The next field is NOT nul-terminated, be careful when printing it: " -"*/\n" -" char vg_uuid[32];\n" -" char *vg_fmt;\n" -" char *vg_attr;\n" -" uint64_t vg_size;\n" -" uint64_t vg_free;\n" -" char *vg_sysid;\n" -" uint64_t vg_extent_size;\n" -" int64_t vg_extent_count;\n" -" int64_t vg_free_count;\n" -" int64_t max_lv;\n" -" int64_t max_pv;\n" -" int64_t pv_count;\n" -" int64_t lv_count;\n" -" int64_t snap_count;\n" -" int64_t vg_seqno;\n" -" char *vg_tags;\n" -" int64_t vg_mda_count;\n" -" uint64_t vg_mda_free;\n" -" };\n" -" \n" +" hexedit <filename|device>\n" +" hexedit <filename|device> <max>\n" +" hexedit <filename|device> <start> <max>\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:69 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:101 ../libguestfs-1.11.19/fish/guestfish-commands.pod:101 msgid "" -" struct guestfs_lvm_vg_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_lvm_vg *val; /* Elements. */\n" -" };\n" -" \n" +"Use hexedit (a hex editor) to edit all or part of a binary file or block " +"device." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:74 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:104 ../libguestfs-1.11.19/fish/guestfish-commands.pod:104 msgid "" -" void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n" -" void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n" -"\n" +"This command works by downloading potentially the whole file or device, " +"editing it locally, then uploading it. If the file or device is large, you " +"have to specify which part you wish to edit by using C<max> and/or C<start> " +"C<max> parameters. C<start> and C<max> are specified in bytes, with the " +"usual modifiers allowed such as C<1M> (1 megabyte)." msgstr "" -#. type: =head2 -#: ../src/guestfs-structs.pod:77 -msgid "guestfs_lvm_lv" +#. type: textblock +#: ../fish/guestfish-commands.pod:111 ../libguestfs-1.11.19/fish/guestfish-commands.pod:111 +msgid "For example to edit the first few sectors of a disk you might do:" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:79 +#: ../fish/guestfish-commands.pod:114 ../libguestfs-1.11.19/fish/guestfish-commands.pod:114 #, no-wrap msgid "" -" struct guestfs_lvm_lv {\n" -" char *lv_name;\n" -" /* The next field is NOT nul-terminated, be careful when printing it: " -"*/\n" -" char lv_uuid[32];\n" -" char *lv_attr;\n" -" int64_t lv_major;\n" -" int64_t lv_minor;\n" -" int64_t lv_kernel_major;\n" -" int64_t lv_kernel_minor;\n" -" uint64_t lv_size;\n" -" int64_t seg_count;\n" -" char *origin;\n" -" /* The next field is [0..100] or -1 meaning 'not present': */\n" -" float snap_percent;\n" -" /* The next field is [0..100] or -1 meaning 'not present': */\n" -" float copy_percent;\n" -" char *move_pv;\n" -" char *lv_tags;\n" -" char *mirror_log;\n" -" char *modules;\n" -" };\n" -" \n" +" hexedit /dev/sda 1M\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:101 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:116 ../libguestfs-1.11.19/fish/guestfish-commands.pod:116 msgid "" -" struct guestfs_lvm_lv_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_lvm_lv *val; /* Elements. */\n" -" };\n" -" \n" +"which would allow you to edit anywhere within the first megabyte of the " +"disk." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-commands.pod:119 ../libguestfs-1.11.19/fish/guestfish-commands.pod:119 +msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:106 +#: ../fish/guestfish-commands.pod:121 ../libguestfs-1.11.19/fish/guestfish-commands.pod:121 #, no-wrap msgid "" -" void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n" -" void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n" +" hexedit /dev/sda1 0x400 0x400\n" "\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:111 -#, no-wrap -msgid "" -" struct guestfs_stat {\n" -" int64_t dev;\n" -" int64_t ino;\n" -" int64_t mode;\n" -" int64_t nlink;\n" -" int64_t uid;\n" -" int64_t gid;\n" -" int64_t rdev;\n" -" int64_t size;\n" -" int64_t blksize;\n" -" int64_t blocks;\n" -" int64_t atime;\n" -" int64_t mtime;\n" -" int64_t ctime;\n" -" };\n" -" \n" +#. type: textblock +#: ../fish/guestfish-commands.pod:123 ../libguestfs-1.11.19/fish/guestfish-commands.pod:123 +msgid "(assuming the superblock is in the standard location)." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:127 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:125 ../libguestfs-1.11.19/fish/guestfish-commands.pod:125 msgid "" -" struct guestfs_stat_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_stat *val; /* Elements. */\n" -" };\n" -" \n" +"This command requires the external L<hexedit(1)> program. You can specify " +"another program to use by setting the C<HEXEDITOR> environment variable." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-commands.pod:129 ../libguestfs-1.11.19/fish/guestfish-commands.pod:129 +msgid "See also L</hexdump>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-commands.pod:131 ../libguestfs-1.11.19/fish/guestfish-commands.pod:131 +msgid "lcd" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:132 +#: ../fish/guestfish-commands.pod:133 ../libguestfs-1.11.19/fish/guestfish-commands.pod:133 #, no-wrap msgid "" -" void guestfs_free_stat (struct guestfs_free_stat *);\n" -" void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n" +" lcd directory\n" "\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:137 -#, no-wrap -msgid "" -" struct guestfs_statvfs {\n" -" int64_t bsize;\n" -" int64_t frsize;\n" -" int64_t blocks;\n" -" int64_t bfree;\n" -" int64_t bavail;\n" -" int64_t files;\n" -" int64_t ffree;\n" -" int64_t favail;\n" -" int64_t fsid;\n" -" int64_t flag;\n" -" int64_t namemax;\n" -" };\n" -" \n" +#. type: textblock +#: ../fish/guestfish-commands.pod:135 ../libguestfs-1.11.19/fish/guestfish-commands.pod:135 +msgid "Change the local directory, ie. the current directory of guestfish itself." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:151 -#, no-wrap -msgid "" -" struct guestfs_statvfs_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_statvfs *val; /* Elements. */\n" -" };\n" -" \n" +#. type: textblock +#: ../fish/guestfish-commands.pod:138 ../libguestfs-1.11.19/fish/guestfish-commands.pod:138 +msgid "Note that C<!cd> won't do what you might expect." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:156 -#, no-wrap -msgid "" -" void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n" -" void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n" -"\n" +#. type: =head2 +#: ../fish/guestfish-commands.pod:140 ../libguestfs-1.11.19/fish/guestfish-commands.pod:140 +msgid "man" msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:159 -msgid "guestfs_dirent" +#: ../fish/guestfish-commands.pod:142 ../libguestfs-1.11.19/fish/guestfish-commands.pod:142 +msgid "manual" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:161 +#: ../fish/guestfish-commands.pod:144 ../libguestfs-1.11.19/fish/guestfish-commands.pod:144 #, no-wrap msgid "" -" struct guestfs_dirent {\n" -" int64_t ino;\n" -" char ftyp;\n" -" char *name;\n" -" };\n" -" \n" +" man\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:167 -#, no-wrap -msgid "" -" struct guestfs_dirent_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_dirent *val; /* Elements. */\n" -" };\n" -" \n" +#. type: textblock +#: ../fish/guestfish-commands.pod:146 ../libguestfs-1.11.19/fish/guestfish-commands.pod:146 +msgid "Opens the manual page for guestfish." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:172 -#, no-wrap -msgid "" -" void guestfs_free_dirent (struct guestfs_free_dirent *);\n" -" void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n" -"\n" +#. type: =head2 +#: ../fish/guestfish-commands.pod:148 ../libguestfs-1.11.19/fish/guestfish-commands.pod:148 +msgid "more" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:177 -#, no-wrap -msgid "" -" struct guestfs_version {\n" -" int64_t major;\n" -" int64_t minor;\n" -" int64_t release;\n" -" char *extra;\n" -" };\n" -" \n" +#. type: =head2 +#: ../fish/guestfish-commands.pod:150 ../libguestfs-1.11.19/fish/guestfish-commands.pod:150 +msgid "less" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:184 +#: ../fish/guestfish-commands.pod:152 ../libguestfs-1.11.19/fish/guestfish-commands.pod:152 #, no-wrap msgid "" -" struct guestfs_version_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_version *val; /* Elements. */\n" -" };\n" -" \n" +" more filename\n" +"\n" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:189 +#: ../fish/guestfish-commands.pod:154 ../libguestfs-1.11.19/fish/guestfish-commands.pod:154 #, no-wrap msgid "" -" void guestfs_free_version (struct guestfs_free_version *);\n" -" void guestfs_free_version_list (struct guestfs_free_version_list *);\n" +" less filename\n" "\n" msgstr "" -#. type: =head2 -#: ../src/guestfs-structs.pod:192 -msgid "guestfs_xattr" +#. type: textblock +#: ../fish/guestfish-commands.pod:156 ../libguestfs-1.11.19/fish/guestfish-commands.pod:156 +msgid "This is used to view a file." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:194 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:158 ../libguestfs-1.11.19/fish/guestfish-commands.pod:158 msgid "" -" struct guestfs_xattr {\n" -" char *attrname;\n" -" /* The next two fields describe a byte array. */\n" -" uint32_t attrval_len;\n" -" char *attrval;\n" -" };\n" -" \n" +"The default viewer is C<$PAGER>. However if you use the alternate command " +"C<less> you will get the C<less> command specifically." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:201 -#, no-wrap -msgid "" -" struct guestfs_xattr_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_xattr *val; /* Elements. */\n" -" };\n" -" \n" +#. type: =head2 +#: ../fish/guestfish-commands.pod:161 ../libguestfs-1.11.19/fish/guestfish-commands.pod:161 +msgid "reopen" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:206 +#: ../fish/guestfish-commands.pod:163 ../libguestfs-1.11.19/fish/guestfish-commands.pod:163 #, no-wrap msgid "" -" void guestfs_free_xattr (struct guestfs_free_xattr *);\n" -" void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n" +" reopen\n" "\n" msgstr "" +#. type: textblock +#: ../fish/guestfish-commands.pod:165 ../libguestfs-1.11.19/fish/guestfish-commands.pod:165 +msgid "" +"Close and reopen the libguestfs handle. It is not necessary to use this " +"normally, because the handle is closed properly when guestfish exits. " +"However this is occasionally useful for testing." +msgstr "" + #. type: =head2 -#: ../src/guestfs-structs.pod:209 -msgid "guestfs_inotify_event" +#: ../fish/guestfish-commands.pod:169 ../libguestfs-1.11.19/fish/guestfish-commands.pod:169 +msgid "sparse" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:211 +#: ../fish/guestfish-commands.pod:171 ../libguestfs-1.11.19/fish/guestfish-commands.pod:171 #, no-wrap msgid "" -" struct guestfs_inotify_event {\n" -" int64_t in_wd;\n" -" uint32_t in_mask;\n" -" uint32_t in_cookie;\n" -" char *in_name;\n" -" };\n" -" \n" +" sparse filename size\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:218 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:173 ../libguestfs-1.11.19/fish/guestfish-commands.pod:173 msgid "" -" struct guestfs_inotify_event_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_inotify_event *val; /* Elements. */\n" -" };\n" -" \n" +"This creates an empty sparse file of the given size, and then adds so it can " +"be further examined." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:223 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:176 ../libguestfs-1.11.19/fish/guestfish-commands.pod:176 msgid "" -" void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n" -" void guestfs_free_inotify_event_list (struct " -"guestfs_free_inotify_event_list *);\n" -"\n" +"In all respects it works the same as the L</alloc> command, except that the " +"image file is allocated sparsely, which means that disk blocks are not " +"assigned to the file until they are needed. Sparse disk files only use " +"space when written to, but they are slower and there is a danger you could " +"run out of real disk space during a write operation." msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:226 -msgid "guestfs_partition" +#: ../fish/guestfish-commands.pod:186 ../libguestfs-1.11.19/fish/guestfish-commands.pod:186 +msgid "supported" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:228 +#: ../fish/guestfish-commands.pod:188 ../libguestfs-1.11.19/fish/guestfish-commands.pod:188 #, no-wrap msgid "" -" struct guestfs_partition {\n" -" int32_t part_num;\n" -" uint64_t part_start;\n" -" uint64_t part_end;\n" -" uint64_t part_size;\n" -" };\n" -" \n" +" supported\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:235 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:190 ../libguestfs-1.11.19/fish/guestfish-commands.pod:190 msgid "" -" struct guestfs_partition_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_partition *val; /* Elements. */\n" -" };\n" -" \n" +"This command returns a list of the optional groups known to the daemon, and " +"indicates which ones are supported by this build of the libguestfs " +"appliance." msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:240 -#, no-wrap -msgid "" -" void guestfs_free_partition (struct guestfs_free_partition *);\n" -" void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n" -"\n" +#. type: textblock +#: ../fish/guestfish-commands.pod:194 ../libguestfs-1.11.19/fish/guestfish-commands.pod:194 +msgid "See also L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: =head2 -#: ../src/guestfs-structs.pod:243 -msgid "guestfs_application" -msgstr "" - -#. type: verbatim -#: ../src/guestfs-structs.pod:245 -#, no-wrap -msgid "" -" struct guestfs_application {\n" -" char *app_name;\n" -" char *app_display_name;\n" -" int32_t app_epoch;\n" -" char *app_version;\n" -" char *app_release;\n" -" char *app_install_path;\n" -" char *app_trans_path;\n" -" char *app_publisher;\n" -" char *app_url;\n" -" char *app_source_package;\n" -" char *app_summary;\n" -" char *app_description;\n" -" };\n" -" \n" +#: ../fish/guestfish-commands.pod:196 ../libguestfs-1.11.19/fish/guestfish-commands.pod:196 +msgid "time" msgstr "" #. type: verbatim -#: ../src/guestfs-structs.pod:260 +#: ../fish/guestfish-commands.pod:198 ../libguestfs-1.11.19/fish/guestfish-commands.pod:198 #, no-wrap msgid "" -" struct guestfs_application_list {\n" -" uint32_t len; /* Number of elements in list. */\n" -" struct guestfs_application *val; /* Elements. */\n" -" };\n" -" \n" +" time command args...\n" +"\n" msgstr "" -#. type: verbatim -#: ../src/guestfs-structs.pod:265 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-commands.pod:200 ../libguestfs-1.11.19/fish/guestfish-commands.pod:200 msgid "" -" void guestfs_free_application (struct guestfs_free_application *);\n" -" void guestfs_free_application_list (struct guestfs_free_application_list " -"*);\n" -"\n" +"Run the command as usual, but print the elapsed time afterwards. This can " +"be useful for benchmarking operations." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:5 +#: ../fish/guestfish.pod:5 ../libguestfs-1.11.19/fish/guestfish.pod:5 msgid "guestfish - the libguestfs Filesystem Interactive SHell" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:9 +#: ../fish/guestfish.pod:9 ../libguestfs-1.11.19/fish/guestfish.pod:9 #, no-wrap msgid "" " guestfish [--options] [commands]\n" @@ -19538,7 +15381,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:11 +#: ../fish/guestfish.pod:11 ../libguestfs-1.11.19/fish/guestfish.pod:11 #, no-wrap msgid "" " guestfish\n" @@ -19546,7 +15389,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:13 +#: ../fish/guestfish.pod:13 ../libguestfs-1.11.19/fish/guestfish.pod:13 #, no-wrap msgid "" " guestfish [--ro|--rw] -a disk.img\n" @@ -19554,7 +15397,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:15 +#: ../fish/guestfish.pod:15 ../libguestfs-1.11.19/fish/guestfish.pod:15 #, no-wrap msgid "" " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n" @@ -19562,7 +15405,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:17 +#: ../fish/guestfish.pod:17 ../libguestfs-1.11.19/fish/guestfish.pod:17 #, no-wrap msgid "" " guestfish -d libvirt-domain\n" @@ -19570,7 +15413,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:19 +#: ../fish/guestfish.pod:19 ../libguestfs-1.11.19/fish/guestfish.pod:19 #, no-wrap msgid "" " guestfish [--ro|--rw] -a disk.img -i\n" @@ -19578,20 +15421,15 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:21 +#: ../fish/guestfish.pod:21 ../libguestfs-1.11.19/fish/guestfish.pod:21 #, no-wrap msgid "" " guestfish -d libvirt-domain -i\n" "\n" msgstr "" -#. type: =head1 -#: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64 -msgid "WARNING" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:25 +#: ../fish/guestfish.pod:25 ../libguestfs-1.11.19/fish/guestfish.pod:25 msgid "" "Using guestfish in read/write mode on live virtual machines can be " "dangerous, potentially causing disk corruption. Use the I<--ro> (read-only) " @@ -19600,7 +15438,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:32 +#: ../fish/guestfish.pod:32 ../libguestfs-1.11.19/fish/guestfish.pod:32 msgid "" "Guestfish is a shell and command-line tool for examining and modifying " "virtual machine filesystems. It uses libguestfs and exposes all of the " @@ -19608,7 +15446,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:36 +#: ../fish/guestfish.pod:36 ../libguestfs-1.11.19/fish/guestfish.pod:36 msgid "" "Guestfish gives you structured access to the libguestfs API, from shell " "scripts or the command line or interactively. If you want to rescue a " @@ -19616,18 +15454,13 @@ msgid "" "command." msgstr "" -#. type: =head1 -#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:1007 ../fuse/guestmount.pod:39 ../tools/virt-tar.pl:50 -msgid "EXAMPLES" -msgstr "" - #. type: =head2 -#: ../fish/guestfish.pod:43 +#: ../fish/guestfish.pod:43 ../libguestfs-1.11.19/fish/guestfish.pod:43 msgid "As an interactive shell" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:45 +#: ../fish/guestfish.pod:45 ../libguestfs-1.11.19/fish/guestfish.pod:45 #, no-wrap msgid "" " $ guestfish\n" @@ -19635,7 +15468,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:47 +#: ../fish/guestfish.pod:47 ../libguestfs-1.11.19/fish/guestfish.pod:47 #, no-wrap msgid "" " Welcome to guestfish, the libguestfs filesystem interactive shell for\n" @@ -19644,7 +15477,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:50 +#: ../fish/guestfish.pod:50 ../libguestfs-1.11.19/fish/guestfish.pod:50 #, no-wrap msgid "" " Type: 'help' for a list of commands\n" @@ -19654,7 +15487,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:54 +#: ../fish/guestfish.pod:54 ../libguestfs-1.11.19/fish/guestfish.pod:54 #, no-wrap msgid "" " ><fs> add-ro disk.img\n" @@ -19673,17 +15506,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:67 +#: ../fish/guestfish.pod:67 ../libguestfs-1.11.19/fish/guestfish.pod:67 msgid "From shell scripts" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:69 +#: ../fish/guestfish.pod:69 ../libguestfs-1.11.19/fish/guestfish.pod:69 msgid "Create a new C</etc/motd> file in a guest or disk image:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:71 +#: ../fish/guestfish.pod:71 ../libguestfs-1.11.19/fish/guestfish.pod:71 #, no-wrap msgid "" " guestfish <<_EOF_\n" @@ -19696,12 +15529,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:78 +#: ../fish/guestfish.pod:78 ../libguestfs-1.11.19/fish/guestfish.pod:78 msgid "List the LVM logical volumes in a disk image:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:80 +#: ../fish/guestfish.pod:80 ../libguestfs-1.11.19/fish/guestfish.pod:80 #, no-wrap msgid "" " guestfish -a disk.img --ro <<_EOF_\n" @@ -19712,12 +15545,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:85 +#: ../fish/guestfish.pod:85 ../libguestfs-1.11.19/fish/guestfish.pod:85 msgid "List all the filesystems in a disk image:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:87 +#: ../fish/guestfish.pod:87 ../libguestfs-1.11.19/fish/guestfish.pod:87 #, no-wrap msgid "" " guestfish -a disk.img --ro <<_EOF_\n" @@ -19728,17 +15561,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:92 +#: ../fish/guestfish.pod:92 ../libguestfs-1.11.19/fish/guestfish.pod:92 msgid "On one command line" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:94 +#: ../fish/guestfish.pod:94 ../fish/virt-copy-in.pod:31 ../libguestfs-1.11.19/fish/guestfish.pod:94 ../libguestfs-1.11.19/fish/virt-copy-in.pod:31 msgid "Update C</etc/resolv.conf> in a guest:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:96 +#: ../fish/guestfish.pod:96 ../libguestfs-1.11.19/fish/guestfish.pod:96 #, no-wrap msgid "" " guestfish \\\n" @@ -19748,12 +15581,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:100 +#: ../fish/guestfish.pod:100 ../libguestfs-1.11.19/fish/guestfish.pod:100 msgid "Edit C</boot/grub/grub.conf> interactively:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:102 +#: ../fish/guestfish.pod:102 ../libguestfs-1.11.19/fish/guestfish.pod:102 #, no-wrap msgid "" " guestfish --rw --add disk.img \\\n" @@ -19764,19 +15597,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:107 +#: ../fish/guestfish.pod:107 ../libguestfs-1.11.19/fish/guestfish.pod:107 msgid "Mount disks automatically" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:109 +#: ../fish/guestfish.pod:109 ../libguestfs-1.11.19/fish/guestfish.pod:109 msgid "" "Use the I<-i> option to automatically mount the disks from a virtual " "machine:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:112 +#: ../fish/guestfish.pod:112 ../libguestfs-1.11.19/fish/guestfish.pod:112 #, no-wrap msgid "" " guestfish --ro -a disk.img -i cat /etc/group\n" @@ -19784,7 +15617,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:114 +#: ../fish/guestfish.pod:114 ../libguestfs-1.11.19/fish/guestfish.pod:114 #, no-wrap msgid "" " guestfish --ro -d libvirt-domain -i cat /etc/group\n" @@ -19792,12 +15625,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:116 +#: ../fish/guestfish.pod:116 ../libguestfs-1.11.19/fish/guestfish.pod:116 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:118 +#: ../fish/guestfish.pod:118 ../libguestfs-1.11.19/fish/guestfish.pod:118 #, no-wrap msgid "" " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n" @@ -19805,17 +15638,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:120 +#: ../fish/guestfish.pod:120 ../libguestfs-1.11.19/fish/guestfish.pod:120 msgid "As a script interpreter" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:122 +#: ../fish/guestfish.pod:122 ../libguestfs-1.11.19/fish/guestfish.pod:122 msgid "Create a 100MB disk containing an ext2-formatted partition:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:124 +#: ../fish/guestfish.pod:124 ../libguestfs-1.11.19/fish/guestfish.pod:124 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" @@ -19827,19 +15660,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:130 +#: ../fish/guestfish.pod:130 ../libguestfs-1.11.19/fish/guestfish.pod:130 msgid "Start with a prepared disk" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:132 +#: ../fish/guestfish.pod:132 ../libguestfs-1.11.19/fish/guestfish.pod:132 msgid "" "An alternate way to create a 100MB disk called C<test1.img> containing a " "single ext2-formatted partition:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:135 +#: ../fish/guestfish.pod:135 ../libguestfs-1.11.19/fish/guestfish.pod:135 #, no-wrap msgid "" " guestfish -N fs\n" @@ -19847,12 +15680,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:137 +#: ../fish/guestfish.pod:137 ../libguestfs-1.11.19/fish/guestfish.pod:137 msgid "To list what is available do:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:998 +#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:998 ../libguestfs-1.11.19/fish/guestfish.pod:139 ../libguestfs-1.11.19/fish/guestfish.pod:998 #, no-wrap msgid "" " guestfish -N help | less\n" @@ -19860,12 +15693,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:141 +#: ../fish/guestfish.pod:141 ../libguestfs-1.11.19/fish/guestfish.pod:141 msgid "Remote control" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:143 +#: ../fish/guestfish.pod:143 ../libguestfs-1.11.19/fish/guestfish.pod:143 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -19875,122 +15708,90 @@ msgid "" "\n" msgstr "" -#. type: =head1 -#: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:83 ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54 -msgid "OPTIONS" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:143 ../tools/virt-win-reg.pl:104 ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111 ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62 -msgid "B<--help>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:154 +#: ../fish/guestfish.pod:154 ../libguestfs-1.11.19/fish/guestfish.pod:154 msgid "Displays general help on options." msgstr "" #. type: =item -#: ../fish/guestfish.pod:156 -msgid "B<-h>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:158 +#: ../fish/guestfish.pod:158 ../libguestfs-1.11.19/fish/guestfish.pod:158 msgid "B<--cmd-help>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:160 +#: ../fish/guestfish.pod:160 ../libguestfs-1.11.19/fish/guestfish.pod:160 msgid "Lists all available guestfish commands." msgstr "" #. type: =item -#: ../fish/guestfish.pod:162 +#: ../fish/guestfish.pod:162 ../libguestfs-1.11.19/fish/guestfish.pod:162 msgid "B<-h cmd>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:164 +#: ../fish/guestfish.pod:164 ../libguestfs-1.11.19/fish/guestfish.pod:164 msgid "B<--cmd-help cmd>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:166 +#: ../fish/guestfish.pod:166 ../libguestfs-1.11.19/fish/guestfish.pod:166 msgid "Displays detailed help on a single command C<cmd>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:168 +#: ../fish/guestfish.pod:168 ../fuse/guestmount.pod:87 ../libguestfs-1.11.19/fish/guestfish.pod:168 ../libguestfs-1.11.19/fuse/guestmount.pod:87 msgid "B<-a image>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:170 +#: ../fish/guestfish.pod:170 ../fuse/guestmount.pod:89 ../libguestfs-1.11.19/fish/guestfish.pod:170 ../libguestfs-1.11.19/fuse/guestmount.pod:89 msgid "B<--add image>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:172 +#: ../fish/guestfish.pod:172 ../libguestfs-1.11.19/fish/guestfish.pod:172 msgid "Add a block device or virtual machine image to the shell." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91 -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: textblock -#: ../fish/guestfish.pod:177 +#: ../fish/guestfish.pod:177 ../libguestfs-1.11.19/fish/guestfish.pod:177 msgid "" "Using this flag is mostly equivalent to using the C<add> command, with " "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if " "the I<--format=...> flag was given." msgstr "" -#. type: =item -#: ../fish/guestfish.pod:181 -msgid "B<-c URI>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:183 -msgid "B<--connect URI>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96 +#: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:100 ../libguestfs-1.11.19/fish/guestfish.pod:185 ../libguestfs-1.11.19/fuse/guestmount.pod:100 msgid "" "When used in conjunction with the I<-d> option, this specifies the libvirt " "URI to use. The default is to use the default libvirt connection." msgstr "" #. type: =item -#: ../fish/guestfish.pod:189 +#: ../fish/guestfish.pod:189 ../libguestfs-1.11.19/fish/guestfish.pod:189 msgid "B<--csh>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:191 +#: ../fish/guestfish.pod:191 ../libguestfs-1.11.19/fish/guestfish.pod:191 msgid "" "If using the I<--listen> option and a csh-like shell, use this option. See " "section L</REMOTE CONTROL AND CSH> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:194 +#: ../fish/guestfish.pod:194 ../fuse/guestmount.pod:104 ../libguestfs-1.11.19/fish/guestfish.pod:194 ../libguestfs-1.11.19/fuse/guestmount.pod:104 msgid "B<-d libvirt-domain>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:196 +#: ../fish/guestfish.pod:196 ../fuse/guestmount.pod:106 ../libguestfs-1.11.19/fish/guestfish.pod:196 ../libguestfs-1.11.19/fuse/guestmount.pod:106 msgid "B<--domain libvirt-domain>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102 +#: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:108 ../libguestfs-1.11.19/fish/guestfish.pod:198 ../libguestfs-1.11.19/fuse/guestmount.pod:108 msgid "" "Add disks from the named libvirt domain. If the I<--ro> option is also " "used, then any libvirt domain can be used. However in write mode, only " @@ -19998,12 +15799,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:106 +#: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:112 ../libguestfs-1.11.19/fish/guestfish.pod:202 ../libguestfs-1.11.19/fuse/guestmount.pod:112 msgid "Domain UUIDs can be used instead of names." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:204 +#: ../fish/guestfish.pod:204 ../libguestfs-1.11.19/fish/guestfish.pod:204 msgid "" "Using this flag is mostly equivalent to using the C<add-domain> command, " "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> " @@ -20011,17 +15812,17 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:208 +#: ../fish/guestfish.pod:208 ../libguestfs-1.11.19/fish/guestfish.pod:208 msgid "B<-D>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:210 +#: ../fish/guestfish.pod:210 ../libguestfs-1.11.19/fish/guestfish.pod:210 msgid "B<--no-dest-paths>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:212 +#: ../fish/guestfish.pod:212 ../libguestfs-1.11.19/fish/guestfish.pod:212 msgid "" "Don't tab-complete paths on the guest filesystem. It is useful to be able " "to hit the tab key to complete paths on the guest filesystem, but this " @@ -20029,13 +15830,8 @@ msgid "" "allow this feature to be disabled." msgstr "" -#. type: =item -#: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120 -msgid "B<--echo-keys>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:122 +#: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:128 ../libguestfs-1.11.19/fish/guestfish.pod:219 ../libguestfs-1.11.19/fuse/guestmount.pod:128 msgid "" "When prompting for keys and passphrases, guestfish normally turns echoing " "off so you cannot see what you are typing. If you are not worried about " @@ -20044,62 +15840,38 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:224 +#: ../fish/guestfish.pod:224 ../libguestfs-1.11.19/fish/guestfish.pod:224 msgid "B<-f file>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:226 +#: ../fish/guestfish.pod:226 ../libguestfs-1.11.19/fish/guestfish.pod:226 msgid "B<--file file>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:228 +#: ../fish/guestfish.pod:228 ../libguestfs-1.11.19/fish/guestfish.pod:228 msgid "Read commands from C<file>. To write pure guestfish scripts, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:231 +#: ../fish/guestfish.pod:231 ../libguestfs-1.11.19/fish/guestfish.pod:231 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" "\n" msgstr "" -#. type: =item -#: ../fish/guestfish.pod:233 -msgid "B<--format=raw|qcow2|..>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:235 -msgid "B<--format>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:129 -msgid "" -"The default for the I<-a> option is to auto-detect the format of the disk " -"image. Using this forces the disk format for I<-a> options which follow on " -"the command line. Using I<--format> with no argument switches back to " -"auto-detection for subsequent I<-a> options." -msgstr "" - #. type: verbatim -#: ../fish/guestfish.pod:244 +#: ../fish/guestfish.pod:244 ../libguestfs-1.11.19/fish/guestfish.pod:244 #, no-wrap msgid "" " guestfish --format=raw -a disk.img\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish.pod:246 -msgid "forces raw format (no auto-detection) for C<disk.img>." -msgstr "" - #. type: verbatim -#: ../fish/guestfish.pod:248 +#: ../fish/guestfish.pod:248 ../libguestfs-1.11.19/fish/guestfish.pod:248 #, no-wrap msgid "" " guestfish --format=raw -a disk.img --format -a another.img\n" @@ -20107,14 +15879,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:250 -msgid "" -"forces raw format (no auto-detection) for C<disk.img> and reverts to " -"auto-detection for C<another.img>." -msgstr "" - -#. type: textblock -#: ../fish/guestfish.pod:253 +#: ../fish/guestfish.pod:253 ../libguestfs-1.11.19/fish/guestfish.pod:253 msgid "" "If you have untrusted raw-format guest disk images, you should use this " "option to specify the disk format. This avoids a possible security problem " @@ -20122,17 +15887,12 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:258 -msgid "B<-i>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:260 +#: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:157 ../libguestfs-1.11.19/fish/guestfish.pod:260 ../libguestfs-1.11.19/fuse/guestmount.pod:157 msgid "B<--inspector>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:149 +#: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:159 ../libguestfs-1.11.19/fish/guestfish.pod:262 ../libguestfs-1.11.19/fuse/guestmount.pod:159 msgid "" "Using L<virt-inspector(1)> code, inspect the disks looking for an operating " "system and mount filesystems as they would be mounted on the real virtual " @@ -20140,12 +15900,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:266 +#: ../fish/guestfish.pod:266 ../libguestfs-1.11.19/fish/guestfish.pod:266 msgid "Typical usage is either:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:268 +#: ../fish/guestfish.pod:268 ../libguestfs-1.11.19/fish/guestfish.pod:268 #, no-wrap msgid "" " guestfish -d myguest -i\n" @@ -20153,12 +15913,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:270 +#: ../fish/guestfish.pod:270 ../libguestfs-1.11.19/fish/guestfish.pod:270 msgid "(for an inactive libvirt domain called I<myguest>), or:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:272 +#: ../fish/guestfish.pod:272 ../libguestfs-1.11.19/fish/guestfish.pod:272 #, no-wrap msgid "" " guestfish --ro -d myguest -i\n" @@ -20166,12 +15926,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:274 +#: ../fish/guestfish.pod:274 ../libguestfs-1.11.19/fish/guestfish.pod:274 msgid "(for active domains, readonly), or specify the block device directly:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:276 +#: ../fish/guestfish.pod:276 ../libguestfs-1.11.19/fish/guestfish.pod:276 #, no-wrap msgid "" " guestfish --rw -a /dev/Guests/MyGuest -i\n" @@ -20179,14 +15939,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:278 +#: ../fish/guestfish.pod:278 ../libguestfs-1.11.19/fish/guestfish.pod:278 msgid "" "Note that the command line syntax changed slightly over older versions of " "guestfish. You can still use the old syntax:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:281 +#: ../fish/guestfish.pod:281 ../libguestfs-1.11.19/fish/guestfish.pod:281 #, no-wrap msgid "" " guestfish [--ro] -i disk.img\n" @@ -20194,7 +15954,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:283 +#: ../fish/guestfish.pod:283 ../libguestfs-1.11.19/fish/guestfish.pod:283 #, no-wrap msgid "" " guestfish [--ro] -i libvirt-domain\n" @@ -20202,82 +15962,70 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:285 +#: ../fish/guestfish.pod:285 ../libguestfs-1.11.19/fish/guestfish.pod:285 msgid "" "Using this flag is mostly equivalent to using the C<inspect-os> command and " "then using other commands to mount the filesystems that were found." msgstr "" #. type: =item -#: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153 -msgid "B<--keys-from-stdin>" -msgstr "" - -#. type: textblock -#: ../fish/guestfish.pod:291 ../fuse/guestmount.pod:155 -msgid "" -"Read key or passphrase parameters from stdin. The default is to try to read " -"passphrases from the user by opening C</dev/tty>." -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:294 +#: ../fish/guestfish.pod:294 ../libguestfs-1.11.19/fish/guestfish.pod:294 msgid "B<--listen>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:296 +#: ../fish/guestfish.pod:296 ../libguestfs-1.11.19/fish/guestfish.pod:296 msgid "" "Fork into the background and listen for remote commands. See section " "L</REMOTE CONTROL GUESTFISH OVER A SOCKET> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158 +#: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:168 ../libguestfs-1.11.19/fish/guestfish.pod:299 ../libguestfs-1.11.19/fuse/guestmount.pod:168 msgid "B<--live>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:160 +#: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:170 ../libguestfs-1.11.19/fish/guestfish.pod:301 ../libguestfs-1.11.19/fuse/guestmount.pod:170 msgid "" "Connect to a live virtual machine. (Experimental, see " "L<guestfs(3)/ATTACHING TO RUNNING DAEMONS>)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163 +#: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:173 ../libguestfs-1.11.19/fish/guestfish.pod:304 ../libguestfs-1.11.19/fuse/guestmount.pod:173 msgid "B<-m dev[:mountpoint[:options]]>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:165 +#: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:175 ../libguestfs-1.11.19/fish/guestfish.pod:306 ../libguestfs-1.11.19/fuse/guestmount.pod:175 msgid "B<--mount dev[:mountpoint[:options]]>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:308 +#: ../fish/guestfish.pod:308 ../libguestfs-1.11.19/fish/guestfish.pod:308 msgid "Mount the named partition or logical volume on the given mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:310 +#: ../fish/guestfish.pod:310 ../libguestfs-1.11.19/fish/guestfish.pod:310 msgid "If the mountpoint is omitted, it defaults to C</>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:312 +#: ../fish/guestfish.pod:312 ../libguestfs-1.11.19/fish/guestfish.pod:312 msgid "You have to mount something on C</> before most commands will work." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:314 +#: ../fish/guestfish.pod:314 ../libguestfs-1.11.19/fish/guestfish.pod:314 msgid "" "If any I<-m> or I<--mount> options are given, the guest is automatically " "launched." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:317 +#: ../fish/guestfish.pod:317 ../libguestfs-1.11.19/fish/guestfish.pod:317 msgid "" "If you don't know what filesystems a disk image contains, you can either run " "guestfish without this option, then list the partitions, filesystems and LVs " @@ -20286,7 +16034,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:173 +#: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:183 ../libguestfs-1.11.19/fish/guestfish.pod:323 ../libguestfs-1.11.19/fuse/guestmount.pod:183 msgid "" "The third (and rarely used) part of the mount parameter is the list of mount " "options used to mount the underlying filesystem. If this is not given, then " @@ -20297,7 +16045,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:181 +#: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:191 ../libguestfs-1.11.19/fish/guestfish.pod:331 ../libguestfs-1.11.19/fuse/guestmount.pod:191 #, no-wrap msgid "" " -m /dev/sda1:/:acl,user_xattr\n" @@ -20305,44 +16053,44 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:333 +#: ../fish/guestfish.pod:333 ../libguestfs-1.11.19/fish/guestfish.pod:333 msgid "Using this flag is equivalent to using the C<mount-options> command." msgstr "" #. type: =item -#: ../fish/guestfish.pod:335 +#: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:193 ../libguestfs-1.11.19/fish/guestfish.pod:335 ../libguestfs-1.11.19/fuse/guestmount.pod:193 ../libguestfs-1.11.19/resize/virt-resize.pod:352 ../resize/virt-resize.pod:352 msgid "B<-n>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:337 +#: ../fish/guestfish.pod:337 ../fuse/guestmount.pod:195 ../libguestfs-1.11.19/fish/guestfish.pod:337 ../libguestfs-1.11.19/fuse/guestmount.pod:195 msgid "B<--no-sync>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:339 +#: ../fish/guestfish.pod:339 ../libguestfs-1.11.19/fish/guestfish.pod:339 msgid "" "Disable autosync. This is enabled by default. See the discussion of " "autosync in the L<guestfs(3)> manpage." msgstr "" #. type: =item -#: ../fish/guestfish.pod:342 +#: ../fish/guestfish.pod:342 ../libguestfs-1.11.19/fish/guestfish.pod:342 msgid "B<-N type>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:344 +#: ../fish/guestfish.pod:344 ../libguestfs-1.11.19/fish/guestfish.pod:344 msgid "B<--new type>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:346 +#: ../fish/guestfish.pod:346 ../libguestfs-1.11.19/fish/guestfish.pod:346 msgid "B<-N help>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:348 +#: ../fish/guestfish.pod:348 ../libguestfs-1.11.19/fish/guestfish.pod:348 msgid "" "Prepare a fresh disk image formatted as \"type\". This is an alternative to " "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a " @@ -20351,63 +16099,63 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:353 +#: ../fish/guestfish.pod:353 ../libguestfs-1.11.19/fish/guestfish.pod:353 msgid "B<--progress-bars>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:355 +#: ../fish/guestfish.pod:355 ../libguestfs-1.11.19/fish/guestfish.pod:355 msgid "Enable progress bars, even when guestfish is used non-interactively." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:357 +#: ../fish/guestfish.pod:357 ../libguestfs-1.11.19/fish/guestfish.pod:357 msgid "" "Progress bars are enabled by default when guestfish is used as an " "interactive shell." msgstr "" #. type: =item -#: ../fish/guestfish.pod:360 +#: ../fish/guestfish.pod:360 ../libguestfs-1.11.19/fish/guestfish.pod:360 msgid "B<--no-progress-bars>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:362 +#: ../fish/guestfish.pod:362 ../libguestfs-1.11.19/fish/guestfish.pod:362 msgid "Disable progress bars." msgstr "" #. type: =item -#: ../fish/guestfish.pod:364 +#: ../fish/guestfish.pod:364 ../libguestfs-1.11.19/fish/guestfish.pod:364 msgid "B<--remote[=pid]>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:366 +#: ../fish/guestfish.pod:366 ../libguestfs-1.11.19/fish/guestfish.pod:366 msgid "" "Send remote commands to C<$GUESTFISH_PID> or C<pid>. See section L</REMOTE " "CONTROL GUESTFISH OVER A SOCKET> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:369 +#: ../fish/guestfish.pod:369 ../fuse/guestmount.pod:239 ../libguestfs-1.11.19/fish/guestfish.pod:369 ../libguestfs-1.11.19/fuse/guestmount.pod:239 ../libguestfs-1.11.19/rescue/virt-rescue.pod:161 ../rescue/virt-rescue.pod:161 msgid "B<-r>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:371 +#: ../fish/guestfish.pod:371 ../fuse/guestmount.pod:241 ../libguestfs-1.11.19/fish/guestfish.pod:371 ../libguestfs-1.11.19/fuse/guestmount.pod:241 ../libguestfs-1.11.19/rescue/virt-rescue.pod:163 ../rescue/virt-rescue.pod:163 msgid "B<--ro>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:373 +#: ../fish/guestfish.pod:373 ../libguestfs-1.11.19/fish/guestfish.pod:373 msgid "" "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and " "mounts are done read-only." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:376 +#: ../fish/guestfish.pod:376 ../libguestfs-1.11.19/fish/guestfish.pod:376 ../libguestfs-1.11.19/rescue/virt-rescue.pod:167 ../rescue/virt-rescue.pod:167 msgid "" "The option must always be used if the disk image or virtual machine might be " "running, and is generally recommended in cases where you don't need write " @@ -20415,7 +16163,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:380 +#: ../fish/guestfish.pod:380 ../libguestfs-1.11.19/fish/guestfish.pod:380 msgid "" "Note that prepared disk images created with I<-N> are not affected by this " "option. Also commands like C<add> are not affected - you have to specify " @@ -20423,103 +16171,78 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:384 +#: ../fish/guestfish.pod:384 ../libguestfs-1.11.19/fish/guestfish.pod:384 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:237 +#: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:253 ../libguestfs-1.11.19/fish/guestfish.pod:386 ../libguestfs-1.11.19/fuse/guestmount.pod:253 ../libguestfs-1.11.19/rescue/virt-rescue.pod:173 ../rescue/virt-rescue.pod:173 msgid "B<--selinux>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:388 +#: ../fish/guestfish.pod:388 ../libguestfs-1.11.19/fish/guestfish.pod:388 msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>." msgstr "" -#. type: =item -#: ../fish/guestfish.pod:390 -msgid "B<-v>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:392 -msgid "B<--verbose>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:394 +#: ../fish/guestfish.pod:394 ../libguestfs-1.11.19/fish/guestfish.pod:394 msgid "" "Enable very verbose messages. This is particularly useful if you find a " "bug." msgstr "" -#. type: =item -#: ../fish/guestfish.pod:397 -msgid "B<-V>" -msgstr "" - -#. type: =item -#: ../fish/guestfish.pod:399 ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70 -msgid "B<--version>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:401 +#: ../fish/guestfish.pod:401 ../libguestfs-1.11.19/fish/guestfish.pod:401 msgid "Display the guestfish / libguestfs version number and exit." msgstr "" #. type: =item -#: ../fish/guestfish.pod:403 +#: ../fish/guestfish.pod:403 ../fuse/guestmount.pod:269 ../libguestfs-1.11.19/fish/guestfish.pod:403 ../libguestfs-1.11.19/fuse/guestmount.pod:269 ../libguestfs-1.11.19/rescue/virt-rescue.pod:190 ../rescue/virt-rescue.pod:190 msgid "B<-w>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:405 +#: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:271 ../libguestfs-1.11.19/fish/guestfish.pod:405 ../libguestfs-1.11.19/fuse/guestmount.pod:271 ../libguestfs-1.11.19/rescue/virt-rescue.pod:192 ../rescue/virt-rescue.pod:192 msgid "B<--rw>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:251 +#: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:273 ../libguestfs-1.11.19/fish/guestfish.pod:407 ../libguestfs-1.11.19/fuse/guestmount.pod:273 msgid "" "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and " "mounts are done read-write." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:410 +#: ../fish/guestfish.pod:410 ../libguestfs-1.11.19/fish/guestfish.pod:410 msgid "See L</OPENING DISKS FOR READ AND WRITE> below." msgstr "" -#. type: =item -#: ../fish/guestfish.pod:412 -msgid "B<-x>" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:414 +#: ../fish/guestfish.pod:414 ../libguestfs-1.11.19/fish/guestfish.pod:414 msgid "Echo each command before executing it." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:418 +#: ../fish/guestfish.pod:418 ../libguestfs-1.11.19/fish/guestfish.pod:418 msgid "COMMANDS ON COMMAND LINE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:420 +#: ../fish/guestfish.pod:420 ../libguestfs-1.11.19/fish/guestfish.pod:420 msgid "Any additional (non-option) arguments are treated as commands to execute." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:423 +#: ../fish/guestfish.pod:423 ../libguestfs-1.11.19/fish/guestfish.pod:423 msgid "" "Commands to execute should be separated by a colon (C<:>), where the colon " "is a separate parameter. Thus:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:426 +#: ../fish/guestfish.pod:426 ../libguestfs-1.11.19/fish/guestfish.pod:426 #, no-wrap msgid "" " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n" @@ -20527,7 +16250,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:428 +#: ../fish/guestfish.pod:428 ../libguestfs-1.11.19/fish/guestfish.pod:428 msgid "" "If there are no additional arguments, then we enter a shell, either an " "interactive shell with a prompt (if the input is a terminal) or a " @@ -20535,7 +16258,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:432 +#: ../fish/guestfish.pod:432 ../libguestfs-1.11.19/fish/guestfish.pod:432 msgid "" "In either command line mode or non-interactive shell, the first command that " "gives an error causes the whole shell to exit. In interactive mode (with a " @@ -20543,12 +16266,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:437 +#: ../fish/guestfish.pod:437 ../libguestfs-1.11.19/fish/guestfish.pod:437 msgid "USING launch (OR run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:439 +#: ../fish/guestfish.pod:439 ../libguestfs-1.11.19/fish/guestfish.pod:439 msgid "" "As with L<guestfs(3)>, you must first configure your guest by adding disks, " "then launch it, then mount any disks you need, and finally issue " @@ -20556,34 +16279,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:447 +#: ../fish/guestfish.pod:447 ../libguestfs-1.11.19/fish/guestfish.pod:447 msgid "add or -a/--add" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:451 +#: ../fish/guestfish.pod:451 ../libguestfs-1.11.19/fish/guestfish.pod:451 msgid "launch (aka run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:455 +#: ../fish/guestfish.pod:455 ../libguestfs-1.11.19/fish/guestfish.pod:455 msgid "mount or -m/--mount" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:459 +#: ../fish/guestfish.pod:459 ../libguestfs-1.11.19/fish/guestfish.pod:459 msgid "any other commands" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:463 +#: ../fish/guestfish.pod:463 ../libguestfs-1.11.19/fish/guestfish.pod:463 msgid "" "C<run> is a synonym for C<launch>. You must C<launch> (or C<run>) your " "guest before mounting or performing any other commands." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:466 +#: ../fish/guestfish.pod:466 ../libguestfs-1.11.19/fish/guestfish.pod:466 msgid "" "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or " "I<--new> options were given then C<run> is done automatically, simply " @@ -20591,12 +16314,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:471 +#: ../fish/guestfish.pod:471 ../libguestfs-1.11.19/fish/guestfish.pod:471 msgid "OPENING DISKS FOR READ AND WRITE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:473 +#: ../fish/guestfish.pod:473 ../libguestfs-1.11.19/fish/guestfish.pod:473 msgid "" "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and " "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, " @@ -20604,7 +16327,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:478 +#: ../fish/guestfish.pod:478 ../libguestfs-1.11.19/fish/guestfish.pod:478 msgid "" "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to " "opening disk images supplied on the command line for write. To open a disk " @@ -20612,16 +16335,16 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:482 +#: ../fish/guestfish.pod:482 ../libguestfs-1.11.19/fish/guestfish.pod:482 msgid "" "This matters: If you accidentally open a live VM disk image writable then " "you will cause irreversible disk corruption." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:485 +#: ../fish/guestfish.pod:485 ../libguestfs-1.11.19/fish/guestfish.pod:485 msgid "" -"By libguestfs 1.12 we intend to change the default the other way. Disk " +"In a future libguestfs we intend to change the default the other way. Disk " "images will be opened read-only. You will have to either specify " "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the " "configuration file C</etc/libguestfs-tools.conf> in order to get write " @@ -20629,7 +16352,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:492 +#: ../fish/guestfish.pod:492 ../libguestfs-1.11.19/fish/guestfish.pod:492 msgid "" "This version of guestfish, guestmount and virt-rescue has a I<--rw> option " "which does nothing (it is already the default). However it is highly " @@ -20639,26 +16362,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:498 +#: ../fish/guestfish.pod:498 ../libguestfs-1.11.19/fish/guestfish.pod:498 msgid "" "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any " "other libguestfs program apart from guestfish and guestmount." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:501 +#: ../fish/guestfish.pod:501 ../libguestfs-1.11.19/fish/guestfish.pod:501 msgid "QUOTING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:503 +#: ../fish/guestfish.pod:503 ../libguestfs-1.11.19/fish/guestfish.pod:503 msgid "" "You can quote ordinary parameters using either single or double quotes. For " "example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:506 +#: ../fish/guestfish.pod:506 ../libguestfs-1.11.19/fish/guestfish.pod:506 #, no-wrap msgid "" " add \"file with a space.img\"\n" @@ -20666,7 +16389,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:508 +#: ../fish/guestfish.pod:508 ../libguestfs-1.11.19/fish/guestfish.pod:508 #, no-wrap msgid "" " rm '/file name'\n" @@ -20674,7 +16397,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:510 +#: ../fish/guestfish.pod:510 ../libguestfs-1.11.19/fish/guestfish.pod:510 #, no-wrap msgid "" " rm '/\"'\n" @@ -20682,7 +16405,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:512 +#: ../fish/guestfish.pod:512 ../libguestfs-1.11.19/fish/guestfish.pod:512 msgid "" "A few commands require a list of strings to be passed. For these, use a " "whitespace-separated list, enclosed in quotes. Strings containing " @@ -20691,7 +16414,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:517 +#: ../fish/guestfish.pod:517 ../libguestfs-1.11.19/fish/guestfish.pod:517 #, no-wrap msgid "" " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n" @@ -20701,150 +16424,150 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:521 +#: ../fish/guestfish.pod:521 ../libguestfs-1.11.19/fish/guestfish.pod:521 msgid "ESCAPE SEQUENCES IN DOUBLE QUOTED ARGUMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:523 +#: ../fish/guestfish.pod:523 ../libguestfs-1.11.19/fish/guestfish.pod:523 msgid "" "In double-quoted arguments (only) use backslash to insert special " "characters:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:528 +#: ../fish/guestfish.pod:528 ../libguestfs-1.11.19/fish/guestfish.pod:528 msgid "C<\\a>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:530 +#: ../fish/guestfish.pod:530 ../libguestfs-1.11.19/fish/guestfish.pod:530 msgid "Alert (bell) character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:532 +#: ../fish/guestfish.pod:532 ../libguestfs-1.11.19/fish/guestfish.pod:532 msgid "C<\\b>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:534 +#: ../fish/guestfish.pod:534 ../libguestfs-1.11.19/fish/guestfish.pod:534 msgid "Backspace character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:536 +#: ../fish/guestfish.pod:536 ../libguestfs-1.11.19/fish/guestfish.pod:536 msgid "C<\\f>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:538 +#: ../fish/guestfish.pod:538 ../libguestfs-1.11.19/fish/guestfish.pod:538 msgid "Form feed character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:540 +#: ../fish/guestfish.pod:540 ../libguestfs-1.11.19/fish/guestfish.pod:540 msgid "C<\\n>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:542 +#: ../fish/guestfish.pod:542 ../libguestfs-1.11.19/fish/guestfish.pod:542 msgid "Newline character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:544 +#: ../fish/guestfish.pod:544 ../libguestfs-1.11.19/fish/guestfish.pod:544 msgid "C<\\r>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:546 +#: ../fish/guestfish.pod:546 ../libguestfs-1.11.19/fish/guestfish.pod:546 msgid "Carriage return character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:548 +#: ../fish/guestfish.pod:548 ../libguestfs-1.11.19/fish/guestfish.pod:548 msgid "C<\\t>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:550 +#: ../fish/guestfish.pod:550 ../libguestfs-1.11.19/fish/guestfish.pod:550 msgid "Horizontal tab character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:552 +#: ../fish/guestfish.pod:552 ../libguestfs-1.11.19/fish/guestfish.pod:552 msgid "C<\\v>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:554 +#: ../fish/guestfish.pod:554 ../libguestfs-1.11.19/fish/guestfish.pod:554 msgid "Vertical tab character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:556 +#: ../fish/guestfish.pod:556 ../libguestfs-1.11.19/fish/guestfish.pod:556 msgid "C<\\\">" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:558 +#: ../fish/guestfish.pod:558 ../libguestfs-1.11.19/fish/guestfish.pod:558 msgid "A literal double quote character." msgstr "" #. type: =item -#: ../fish/guestfish.pod:560 +#: ../fish/guestfish.pod:560 ../libguestfs-1.11.19/fish/guestfish.pod:560 msgid "C<\\ooo>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:562 +#: ../fish/guestfish.pod:562 ../libguestfs-1.11.19/fish/guestfish.pod:562 msgid "" "A character with octal value I<ooo>. There must be precisely 3 octal digits " "(unlike C)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:565 +#: ../fish/guestfish.pod:565 ../libguestfs-1.11.19/fish/guestfish.pod:565 msgid "C<\\xhh>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:567 +#: ../fish/guestfish.pod:567 ../libguestfs-1.11.19/fish/guestfish.pod:567 msgid "A character with hex value I<hh>. There must be precisely 2 hex digits." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:570 +#: ../fish/guestfish.pod:570 ../libguestfs-1.11.19/fish/guestfish.pod:570 msgid "" "In the current implementation C<\\000> and C<\\x00> cannot be used in " "strings." msgstr "" #. type: =item -#: ../fish/guestfish.pod:573 +#: ../fish/guestfish.pod:573 ../libguestfs-1.11.19/fish/guestfish.pod:573 msgid "C<\\\\>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:575 +#: ../fish/guestfish.pod:575 ../libguestfs-1.11.19/fish/guestfish.pod:575 msgid "A literal backslash character." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:579 +#: ../fish/guestfish.pod:579 ../libguestfs-1.11.19/fish/guestfish.pod:579 msgid "OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:581 +#: ../fish/guestfish.pod:581 ../libguestfs-1.11.19/fish/guestfish.pod:581 msgid "" "Some commands take optional arguments. These arguments appear in this " "documentation as C<[argname:..]>. You can use them as in these examples:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:585 +#: ../fish/guestfish.pod:585 ../libguestfs-1.11.19/fish/guestfish.pod:585 #, no-wrap msgid "" " add-drive-opts filename\n" @@ -20852,7 +16575,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:587 +#: ../fish/guestfish.pod:587 ../libguestfs-1.11.19/fish/guestfish.pod:587 #, no-wrap msgid "" " add-drive-opts filename readonly:true\n" @@ -20860,7 +16583,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:589 +#: ../fish/guestfish.pod:589 ../libguestfs-1.11.19/fish/guestfish.pod:589 #, no-wrap msgid "" " add-drive-opts filename format:qcow2 readonly:false\n" @@ -20868,196 +16591,196 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:591 +#: ../fish/guestfish.pod:591 ../libguestfs-1.11.19/fish/guestfish.pod:591 msgid "" "Each optional argument can appear at most once. All optional arguments must " "appear after the required ones." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:594 +#: ../fish/guestfish.pod:594 ../libguestfs-1.11.19/fish/guestfish.pod:594 msgid "NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:596 +#: ../fish/guestfish.pod:596 ../libguestfs-1.11.19/fish/guestfish.pod:596 msgid "This section applies to all commands which can take integers as parameters." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:599 +#: ../fish/guestfish.pod:599 ../libguestfs-1.11.19/fish/guestfish.pod:599 msgid "SIZE SUFFIX" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:601 +#: ../fish/guestfish.pod:601 ../libguestfs-1.11.19/fish/guestfish.pod:601 msgid "" "When the command takes a parameter measured in bytes, you can use one of the " "following suffixes to specify kilobytes, megabytes and larger sizes:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:607 +#: ../fish/guestfish.pod:607 ../libguestfs-1.11.19/fish/guestfish.pod:607 msgid "B<k> or B<K> or B<KiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:609 +#: ../fish/guestfish.pod:609 ../libguestfs-1.11.19/fish/guestfish.pod:609 msgid "The size in kilobytes (multiplied by 1024)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:611 +#: ../fish/guestfish.pod:611 ../libguestfs-1.11.19/fish/guestfish.pod:611 msgid "B<KB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:613 +#: ../fish/guestfish.pod:613 ../libguestfs-1.11.19/fish/guestfish.pod:613 msgid "The size in SI 1000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:615 +#: ../fish/guestfish.pod:615 ../libguestfs-1.11.19/fish/guestfish.pod:615 msgid "B<M> or B<MiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:617 +#: ../fish/guestfish.pod:617 ../libguestfs-1.11.19/fish/guestfish.pod:617 msgid "The size in megabytes (multiplied by 1048576)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:619 +#: ../fish/guestfish.pod:619 ../libguestfs-1.11.19/fish/guestfish.pod:619 msgid "B<MB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:621 +#: ../fish/guestfish.pod:621 ../libguestfs-1.11.19/fish/guestfish.pod:621 msgid "The size in SI 1000000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:623 +#: ../fish/guestfish.pod:623 ../libguestfs-1.11.19/fish/guestfish.pod:623 msgid "B<G> or B<GiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:625 +#: ../fish/guestfish.pod:625 ../libguestfs-1.11.19/fish/guestfish.pod:625 msgid "The size in gigabytes (multiplied by 2**30)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:627 +#: ../fish/guestfish.pod:627 ../libguestfs-1.11.19/fish/guestfish.pod:627 msgid "B<GB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:629 +#: ../fish/guestfish.pod:629 ../libguestfs-1.11.19/fish/guestfish.pod:629 msgid "The size in SI 10**9 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:631 +#: ../fish/guestfish.pod:631 ../libguestfs-1.11.19/fish/guestfish.pod:631 msgid "B<T> or B<TiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:633 +#: ../fish/guestfish.pod:633 ../libguestfs-1.11.19/fish/guestfish.pod:633 msgid "The size in terabytes (multiplied by 2**40)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:635 +#: ../fish/guestfish.pod:635 ../libguestfs-1.11.19/fish/guestfish.pod:635 msgid "B<TB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:637 +#: ../fish/guestfish.pod:637 ../libguestfs-1.11.19/fish/guestfish.pod:637 msgid "The size in SI 10**12 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:639 +#: ../fish/guestfish.pod:639 ../libguestfs-1.11.19/fish/guestfish.pod:639 msgid "B<P> or B<PiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:641 +#: ../fish/guestfish.pod:641 ../libguestfs-1.11.19/fish/guestfish.pod:641 msgid "The size in petabytes (multiplied by 2**50)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:643 +#: ../fish/guestfish.pod:643 ../libguestfs-1.11.19/fish/guestfish.pod:643 msgid "B<PB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:645 +#: ../fish/guestfish.pod:645 ../libguestfs-1.11.19/fish/guestfish.pod:645 msgid "The size in SI 10**15 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:647 +#: ../fish/guestfish.pod:647 ../libguestfs-1.11.19/fish/guestfish.pod:647 msgid "B<E> or B<EiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:649 +#: ../fish/guestfish.pod:649 ../libguestfs-1.11.19/fish/guestfish.pod:649 msgid "The size in exabytes (multiplied by 2**60)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:651 +#: ../fish/guestfish.pod:651 ../libguestfs-1.11.19/fish/guestfish.pod:651 msgid "B<EB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:653 +#: ../fish/guestfish.pod:653 ../libguestfs-1.11.19/fish/guestfish.pod:653 msgid "The size in SI 10**18 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:655 +#: ../fish/guestfish.pod:655 ../libguestfs-1.11.19/fish/guestfish.pod:655 msgid "B<Z> or B<ZiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:657 +#: ../fish/guestfish.pod:657 ../libguestfs-1.11.19/fish/guestfish.pod:657 msgid "The size in zettabytes (multiplied by 2**70)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:659 +#: ../fish/guestfish.pod:659 ../libguestfs-1.11.19/fish/guestfish.pod:659 msgid "B<ZB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:661 +#: ../fish/guestfish.pod:661 ../libguestfs-1.11.19/fish/guestfish.pod:661 msgid "The size in SI 10**21 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:663 +#: ../fish/guestfish.pod:663 ../libguestfs-1.11.19/fish/guestfish.pod:663 msgid "B<Y> or B<YiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:665 +#: ../fish/guestfish.pod:665 ../libguestfs-1.11.19/fish/guestfish.pod:665 msgid "The size in yottabytes (multiplied by 2**80)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:667 +#: ../fish/guestfish.pod:667 ../libguestfs-1.11.19/fish/guestfish.pod:667 msgid "B<YB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:669 +#: ../fish/guestfish.pod:669 ../libguestfs-1.11.19/fish/guestfish.pod:669 msgid "The size in SI 10**24 byte units." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:675 +#: ../fish/guestfish.pod:675 ../libguestfs-1.11.19/fish/guestfish.pod:675 #, no-wrap msgid "" " truncate-size /file 1G\n" @@ -21065,12 +16788,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:677 +#: ../fish/guestfish.pod:677 ../libguestfs-1.11.19/fish/guestfish.pod:677 msgid "would truncate the file to 1 gigabyte." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:679 +#: ../fish/guestfish.pod:679 ../libguestfs-1.11.19/fish/guestfish.pod:679 msgid "" "Be careful because a few commands take sizes in kilobytes or megabytes " "(eg. the parameter to L</memsize> is specified in megabytes already). " @@ -21078,19 +16801,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:683 +#: ../fish/guestfish.pod:683 ../libguestfs-1.11.19/fish/guestfish.pod:683 msgid "OCTAL AND HEXADECIMAL NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:685 +#: ../fish/guestfish.pod:685 ../libguestfs-1.11.19/fish/guestfish.pod:685 msgid "" "For specifying the radix (base) use the C convention: C<0> to prefix an " "octal number or C<0x> to prefix a hexadecimal number. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:688 +#: ../fish/guestfish.pod:688 ../libguestfs-1.11.19/fish/guestfish.pod:688 #, no-wrap msgid "" " 1234 decimal number 1234\n" @@ -21100,7 +16823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:692 +#: ../fish/guestfish.pod:692 ../libguestfs-1.11.19/fish/guestfish.pod:692 msgid "" "When using the C<chmod> command, you almost always want to specify an octal " "number for the mode, and you must prefix it with C<0> (unlike the Unix " @@ -21108,7 +16831,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:696 +#: ../fish/guestfish.pod:696 ../libguestfs-1.11.19/fish/guestfish.pod:696 #, no-wrap msgid "" " chmod 0777 /public # OK\n" @@ -21117,7 +16840,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:699 +#: ../fish/guestfish.pod:699 ../libguestfs-1.11.19/fish/guestfish.pod:699 msgid "" "Commands that return numbers usually print them in decimal, but some " "commands print numbers in other radices (eg. C<umask> prints the mode in " @@ -21125,12 +16848,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:703 +#: ../fish/guestfish.pod:703 ../libguestfs-1.11.19/fish/guestfish.pod:703 msgid "WILDCARDS AND GLOBBING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:705 +#: ../fish/guestfish.pod:705 ../libguestfs-1.11.19/fish/guestfish.pod:705 msgid "" "Neither guestfish nor the underlying guestfs API performs wildcard expansion " "(globbing) by default. So for example the following will not do what you " @@ -21138,7 +16861,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:709 +#: ../fish/guestfish.pod:709 ../libguestfs-1.11.19/fish/guestfish.pod:709 #, no-wrap msgid "" " rm-rf /home/*\n" @@ -21146,19 +16869,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:711 +#: ../fish/guestfish.pod:711 ../libguestfs-1.11.19/fish/guestfish.pod:711 msgid "" "Assuming you don't have a directory called literally C</home/*> then the " "above command will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:714 +#: ../fish/guestfish.pod:714 ../libguestfs-1.11.19/fish/guestfish.pod:714 msgid "To perform wildcard expansion, use the C<glob> command." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:716 +#: ../fish/guestfish.pod:716 ../libguestfs-1.11.19/fish/guestfish.pod:716 #, no-wrap msgid "" " glob rm-rf /home/*\n" @@ -21166,14 +16889,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:718 +#: ../fish/guestfish.pod:718 ../libguestfs-1.11.19/fish/guestfish.pod:718 msgid "" "runs C<rm-rf> on each path that matches (ie. potentially running the command " "many times), equivalent to:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:721 +#: ../fish/guestfish.pod:721 ../libguestfs-1.11.19/fish/guestfish.pod:721 #, no-wrap msgid "" " rm-rf /home/jim\n" @@ -21183,24 +16906,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:725 +#: ../fish/guestfish.pod:725 ../libguestfs-1.11.19/fish/guestfish.pod:725 msgid "C<glob> only works on simple guest paths and not on device names." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:727 +#: ../fish/guestfish.pod:727 ../libguestfs-1.11.19/fish/guestfish.pod:727 msgid "" "If you have several parameters, each containing a wildcard, then glob will " "perform a Cartesian product." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:730 +#: ../fish/guestfish.pod:730 ../libguestfs-1.11.19/fish/guestfish.pod:730 msgid "COMMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:732 +#: ../fish/guestfish.pod:732 ../libguestfs-1.11.19/fish/guestfish.pod:732 msgid "" "Any line which starts with a I<#> character is treated as a comment and " "ignored. The I<#> can optionally be preceeded by whitespace, but B<not> by " @@ -21208,7 +16931,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:736 +#: ../fish/guestfish.pod:736 ../libguestfs-1.11.19/fish/guestfish.pod:736 #, no-wrap msgid "" " # this is a comment\n" @@ -21218,24 +16941,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:740 +#: ../fish/guestfish.pod:740 ../libguestfs-1.11.19/fish/guestfish.pod:740 msgid "Blank lines are also ignored." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:742 +#: ../fish/guestfish.pod:742 ../libguestfs-1.11.19/fish/guestfish.pod:742 msgid "RUNNING COMMANDS LOCALLY" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:744 +#: ../fish/guestfish.pod:744 ../libguestfs-1.11.19/fish/guestfish.pod:744 msgid "" "Any line which starts with a I<!> character is treated as a command sent to " "the local shell (C</bin/sh> or whatever L<system(3)> uses). For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:748 +#: ../fish/guestfish.pod:748 ../libguestfs-1.11.19/fish/guestfish.pod:748 #, no-wrap msgid "" " !mkdir local\n" @@ -21244,7 +16967,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:751 +#: ../fish/guestfish.pod:751 ../libguestfs-1.11.19/fish/guestfish.pod:751 msgid "" "will create a directory C<local> on the host, and then export the contents " "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>. " @@ -21252,19 +16975,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:755 +#: ../fish/guestfish.pod:755 ../libguestfs-1.11.19/fish/guestfish.pod:755 msgid "" "To change the local directory, use the C<lcd> command. C<!cd> will have no " "effect, due to the way that subprocesses work in Unix." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:758 +#: ../fish/guestfish.pod:758 ../libguestfs-1.11.19/fish/guestfish.pod:758 msgid "LOCAL COMMANDS WITH INLINE EXECUTION" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:760 +#: ../fish/guestfish.pod:760 ../libguestfs-1.11.19/fish/guestfish.pod:760 msgid "" "If a line starts with I<E<lt>!> then the shell command is executed (as for " "I<!>), but subsequently any output (stdout) of the shell command is parsed " @@ -21272,14 +16995,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:764 +#: ../fish/guestfish.pod:764 ../libguestfs-1.11.19/fish/guestfish.pod:764 msgid "" "Thus you can use shell script to construct arbitrary guestfish commands " "which are then parsed by guestfish." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:767 +#: ../fish/guestfish.pod:767 ../libguestfs-1.11.19/fish/guestfish.pod:767 msgid "" "For example it is tedious to create a sequence of files (eg. C</foo.1> " "through C</foo.100>) using guestfish commands alone. However this is simple " @@ -21287,7 +17010,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:772 +#: ../fish/guestfish.pod:772 ../libguestfs-1.11.19/fish/guestfish.pod:772 #, no-wrap msgid "" " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n" @@ -21295,12 +17018,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:774 +#: ../fish/guestfish.pod:774 ../libguestfs-1.11.19/fish/guestfish.pod:774 msgid "or with names like C</foo.001>:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:776 +#: ../fish/guestfish.pod:776 ../libguestfs-1.11.19/fish/guestfish.pod:776 #, no-wrap msgid "" " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n" @@ -21308,7 +17031,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:778 +#: ../fish/guestfish.pod:778 ../libguestfs-1.11.19/fish/guestfish.pod:778 msgid "" "When using guestfish interactively it can be helpful to just run the shell " "script first (ie. remove the initial C<E<lt>> character so it is just an " @@ -21318,12 +17041,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:784 +#: ../fish/guestfish.pod:784 ../libguestfs-1.11.19/fish/guestfish.pod:784 msgid "PIPES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:786 +#: ../fish/guestfish.pod:786 ../libguestfs-1.11.19/fish/guestfish.pod:786 msgid "" "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first " "command (a guestfish command) to the second command (any host command). For " @@ -21331,7 +17054,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:790 +#: ../fish/guestfish.pod:790 ../libguestfs-1.11.19/fish/guestfish.pod:790 #, no-wrap msgid "" " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n" @@ -21339,7 +17062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:792 +#: ../fish/guestfish.pod:792 ../libguestfs-1.11.19/fish/guestfish.pod:792 msgid "" "(where C<cat> is the guestfish cat command, but C<awk> is the host awk " "program). The above command would list all accounts in the guest filesystem " @@ -21347,7 +17070,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:797 +#: ../fish/guestfish.pod:797 ../libguestfs-1.11.19/fish/guestfish.pod:797 #, no-wrap msgid "" " hexdump /bin/ls | head\n" @@ -21357,7 +17080,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:801 +#: ../fish/guestfish.pod:801 ../libguestfs-1.11.19/fish/guestfish.pod:801 msgid "" "The space before the pipe symbol is required, any space after the pipe " "symbol is optional. Everything after the pipe symbol is just passed " @@ -21366,14 +17089,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:806 +#: ../fish/guestfish.pod:806 ../libguestfs-1.11.19/fish/guestfish.pod:806 msgid "" "To use a literal argument which begins with a pipe symbol, you have to quote " "it, eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:809 +#: ../fish/guestfish.pod:809 ../libguestfs-1.11.19/fish/guestfish.pod:809 #, no-wrap msgid "" " echo \"|\"\n" @@ -21381,12 +17104,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:811 +#: ../fish/guestfish.pod:811 ../libguestfs-1.11.19/fish/guestfish.pod:811 msgid "HOME DIRECTORIES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:813 +#: ../fish/guestfish.pod:813 ../libguestfs-1.11.19/fish/guestfish.pod:813 msgid "" "If a parameter starts with the character C<~> then the tilde may be expanded " "as a home directory path (either C<~> for the current user's home directory, " @@ -21394,29 +17117,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:817 +#: ../fish/guestfish.pod:817 ../libguestfs-1.11.19/fish/guestfish.pod:817 msgid "" "Note that home directory expansion happens for users known I<on the host>, " "not in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:820 +#: ../fish/guestfish.pod:820 ../libguestfs-1.11.19/fish/guestfish.pod:820 msgid "" "To use a literal argument which begins with a tilde, you have to quote it, " "eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:823 +#: ../fish/guestfish.pod:823 ../libguestfs-1.11.19/fish/guestfish.pod:823 #, no-wrap msgid "" " echo \"~\"\n" "\n" msgstr "" +#. type: =head2 +#: ../fish/guestfish.pod:825 ../libguestfs-1.11.19/fish/guestfish.pod:825 ../libguestfs-1.11.19/src/guestfs.pod:519 ../src/guestfs.pod:519 +msgid "ENCRYPTED DISKS" +msgstr "" + #. type: textblock -#: ../fish/guestfish.pod:827 +#: ../fish/guestfish.pod:827 ../libguestfs-1.11.19/fish/guestfish.pod:827 msgid "" "Libguestfs has some support for Linux guests encrypted according to the " "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole " @@ -21425,12 +17153,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:832 +#: ../fish/guestfish.pod:832 ../libguestfs-1.11.19/fish/guestfish.pod:832 msgid "Identify encrypted block devices and partitions using L</vfs-type>:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:834 +#: ../fish/guestfish.pod:834 ../libguestfs-1.11.19/fish/guestfish.pod:834 #, no-wrap msgid "" " ><fs> vfs-type /dev/sda2\n" @@ -21439,14 +17167,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:837 +#: ../fish/guestfish.pod:837 ../libguestfs-1.11.19/fish/guestfish.pod:837 msgid "" "Then open those devices using L</luks-open>. This creates a device-mapper " "device called C</dev/mapper/luksdev>." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:840 +#: ../fish/guestfish.pod:840 ../libguestfs-1.11.19/fish/guestfish.pod:840 #, no-wrap msgid "" " ><fs> luks-open /dev/sda2 luksdev\n" @@ -21455,14 +17183,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:843 +#: ../fish/guestfish.pod:843 ../libguestfs-1.11.19/fish/guestfish.pod:843 msgid "" "Finally you have to tell LVM to scan for volume groups on the newly created " "mapper device:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:846 +#: ../fish/guestfish.pod:846 ../libguestfs-1.11.19/fish/guestfish.pod:846 #, no-wrap msgid "" " vgscan\n" @@ -21471,12 +17199,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:849 +#: ../fish/guestfish.pod:849 ../libguestfs-1.11.19/fish/guestfish.pod:849 msgid "The logical volume(s) can now be mounted in the usual way." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:851 +#: ../fish/guestfish.pod:851 ../libguestfs-1.11.19/fish/guestfish.pod:851 msgid "" "Before closing a LUKS device you must unmount any logical volumes on it and " "deactivate the volume groups by calling C<vg-activate false VG> on each " @@ -21484,7 +17212,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:855 +#: ../fish/guestfish.pod:855 ../libguestfs-1.11.19/fish/guestfish.pod:855 #, no-wrap msgid "" " vg-activate false /dev/VG\n" @@ -21492,13 +17220,8 @@ msgid "" "\n" msgstr "" -#. type: =head1 -#: ../fish/guestfish.pod:858 -msgid "WINDOWS PATHS" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:860 +#: ../fish/guestfish.pod:860 ../libguestfs-1.11.19/fish/guestfish.pod:860 msgid "" "If a path is prefixed with C<win:> then you can use Windows-style drive " "letters and paths (with some limitations). The following commands are " @@ -21506,7 +17229,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:864 +#: ../fish/guestfish.pod:864 ../libguestfs-1.11.19/fish/guestfish.pod:864 #, no-wrap msgid "" " file /WINDOWS/system32/config/system.LOG\n" @@ -21514,7 +17237,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:866 +#: ../fish/guestfish.pod:866 ../libguestfs-1.11.19/fish/guestfish.pod:866 #, no-wrap msgid "" " file win:\\windows\\system32\\config\\system.log\n" @@ -21522,7 +17245,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:868 +#: ../fish/guestfish.pod:868 ../libguestfs-1.11.19/fish/guestfish.pod:868 #, no-wrap msgid "" " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n" @@ -21530,7 +17253,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:870 +#: ../fish/guestfish.pod:870 ../libguestfs-1.11.19/fish/guestfish.pod:870 msgid "" "The parameter is rewritten \"behind the scenes\" by looking up the position " "where the drive is mounted, prepending that to the path, changing all " @@ -21540,7 +17263,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:876 +#: ../fish/guestfish.pod:876 ../libguestfs-1.11.19/fish/guestfish.pod:876 #, no-wrap msgid "" " win:e:\\foo\\bar => /e/FOO/bar\n" @@ -21548,17 +17271,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:878 +#: ../fish/guestfish.pod:878 ../libguestfs-1.11.19/fish/guestfish.pod:878 msgid "This only works in argument positions that expect a path." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:880 +#: ../fish/guestfish.pod:880 ../libguestfs-1.11.19/fish/guestfish.pod:880 msgid "UPLOADING AND DOWNLOADING FILES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:882 +#: ../fish/guestfish.pod:882 ../libguestfs-1.11.19/fish/guestfish.pod:882 msgid "" "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and " "others which upload from or download to a local file, you can use the " @@ -21566,7 +17289,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:886 +#: ../fish/guestfish.pod:886 ../libguestfs-1.11.19/fish/guestfish.pod:886 #, no-wrap msgid "" " upload - /foo\n" @@ -21574,12 +17297,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:888 +#: ../fish/guestfish.pod:888 ../libguestfs-1.11.19/fish/guestfish.pod:888 msgid "reads stdin and creates from that a file C</foo> in the disk image, and:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:891 +#: ../fish/guestfish.pod:891 ../libguestfs-1.11.19/fish/guestfish.pod:891 #, no-wrap msgid "" " tar-out /etc - | tar tf -\n" @@ -21587,14 +17310,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:893 +#: ../fish/guestfish.pod:893 ../libguestfs-1.11.19/fish/guestfish.pod:893 msgid "" "writes the tarball to stdout and then pipes that into the external \"tar\" " "command (see L</PIPES>)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:896 +#: ../fish/guestfish.pod:896 ../libguestfs-1.11.19/fish/guestfish.pod:896 msgid "" "When using C<-> to read from stdin, the input is read up to the end of " "stdin. You can also use a special \"heredoc\"-like syntax to read up to " @@ -21602,7 +17325,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:900 +#: ../fish/guestfish.pod:900 ../libguestfs-1.11.19/fish/guestfish.pod:900 #, no-wrap msgid "" " upload -<<END /foo\n" @@ -21614,7 +17337,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:906 +#: ../fish/guestfish.pod:906 ../libguestfs-1.11.19/fish/guestfish.pod:906 msgid "" "Any string of characters can be used instead of C<END>. The end marker must " "appear on a line of its own, without any preceeding or following characters " @@ -21622,19 +17345,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:910 +#: ../fish/guestfish.pod:910 ../libguestfs-1.11.19/fish/guestfish.pod:910 msgid "" "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to " "upload local files (so-called \"FileIn\" parameters in the generator)." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:913 +#: ../fish/guestfish.pod:913 ../libguestfs-1.11.19/fish/guestfish.pod:913 msgid "EXIT ON ERROR BEHAVIOUR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:915 +#: ../fish/guestfish.pod:915 ../libguestfs-1.11.19/fish/guestfish.pod:915 msgid "" "By default, guestfish will ignore any errors when in interactive mode " "(ie. taking commands from a human over a tty), and will exit on the first " @@ -21642,19 +17365,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:920 +#: ../fish/guestfish.pod:920 ../libguestfs-1.11.19/fish/guestfish.pod:920 msgid "" "If you prefix a command with a I<-> character, then that command will not " "cause guestfish to exit, even if that (one) command returns an error." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:924 +#: ../fish/guestfish.pod:924 ../libguestfs-1.11.19/fish/guestfish.pod:924 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:926 +#: ../fish/guestfish.pod:926 ../libguestfs-1.11.19/fish/guestfish.pod:926 msgid "" "Guestfish can be remote-controlled over a socket. This is useful " "particularly in shell scripts where you want to make several different " @@ -21663,12 +17386,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:931 +#: ../fish/guestfish.pod:931 ../libguestfs-1.11.19/fish/guestfish.pod:931 msgid "Start a guestfish server process using:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:933 +#: ../fish/guestfish.pod:933 ../libguestfs-1.11.19/fish/guestfish.pod:933 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -21676,12 +17399,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:935 +#: ../fish/guestfish.pod:935 ../libguestfs-1.11.19/fish/guestfish.pod:935 msgid "and then send it commands by doing:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:937 +#: ../fish/guestfish.pod:937 ../libguestfs-1.11.19/fish/guestfish.pod:937 #, no-wrap msgid "" " guestfish --remote cmd [...]\n" @@ -21689,20 +17412,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:939 +#: ../fish/guestfish.pod:939 ../libguestfs-1.11.19/fish/guestfish.pod:939 msgid "To cause the server to exit, send it the exit command:" msgstr "" -#. type: verbatim -#: ../fish/guestfish.pod:941 -#, no-wrap -msgid "" -" guestfish --remote exit\n" -"\n" -msgstr "" - #. type: textblock -#: ../fish/guestfish.pod:943 +#: ../fish/guestfish.pod:943 ../libguestfs-1.11.19/fish/guestfish.pod:943 msgid "" "Note that the server will normally exit if there is an error in a command. " "You can change this in the usual way. See section L</EXIT ON ERROR " @@ -21710,12 +17425,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:947 +#: ../fish/guestfish.pod:947 ../libguestfs-1.11.19/fish/guestfish.pod:947 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:949 +#: ../fish/guestfish.pod:949 ../libguestfs-1.11.19/fish/guestfish.pod:949 msgid "" "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which " "is how the I<--remote> option knows where to send the commands. You can " @@ -21723,7 +17438,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:953 +#: ../fish/guestfish.pod:953 ../libguestfs-1.11.19/fish/guestfish.pod:953 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -21737,19 +17452,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:961 +#: ../fish/guestfish.pod:961 ../libguestfs-1.11.19/fish/guestfish.pod:961 msgid "REMOTE CONTROL AND CSH" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:963 +#: ../fish/guestfish.pod:963 ../libguestfs-1.11.19/fish/guestfish.pod:963 msgid "" "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> " "option:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:966 +#: ../fish/guestfish.pod:966 ../libguestfs-1.11.19/fish/guestfish.pod:966 #, no-wrap msgid "" " eval \"`guestfish --listen --csh`\"\n" @@ -21757,12 +17472,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:968 +#: ../fish/guestfish.pod:968 ../libguestfs-1.11.19/fish/guestfish.pod:968 msgid "REMOTE CONTROL DETAILS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:970 +#: ../fish/guestfish.pod:970 ../libguestfs-1.11.19/fish/guestfish.pod:970 msgid "" "Remote control happens over a Unix domain socket called " "C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID " @@ -21770,17 +17485,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:974 +#: ../fish/guestfish.pod:974 ../libguestfs-1.11.19/fish/guestfish.pod:974 msgid "Guestfish client and server versions must match exactly." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:976 +#: ../fish/guestfish.pod:976 ../libguestfs-1.11.19/fish/guestfish.pod:976 msgid "PREPARED DISK IMAGES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:978 +#: ../fish/guestfish.pod:978 ../libguestfs-1.11.19/fish/guestfish.pod:978 msgid "" "Use the I<-N type> or I<--new type> parameter to select one of a set of " "preformatted disk images that guestfish can make for you to save typing. " @@ -21790,7 +17505,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:984 +#: ../fish/guestfish.pod:984 ../libguestfs-1.11.19/fish/guestfish.pod:984 msgid "" "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for " "the second and so on. Existing files in the current directory are " @@ -21798,7 +17513,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:988 +#: ../fish/guestfish.pod:988 ../libguestfs-1.11.19/fish/guestfish.pod:988 msgid "" "The type briefly describes how the disk should be sized, partitioned, how " "filesystem(s) should be created, and how content should be added. " @@ -21810,31 +17525,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:996 +#: ../fish/guestfish.pod:996 ../libguestfs-1.11.19/fish/guestfish.pod:996 msgid "To list the available types and any extra parameters they take, run:" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1000 +#: ../fish/guestfish.pod:1000 ../libguestfs-1.11.19/fish/guestfish.pod:1000 msgid "" "Note that the prepared filesystem is not mounted. You would usually have to " "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1004 +#: ../fish/guestfish.pod:1004 ../libguestfs-1.11.19/fish/guestfish.pod:1004 msgid "" "If any I<-N> or I<--new> options are given, the guest is automatically " "launched." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1009 +#: ../fish/guestfish.pod:1009 ../libguestfs-1.11.19/fish/guestfish.pod:1009 msgid "Create a 100MB disk with an ext4-formatted partition:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1011 +#: ../fish/guestfish.pod:1011 ../libguestfs-1.11.19/fish/guestfish.pod:1011 #, no-wrap msgid "" " guestfish -N fs:ext4\n" @@ -21842,12 +17557,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1013 +#: ../fish/guestfish.pod:1013 ../libguestfs-1.11.19/fish/guestfish.pod:1013 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1015 +#: ../fish/guestfish.pod:1015 ../libguestfs-1.11.19/fish/guestfish.pod:1015 #, no-wrap msgid "" " guestfish -N fs:vfat:32M -m /dev/sda1\n" @@ -21855,12 +17570,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1017 +#: ../fish/guestfish.pod:1017 ../libguestfs-1.11.19/fish/guestfish.pod:1017 msgid "Create a blank 200MB disk:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1019 +#: ../fish/guestfish.pod:1019 ../libguestfs-1.11.19/fish/guestfish.pod:1019 #, no-wrap msgid "" " guestfish -N disk:200M\n" @@ -21868,19 +17583,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1021 +#: ../fish/guestfish.pod:1021 ../libguestfs-1.11.19/fish/guestfish.pod:1021 msgid "PROGRESS BARS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1023 +#: ../fish/guestfish.pod:1023 ../libguestfs-1.11.19/fish/guestfish.pod:1023 msgid "" "Some (not all) long-running commands send progress notification messages as " "they are running. Guestfish turns these messages into progress bars." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1027 +#: ../fish/guestfish.pod:1027 ../libguestfs-1.11.19/fish/guestfish.pod:1027 msgid "" "When a command that supports progress bars takes longer than two seconds to " "run, and if progress bars are enabled, then you will see one appearing below " @@ -21888,7 +17603,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1031 +#: ../fish/guestfish.pod:1031 ../libguestfs-1.11.19/fish/guestfish.pod:1031 #, no-wrap msgid "" " ><fs> copy-size /large-file /another-file 2048M\n" @@ -21897,7 +17612,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1034 +#: ../fish/guestfish.pod:1034 ../libguestfs-1.11.19/fish/guestfish.pod:1034 msgid "" "The spinner on the left hand side moves round once for every progress " "notification received from the backend. This is a (reasonably) golden " @@ -21908,7 +17623,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1041 +#: ../fish/guestfish.pod:1041 ../libguestfs-1.11.19/fish/guestfish.pod:1041 msgid "" "Progress bars are enabled by default when guestfish is used interactively. " "You can enable them even for non-interactive modes using I<--progress-bars>, " @@ -21916,24 +17631,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1046 +#: ../fish/guestfish.pod:1046 ../libguestfs-1.11.19/fish/guestfish.pod:1046 msgid "GUESTFISH COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1048 +#: ../fish/guestfish.pod:1048 ../libguestfs-1.11.19/fish/guestfish.pod:1048 msgid "" "The commands in this section are guestfish convenience commands, in other " "words, they are not part of the L<guestfs(3)> API." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:1051 +#: ../fish/guestfish.pod:1051 ../libguestfs-1.11.19/fish/guestfish.pod:1051 msgid "help" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1053 +#: ../fish/guestfish.pod:1053 ../libguestfs-1.11.19/fish/guestfish.pod:1053 #, no-wrap msgid "" " help\n" @@ -21942,189 +17657,270 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1056 +#: ../fish/guestfish.pod:1056 ../libguestfs-1.11.19/fish/guestfish.pod:1056 msgid "Without any parameter, this provides general help." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1058 +#: ../fish/guestfish.pod:1058 ../libguestfs-1.11.19/fish/guestfish.pod:1058 msgid "With a C<cmd> parameter, this displays detailed help for that command." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:1060 +#: ../fish/guestfish.pod:1060 ../libguestfs-1.11.19/fish/guestfish.pod:1060 msgid "quit | exit" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1062 +#: ../fish/guestfish.pod:1062 ../libguestfs-1.11.19/fish/guestfish.pod:1062 msgid "This exits guestfish. You can also use C<^D> key." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1064 +#: ../fish/guestfish.pod:1064 ../libguestfs-1.11.19/fish/guestfish.pod:1064 msgid "@FISH_COMMANDS@" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1066 +#: ../fish/guestfish.pod:1066 ../libguestfs-1.11.19/fish/guestfish.pod:1066 msgid "COMMANDS" msgstr "" +#. type: textblock +#: ../fish/guestfish.pod:1068 ../libguestfs-1.11.19/fish/guestfish.pod:1068 ../libguestfs-1.11.19/src/guestfs.pod:1474 ../src/guestfs.pod:1474 +msgid "@ACTIONS@" +msgstr "" + #. type: =head1 -#: ../fish/guestfish.pod:1070 ../test-tool/libguestfs-test-tool.pod:77 +#: ../fish/guestfish.pod:1070 ../libguestfs-1.11.19/fish/guestfish.pod:1070 ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:77 ../test-tool/libguestfs-test-tool.pod:77 msgid "EXIT CODE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1072 +#: ../fish/guestfish.pod:1072 ../libguestfs-1.11.19/fish/guestfish.pod:1072 msgid "" "guestfish returns 0 if the commands completed without error, or 1 if there " "was an error." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1079 +#: ../fish/guestfish.pod:1079 ../libguestfs-1.11.19/fish/guestfish.pod:1079 msgid "EDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1081 +#: ../fish/guestfish.pod:1081 ../libguestfs-1.11.19/fish/guestfish.pod:1081 msgid "" "The C<edit> command uses C<$EDITOR> as the editor. If not set, it uses " "C<vi>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1084 +#: ../fish/guestfish.pod:1084 ../libguestfs-1.11.19/fish/guestfish.pod:1084 msgid "GUESTFISH_DISPLAY_IMAGE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1086 +#: ../fish/guestfish.pod:1086 ../libguestfs-1.11.19/fish/guestfish.pod:1086 msgid "" "The C<display> command uses C<$GUESTFISH_DISPLAY_IMAGE> to display images. " "If not set, it uses L<display(1)>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1089 +#: ../fish/guestfish.pod:1089 ../libguestfs-1.11.19/fish/guestfish.pod:1089 msgid "GUESTFISH_PID" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1091 +#: ../fish/guestfish.pod:1091 ../libguestfs-1.11.19/fish/guestfish.pod:1091 msgid "" "Used with the I<--remote> option to specify the remote guestfish process to " "control. See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1095 +#: ../fish/guestfish.pod:1095 ../libguestfs-1.11.19/fish/guestfish.pod:1095 msgid "HEXEDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1097 +#: ../fish/guestfish.pod:1097 ../libguestfs-1.11.19/fish/guestfish.pod:1097 msgid "" "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor. If " "not specified, the external L<hexedit(1)> program is used." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1101 +#: ../fish/guestfish.pod:1101 ../libguestfs-1.11.19/fish/guestfish.pod:1101 msgid "HOME" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1103 +#: ../fish/guestfish.pod:1103 ../libguestfs-1.11.19/fish/guestfish.pod:1103 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L</FILES>." msgstr "" +#. type: =item +#: ../fish/guestfish.pod:1106 ../libguestfs-1.11.19/fish/guestfish.pod:1106 ../libguestfs-1.11.19/src/guestfs.pod:2964 ../src/guestfs.pod:2964 +msgid "LIBGUESTFS_APPEND" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1108 ../libguestfs-1.11.19/fish/guestfish.pod:1108 ../libguestfs-1.11.19/src/guestfs.pod:2966 ../src/guestfs.pod:2966 +msgid "Pass additional options to the guest kernel." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1110 ../libguestfs-1.11.19/fish/guestfish.pod:1110 ../libguestfs-1.11.19/src/guestfs.pod:2968 ../src/guestfs.pod:2968 +msgid "LIBGUESTFS_DEBUG" +msgstr "" + #. type: textblock -#: ../fish/guestfish.pod:1112 +#: ../fish/guestfish.pod:1112 ../libguestfs-1.11.19/fish/guestfish.pod:1112 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" +#. type: =item +#: ../fish/guestfish.pod:1115 ../libguestfs-1.11.19/fish/guestfish.pod:1115 ../libguestfs-1.11.19/src/guestfs.pod:2973 ../src/guestfs.pod:2973 +msgid "LIBGUESTFS_MEMSIZE" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1117 ../libguestfs-1.11.19/fish/guestfish.pod:1117 ../libguestfs-1.11.19/src/guestfs.pod:2975 ../src/guestfs.pod:2975 +msgid "Set the memory allocated to the qemu process, in megabytes. For example:" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish.pod:1120 ../libguestfs-1.11.19/fish/guestfish.pod:1120 ../libguestfs-1.11.19/src/guestfs.pod:2978 ../src/guestfs.pod:2978 +#, no-wrap +msgid "" +" LIBGUESTFS_MEMSIZE=700\n" +"\n" +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1122 ../libguestfs-1.11.19/fish/guestfish.pod:1122 ../libguestfs-1.11.19/src/guestfs.pod:2980 ../src/guestfs.pod:2980 +msgid "LIBGUESTFS_PATH" +msgstr "" + #. type: textblock -#: ../fish/guestfish.pod:1124 +#: ../fish/guestfish.pod:1124 ../libguestfs-1.11.19/fish/guestfish.pod:1124 msgid "" "Set the path that guestfish uses to search for kernel and initrd.img. See " "the discussion of paths in L<guestfs(3)>." msgstr "" +#. type: =item +#: ../fish/guestfish.pod:1127 ../libguestfs-1.11.19/fish/guestfish.pod:1127 ../libguestfs-1.11.19/src/guestfs.pod:2985 ../src/guestfs.pod:2985 +msgid "LIBGUESTFS_QEMU" +msgstr "" + #. type: textblock -#: ../fish/guestfish.pod:1135 +#: ../fish/guestfish.pod:1129 ../libguestfs-1.11.19/fish/guestfish.pod:1129 ../libguestfs-1.11.19/src/guestfs.pod:2987 ../src/guestfs.pod:2987 +msgid "" +"Set the default qemu binary that libguestfs uses. If not set, then the qemu " +"which was found at compile time by the configure script is used." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1133 ../libguestfs-1.11.19/fish/guestfish.pod:1133 ../libguestfs-1.11.19/src/guestfs.pod:2993 ../src/guestfs.pod:2993 +msgid "LIBGUESTFS_TRACE" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1135 ../libguestfs-1.11.19/fish/guestfish.pod:1135 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1137 +#: ../fish/guestfish.pod:1137 ../libguestfs-1.11.19/fish/guestfish.pod:1137 msgid "PAGER" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1139 +#: ../fish/guestfish.pod:1139 ../libguestfs-1.11.19/fish/guestfish.pod:1139 msgid "" "The C<more> command uses C<$PAGER> as the pager. If not set, it uses " "C<more>." msgstr "" +#. type: =item +#: ../fish/guestfish.pod:1142 ../libguestfs-1.11.19/fish/guestfish.pod:1142 ../libguestfs-1.11.19/src/guestfs.pod:2998 ../src/guestfs.pod:2998 +msgid "TMPDIR" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1144 ../libguestfs-1.11.19/fish/guestfish.pod:1144 ../libguestfs-1.11.19/src/guestfs.pod:3000 ../src/guestfs.pod:3000 +msgid "" +"Location of temporary directory, defaults to C</tmp> except for the cached " +"supermin appliance which defaults to C</var/tmp>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1147 ../libguestfs-1.11.19/fish/guestfish.pod:1147 ../libguestfs-1.11.19/src/guestfs.pod:3003 ../src/guestfs.pod:3003 +msgid "" +"If libguestfs was compiled to use the supermin appliance then the real " +"appliance is cached in this directory, shared between all handles belonging " +"to the same EUID. You can use C<$TMPDIR> to configure another directory to " +"use in case C</var/tmp> is not large enough." +msgstr "" + #. type: =head1 -#: ../fish/guestfish.pod:1155 ../fuse/guestmount.pod:264 +#: ../fish/guestfish.pod:1155 ../fuse/guestmount.pod:288 ../libguestfs-1.11.19/fish/guestfish.pod:1155 ../libguestfs-1.11.19/fuse/guestmount.pod:288 ../libguestfs-1.11.19/rescue/virt-rescue.pod:269 ../rescue/virt-rescue.pod:269 msgid "FILES" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1159 ../fuse/guestmount.pod:268 +#: ../fish/guestfish.pod:1159 ../fuse/guestmount.pod:292 ../libguestfs-1.11.19/fish/guestfish.pod:1159 ../libguestfs-1.11.19/fuse/guestmount.pod:292 ../libguestfs-1.11.19/rescue/virt-rescue.pod:273 ../rescue/virt-rescue.pod:273 msgid "$HOME/.libguestfs-tools.rc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1161 ../fuse/guestmount.pod:270 +#: ../fish/guestfish.pod:1161 ../fuse/guestmount.pod:294 ../libguestfs-1.11.19/fish/guestfish.pod:1161 ../libguestfs-1.11.19/fuse/guestmount.pod:294 ../libguestfs-1.11.19/rescue/virt-rescue.pod:275 ../rescue/virt-rescue.pod:275 msgid "/etc/libguestfs-tools.conf" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1163 ../fuse/guestmount.pod:272 +#: ../fish/guestfish.pod:1163 ../fuse/guestmount.pod:296 ../libguestfs-1.11.19/fish/guestfish.pod:1163 ../libguestfs-1.11.19/fuse/guestmount.pod:296 ../libguestfs-1.11.19/rescue/virt-rescue.pod:277 ../rescue/virt-rescue.pod:277 msgid "" "This configuration file controls the default read-only or read-write mode " "(I<--ro> or I<--rw>)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1166 +#: ../fish/guestfish.pod:1166 ../libguestfs-1.11.19/fish/guestfish.pod:1166 msgid "See L</OPENING DISKS FOR READ AND WRITE>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1168 +#: ../fish/guestfish.pod:1168 ../libguestfs-1.11.19/fish/guestfish.pod:1168 msgid "$HOME/.guestfish" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1170 +#: ../fish/guestfish.pod:1170 ../libguestfs-1.11.19/fish/guestfish.pod:1170 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1173 +#: ../fish/guestfish.pod:1173 ../libguestfs-1.11.19/fish/guestfish.pod:1173 msgid "$HOME/.inputrc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1175 +#: ../fish/guestfish.pod:1175 ../libguestfs-1.11.19/fish/guestfish.pod:1175 msgid "/etc/inputrc" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1177 +#: ../fish/guestfish.pod:1177 ../libguestfs-1.11.19/fish/guestfish.pod:1177 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -22132,12 +17928,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1181 +#: ../fish/guestfish.pod:1181 ../libguestfs-1.11.19/fish/guestfish.pod:1181 msgid "To write rules which only apply to guestfish, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1183 +#: ../fish/guestfish.pod:1183 ../libguestfs-1.11.19/fish/guestfish.pod:1183 #, no-wrap msgid "" " $if guestfish\n" @@ -22147,26 +17943,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1187 +#: ../fish/guestfish.pod:1187 ../libguestfs-1.11.19/fish/guestfish.pod:1187 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1192 +#: ../fish/guestfish.pod:1192 ../libguestfs-1.11.19/fish/guestfish.pod:1192 msgid "completion-ignore-case (default: on)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1194 +#: ../fish/guestfish.pod:1194 ../libguestfs-1.11.19/fish/guestfish.pod:1194 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1197 +#: ../fish/guestfish.pod:1197 ../libguestfs-1.11.19/fish/guestfish.pod:1197 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -22174,22 +17970,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1199 +#: ../fish/guestfish.pod:1199 ../libguestfs-1.11.19/fish/guestfish.pod:1199 msgid "to make guestfish case sensitive." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1203 +#: ../fish/guestfish.pod:1203 ../libguestfs-1.11.19/fish/guestfish.pod:1203 msgid "test1.img" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1205 +#: ../fish/guestfish.pod:1205 ../libguestfs-1.11.19/fish/guestfish.pod:1205 msgid "test2.img (etc)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1207 +#: ../fish/guestfish.pod:1207 ../libguestfs-1.11.19/fish/guestfish.pod:1207 msgid "" "When using the I<-N> or I<--new> option, the prepared disk or filesystem " "will be created in the file C<test1.img> in the current directory. The " @@ -22198,7 +17994,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1216 +#: ../fish/guestfish.pod:1216 ../libguestfs-1.11.19/fish/guestfish.pod:1216 msgid "" "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, " "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, " @@ -22209,8379 +18005,17771 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1247 ../test-tool/libguestfs-test-tool.pod:102 ../fuse/guestmount.pod:299 ../tools/virt-win-reg.pl:778 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277 +#: ../fish/guestfish.pod:1244 ../libguestfs-1.11.19/fish/guestfish.pod:1244 ../libguestfs-1.11.19/src/guestfs.pod:3086 ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:99 ../src/guestfs.pod:3086 ../test-tool/libguestfs-test-tool.pod:99 +msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:5 ../libguestfs-1.11.19/fish/virt-copy-in.pod:5 +msgid "virt-copy-in - Copy files and directories into a virtual machine disk image." +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-in.pod:9 ../libguestfs-1.11.19/fish/virt-copy-in.pod:9 +#, no-wrap msgid "" -"This program is free software; you can redistribute it and/or modify it " -"under the terms of the GNU General Public License as published by the Free " -"Software Foundation; either version 2 of the License, or (at your option) " -"any later version." +" virt-copy-in -a disk.img file|dir [file|dir ...] /destination\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-in.pod:11 ../libguestfs-1.11.19/fish/virt-copy-in.pod:11 +#, no-wrap +msgid "" +" virt-copy-in -d domain file|dir [file|dir ...] /destination\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1252 ../test-tool/libguestfs-test-tool.pod:107 ../fuse/guestmount.pod:304 ../tools/virt-win-reg.pl:783 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282 +#: ../fish/virt-copy-in.pod:15 ../libguestfs-1.11.19/fish/virt-copy-in.pod:15 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." +"Using C<virt-copy-in> on live virtual machines can be dangerous, potentially " +"causing disk corruption. The virtual machine must be shut down before you " +"use this command." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1257 ../test-tool/libguestfs-test-tool.pod:112 ../fuse/guestmount.pod:309 ../tools/virt-win-reg.pl:788 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287 +#: ../fish/virt-copy-in.pod:21 ../libguestfs-1.11.19/fish/virt-copy-in.pod:21 msgid "" -"You should have received a copy of the GNU General Public License along with " -"this program; if not, write to the Free Software Foundation, Inc., 675 Mass " -"Ave, Cambridge, MA 02139, USA." +"C<virt-copy-in> copies files and directories from the local disk into a " +"virtual machine disk image or named libvirt domain." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:24 ../libguestfs-1.11.19/fish/virt-copy-in.pod:24 +msgid "" +"You can give one of more filenames and directories on the command line. " +"Directories are copied in recursively. The final parameter must be the " +"destination directory in the disk image which must be an absolute path " +"starting with a C</> character." +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-in.pod:33 ../libguestfs-1.11.19/fish/virt-copy-in.pod:33 +#, no-wrap +msgid "" +" virt-copy-in -d MyGuest resolv.conf /etc\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:35 ../fish/virt-tar-in.pod:32 ../libguestfs-1.11.19/fish/virt-copy-in.pod:35 ../libguestfs-1.11.19/fish/virt-tar-in.pod:32 +msgid "Upload a home directory to a guest:" +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-in.pod:37 ../libguestfs-1.11.19/fish/virt-copy-in.pod:37 +#, no-wrap +msgid "" +" virt-copy-in -d MyGuest skel /home\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../fish/virt-copy-in.pod:39 ../fish/virt-copy-out.pod:28 ../fish/virt-tar-in.pod:36 ../fish/virt-tar-out.pod:30 ../libguestfs-1.11.19/fish/virt-copy-in.pod:39 ../libguestfs-1.11.19/fish/virt-copy-out.pod:28 ../libguestfs-1.11.19/fish/virt-tar-in.pod:36 ../libguestfs-1.11.19/fish/virt-tar-out.pod:30 +msgid "JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:41 ../libguestfs-1.11.19/fish/virt-copy-in.pod:41 +msgid "" +"This command is just a simple shell script wrapper around the " +"L<guestfish(1)> C<copy-in> command. For anything more complex than a " +"trivial copy, you are probably better off using guestfish directly." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:47 ../fish/virt-copy-out.pod:36 ../fish/virt-tar-in.pod:44 ../fish/virt-tar-out.pod:38 ../libguestfs-1.11.19/fish/virt-copy-in.pod:47 ../libguestfs-1.11.19/fish/virt-copy-out.pod:36 ../libguestfs-1.11.19/fish/virt-tar-in.pod:44 ../libguestfs-1.11.19/fish/virt-tar-out.pod:38 +msgid "" +"Since the shell script just passes options straight to guestfish, read " +"L<guestfish(1)> to see the full list of options." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:52 ../libguestfs-1.11.19/fish/virt-copy-in.pod:52 +msgid "" +"L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, " +"L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-in.pod:66 ../fish/virt-copy-out.pod:55 ../fish/virt-tar-in.pod:64 ../fish/virt-tar-out.pod:57 ../libguestfs-1.11.19/fish/virt-copy-in.pod:66 ../libguestfs-1.11.19/fish/virt-copy-out.pod:55 ../libguestfs-1.11.19/fish/virt-tar-in.pod:64 ../libguestfs-1.11.19/fish/virt-tar-out.pod:57 +msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:5 ../libguestfs-1.11.19/fish/virt-copy-out.pod:5 +msgid "" +"virt-copy-out - Copy files and directories out of a virtual machine disk " +"image." +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-out.pod:9 ../libguestfs-1.11.19/fish/virt-copy-out.pod:9 +#, no-wrap +msgid "" +" virt-copy-out -a disk.img /file|dir [/file|dir ...] localdir\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-out.pod:11 ../libguestfs-1.11.19/fish/virt-copy-out.pod:11 +#, no-wrap +msgid "" +" virt-copy-out -d domain /file|dir [/file|dir ...] localdir\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:15 ../libguestfs-1.11.19/fish/virt-copy-out.pod:15 +msgid "" +"C<virt-copy-out> copies files and directories out of a virtual machine disk " +"image or named libvirt domain." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:18 ../libguestfs-1.11.19/fish/virt-copy-out.pod:18 +msgid "" +"You can give one of more filenames and directories on the command line. " +"Directories are copied out recursively." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:23 ../libguestfs-1.11.19/fish/virt-copy-out.pod:23 +msgid "Download the home directories from a virtual machine:" +msgstr "" + +#. type: verbatim +#: ../fish/virt-copy-out.pod:25 ../libguestfs-1.11.19/fish/virt-copy-out.pod:25 +#, no-wrap +msgid "" +" mkdir homes\n" +" virt-copy-out -d MyGuest /home homes\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:30 ../libguestfs-1.11.19/fish/virt-copy-out.pod:30 +msgid "" +"This command is just a simple shell script wrapper around the " +"L<guestfish(1)> C<copy-out> command. For anything more complex than a " +"trivial copy, you are probably better off using guestfish directly." +msgstr "" + +#. type: textblock +#: ../fish/virt-copy-out.pod:41 ../libguestfs-1.11.19/fish/virt-copy-out.pod:41 +msgid "" +"L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-edit(1)>, " +"L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:5 ../libguestfs-1.11.19/fish/virt-tar-in.pod:5 +msgid "virt-tar-in - Unpack a tarball into a virtual machine disk image." +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-in.pod:9 ../libguestfs-1.11.19/fish/virt-tar-in.pod:9 +#, no-wrap +msgid "" +" virt-tar-in -a disk.img data.tar /destination\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-in.pod:11 ../libguestfs-1.11.19/fish/virt-tar-in.pod:11 +#, no-wrap +msgid "" +" virt-tar-in -d domain data.tar /destination\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-in.pod:13 ../libguestfs-1.11.19/fish/virt-tar-in.pod:13 +#, no-wrap +msgid "" +" zcat data.tar.gz | virt-tar-in -d domain - /destination\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:17 ../libguestfs-1.11.19/fish/virt-tar-in.pod:17 +msgid "" +"Using C<virt-tar-in> on live virtual machines can be dangerous, potentially " +"causing disk corruption. The virtual machine must be shut down before you " +"use this command." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:23 ../libguestfs-1.11.19/fish/virt-tar-in.pod:23 +msgid "" +"C<virt-tar-in> unpacks an uncompressed tarball into a virtual machine disk " +"image or named libvirt domain." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:26 ../libguestfs-1.11.19/fish/virt-tar-in.pod:26 +msgid "" +"The first parameter is the tar file. Use C<-> to read the tar file from " +"standard input. The second parameter is the absolute target directory to " +"unpack into." +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-in.pod:34 ../libguestfs-1.11.19/fish/virt-tar-in.pod:34 +#, no-wrap +msgid "" +" virt-tar-in -d MyGuest homes.tar /home\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:38 ../libguestfs-1.11.19/fish/virt-tar-in.pod:38 +msgid "" +"This command is just a simple shell script wrapper around the " +"L<guestfish(1)> C<tar-in> command. For anything more complex than a trivial " +"copy, you are probably better off using guestfish directly." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-in.pod:49 ../libguestfs-1.11.19/fish/virt-tar-in.pod:49 +msgid "" +"L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, " +"L<virt-edit(1)>, L<virt-make-fs(1)>, L<virt-tar-out(1)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:5 ../libguestfs-1.11.19/fish/virt-tar-out.pod:5 +msgid "virt-tar-out - Pack a virtual machine disk image directory into a tarball." +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-out.pod:9 ../libguestfs-1.11.19/fish/virt-tar-out.pod:9 +#, no-wrap +msgid "" +" virt-tar-out -a disk.img /dir files.tar\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-out.pod:11 ../libguestfs-1.11.19/fish/virt-tar-out.pod:11 +#, no-wrap +msgid "" +" virt-tar-out -d domain /dir files.tar\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-out.pod:13 ../libguestfs-1.11.19/fish/virt-tar-out.pod:13 +#, no-wrap +msgid "" +" virt-tar-out -d domain /dir - | gzip --best > files.tar.gz\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:17 ../libguestfs-1.11.19/fish/virt-tar-out.pod:17 +msgid "C<virt-tar-out> packs a virtual machine disk image directory into a tarball." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:20 ../libguestfs-1.11.19/fish/virt-tar-out.pod:20 +msgid "" +"The first parameter is the absolute path of the virtual machine directory. " +"The second parameter is the tar file to write. Use C<-> to write to " +"standard output." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:26 ../libguestfs-1.11.19/fish/virt-tar-out.pod:26 +msgid "Download the home directories from a guest:" +msgstr "" + +#. type: verbatim +#: ../fish/virt-tar-out.pod:28 ../libguestfs-1.11.19/fish/virt-tar-out.pod:28 +#, no-wrap +msgid "" +" virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:32 ../libguestfs-1.11.19/fish/virt-tar-out.pod:32 +msgid "" +"This command is just a simple shell script wrapper around the " +"L<guestfish(1)> C<tar-out> command. For anything more complex than a " +"trivial copy, you are probably better off using guestfish directly." +msgstr "" + +#. type: textblock +#: ../fish/virt-tar-out.pod:43 ../libguestfs-1.11.19/fish/virt-tar-out.pod:43 +msgid "" +"L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, " +"L<virt-edit(1)>, L<virt-tar-in(1)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:5 ../libguestfs-1.11.19/fuse/guestmount.pod:5 +msgid "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:9 ../libguestfs-1.11.19/fuse/guestmount.pod:9 +#, no-wrap +msgid "" +" guestmount [--options] -a disk.img -m device [--ro] mountpoint\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:11 ../libguestfs-1.11.19/fuse/guestmount.pod:11 +#, no-wrap +msgid "" +" guestmount [--options] -a disk.img -i [--ro] mountpoint\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:13 ../libguestfs-1.11.19/fuse/guestmount.pod:13 +#, no-wrap +msgid "" +" guestmount [--options] -d Guest -i [--ro] mountpoint\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:17 ../libguestfs-1.11.19/fuse/guestmount.pod:17 +msgid "" +"You must I<not> use C<guestmount> in read-write mode on live virtual " +"machines. If you do this, you risk disk corruption in the VM." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:22 ../libguestfs-1.11.19/fuse/guestmount.pod:22 +msgid "" +"The guestmount program can be used to mount virtual machine filesystems and " +"other disk images on the host. It uses libguestfs for access to the guest " +"filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as " +"a mountable device." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:27 ../libguestfs-1.11.19/fuse/guestmount.pod:27 +msgid "" +"Along with other options, you have to give at least one device (I<-a> " +"option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> " +"option) or use the I<-i> inspection option. How this works is better " +"explained in the L<guestfish(1)> manual page, or by looking at the examples " +"below." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:33 ../libguestfs-1.11.19/fuse/guestmount.pod:33 +msgid "" +"FUSE lets you mount filesystems as non-root. The mountpoint must be owned " +"by you, and the filesystem will not be visible to any other users unless you " +"make certain global configuration changes to C</etc/fuse.conf>. To unmount " +"the filesystem, use the C<fusermount -u> command." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:41 ../libguestfs-1.11.19/fuse/guestmount.pod:41 +msgid "" +"For a typical Windows guest which has its main filesystem on the first " +"partition:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:44 ../libguestfs-1.11.19/fuse/guestmount.pod:44 +#, no-wrap +msgid "" +" guestmount -a windows.img -m /dev/sda1 --ro /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:46 ../libguestfs-1.11.19/fuse/guestmount.pod:46 +msgid "" +"For a typical Linux guest which has a /boot filesystem on the first " +"partition, and the root filesystem on a logical volume:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:49 ../libguestfs-1.11.19/fuse/guestmount.pod:49 +#, no-wrap +msgid "" +" guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:51 ../libguestfs-1.11.19/fuse/guestmount.pod:51 +msgid "To get libguestfs to detect guest mountpoints for you:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:53 ../libguestfs-1.11.19/fuse/guestmount.pod:53 +#, no-wrap +msgid "" +" guestmount -a guest.img -i --ro /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:55 ../libguestfs-1.11.19/fuse/guestmount.pod:55 +msgid "For a libvirt guest called \"Guest\" you could do:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:57 ../libguestfs-1.11.19/fuse/guestmount.pod:57 +#, no-wrap +msgid "" +" guestmount -d Guest -i --ro /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:59 ../libguestfs-1.11.19/fuse/guestmount.pod:59 +msgid "" +"If you don't know what filesystems are contained in a guest or disk image, " +"use L<virt-filesystems(1)> first:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:62 ../libguestfs-1.11.19/fuse/guestmount.pod:62 +#, no-wrap +msgid "" +" virt-filesystems MyGuest\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:64 ../libguestfs-1.11.19/fuse/guestmount.pod:64 +msgid "" +"If you want to trace the libguestfs calls but without excessive debugging " +"information, we recommend:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:67 ../libguestfs-1.11.19/fuse/guestmount.pod:67 +#, no-wrap +msgid "" +" guestmount [...] --trace /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:69 ../libguestfs-1.11.19/fuse/guestmount.pod:69 +msgid "If you want to debug the program, we recommend:" +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:71 ../libguestfs-1.11.19/fuse/guestmount.pod:71 +#, no-wrap +msgid "" +" guestmount [...] --trace --verbose /mnt\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../fuse/guestmount.pod:73 ../libguestfs-1.11.19/fuse/guestmount.pod:73 ../libguestfs-1.11.19/rescue/virt-rescue.pod:68 ../libguestfs-1.11.19/resize/virt-resize.pod:486 ../rescue/virt-rescue.pod:68 ../resize/virt-resize.pod:486 +msgid "NOTES" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1 -msgid "add-cdrom" +#: ../fuse/guestmount.pod:75 ../libguestfs-1.11.19/fuse/guestmount.pod:75 +msgid "Other users cannot see the filesystem by default" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:77 ../libguestfs-1.11.19/fuse/guestmount.pod:77 +msgid "" +"If you mount a filesystem as one user (eg. root), then other users will not " +"be able to see it by default. The fix is to add the FUSE C<allow_other> " +"option when mounting:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3 +#: ../fuse/guestmount.pod:81 ../libguestfs-1.11.19/fuse/guestmount.pod:81 #, no-wrap msgid "" -" add-cdrom filename\n" +" sudo guestmount [...] -o allow_other /mnt\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:91 ../libguestfs-1.11.19/fuse/guestmount.pod:91 +msgid "Add a block device or virtual machine image." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:114 ../libguestfs-1.11.19/fuse/guestmount.pod:114 +msgid "B<--dir-cache-timeout N>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:116 ../libguestfs-1.11.19/fuse/guestmount.pod:116 +msgid "" +"Set the readdir cache timeout to I<N> seconds, the default being 60 " +"seconds. The readdir cache [actually, there are several semi-independent " +"caches] is populated after a readdir(2) call with the stat and extended " +"attributes of the files in the directory, in anticipation that they will be " +"requested soon after." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:122 ../libguestfs-1.11.19/fuse/guestmount.pod:122 +msgid "" +"There is also a different attribute cache implemented by FUSE (see the FUSE " +"option I<-o attr_timeout>), but the FUSE cache does not anticipate future " +"requests, only cache existing ones." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:142 ../libguestfs-1.11.19/fuse/guestmount.pod:142 +msgid "" +"If you have untrusted raw-format guest disk images, you should use this " +"option to specify the disk format. This avoids a possible security problem " +"with malicious guests (CVE-2010-3851). See also " +"L<guestfs(3)/guestfs_add_drive_opts>." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:147 ../libguestfs-1.11.19/fuse/guestmount.pod:147 +msgid "B<--fuse-help>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:149 ../libguestfs-1.11.19/fuse/guestmount.pod:149 +msgid "Display help on special FUSE options (see I<-o> below)." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:153 ../libguestfs-1.11.19/fuse/guestmount.pod:153 +msgid "Display brief help and exit." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:177 ../libguestfs-1.11.19/fuse/guestmount.pod:177 +msgid "" +"Mount the named partition or logical volume on the given mountpoint B<in the " +"guest> (this has nothing to do with mountpoints in the host)." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:180 ../libguestfs-1.11.19/fuse/guestmount.pod:180 +msgid "" +"If the mountpoint is omitted, it defaults to C</>. You have to mount " +"something on C</>." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:197 ../libguestfs-1.11.19/fuse/guestmount.pod:197 +msgid "" +"By default, we attempt to sync the guest disk when the FUSE mountpoint is " +"unmounted. If you specify this option, then we don't attempt to sync the " +"disk. See the discussion of autosync in the L<guestfs(3)> manpage." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:202 ../libguestfs-1.11.19/fuse/guestmount.pod:202 +msgid "B<-o option>" +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:204 ../libguestfs-1.11.19/fuse/guestmount.pod:204 +msgid "B<--option option>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:206 ../libguestfs-1.11.19/fuse/guestmount.pod:206 +msgid "Pass extra options to FUSE." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:208 ../libguestfs-1.11.19/fuse/guestmount.pod:208 +msgid "" +"To get a list of all the extra options supported by FUSE, use the command " +"below. Note that only the FUSE I<-o> options can be passed, and only some " +"of them are a good idea." +msgstr "" + +#. type: verbatim +#: ../fuse/guestmount.pod:212 ../libguestfs-1.11.19/fuse/guestmount.pod:212 +#, no-wrap +msgid "" +" guestmount --fuse-help\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:214 ../libguestfs-1.11.19/fuse/guestmount.pod:214 +msgid "Some potentially useful FUSE options:" +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:218 ../libguestfs-1.11.19/fuse/guestmount.pod:218 +msgid "B<-o allow_other>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:220 ../libguestfs-1.11.19/fuse/guestmount.pod:220 +msgid "Allow other users to see the filesystem." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:222 ../libguestfs-1.11.19/fuse/guestmount.pod:222 +msgid "B<-o attr_timeout=N>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:224 ../libguestfs-1.11.19/fuse/guestmount.pod:224 +msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:226 ../libguestfs-1.11.19/fuse/guestmount.pod:226 +msgid "B<-o kernel_cache>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:228 ../libguestfs-1.11.19/fuse/guestmount.pod:228 +msgid "" +"Allow the kernel to cache files (reduces the number of reads that have to go " +"through the L<guestfs(3)> API). This is generally a good idea if you can " +"afford the extra memory usage." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:232 ../libguestfs-1.11.19/fuse/guestmount.pod:232 +msgid "B<-o uid=N> B<-o gid=N>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:234 ../libguestfs-1.11.19/fuse/guestmount.pod:234 +msgid "" +"Use these options to map all UIDs and GIDs inside the guest filesystem to " +"the chosen values." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:243 ../libguestfs-1.11.19/fuse/guestmount.pod:243 +msgid "" +"Add devices and mount everything read-only. Also disallow writes and make " +"the disk appear read-only to FUSE." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:246 ../libguestfs-1.11.19/fuse/guestmount.pod:246 +msgid "" +"This is highly recommended if you are not going to edit the guest disk. If " +"the guest is running and this option is I<not> supplied, then there is a " +"strong risk of disk corruption in the guest. We try to prevent this from " +"happening, but it is not always possible." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:251 ../libguestfs-1.11.19/fuse/guestmount.pod:251 ../libguestfs-1.11.19/rescue/virt-rescue.pod:171 ../rescue/virt-rescue.pod:171 +msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:255 ../libguestfs-1.11.19/fuse/guestmount.pod:255 +msgid "Enable SELinux support for the guest." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:261 ../libguestfs-1.11.19/fuse/guestmount.pod:261 +msgid "Enable verbose messages from underlying libguestfs." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:267 ../libguestfs-1.11.19/fuse/guestmount.pod:267 +msgid "Display the program version and exit." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:276 ../fuse/guestmount.pod:299 ../libguestfs-1.11.19/fuse/guestmount.pod:276 ../libguestfs-1.11.19/fuse/guestmount.pod:299 ../libguestfs-1.11.19/rescue/virt-rescue.pod:197 ../libguestfs-1.11.19/rescue/virt-rescue.pod:280 ../rescue/virt-rescue.pod:197 ../rescue/virt-rescue.pod:280 +msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>." +msgstr "" + +#. type: =item +#: ../fuse/guestmount.pod:280 ../libguestfs-1.11.19/fuse/guestmount.pod:280 +msgid "B<--trace>" +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:282 ../libguestfs-1.11.19/fuse/guestmount.pod:282 +msgid "Trace libguestfs calls and entry into each FUSE function." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:284 ../libguestfs-1.11.19/fuse/guestmount.pod:284 +msgid "This also stops the daemon from forking into the background." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:305 ../libguestfs-1.11.19/fuse/guestmount.pod:305 +msgid "" +"L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " +"L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, " +"L<http://fuse.sf.net/>." +msgstr "" + +#. type: textblock +#: ../fuse/guestmount.pod:320 ../libguestfs-1.11.19/fuse/guestmount.pod:320 +msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:5 ../libguestfs-1.11.19/inspector/virt-inspector.pod:5 +msgid "" +"virt-inspector - Display operating system version and other information " +"about a virtual machine" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:9 ../libguestfs-1.11.19/inspector/virt-inspector.pod:9 +#, no-wrap +msgid "" +" virt-inspector [--options] -d domname\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:11 ../libguestfs-1.11.19/inspector/virt-inspector.pod:11 +#, no-wrap +msgid "" +" virt-inspector [--options] -a disk.img [-a disk.img ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:15 ../libguestfs-1.11.19/inspector/virt-inspector.pod:15 +#, no-wrap +msgid "" +" virt-inspector domname\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:17 ../inspector/virt-inspector.pod:141 ../libguestfs-1.11.19/inspector/virt-inspector.pod:17 ../libguestfs-1.11.19/inspector/virt-inspector.pod:141 +#, no-wrap +msgid "" +" virt-inspector disk.img [disk.img ...]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:21 ../libguestfs-1.11.19/inspector/virt-inspector.pod:21 +msgid "" +"B<virt-inspector> examines a virtual machine or disk image and tries to " +"determine the version of the operating system and other information about " +"the virtual machine." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:25 ../libguestfs-1.11.19/inspector/virt-inspector.pod:25 +msgid "Virt-inspector produces XML output for feeding into other programs." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:27 ../libguestfs-1.11.19/inspector/virt-inspector.pod:27 +msgid "" +"In the normal usage, use C<virt-inspector -d domname> where C<domname> is " +"the libvirt domain (see: C<virsh list --all>)." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:30 ../libguestfs-1.11.19/inspector/virt-inspector.pod:30 +msgid "" +"You can also run virt-inspector directly on disk images from a single " +"virtual machine. Use C<virt-inspector -a disk.img>. In rare cases a domain " +"has several block devices, in which case you should list several I<-a> " +"options one after another, with the first corresponding to the guest's " +"C</dev/sda>, the second to the guest's C</dev/sdb> and so on." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:37 ../libguestfs-1.11.19/inspector/virt-inspector.pod:37 +msgid "" +"You can also run virt-inspector on install disks, live CDs, bootable USB " +"keys and similar." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:40 ../libguestfs-1.11.19/inspector/virt-inspector.pod:40 +msgid "" +"Virt-inspector can only inspect and report upon I<one domain at a time>. To " +"inspect several virtual machines, you have to run virt-inspector several " +"times (for example, from a shell script for-loop)." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:45 ../libguestfs-1.11.19/inspector/virt-inspector.pod:45 +msgid "" +"Because virt-inspector needs direct access to guest images, it won't " +"normally work over remote libvirt connections." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:48 ../libguestfs-1.11.19/inspector/virt-inspector.pod:48 +msgid "" +"All of the information available from virt-inspector is also available " +"through the core libguestfs inspection API (see L<guestfs(3)/INSPECTION>). " +"The same information can also be fetched using guestfish or via libguestfs " +"bindings in many programming languages (see L<guestfs(3)/USING LIBGUESTFS " +"WITH OTHER PROGRAMMING LANGUAGES>)." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:81 ../libguestfs-1.11.19/inspector/virt-inspector.pod:81 +msgid "" +"Libvirt is only used if you specify a C<domname> on the command line. If " +"you specify guest block devices directly (I<-a>), then libvirt is not used " +"at all." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:94 ../libguestfs-1.11.19/inspector/virt-inspector.pod:94 +msgid "" +"When prompting for keys and passphrases, virt-inspector normally turns " +"echoing off so you cannot see what you are typing. If you are not worried " +"about Tempest attacks and there is no one else in the room you can specify " +"this flag to see what you are typing." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:103 ../libguestfs-1.11.19/inspector/virt-inspector.pod:103 ../tools/virt-list-filesystems.pl:93 ../tools/virt-list-partitions.pl:94 ../tools/virt-tar.pl:143 ../tools/virt-win-reg.pl:144 +msgid "" +"Specify the format of disk images given on the command line. If this is " +"omitted then the format is autodetected from the content of the disk image." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:107 ../libguestfs-1.11.19/inspector/virt-inspector.pod:107 ../tools/virt-list-filesystems.pl:97 ../tools/virt-list-partitions.pl:98 ../tools/virt-tar.pl:147 ../tools/virt-win-reg.pl:148 +msgid "" +"If disk images are requested from libvirt, then this program asks libvirt " +"for this information. In this case, the value of the format parameter is " +"ignored." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:111 ../libguestfs-1.11.19/inspector/virt-inspector.pod:111 ../libguestfs-1.11.19/resize/virt-resize.pod:314 ../libguestfs-1.11.19/resize/virt-resize.pod:400 ../resize/virt-resize.pod:314 ../resize/virt-resize.pod:400 ../tools/virt-list-filesystems.pl:101 ../tools/virt-list-partitions.pl:102 ../tools/virt-tar.pl:151 ../tools/virt-win-reg.pl:152 +msgid "" +"If working with untrusted raw-format guest disk images, you should ensure " +"the format is always specified." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:139 ../libguestfs-1.11.19/inspector/virt-inspector.pod:139 +msgid "Previous versions of virt-inspector allowed you to write either:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:145 ../libguestfs-1.11.19/inspector/virt-inspector.pod:145 +#, no-wrap +msgid "" +" virt-inspector guestname\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../inspector/virt-inspector.pod:153 ../libguestfs-1.11.19/inspector/virt-inspector.pod:153 +msgid "XML FORMAT" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:155 ../libguestfs-1.11.19/inspector/virt-inspector.pod:155 +msgid "" +"The virt-inspector XML is described precisely in a RELAX NG schema file " +"C<virt-inspector.rng> which is supplied with libguestfs. This section is " +"just an overview." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:159 ../libguestfs-1.11.19/inspector/virt-inspector.pod:159 +msgid "" +"The top-level element is E<lt>operatingsystemsE<gt>, and it contains one or " +"more E<lt>operatingsystemE<gt> elements. You would only see more than one " +"E<lt>operatingsystemE<gt> element if the virtual machine is multi-boot, " +"which is vanishingly rare in real world VMs." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:164 ../libguestfs-1.11.19/inspector/virt-inspector.pod:164 +msgid "E<lt>operatingsystemE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:166 ../libguestfs-1.11.19/inspector/virt-inspector.pod:166 +msgid "" +"In the E<lt>operatingsystemE<gt> tag are various optional fields that " +"describe the operating system, its architecture, the descriptive \"product " +"name\" string, the type of OS and so on, as in this example:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:170 ../libguestfs-1.11.19/inspector/virt-inspector.pod:170 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" <root>/dev/sda2</root>\n" +" <name>windows</name>\n" +" <arch>i386</arch>\n" +" <distro>windows</distro>\n" +" <product_name>Windows 7 Enterprise</product_name>\n" +" <product_variant>Client</product_variant>\n" +" <major_version>6</major_version>\n" +" <minor_version>1</minor_version>\n" +" <windows_systemroot>/Windows</windows_systemroot>\n" +" <format>installed</format>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:183 ../libguestfs-1.11.19/inspector/virt-inspector.pod:183 +msgid "" +"In brief, E<lt>nameE<gt> is the class of operating system (something like " +"C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> " +"but many other distros are recognized) and E<lt>archE<gt> is the guest " +"architecture. The other fields are fairly self-explanatory, but because " +"these fields are taken directly from the libguestfs inspection API you can " +"find precise information from L<guestfs(3)/INSPECTION>." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:191 ../libguestfs-1.11.19/inspector/virt-inspector.pod:191 +msgid "" +"The E<lt>rootE<gt> element is the root filesystem device, but from the point " +"of view of libguestfs (block devices may have completely different names " +"inside the VM itself)." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:195 ../libguestfs-1.11.19/inspector/virt-inspector.pod:195 +msgid "E<lt>mountpointsE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:197 ../libguestfs-1.11.19/inspector/virt-inspector.pod:197 +msgid "" +"Un*x-like guests typically have multiple filesystems which are mounted at " +"various mountpoints, and these are described in the E<lt>mountpointsE<gt> " +"element which looks like this:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:201 ../libguestfs-1.11.19/inspector/virt-inspector.pod:201 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" ...\n" +" <mountpoints>\n" +" <mountpoint dev=\"/dev/vg_f13x64/lv_root\">/</mountpoint>\n" +" <mountpoint dev=\"/dev/sda1\">/boot</mountpoint>\n" +" </mountpoints>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:209 ../libguestfs-1.11.19/inspector/virt-inspector.pod:209 +msgid "" +"As with E<lt>rootE<gt>, devices are from the point of view of libguestfs, " +"and may have completely different names inside the guest. Only mountable " +"filesystems appear in this list, not things like swap devices." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:214 ../libguestfs-1.11.19/inspector/virt-inspector.pod:214 +msgid "E<lt>filesystemsE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:216 ../libguestfs-1.11.19/inspector/virt-inspector.pod:216 +msgid "" +"E<lt>filesystemsE<gt> is like E<lt>mountpointsE<gt> but covers I<all> " +"filesystems belonging to the guest, including swap and empty partitions. " +"(In the rare case of a multi-boot guest, it covers filesystems belonging to " +"this OS or shared with this OS and other OSes)." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:222 ../libguestfs-1.11.19/inspector/virt-inspector.pod:222 +msgid "You might see something like this:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:224 ../libguestfs-1.11.19/inspector/virt-inspector.pod:224 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" ...\n" +" <filesystems>\n" +" <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n" +" <type>ext4</type>\n" +" <label>Fedora-13-x86_64</label>\n" +" <uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>\n" +" </filesystem>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:234 ../libguestfs-1.11.19/inspector/virt-inspector.pod:234 +msgid "" +"The optional elements within E<lt>filesystemE<gt> are the filesystem type, " +"the label, and the UUID." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:237 ../libguestfs-1.11.19/inspector/virt-inspector.pod:237 +msgid "E<lt>applicationsE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:239 ../libguestfs-1.11.19/inspector/virt-inspector.pod:239 +msgid "" +"The related elements E<lt>package_formatE<gt>, E<lt>package_managementE<gt> " +"and E<lt>applicationsE<gt> describe applications installed in the virtual " +"machine." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:243 ../libguestfs-1.11.19/inspector/virt-inspector.pod:243 +msgid "" +"E<lt>package_formatE<gt>, if present, describes the packaging system used. " +"Typical values would be C<rpm> and C<deb>." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:246 ../libguestfs-1.11.19/inspector/virt-inspector.pod:246 +msgid "" +"E<lt>package_managementE<gt>, if present, describes the package manager. " +"Typical values include C<yum>, C<up2date> and C<apt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:249 ../libguestfs-1.11.19/inspector/virt-inspector.pod:249 +msgid "E<lt>applicationsE<gt> lists the packages or applications installed." +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:252 ../libguestfs-1.11.19/inspector/virt-inspector.pod:252 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" ...\n" +" <applications>\n" +" <application>\n" +" <name>coreutils</name>\n" +" <version>8.5</version>\n" +" <release>1</release>\n" +" </application>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:262 ../libguestfs-1.11.19/inspector/virt-inspector.pod:262 +msgid "" +"The version and release fields may not be available for some types guests. " +"Other fields are possible, see " +"L<guestfs(3)/guestfs_inspect_list_applications>." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:266 ../libguestfs-1.11.19/inspector/virt-inspector.pod:266 +msgid "E<lt>drive_mappingsE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:268 ../libguestfs-1.11.19/inspector/virt-inspector.pod:268 +msgid "" +"For operating systems like Windows which use drive letters, virt-inspector " +"is able to find out how drive letters map to filesystems." +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:272 ../libguestfs-1.11.19/inspector/virt-inspector.pod:272 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" ...\n" +" <drive_mappings>\n" +" <drive_mapping name=\"C\">/dev/sda2</drive_mapping>\n" +" <drive_mapping name=\"E\">/dev/sdb1</drive_mapping>\n" +" </drive_mappings>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:280 ../libguestfs-1.11.19/inspector/virt-inspector.pod:280 +msgid "" +"In the example above, drive C maps to the filesystem on the second partition " +"on the first disk, and drive E maps to the filesystem on the first partition " +"on the second disk." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:284 ../libguestfs-1.11.19/inspector/virt-inspector.pod:284 +msgid "" +"Note that this only covers permanent local filesystem mappings, not things " +"like network shares. Furthermore NTFS volume mount points may not be listed " +"here." +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:288 ../libguestfs-1.11.19/inspector/virt-inspector.pod:288 +msgid "E<lt>iconE<gt>" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:290 ../libguestfs-1.11.19/inspector/virt-inspector.pod:290 +msgid "" +"Virt-inspector is sometimes able to extract an icon or logo for the guest. " +"The icon is returned as base64-encoded PNG data. Note that the icon can be " +"very large and high quality." +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:294 ../libguestfs-1.11.19/inspector/virt-inspector.pod:294 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" ...\n" +" <icon>\n" +" iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n" +" [... many lines of base64 data ...]\n" +" </icon>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:302 ../libguestfs-1.11.19/inspector/virt-inspector.pod:302 +msgid "" +"To display the icon, you have to extract it and convert the base64 data back " +"to a binary file. Use an XPath query or simply an editor to extract the " +"data, then use the coreutils L<base64(1)> program to do the conversion back " +"to a PNG file:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:307 ../libguestfs-1.11.19/inspector/virt-inspector.pod:307 +#, no-wrap +msgid "" +" base64 -i -d < icon.data > icon.png\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../inspector/virt-inspector.pod:309 ../libguestfs-1.11.19/inspector/virt-inspector.pod:309 +msgid "INSPECTING INSTALL DISKS, LIVE CDs" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:311 ../libguestfs-1.11.19/inspector/virt-inspector.pod:311 +msgid "" +"Virt-inspector can detect some operating system installers on install disks, " +"live CDs, bootable USB keys and more." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:314 ../libguestfs-1.11.19/inspector/virt-inspector.pod:314 +msgid "" +"In this case the E<lt>formatE<gt> tag will contain C<installer> and other " +"fields may be present to indicate a live CD, network installer, or one part " +"of a multipart CD. For example:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:318 ../libguestfs-1.11.19/inspector/virt-inspector.pod:318 +#, no-wrap +msgid "" +" <operatingsystems>\n" +" <operatingsystem>\n" +" <root>/dev/sda</root>\n" +" <name>linux</name>\n" +" <arch>i386</arch>\n" +" <distro>ubuntu</distro>\n" +" <product_name>Ubuntu 10.10 "Maverick " +"Meerkat"</product_name>\n" +" <major_version>10</major_version>\n" +" <minor_version>10</minor_version>\n" +" <format>installer</format>\n" +" <live/>\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../inspector/virt-inspector.pod:330 ../libguestfs-1.11.19/inspector/virt-inspector.pod:330 +msgid "USING XPATH" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:332 ../libguestfs-1.11.19/inspector/virt-inspector.pod:332 +msgid "" +"You can use the XPath query language, and/or the xpath tool, in order to " +"select parts of the XML." +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:337 ../libguestfs-1.11.19/inspector/virt-inspector.pod:337 +#, no-wrap +msgid "" +" $ virt-inspector -d Guest | xpath //filesystems\n" +" Found 1 nodes:\n" +" -- NODE --\n" +" <filesystems>\n" +" <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n" +" <type>ext4</type>\n" +" [etc]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:345 ../libguestfs-1.11.19/inspector/virt-inspector.pod:345 +#, no-wrap +msgid "" +" $ virt-inspector -d Guest | \\\n" +" xpath \"string(//filesystem[@dev='/dev/sda1']/type)\"\n" +" Query didn't return a nodeset. Value: ext4\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../inspector/virt-inspector.pod:356 ../libguestfs-1.11.19/inspector/virt-inspector.pod:356 +msgid "OLD VERSIONS OF VIRT-INSPECTOR" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:358 ../libguestfs-1.11.19/inspector/virt-inspector.pod:358 +msgid "" +"Early versions of libguestfs shipped with a different virt-inspector program " +"written in Perl (the current version is written in C). The XML output of " +"the Perl virt-inspector was different and it could also output in other " +"formats like text." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:363 ../libguestfs-1.11.19/inspector/virt-inspector.pod:363 +msgid "The old virt-inspector is no longer supported or shipped with libguestfs." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:366 ../libguestfs-1.11.19/inspector/virt-inspector.pod:366 +msgid "" +"To confuse matters further, in Red Hat Enterprise Linux 6 we ship two " +"versions of virt-inspector with different names:" +msgstr "" + +#. type: verbatim +#: ../inspector/virt-inspector.pod:369 ../libguestfs-1.11.19/inspector/virt-inspector.pod:369 +#, no-wrap +msgid "" +" virt-inspector Old Perl version.\n" +" virt-inspector2 New C version.\n" +"\n" +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:374 ../libguestfs-1.11.19/inspector/virt-inspector.pod:374 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<http://www.w3.org/TR/xpath/>, " +"L<base64(1)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../inspector/virt-inspector.pod:390 ../libguestfs-1.11.19/inspector/virt-inspector.pod:390 +msgid "Matthew Booth L<mbooth@redhat.com>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:5 ../ocaml/examples/guestfs-ocaml.pod:5 +msgid "guestfs-ocaml - How to use libguestfs from OCaml" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:9 ../ocaml/examples/guestfs-ocaml.pod:9 +msgid "Module style:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:11 ../ocaml/examples/guestfs-ocaml.pod:11 +#, no-wrap +msgid "" +" let g = Guestfs.create () in\n" +" Guestfs.add_drive_opts g ~format:\"raw\" ~readonly:true \"disk.img\";\n" +" Guestfs.launch g;\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:15 ../ocaml/examples/guestfs-ocaml.pod:15 +msgid "Object-oriented style:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:17 ../ocaml/examples/guestfs-ocaml.pod:17 +#, no-wrap +msgid "" +" let g = new Guestfs.guestfs () in\n" +" g#add_drive_opts ~format:\"raw\" ~readonly:true \"disk.img\";\n" +" g#launch ();\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:21 ../ocaml/examples/guestfs-ocaml.pod:21 +#, no-wrap +msgid "" +" ocamlfind opt prog.ml -package guestfs -linkpkg -o prog\n" +"or:\n" +" ocamlopt -I +guestfs mlguestfs.cmxa prog.ml -o prog\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:27 ../ocaml/examples/guestfs-ocaml.pod:27 +msgid "" +"This manual page documents how to call libguestfs from the OCaml programming " +"language. This page just documents the differences from the C API and gives " +"some examples. If you are not familiar with using libguestfs, you also need " +"to read L<guestfs(3)>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:32 ../ocaml/examples/guestfs-ocaml.pod:32 +msgid "PROGRAMMING STYLES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:34 ../ocaml/examples/guestfs-ocaml.pod:34 +msgid "" +"There are two different programming styles supported by the OCaml bindings. " +"You can use a module style, with each C function mapped to an OCaml " +"function:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:38 ../ocaml/examples/guestfs-ocaml.pod:38 +#, no-wrap +msgid "" +" int guestfs_set_verbose (guestfs_h *g, int flag);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:40 ../ocaml/examples/guestfs-ocaml.pod:40 +msgid "becomes:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:42 ../ocaml/examples/guestfs-ocaml.pod:42 +#, no-wrap +msgid "" +" val Guestfs.set_verbose : Guestfs.t -> bool -> unit\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:44 ../ocaml/examples/guestfs-ocaml.pod:44 +msgid "" +"Alternately you can use an object-oriented style, calling methods on the " +"class C<Guestfs.guestfs>:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:47 ../ocaml/examples/guestfs-ocaml.pod:47 +#, no-wrap +msgid "" +" method set_verbose : bool -> unit\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:49 ../ocaml/examples/guestfs-ocaml.pod:49 +msgid "" +"The object-oriented style is usually briefer, and the minor performance " +"penalty isn't noticable in the general overhead of performing libguestfs " +"functions." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:53 ../ocaml/examples/guestfs-ocaml.pod:53 +msgid "CLOSING THE HANDLE" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:55 ../ocaml/examples/guestfs-ocaml.pod:55 +msgid "" +"The handle is closed when it is reaped by the garbage collector. Because " +"libguestfs handles include a lot of state, it is also possible to close (and " +"hence free) them explicitly by calling C<Guestfs.close> or the C<#close> " +"method." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:60 ../libguestfs-1.11.19/python/examples/guestfs-python.pod:21 ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:22 ../ocaml/examples/guestfs-ocaml.pod:60 ../python/examples/guestfs-python.pod:21 ../ruby/examples/guestfs-ruby.pod:22 +msgid "EXCEPTIONS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:62 ../ocaml/examples/guestfs-ocaml.pod:62 +msgid "" +"Errors from libguestfs functions are mapped into the C<Guestfs.Error> " +"exception. This has a single parameter which is the error message (a " +"string)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:66 ../ocaml/examples/guestfs-ocaml.pod:66 +msgid "" +"Calling any function/method on a closed handle raises " +"C<Guestfs.Handle_closed>. The single parameter is the name of the function " +"that you called." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ocaml/examples/guestfs-ocaml.pod:80 ../ocaml/examples/guestfs-ocaml.pod:80 +msgid "" +"L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-perl(3)>, " +"L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, " +"L<http://libguestfs.org/>, L<http://caml.inria.fr/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:5 ../perl/examples/guestfs-perl.pod:5 +msgid "guestfs-perl - How to use libguestfs from Perl" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:9 ../perl/examples/guestfs-perl.pod:9 +#, no-wrap +msgid "" +" use Sys::Guestfs;\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:11 ../perl/examples/guestfs-perl.pod:11 +#, no-wrap +msgid "" +" my $h = Sys::Guestfs->new ();\n" +" $h->add_drive_opts ('guest.img', format => 'raw');\n" +" $h->launch ();\n" +" $h->mount_options ('', '/dev/sda1', '/');\n" +" $h->touch ('/hello');\n" +" $h->sync ();\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:20 ../perl/examples/guestfs-perl.pod:20 +msgid "" +"This manual page documents how to call libguestfs from the Perl programming " +"language. This page just documents the differences from the C API and gives " +"some examples. If you are not familiar with using libguestfs, you also need " +"to read L<guestfs(3)>. To read the full Perl API, see L<Sys::Guestfs(3)>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:26 ../perl/examples/guestfs-perl.pod:26 +msgid "ERRORS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:28 ../perl/examples/guestfs-perl.pod:28 +msgid "" +"Errors from libguestfs functions turn into calls to C<croak> (see " +"L<Carp(3)>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:41 ../perl/examples/guestfs-perl.pod:41 +msgid "" +"L<Sys::Guestfs(3)>, L<guestfs(3)>, L<guestfs-examples(3)>, " +"L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, " +"L<guestfs-ruby(3)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/perl/examples/guestfs-perl.pod:56 ../perl/examples/guestfs-perl.pod:56 +msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:5 ../python/examples/guestfs-python.pod:5 +msgid "guestfs-python - How to use libguestfs from Python" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:9 ../python/examples/guestfs-python.pod:9 +#, no-wrap +msgid "" +" import guestfs\n" +" g = guestfs.GuestFS ()\n" +" g.add_drive_opts (\"disk.img\", format=\"raw\", readonly=1)\n" +" g.launch\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:16 ../python/examples/guestfs-python.pod:16 +msgid "" +"This manual page documents how to call libguestfs from the Python " +"programming language. This page just documents the differences from the C " +"API and gives some examples. If you are not familiar with using libguestfs, " +"you also need to read L<guestfs(3)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:23 ../python/examples/guestfs-python.pod:23 +msgid "" +"Errors from libguestfs functions are mapped into C<RuntimeException> with a " +"single string argument which is the error message." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:26 ../python/examples/guestfs-python.pod:26 +msgid "MORE DOCUMENTATION" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:28 ../python/examples/guestfs-python.pod:28 +msgid "Type:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:30 ../python/examples/guestfs-python.pod:30 +#, no-wrap +msgid "" +" $ python\n" +" >>> import guestfs\n" +" >>> help (guestfs)\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/python/examples/guestfs-python.pod:44 ../python/examples/guestfs-python.pod:44 +msgid "" +"L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, " +"L<guestfs-perl(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:5 ../rescue/virt-rescue.pod:5 +msgid "virt-rescue - Run a rescue shell on a virtual machine" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:9 ../rescue/virt-rescue.pod:9 +#, no-wrap +msgid "" +" virt-rescue [--options] -d domname\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:11 ../rescue/virt-rescue.pod:11 +#, no-wrap +msgid "" +" virt-rescue [--options] -a disk.img [-a disk.img ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:15 ../rescue/virt-rescue.pod:15 +#, no-wrap +msgid "" +" virt-rescue [--options] domname\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:17 ../rescue/virt-rescue.pod:17 +#, no-wrap +msgid "" +" virt-rescue [--options] disk.img [disk.img ...]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:21 ../rescue/virt-rescue.pod:21 +msgid "" +"You must I<not> use C<virt-rescue> on live virtual machines. Doing so will " +"probably result in disk corruption in the VM. C<virt-rescue> tries to stop " +"you from doing this, but doesn't catch all cases." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:25 ../rescue/virt-rescue.pod:25 +msgid "" +"However if you use the I<--ro> (read only) option, then you can attach a " +"shell to a live virtual machine. The results might be strange or " +"inconsistent at times but you won't get disk corruption." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:31 ../rescue/virt-rescue.pod:31 +msgid "" +"virt-rescue is like a Rescue CD, but for virtual machines, and without the " +"need for a CD. virt-rescue gives you a rescue shell and some simple " +"recovery tools which you can use to examine or rescue a virtual machine or " +"disk image." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:36 ../rescue/virt-rescue.pod:36 +msgid "" +"You can run virt-rescue on any virtual machine known to libvirt, or directly " +"on disk image(s):" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:39 ../rescue/virt-rescue.pod:39 +#, no-wrap +msgid "" +" virt-rescue -d GuestName\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:41 ../rescue/virt-rescue.pod:41 +#, no-wrap +msgid "" +" virt-rescue --ro -a /path/to/disk.img\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:43 ../rescue/virt-rescue.pod:43 +#, no-wrap +msgid "" +" virt-rescue -a /dev/sdc\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:45 ../rescue/virt-rescue.pod:45 +msgid "For live VMs you I<must> use the --ro option." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:47 ../rescue/virt-rescue.pod:47 +msgid "" +"When you run virt-rescue on a virtual machine or disk image, you are placed " +"in an interactive bash shell where you can use many ordinary Linux " +"commands. What you see in C</> (C</bin>, C</lib> etc) is the rescue " +"appliance. You must mount the virtual machine's filesystems by hand. There " +"is an empty directory called C</sysroot> where you can mount filesystems." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:54 ../rescue/virt-rescue.pod:54 +msgid "" +"In the example below, we list logical volumes, then choose one to mount " +"under C</sysroot>:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:57 ../rescue/virt-rescue.pod:57 +#, no-wrap +msgid "" +" ><rescue> lvs\n" +" LV VG Attr LSize Origin Snap% Move Log Copy% Convert\n" +" lv_root vg_f11x64 -wi-a- 8.83G\n" +" lv_swap vg_f11x64 -wi-a- 992.00M\n" +" ><rescue> mount /dev/vg_f11x64/lv_root /sysroot\n" +" ><rescue> ls /sysroot\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:64 ../rescue/virt-rescue.pod:64 +msgid "" +"If you don't know what filesystems are available on the virtual machine then " +"you can use commands such as L<parted(8)> and L<lvs(8)> to find out." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:70 ../rescue/virt-rescue.pod:70 +msgid "" +"Virt-rescue can be used on I<any> disk image file or device, not just a " +"virtual machine. For example you can use it on a blank file if you want to " +"partition that file (although we would recommend using L<guestfish(1)> " +"instead as it is more suitable for this purpose). You can even use " +"virt-rescue on things like SD cards." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:76 ../rescue/virt-rescue.pod:76 +msgid "" +"Virt-rescue does not require root. You only need to run it as root if you " +"need root to open the disk image." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:79 ../rescue/virt-rescue.pod:79 +msgid "" +"This tool is just designed for quick interactive hacking on a virtual " +"machine. For more structured access to a virtual machine disk image, you " +"should use L<guestfs(3)>. To get a structured shell that you can use to " +"make scripted changes to guests, use L<guestfish(1)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:103 ../rescue/virt-rescue.pod:103 +msgid "B<--append kernelopts>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:105 ../rescue/virt-rescue.pod:105 +msgid "Pass additional options to the rescue kernel." +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:135 ../rescue/virt-rescue.pod:135 +#, no-wrap +msgid "" +" virt-rescue --format=raw -a disk.img\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:139 ../rescue/virt-rescue.pod:139 +#, no-wrap +msgid "" +" virt-rescue --format=raw -a disk.img --format -a another.img\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:148 ../rescue/virt-rescue.pod:148 +msgid "B<-m MB>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:150 ../rescue/virt-rescue.pod:150 +msgid "B<--memsize MB>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:152 ../rescue/virt-rescue.pod:152 +msgid "" +"Change the amount of memory allocated to the rescue system. The default is " +"set by libguestfs and is small but adequate for running system tools. The " +"occasional program might need more memory. The parameter is specified in " +"megabytes." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:157 ../rescue/virt-rescue.pod:157 +msgid "B<--network>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:159 ../rescue/virt-rescue.pod:159 +msgid "Enable QEMU user networking in the guest. See L</NETWORK>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:165 ../rescue/virt-rescue.pod:165 +msgid "Open the image read-only." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:175 ../rescue/virt-rescue.pod:175 +msgid "" +"Enable SELinux in the rescue appliance. You should read " +"L<guestfs(3)/SELINUX> before using this option." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:194 ../rescue/virt-rescue.pod:194 +msgid "" +"This changes the I<-a> and I<-d> options so that disks are added and mounts " +"are done read-write." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:207 ../rescue/virt-rescue.pod:207 +msgid "Previous versions of virt-rescue allowed you to write either:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:209 ../rescue/virt-rescue.pod:209 +#, no-wrap +msgid "" +" virt-rescue disk.img [disk.img ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:213 ../rescue/virt-rescue.pod:213 +#, no-wrap +msgid "" +" virt-rescue guestname\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:221 ../rescue/virt-rescue.pod:221 +msgid "NETWORK" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:223 ../rescue/virt-rescue.pod:223 +msgid "" +"Adding the I<--network> option enables QEMU user networking in the rescue " +"appliance. There are some differences between user networking and ordinary " +"networking:" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:229 ../rescue/virt-rescue.pod:229 +msgid "ping does not work" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:231 ../rescue/virt-rescue.pod:231 +msgid "" +"Because the ICMP ECHO_REQUEST protocol generally requires root in order to " +"send the ping packets, and because virt-rescue must be able to run as " +"non-root, QEMU user networking is not able to emulate the L<ping(8)> " +"command. The ping command will appear to resolve addresses but will not be " +"able to send or receive any packets. This does not mean that the network is " +"not working." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:238 ../rescue/virt-rescue.pod:238 +msgid "cannot receive connections" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:240 ../rescue/virt-rescue.pod:240 +msgid "QEMU user networking cannot receive incoming connections." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:242 ../rescue/virt-rescue.pod:242 +msgid "making TCP connections" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:244 ../rescue/virt-rescue.pod:244 +msgid "" +"The virt-rescue appliance needs to be small and so does not include many " +"network tools. In particular there is no L<telnet(1)> command. You can " +"make TCP connections from the shell using the magical " +"C</dev/tcp/E<lt>hostnameE<gt>/E<lt>portE<gt>> syntax:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:249 ../rescue/virt-rescue.pod:249 +#, no-wrap +msgid "" +" exec 3<>/dev/tcp/redhat.com/80\n" +" echo \"GET /\" >&3\n" +" cat <&3\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:253 ../rescue/virt-rescue.pod:253 +msgid "See L<bash(1)> for more details." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:259 ../rescue/virt-rescue.pod:259 +msgid "" +"Several environment variables affect virt-rescue. See " +"L<guestfs(3)/ENVIRONMENT VARIABLES> for the complete list." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/rescue/virt-rescue.pod:286 ../rescue/virt-rescue.pod:286 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:5 ../resize/virt-resize.pod:5 +msgid "virt-resize - Resize a virtual machine disk" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:9 ../resize/virt-resize.pod:9 +#, no-wrap +msgid "" +" virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n" +" [--expand /dev/sdaN] [--shrink /dev/sdaN]\n" +" [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:15 ../resize/virt-resize.pod:15 +msgid "" +"Virt-resize is a tool which can resize a virtual machine disk, making it " +"larger or smaller overall, and resizing or deleting any partitions contained " +"within." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:19 ../resize/virt-resize.pod:19 +msgid "" +"Virt-resize B<cannot> resize disk images in-place. Virt-resize B<should " +"not> be used on live virtual machines - for consistent results, shut the " +"virtual machine down before resizing it." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:23 ../resize/virt-resize.pod:23 +msgid "" +"If you are not familiar with the associated tools: L<virt-filesystems(1)> " +"and L<virt-df(1)>, we recommend you go and read those manual pages first." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:31 ../libguestfs-1.11.19/src/guestfs.pod:469 ../libguestfs-1.11.19/src/guestfs.pod:1257 ../libguestfs-1.11.19/src/guestfs.pod:1395 ../libguestfs-1.11.19/src/guestfs.pod:2465 ../resize/virt-resize.pod:31 ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2465 +msgid "1." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:33 ../resize/virt-resize.pod:33 +msgid "" +"Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to " +"fill the extra 5GB of space." +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:36 ../resize/virt-resize.pod:36 +#, no-wrap +msgid "" +" virt-filesystems --long -h --all -a olddisk\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:38 ../resize/virt-resize.pod:38 +#, no-wrap +msgid "" +" truncate -r olddisk newdisk\n" +" truncate -s +5G newdisk\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:41 ../resize/virt-resize.pod:41 +#, no-wrap +msgid "" +" # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n" +" virt-resize --expand /dev/sda2 olddisk newdisk\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:44 ../libguestfs-1.11.19/src/guestfs.pod:475 ../libguestfs-1.11.19/src/guestfs.pod:1261 ../libguestfs-1.11.19/src/guestfs.pod:1399 ../libguestfs-1.11.19/src/guestfs.pod:2490 ../resize/virt-resize.pod:44 ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2490 +msgid "2." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:46 ../resize/virt-resize.pod:46 +msgid "" +"As above, but make the /boot partition 200MB bigger, while giving the " +"remaining space to /dev/sda2:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:49 ../resize/virt-resize.pod:49 +#, no-wrap +msgid "" +" virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n" +" olddisk newdisk\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:52 ../libguestfs-1.11.19/src/guestfs.pod:486 ../libguestfs-1.11.19/src/guestfs.pod:1405 ../resize/virt-resize.pod:52 ../src/guestfs.pod:486 ../src/guestfs.pod:1405 +msgid "3." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:54 ../resize/virt-resize.pod:54 +msgid "" +"As in the first example, but expand a logical volume as the final step. " +"This is what you would typically use for Linux guests that use LVM:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:58 ../resize/virt-resize.pod:58 +#, no-wrap +msgid "" +" virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \\\n" +" olddisk newdisk\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:61 ../resize/virt-resize.pod:61 +msgid "4." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:63 ../resize/virt-resize.pod:63 +msgid "" +"As in the first example, but the output format will be qcow2 instead of a " +"raw disk:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:66 ../resize/virt-resize.pod:66 +#, no-wrap +msgid "" +" qemu-img create -f qcow2 newdisk.qcow2 15G\n" +" virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:71 ../resize/virt-resize.pod:71 +msgid "DETAILED USAGE" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:73 ../resize/virt-resize.pod:73 +msgid "EXPANDING A VIRTUAL MACHINE DISK" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:77 ../resize/virt-resize.pod:77 +msgid "1. Shut down the virtual machine" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:79 ../resize/virt-resize.pod:79 +msgid "2. Locate input disk image" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:81 ../resize/virt-resize.pod:81 +msgid "" +"Locate the input disk image (ie. the file or device on the host containing " +"the guest's disk). If the guest is managed by libvirt, you can use C<virsh " +"dumpxml> like this to find the disk image name:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:85 ../resize/virt-resize.pod:85 +#, no-wrap +msgid "" +" # virsh dumpxml guestname | xpath /domain/devices/disk/source\n" +" Found 1 nodes:\n" +" -- NODE --\n" +" <source dev=\"/dev/vg/lv_guest\" />\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:90 ../resize/virt-resize.pod:90 +msgid "3. Look at current sizing" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:92 ../resize/virt-resize.pod:92 +msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:95 ../resize/virt-resize.pod:95 +#, no-wrap +msgid "" +" # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n" +" Name Type Size Parent\n" +" /dev/sda1 partition 101M /dev/sda\n" +" /dev/sda2 partition 7.9G /dev/sda\n" +" /dev/sda device 8.0G -\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:101 ../resize/virt-resize.pod:101 +msgid "" +"(This example is a virtual machine with an 8 GB disk which we would like to " +"expand up to 10 GB)." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:104 ../resize/virt-resize.pod:104 +msgid "4. Create output disk" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:106 ../resize/virt-resize.pod:106 +msgid "" +"Virt-resize cannot do in-place disk modifications. You have to have space " +"to store the resized output disk." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:109 ../resize/virt-resize.pod:109 +msgid "To store the resized disk image in a file, create a file of a suitable size:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:112 ../resize/virt-resize.pod:112 +#, no-wrap +msgid "" +" # rm -f outdisk\n" +" # truncate -s 10G outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:115 ../resize/virt-resize.pod:115 +msgid "Or use L<lvcreate(1)> to create a logical volume:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:117 ../resize/virt-resize.pod:117 +#, no-wrap +msgid "" +" # lvcreate -L 10G -n lv_name vg_name\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:119 ../resize/virt-resize.pod:119 +msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:121 ../resize/virt-resize.pod:121 +#, no-wrap +msgid "" +" # virsh pool-list\n" +" # virsh vol-create-as poolname newvol 10G\n" +"\n" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:124 ../resize/virt-resize.pod:124 +msgid "5. Resize" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:126 ../resize/virt-resize.pod:126 +msgid "" +"virt-resize takes two mandatory parameters, the input disk (eg. device or " +"file) and the output disk. The output disk is the one created in the " +"previous step." +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:130 ../resize/virt-resize.pod:130 +#, no-wrap +msgid "" +" # virt-resize indisk outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:132 ../resize/virt-resize.pod:132 +msgid "" +"This command just copies disk image C<indisk> to disk image C<outdisk> " +"I<without> resizing or changing any existing partitions. If C<outdisk> is " +"larger, then an extra, empty partition is created at the end of the disk " +"covering the extra space. If C<outdisk> is smaller, then it will give an " +"error." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:138 ../resize/virt-resize.pod:138 +msgid "" +"More realistically you'd want to expand existing partitions in the disk " +"image by passing extra options (for the full list see the L</OPTIONS> " +"section below)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:142 ../resize/virt-resize.pod:142 +msgid "" +"L</--expand> is the most useful option. It expands the named partition " +"within the disk to fill any extra space:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:145 ../resize/virt-resize.pod:145 +#, no-wrap +msgid "" +" # virt-resize --expand /dev/sda2 indisk outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:147 ../resize/virt-resize.pod:147 +msgid "" +"(In this case, an extra partition is I<not> created at the end of the disk, " +"because there will be no unused space)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:150 ../resize/virt-resize.pod:150 +msgid "" +"L</--resize> is the other commonly used option. The following would " +"increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the " +"rest of the available space:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:154 ../resize/virt-resize.pod:154 +#, no-wrap +msgid "" +" # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n" +" indisk outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:157 ../resize/virt-resize.pod:157 +msgid "" +"If the expanded partition in the image contains a filesystem or LVM PV, then " +"if virt-resize knows how, it will resize the contents, the equivalent of " +"calling a command such as L<pvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)> " +"or L<btrfs(8)>. However virt-resize does not know how to resize some " +"filesystems, so you would have to online resize them after booting the " +"guest." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:164 ../resize/virt-resize.pod:164 +msgid "Other options are covered below." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:166 ../resize/virt-resize.pod:166 +msgid "6. Test" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:168 ../resize/virt-resize.pod:168 +msgid "Thoroughly test the new disk image I<before> discarding the old one." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:170 ../resize/virt-resize.pod:170 +msgid "If you are using libvirt, edit the XML to point at the new disk:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:172 ../resize/virt-resize.pod:172 +#, no-wrap +msgid "" +" # virsh edit guestname\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:174 ../resize/virt-resize.pod:174 +msgid "" +"Change E<lt>source ...E<gt>, see " +"L<http://libvirt.org/formatdomain.html#elementsDisks>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:177 ../resize/virt-resize.pod:177 +msgid "Then start up the domain with the new, resized disk:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:179 ../resize/virt-resize.pod:179 +#, no-wrap +msgid "" +" # virsh start guestname\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:181 ../resize/virt-resize.pod:181 +msgid "" +"and check that it still works. See also the L</NOTES> section below for " +"additional information." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:184 ../resize/virt-resize.pod:184 +msgid "7. Resize LVs etc inside the guest" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:186 ../resize/virt-resize.pod:186 +msgid "(This can also be done offline using L<guestfish(1)>)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:188 ../resize/virt-resize.pod:188 +msgid "" +"Once the guest has booted you should see the new space available, at least " +"for filesystems that virt-resize knows how to resize, and for PVs. The user " +"may need to resize LVs inside PVs, and also resize filesystem types that " +"virt-resize does not know how to expand." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:195 ../resize/virt-resize.pod:195 +msgid "SHRINKING A VIRTUAL MACHINE DISK" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:197 ../resize/virt-resize.pod:197 +msgid "" +"Shrinking is somewhat more complex than expanding, and only an overview is " +"given here." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:200 ../resize/virt-resize.pod:200 +msgid "" +"Firstly virt-resize will not attempt to shrink any partition content (PVs, " +"filesystems). The user has to shrink content before passing the disk image " +"to virt-resize, and virt-resize will check that the content has been shrunk " +"properly." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:205 ../resize/virt-resize.pod:205 +msgid "(Shrinking can also be done offline using L<guestfish(1)>)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:207 ../resize/virt-resize.pod:207 +msgid "" +"After shrinking PVs and filesystems, shut down the guest, and proceed with " +"steps 3 and 4 above to allocate a new disk image." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:210 ../resize/virt-resize.pod:210 +msgid "Then run virt-resize with any of the I<--shrink> and/or I<--resize> options." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:213 ../resize/virt-resize.pod:213 +msgid "IGNORING OR DELETING PARTITIONS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:215 ../resize/virt-resize.pod:215 +msgid "" +"virt-resize also gives a convenient way to ignore or delete partitions when " +"copying from the input disk to the output disk. Ignoring a partition speeds " +"up the copy where you don't care about the existing contents of a " +"partition. Deleting a partition removes it completely, but note that it " +"also renumbers any partitions after the one which is deleted, which can " +"leave some guests unbootable." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:222 ../resize/virt-resize.pod:222 +msgid "QCOW2 AND NON-SPARSE RAW FORMATS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:224 ../resize/virt-resize.pod:224 +msgid "" +"If the input disk is in qcow2 format, then you may prefer that the output is " +"in qcow2 format as well. Alternately, virt-resize can convert the format on " +"the fly. The output format is simply determined by the format of the empty " +"output container that you provide. Thus to create qcow2 output, use:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:230 ../resize/virt-resize.pod:230 +#, no-wrap +msgid "" +" qemu-img create [-c] -f qcow2 outdisk [size]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:232 ../resize/virt-resize.pod:232 +msgid "instead of the truncate command (use I<-c> for a compressed disk)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:234 ../resize/virt-resize.pod:234 +msgid "Similarly, to get non-sparse raw output use:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:236 ../resize/virt-resize.pod:236 +#, no-wrap +msgid "" +" fallocate -l size outdisk\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:238 ../resize/virt-resize.pod:238 +msgid "" +"(on older systems that don't have the L<fallocate(1)> command use C<dd " +"if=/dev/zero of=outdisk bs=1M count=..>)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:247 ../resize/virt-resize.pod:247 +msgid "Display help." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:249 ../resize/virt-resize.pod:249 +msgid "B<-d>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:251 ../resize/virt-resize.pod:251 ../tools/virt-make-fs.pl:177 ../tools/virt-win-reg.pl:120 +msgid "B<--debug>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:253 ../resize/virt-resize.pod:253 ../tools/virt-win-reg.pl:122 +msgid "Enable debugging messages." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:255 ../resize/virt-resize.pod:255 +msgid "B<--delete part>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:257 ../resize/virt-resize.pod:257 +msgid "" +"Delete the named partition. It would be more accurate to describe this as " +"\"don't copy it over\", since virt-resize doesn't do in-place changes and " +"the original disk image is left intact." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:261 ../resize/virt-resize.pod:261 +msgid "" +"Note that when you delete a partition, then anything contained in the " +"partition is also deleted. Furthermore, this causes any partitions that " +"come after to be I<renumbered>, which can easily make your guest unbootable." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:266 ../libguestfs-1.11.19/resize/virt-resize.pod:327 ../libguestfs-1.11.19/resize/virt-resize.pod:448 ../resize/virt-resize.pod:266 ../resize/virt-resize.pod:327 ../resize/virt-resize.pod:448 +msgid "You can give this option multiple times." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:268 ../resize/virt-resize.pod:268 +msgid "B<--expand part>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:270 ../resize/virt-resize.pod:270 +msgid "" +"Expand the named partition so it uses up all extra space (space left over " +"after any other resize changes that you request have been done)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:273 ../resize/virt-resize.pod:273 +msgid "" +"If virt-resize knows how, it will expand the direct content of the " +"partition. For example, if the partition is an LVM PV, it will expand the " +"PV to fit (like calling L<pvresize(8)>). Virt-resize leaves any other " +"content it doesn't know about alone." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:278 ../resize/virt-resize.pod:278 +msgid "Currently virt-resize can resize:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:284 ../resize/virt-resize.pod:284 +msgid "ext2, ext3 and ext4 filesystems." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:288 ../resize/virt-resize.pod:288 +msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:290 ../resize/virt-resize.pod:290 +msgid "" +"The filesystem must have been shut down consistently last time it was used. " +"Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a " +"consistency check, so at the first boot after resizing Windows will check " +"the disk." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:297 ../resize/virt-resize.pod:297 +msgid "" +"LVM PVs (physical volumes). virt-resize does not usually resize anything " +"inside the PV, but see the I<--LV-expand> option. The user could also " +"resize LVs as desired after boot." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:303 ../resize/virt-resize.pod:303 +msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:307 ../libguestfs-1.11.19/resize/virt-resize.pod:476 ../resize/virt-resize.pod:307 ../resize/virt-resize.pod:476 +msgid "Note that you cannot use I<--expand> and I<--shrink> together." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:309 ../resize/virt-resize.pod:309 ../tools/virt-list-filesystems.pl:91 ../tools/virt-list-partitions.pl:92 ../tools/virt-tar.pl:141 ../tools/virt-win-reg.pl:142 +msgid "B<--format> raw" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:311 ../resize/virt-resize.pod:311 +msgid "" +"Specify the format of the input disk image. If this flag is not given then " +"it is auto-detected from the image itself." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:317 ../resize/virt-resize.pod:317 +msgid "" +"Note that this option I<does not> affect the output format. See L</QCOW2 " +"AND NON-SPARSE RAW FORMATS>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:320 ../resize/virt-resize.pod:320 +msgid "B<--ignore part>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:322 ../resize/virt-resize.pod:322 +msgid "" +"Ignore the named partition. Effectively this means the partition is " +"allocated on the destination disk, but the content is not copied across from " +"the source disk. The content of the partition will be blank (all zero " +"bytes)." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:329 ../resize/virt-resize.pod:329 +msgid "B<--LV-expand logvol>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:331 ../resize/virt-resize.pod:331 +msgid "" +"This takes the logical volume and, as a final step, expands it to fill all " +"the space available in its volume group. A typical usage, assuming a Linux " +"guest with a single PV C</dev/sda2> and a root device called " +"C</dev/vg_guest/lv_root> would be:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:336 ../resize/virt-resize.pod:336 +#, no-wrap +msgid "" +" virt-resize indisk outdisk \\\n" +" --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:339 ../resize/virt-resize.pod:339 +msgid "" +"This would first expand the partition (and PV), and then expand the root " +"device to fill the extra space in the PV." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:342 ../resize/virt-resize.pod:342 +msgid "" +"The contents of the LV are also resized if virt-resize knows how to do " +"that. You can stop virt-resize from trying to expand the content by using " +"the option I<--no-expand-content>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:346 ../resize/virt-resize.pod:346 +msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:348 ../resize/virt-resize.pod:348 +msgid "" +"You can give this option multiple times, I<but> it doesn't make sense to do " +"this unless the logical volumes you specify are all in different volume " +"groups." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:354 ../resize/virt-resize.pod:354 +msgid "B<--dryrun>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:356 ../resize/virt-resize.pod:356 +msgid "Print a summary of what would be done, but don't do anything." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:358 ../resize/virt-resize.pod:358 +msgid "B<--no-copy-boot-loader>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:360 ../resize/virt-resize.pod:360 +msgid "" +"By default, virt-resize copies over some sectors at the start of the disk " +"(up to the beginning of the first partition). Commonly these sectors " +"contain the Master Boot Record (MBR) and the boot loader, and are required " +"in order for the guest to boot correctly." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:365 ../resize/virt-resize.pod:365 +msgid "" +"If you specify this flag, then this initial copy is not done. You may need " +"to reinstall the boot loader in this case." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:368 ../resize/virt-resize.pod:368 +msgid "B<--no-extra-partition>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:370 ../resize/virt-resize.pod:370 +msgid "" +"By default, virt-resize creates an extra partition if there is any extra, " +"unused space after all resizing has happened. Use this option to prevent " +"the extra partition from being created. If you do this then the extra space " +"will be inaccessible until you run fdisk, parted, or some other partitioning " +"tool in the guest." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:376 ../resize/virt-resize.pod:376 +msgid "" +"Note that if the surplus space is smaller than 10 MB, no extra partition " +"will be created." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:379 ../resize/virt-resize.pod:379 +msgid "B<--no-expand-content>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:381 ../resize/virt-resize.pod:381 +msgid "" +"By default, virt-resize will try to expand the direct contents of " +"partitions, if it knows how (see I<--expand> option above)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:384 ../resize/virt-resize.pod:384 +msgid "" +"If you give the I<--no-expand-content> option then virt-resize will not " +"attempt this." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:387 ../resize/virt-resize.pod:387 +msgid "B<--ntfsresize-force>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:389 ../resize/virt-resize.pod:389 +msgid "" +"Pass the I<--force> option to L<ntfsresize(8)>, allowing resizing even if " +"the NTFS disk is marked as needing a consistency check. You have to use " +"this option if you want to resize a Windows guest multiple times without " +"booting into Windows between each resize." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:395 ../resize/virt-resize.pod:395 +msgid "B<--output-format> raw" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:397 ../resize/virt-resize.pod:397 +msgid "" +"Specify the format of the output disk image. If this flag is not given then " +"it is auto-detected from the image itself." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:403 ../resize/virt-resize.pod:403 +msgid "" +"Note that this option I<does not create> the output format. This option " +"just tells libguestfs what it is so it doesn't try to guess it. You still " +"need to create the output disk with the right format. See L</QCOW2 AND " +"NON-SPARSE RAW FORMATS>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:408 ../resize/virt-resize.pod:408 +msgid "B<-q>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:410 ../resize/virt-resize.pod:410 +msgid "B<--quiet>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:412 ../resize/virt-resize.pod:412 +msgid "Don't print the summary." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:414 ../resize/virt-resize.pod:414 +msgid "B<--resize part=size>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:416 ../resize/virt-resize.pod:416 +msgid "" +"Resize the named partition (expanding or shrinking it) so that it has the " +"given size." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:419 ../resize/virt-resize.pod:419 +msgid "" +"C<size> can be expressed as an absolute number followed by b/K/M/G to mean " +"bytes, Kilobytes, Megabytes, or Gigabytes; or as a percentage of the current " +"size; or as a relative number or percentage. For example:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:425 ../resize/virt-resize.pod:425 +#, no-wrap +msgid "" +" --resize /dev/sda2=10G\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:427 ../resize/virt-resize.pod:427 +#, no-wrap +msgid "" +" --resize /dev/sda4=90%\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:429 ../resize/virt-resize.pod:429 +#, no-wrap +msgid "" +" --resize /dev/sda2=+1G\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:431 ../resize/virt-resize.pod:431 +#, no-wrap +msgid "" +" --resize /dev/sda2=-200M\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:433 ../resize/virt-resize.pod:433 +#, no-wrap +msgid "" +" --resize /dev/sda1=+128K\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:435 ../resize/virt-resize.pod:435 +#, no-wrap +msgid "" +" --resize /dev/sda1=+10%\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:437 ../resize/virt-resize.pod:437 +#, no-wrap +msgid "" +" --resize /dev/sda1=-10%\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:439 ../resize/virt-resize.pod:439 +msgid "" +"You can increase the size of any partition. Virt-resize will expand the " +"direct content of the partition if it knows how (see I<--expand> below)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:443 ../resize/virt-resize.pod:443 +msgid "" +"You can only I<decrease> the size of partitions that contain filesystems or " +"PVs which have already been shrunk. Virt-resize will check this has been " +"done before proceeding, or else will print an error (see also " +"I<--resize-force>)." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:450 ../resize/virt-resize.pod:450 +msgid "B<--resize-force part=size>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:452 ../resize/virt-resize.pod:452 +msgid "" +"This is the same as I<--resize> except that it will let you decrease the " +"size of any partition. Generally this means you will lose any data which " +"was at the end of the partition you shrink, but you may not care about that " +"(eg. if shrinking an unused partition, or if you can easily recreate it such " +"as a swap partition)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:458 ../resize/virt-resize.pod:458 +msgid "See also the I<--ignore> option." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/resize/virt-resize.pod:460 ../resize/virt-resize.pod:460 +msgid "B<--shrink part>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:462 ../resize/virt-resize.pod:462 +msgid "" +"Shrink the named partition until the overall disk image fits in the " +"destination. The named partition B<must> contain a filesystem or PV which " +"has already been shrunk using another tool (eg. L<guestfish(1)> or other " +"online tools). Virt-resize will check this and give an error if it has not " +"been done." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:468 ../resize/virt-resize.pod:468 +msgid "" +"The amount by which the overall disk must be shrunk (after carrying out all " +"other operations requested by the user) is called the \"deficit\". For " +"example, a straight copy (assume no other operations) from a 5GB disk image " +"to a 4GB disk image results in a 1GB deficit. In this case, virt-resize " +"would give an error unless the user specified a partition to shrink and that " +"partition had more than a gigabyte of free space." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:488 ../resize/virt-resize.pod:488 +msgid "\"Partition 1 does not end on cylinder boundary.\"" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:490 ../resize/virt-resize.pod:490 +msgid "" +"Virt-resize aligns partitions to multiples of 64 sectors. Usually this " +"means the partitions will not be aligned to the ancient CHS geometry. " +"However CHS geometry is meaningless for disks manufactured since the early " +"1990s, and doubly so for virtual hard drives. Alignment of partitions to " +"cylinders is not required by any modern operating system." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:497 ../resize/virt-resize.pod:497 +msgid "RESIZING WINDOWS VIRTUAL MACHINES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:499 ../resize/virt-resize.pod:499 +msgid "" +"In Windows Vista and later versions, Microsoft switched to using a separate " +"boot partition. In these VMs, typically C</dev/sda1> is the boot partition " +"and C</dev/sda2> is the main (C:) drive. We have not had any luck resizing " +"the boot partition. Doing so seems to break the guest completely. However " +"expanding the second partition (ie. C: drive) should work." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:506 ../resize/virt-resize.pod:506 +msgid "" +"Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if " +"NTFS partitions have been expanded. This is just a safety check and (unless " +"it find errors) is nothing to worry about." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:510 ../resize/virt-resize.pod:510 +msgid "GUEST BOOT STUCK AT \"GRUB\"" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:512 ../resize/virt-resize.pod:512 +msgid "" +"If a Linux guest does not boot after resizing, and the boot is stuck after " +"printing C<GRUB> on the console, try reinstalling grub. This sometimes " +"happens on older (RHEL 5-era) guests, for reasons we don't fully understand, " +"although we think is to do with partition alignment." +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/resize/virt-resize.pod:517 ../resize/virt-resize.pod:517 +#, no-wrap +msgid "" +" guestfish -i -a newdisk\n" +" ><fs> cat /boot/grub/device.map\n" +" # check the contents of this file are sensible or\n" +" # edit the file if necessary\n" +" ><fs> grub-install / /dev/vda\n" +" ><fs> exit\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:15 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:524 ../resize/virt-resize.pod:524 +msgid "" +"For more flexible guest reconfiguration, including if you need to specify " +"other parameters to grub-install, use L<virt-rescue(1)>." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/resize/virt-resize.pod:527 ../resize/virt-resize.pod:527 +msgid "ALTERNATIVE TOOLS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:529 ../resize/virt-resize.pod:529 +msgid "" +"There are several proprietary tools for resizing partitions. We won't " +"mention any here." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:532 ../resize/virt-resize.pod:532 +msgid "" +"L<parted(8)> and its graphical shell gparted can do some types of resizing " +"operations on disk images. They can resize and move partitions, but I don't " +"think they can do anything with the contents, and they certainly don't " +"understand LVM." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:537 ../resize/virt-resize.pod:537 +msgid "" +"L<guestfish(1)> can do everything that virt-resize can do and a lot more, " +"but at a much lower level. You will probably end up hand-calculating sector " +"offsets, which is something that virt-resize was designed to avoid. If you " +"want to see the guestfish-equivalent commands that virt-resize runs, use the " +"I<--debug> flag." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/resize/virt-resize.pod:552 ../resize/virt-resize.pod:552 +msgid "" +"L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, " +"L<lvm(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, " +"L<ntfsresize(8)>, L<btrfs(8)>, L<virsh(1)>, L<parted(8)>, L<truncate(1)>, " +"L<fallocate(1)>, L<grub(8)>, L<grub-install(8)>, L<virt-rescue(1)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:5 ../ruby/examples/guestfs-ruby.pod:5 +msgid "guestfs-ruby - How to use libguestfs from Ruby" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:9 ../ruby/examples/guestfs-ruby.pod:9 +#, no-wrap +msgid "" +" require 'guestfs'\n" +" g = Guestfs::Guestfs.new()\n" +" g.add_drive_opts(\"disk.img\",\n" +" :readonly => 1, :format => \"raw\")\n" +" g.launch()\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:17 ../ruby/examples/guestfs-ruby.pod:17 +msgid "" +"This manual page documents how to call libguestfs from the Ruby programming " +"language. This page just documents the differences from the C API and gives " +"some examples. If you are not familiar with using libguestfs, you also need " +"to read L<guestfs(3)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:24 ../ruby/examples/guestfs-ruby.pod:24 +msgid "" +"Errors from libguestfs functions are mapped into the C<Error> exception. " +"This has a single parameter which is the error message (a string)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/ruby/examples/guestfs-ruby.pod:38 ../ruby/examples/guestfs-ruby.pod:38 +msgid "" +"L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, " +"L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1 ../src/guestfs-actions.pod:1 +msgid "guestfs_add_cdrom" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3 ../src/guestfs-actions.pod:3 +#, no-wrap +msgid "" +" int\n" +" guestfs_add_cdrom (guestfs_h *g,\n" +" const char *filename);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:17 ../src/guestfs-actions.pod:17 msgid "" "This call checks for the existence of C<filename>. This stops you from " "specifying other types of drive which are supported by qemu such as C<nbd:> " -"and C<http:> URLs. To specify those, use the general L</config> call " +"and C<http:> URLs. To specify those, use the general C<guestfs_config> call " "instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:22 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:24 ../src/guestfs-actions.pod:24 msgid "" "If you just want to add an ISO file (often you use this as an efficient way " "to transfer large files into the guest), then you should probably use " -"L</add-drive-ro> instead." +"C<guestfs_add_drive_ro> instead." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:35 -msgid "add-domain" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:30 ../libguestfs-1.11.19/src/guestfs-actions.pod:140 ../libguestfs-1.11.19/src/guestfs-actions.pod:201 ../libguestfs-1.11.19/src/guestfs-actions.pod:238 ../libguestfs-1.11.19/src/guestfs-actions.pod:252 ../libguestfs-1.11.19/src/guestfs-actions.pod:273 ../libguestfs-1.11.19/src/guestfs-actions.pod:293 ../libguestfs-1.11.19/src/guestfs-actions.pod:307 ../libguestfs-1.11.19/src/guestfs-actions.pod:422 ../libguestfs-1.11.19/src/guestfs-actions.pod:442 ../libguestfs-1.11.19/src/guestfs-actions.pod:456 ../libguestfs-1.11.19/src/guestfs-actions.pod:501 ../libguestfs-1.11.19/src/guestfs-actions.pod:529 ../libguestfs-1.11.19/src/guestfs-actions.pod:547 ../libguestfs-1.11.19/src/guestfs-actions.pod:614 ../libguestfs-1.11.19/src/guestfs-actions.pod:647 ../libguestfs-1.11.19/src/guestfs-actions.pod:661 ../libguestfs-1.11.19/src/guestfs-actions.pod:676 ../libguestfs-1.11.19/src/guestfs-actions.pod:775 ../libguestfs-1.11.19/src/guestfs-actions.pod:793 ../libguestfs-1.11.19/src/guestfs-actions.pod:807 ../libguestfs-1.11.19/src/guestfs-actions.pod:821 ../libguestfs-1.11.19/src/guestfs-actions.pod:858 ../libguestfs-1.11.19/src/guestfs-actions.pod:1041 ../libguestfs-1.11.19/src/guestfs-actions.pod:1061 ../libguestfs-1.11.19/src/guestfs-actions.pod:1079 ../libguestfs-1.11.19/src/guestfs-actions.pod:1163 ../libguestfs-1.11.19/src/guestfs-actions.pod:1181 ../libguestfs-1.11.19/src/guestfs-actions.pod:1200 ../libguestfs-1.11.19/src/guestfs-actions.pod:1214 ../libguestfs-1.11.19/src/guestfs-actions.pod:1234 ../libguestfs-1.11.19/src/guestfs-actions.pod:1304 ../libguestfs-1.11.19/src/guestfs-actions.pod:1335 ../libguestfs-1.11.19/src/guestfs-actions.pod:1360 ../libguestfs-1.11.19/src/guestfs-actions.pod:1402 ../libguestfs-1.11.19/src/guestfs-actions.pod:1508 ../libguestfs-1.11.19/src/guestfs-actions.pod:1542 ../libguestfs-1.11.19/src/guestfs-actions.pod:1757 ../libguestfs-1.11.19/src/guestfs-actions.pod:1779 ../libguestfs-1.11.19/src/guestfs-actions.pod:1866 ../libguestfs-1.11.19/src/guestfs-actions.pod:2341 ../libguestfs-1.11.19/src/guestfs-actions.pod:2485 ../libguestfs-1.11.19/src/guestfs-actions.pod:2546 ../libguestfs-1.11.19/src/guestfs-actions.pod:2581 ../libguestfs-1.11.19/src/guestfs-actions.pod:3621 ../libguestfs-1.11.19/src/guestfs-actions.pod:3636 ../libguestfs-1.11.19/src/guestfs-actions.pod:3661 ../libguestfs-1.11.19/src/guestfs-actions.pod:3850 ../libguestfs-1.11.19/src/guestfs-actions.pod:3864 ../libguestfs-1.11.19/src/guestfs-actions.pod:3877 ../libguestfs-1.11.19/src/guestfs-actions.pod:3891 ../libguestfs-1.11.19/src/guestfs-actions.pod:3906 ../libguestfs-1.11.19/src/guestfs-actions.pod:3942 ../libguestfs-1.11.19/src/guestfs-actions.pod:4014 ../libguestfs-1.11.19/src/guestfs-actions.pod:4034 ../libguestfs-1.11.19/src/guestfs-actions.pod:4051 ../libguestfs-1.11.19/src/guestfs-actions.pod:4074 ../libguestfs-1.11.19/src/guestfs-actions.pod:4097 ../libguestfs-1.11.19/src/guestfs-actions.pod:4132 ../libguestfs-1.11.19/src/guestfs-actions.pod:4151 ../libguestfs-1.11.19/src/guestfs-actions.pod:4170 ../libguestfs-1.11.19/src/guestfs-actions.pod:4205 ../libguestfs-1.11.19/src/guestfs-actions.pod:4217 ../libguestfs-1.11.19/src/guestfs-actions.pod:4253 ../libguestfs-1.11.19/src/guestfs-actions.pod:4269 ../libguestfs-1.11.19/src/guestfs-actions.pod:4282 ../libguestfs-1.11.19/src/guestfs-actions.pod:4297 ../libguestfs-1.11.19/src/guestfs-actions.pod:4314 ../libguestfs-1.11.19/src/guestfs-actions.pod:4407 ../libguestfs-1.11.19/src/guestfs-actions.pod:4427 ../libguestfs-1.11.19/src/guestfs-actions.pod:4440 ../libguestfs-1.11.19/src/guestfs-actions.pod:4491 ../libguestfs-1.11.19/src/guestfs-actions.pod:4509 ../libguestfs-1.11.19/src/guestfs-actions.pod:4527 ../libguestfs-1.11.19/src/guestfs-actions.pod:4543 ../libguestfs-1.11.19/src/guestfs-actions.pod:4557 ../libguestfs-1.11.19/src/guestfs-actions.pod:4571 ../libguestfs-1.11.19/src/guestfs-actions.pod:4588 ../libguestfs-1.11.19/src/guestfs-actions.pod:4603 ../libguestfs-1.11.19/src/guestfs-actions.pod:4623 ../libguestfs-1.11.19/src/guestfs-actions.pod:4693 ../libguestfs-1.11.19/src/guestfs-actions.pod:4766 ../libguestfs-1.11.19/src/guestfs-actions.pod:4797 ../libguestfs-1.11.19/src/guestfs-actions.pod:4816 ../libguestfs-1.11.19/src/guestfs-actions.pod:4835 ../libguestfs-1.11.19/src/guestfs-actions.pod:4847 ../libguestfs-1.11.19/src/guestfs-actions.pod:4864 ../libguestfs-1.11.19/src/guestfs-actions.pod:4877 ../libguestfs-1.11.19/src/guestfs-actions.pod:4892 ../libguestfs-1.11.19/src/guestfs-actions.pod:4907 ../libguestfs-1.11.19/src/guestfs-actions.pod:4942 ../libguestfs-1.11.19/src/guestfs-actions.pod:4975 ../libguestfs-1.11.19/src/guestfs-actions.pod:5014 ../libguestfs-1.11.19/src/guestfs-actions.pod:5034 ../libguestfs-1.11.19/src/guestfs-actions.pod:5048 ../libguestfs-1.11.19/src/guestfs-actions.pod:5065 ../libguestfs-1.11.19/src/guestfs-actions.pod:5114 ../libguestfs-1.11.19/src/guestfs-actions.pod:5160 ../libguestfs-1.11.19/src/guestfs-actions.pod:5214 ../libguestfs-1.11.19/src/guestfs-actions.pod:5250 ../libguestfs-1.11.19/src/guestfs-actions.pod:5285 ../libguestfs-1.11.19/src/guestfs-actions.pod:5302 ../libguestfs-1.11.19/src/guestfs-actions.pod:5320 ../libguestfs-1.11.19/src/guestfs-actions.pod:5460 ../libguestfs-1.11.19/src/guestfs-actions.pod:5517 ../libguestfs-1.11.19/src/guestfs-actions.pod:5539 ../libguestfs-1.11.19/src/guestfs-actions.pod:5557 ../libguestfs-1.11.19/src/guestfs-actions.pod:5589 ../libguestfs-1.11.19/src/guestfs-actions.pod:5655 ../libguestfs-1.11.19/src/guestfs-actions.pod:5672 ../libguestfs-1.11.19/src/guestfs-actions.pod:5685 ../libguestfs-1.11.19/src/guestfs-actions.pod:5699 ../libguestfs-1.11.19/src/guestfs-actions.pod:5988 ../libguestfs-1.11.19/src/guestfs-actions.pod:6007 ../libguestfs-1.11.19/src/guestfs-actions.pod:6026 ../libguestfs-1.11.19/src/guestfs-actions.pod:6040 ../libguestfs-1.11.19/src/guestfs-actions.pod:6052 ../libguestfs-1.11.19/src/guestfs-actions.pod:6066 ../libguestfs-1.11.19/src/guestfs-actions.pod:6078 ../libguestfs-1.11.19/src/guestfs-actions.pod:6092 ../libguestfs-1.11.19/src/guestfs-actions.pod:6108 ../libguestfs-1.11.19/src/guestfs-actions.pod:6129 ../libguestfs-1.11.19/src/guestfs-actions.pod:6148 ../libguestfs-1.11.19/src/guestfs-actions.pod:6167 ../libguestfs-1.11.19/src/guestfs-actions.pod:6197 ../libguestfs-1.11.19/src/guestfs-actions.pod:6215 ../libguestfs-1.11.19/src/guestfs-actions.pod:6238 ../libguestfs-1.11.19/src/guestfs-actions.pod:6256 ../libguestfs-1.11.19/src/guestfs-actions.pod:6275 ../libguestfs-1.11.19/src/guestfs-actions.pod:6296 ../libguestfs-1.11.19/src/guestfs-actions.pod:6315 ../libguestfs-1.11.19/src/guestfs-actions.pod:6332 ../libguestfs-1.11.19/src/guestfs-actions.pod:6351 ../libguestfs-1.11.19/src/guestfs-actions.pod:6379 ../libguestfs-1.11.19/src/guestfs-actions.pod:6403 ../libguestfs-1.11.19/src/guestfs-actions.pod:6422 ../libguestfs-1.11.19/src/guestfs-actions.pod:6446 ../libguestfs-1.11.19/src/guestfs-actions.pod:6465 ../libguestfs-1.11.19/src/guestfs-actions.pod:6480 ../libguestfs-1.11.19/src/guestfs-actions.pod:6499 ../libguestfs-1.11.19/src/guestfs-actions.pod:6536 ../libguestfs-1.11.19/src/guestfs-actions.pod:6566 ../libguestfs-1.11.19/src/guestfs-actions.pod:6599 ../libguestfs-1.11.19/src/guestfs-actions.pod:6721 ../libguestfs-1.11.19/src/guestfs-actions.pod:6842 ../libguestfs-1.11.19/src/guestfs-actions.pod:6854 ../libguestfs-1.11.19/src/guestfs-actions.pod:6867 ../libguestfs-1.11.19/src/guestfs-actions.pod:6880 ../libguestfs-1.11.19/src/guestfs-actions.pod:6902 ../libguestfs-1.11.19/src/guestfs-actions.pod:6915 ../libguestfs-1.11.19/src/guestfs-actions.pod:6928 ../libguestfs-1.11.19/src/guestfs-actions.pod:6941 ../libguestfs-1.11.19/src/guestfs-actions.pod:6956 ../libguestfs-1.11.19/src/guestfs-actions.pod:7015 ../libguestfs-1.11.19/src/guestfs-actions.pod:7032 ../libguestfs-1.11.19/src/guestfs-actions.pod:7048 ../libguestfs-1.11.19/src/guestfs-actions.pod:7064 ../libguestfs-1.11.19/src/guestfs-actions.pod:7081 ../libguestfs-1.11.19/src/guestfs-actions.pod:7094 ../libguestfs-1.11.19/src/guestfs-actions.pod:7114 ../libguestfs-1.11.19/src/guestfs-actions.pod:7150 ../libguestfs-1.11.19/src/guestfs-actions.pod:7164 ../libguestfs-1.11.19/src/guestfs-actions.pod:7205 ../libguestfs-1.11.19/src/guestfs-actions.pod:7218 ../libguestfs-1.11.19/src/guestfs-actions.pod:7236 ../libguestfs-1.11.19/src/guestfs-actions.pod:7270 ../libguestfs-1.11.19/src/guestfs-actions.pod:7306 ../libguestfs-1.11.19/src/guestfs-actions.pod:7422 ../libguestfs-1.11.19/src/guestfs-actions.pod:7437 ../libguestfs-1.11.19/src/guestfs-actions.pod:7451 ../libguestfs-1.11.19/src/guestfs-actions.pod:7506 ../libguestfs-1.11.19/src/guestfs-actions.pod:7519 ../libguestfs-1.11.19/src/guestfs-actions.pod:7564 ../libguestfs-1.11.19/src/guestfs-actions.pod:7597 ../libguestfs-1.11.19/src/guestfs-actions.pod:7660 ../libguestfs-1.11.19/src/guestfs-actions.pod:7680 ../libguestfs-1.11.19/src/guestfs-actions.pod:7706 ../libguestfs-1.11.19/src/guestfs-actions.pod:7773 ../libguestfs-1.11.19/src/guestfs-actions.pod:7792 ../libguestfs-1.11.19/src/guestfs-actions.pod:7821 ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:858 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1214 ../src/guestfs-actions.pod:1234 ../src/guestfs-actions.pod:1304 ../src/guestfs-actions.pod:1335 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1757 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:2341 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:3661 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4151 ../src/guestfs-actions.pod:4170 ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:4253 ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:4314 ../src/guestfs-actions.pod:4407 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4491 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4543 ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:4623 ../src/guestfs-actions.pod:4693 ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:4907 ../src/guestfs-actions.pod:4942 ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5065 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5160 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:5460 ../src/guestfs-actions.pod:5517 ../src/guestfs-actions.pod:5539 ../src/guestfs-actions.pod:5557 ../src/guestfs-actions.pod:5589 ../src/guestfs-actions.pod:5655 ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5685 ../src/guestfs-actions.pod:5699 ../src/guestfs-actions.pod:5988 ../src/guestfs-actions.pod:6007 ../src/guestfs-actions.pod:6026 ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6052 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:6078 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6108 ../src/guestfs-actions.pod:6129 ../src/guestfs-actions.pod:6148 ../src/guestfs-actions.pod:6167 ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6215 ../src/guestfs-actions.pod:6238 ../src/guestfs-actions.pod:6256 ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6296 ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6403 ../src/guestfs-actions.pod:6422 ../src/guestfs-actions.pod:6446 ../src/guestfs-actions.pod:6465 ../src/guestfs-actions.pod:6480 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6536 ../src/guestfs-actions.pod:6566 ../src/guestfs-actions.pod:6599 ../src/guestfs-actions.pod:6721 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6854 ../src/guestfs-actions.pod:6867 ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6902 ../src/guestfs-actions.pod:6915 ../src/guestfs-actions.pod:6928 ../src/guestfs-actions.pod:6941 ../src/guestfs-actions.pod:6956 ../src/guestfs-actions.pod:7015 ../src/guestfs-actions.pod:7032 ../src/guestfs-actions.pod:7048 ../src/guestfs-actions.pod:7064 ../src/guestfs-actions.pod:7081 ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7114 ../src/guestfs-actions.pod:7150 ../src/guestfs-actions.pod:7164 ../src/guestfs-actions.pod:7205 ../src/guestfs-actions.pod:7218 ../src/guestfs-actions.pod:7236 ../src/guestfs-actions.pod:7270 ../src/guestfs-actions.pod:7306 ../src/guestfs-actions.pod:7422 ../src/guestfs-actions.pod:7437 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7506 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7564 ../src/guestfs-actions.pod:7597 ../src/guestfs-actions.pod:7660 ../src/guestfs-actions.pod:7680 ../src/guestfs-actions.pod:7706 ../src/guestfs-actions.pod:7773 ../src/guestfs-actions.pod:7792 ../src/guestfs-actions.pod:7821 +msgid "This function returns 0 on success or -1 on error." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:39 ../libguestfs-1.11.19/src/guestfs-actions.pod:142 ../libguestfs-1.11.19/src/guestfs-actions.pod:1165 ../libguestfs-1.11.19/src/guestfs-actions.pod:1980 ../libguestfs-1.11.19/src/guestfs-actions.pod:2078 ../libguestfs-1.11.19/src/guestfs-actions.pod:2192 ../libguestfs-1.11.19/src/guestfs-actions.pod:3623 ../libguestfs-1.11.19/src/guestfs-actions.pod:3643 ../libguestfs-1.11.19/src/guestfs-actions.pod:4951 ../libguestfs-1.11.19/src/guestfs-actions.pod:6217 ../libguestfs-1.11.19/src/guestfs-actions.pod:6334 ../libguestfs-1.11.19/src/guestfs-actions.pod:6467 ../libguestfs-1.11.19/src/guestfs-actions.pod:6958 ../libguestfs-1.11.19/src/guestfs-actions.pod:7083 ../libguestfs-1.11.19/src/guestfs-actions.pod:7606 ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1165 ../src/guestfs-actions.pod:1980 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2192 ../src/guestfs-actions.pod:3623 ../src/guestfs-actions.pod:3643 ../src/guestfs-actions.pod:4951 ../src/guestfs-actions.pod:6217 ../src/guestfs-actions.pod:6334 ../src/guestfs-actions.pod:6467 ../src/guestfs-actions.pod:6958 ../src/guestfs-actions.pod:7083 ../src/guestfs-actions.pod:7606 +msgid "(Added in 0.3)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:37 -msgid "domain" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:41 ../src/guestfs-actions.pod:41 +msgid "guestfs_add_domain" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:39 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:43 ../src/guestfs-actions.pod:43 #, no-wrap msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] " -"[allowuuid:..]\n" +" int\n" +" guestfs_add_domain (guestfs_h *g,\n" +" const char *dom,\n" +" ...);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:41 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:48 ../libguestfs-1.11.19/src/guestfs-actions.pod:151 ../libguestfs-1.11.19/src/guestfs-actions.pod:832 ../libguestfs-1.11.19/src/guestfs-actions.pod:2826 ../libguestfs-1.11.19/src/guestfs-actions.pod:4642 ../libguestfs-1.11.19/src/guestfs-actions.pod:4961 ../libguestfs-1.11.19/src/guestfs-actions.pod:5178 ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:832 ../src/guestfs-actions.pod:2826 ../src/guestfs-actions.pod:4642 ../src/guestfs-actions.pod:4961 ../src/guestfs-actions.pod:5178 +msgid "" +"You may supply a list of optional arguments to this call. Use zero or more " +"of the following pairs of parameters, and terminate the list with C<-1> on " +"its own. See L</CALLS WITH OPTIONAL ARGUMENTS>." +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:53 ../src/guestfs-actions.pod:53 +#, no-wrap +msgid "" +" GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n" +" GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n" +" GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n" +" GUESTFS_ADD_DOMAIN_LIVE, int live,\n" +" GUESTFS_ADD_DOMAIN_ALLOWUUID, int allowuuid,\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:59 ../src/guestfs-actions.pod:59 msgid "" "This function adds the disk(s) attached to the named libvirt domain C<dom>. " "It works by connecting to libvirt, requesting the domain and domain XML from " -"libvirt, parsing it for disks, and calling L</add-drive-opts> on each one." +"libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each " +"one." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:76 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:94 ../src/guestfs-actions.pod:94 msgid "" "The other optional parameters are passed directly through to " -"L</add-drive-opts>." +"C<guestfs_add_drive_opts>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143 ../fish/guestfish-actions.pod:568 ../fish/guestfish-actions.pod:1968 ../fish/guestfish-actions.pod:3134 ../fish/guestfish-actions.pod:3307 ../fish/guestfish-actions.pod:3442 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:97 ../libguestfs-1.11.19/src/guestfs-actions.pod:350 ../libguestfs-1.11.19/src/guestfs-actions.pod:515 ../libguestfs-1.11.19/src/guestfs-actions.pod:693 ../libguestfs-1.11.19/src/guestfs-actions.pod:724 ../libguestfs-1.11.19/src/guestfs-actions.pod:742 ../libguestfs-1.11.19/src/guestfs-actions.pod:761 ../libguestfs-1.11.19/src/guestfs-actions.pod:1380 ../libguestfs-1.11.19/src/guestfs-actions.pod:1736 ../libguestfs-1.11.19/src/guestfs-actions.pod:1939 ../libguestfs-1.11.19/src/guestfs-actions.pod:2050 ../libguestfs-1.11.19/src/guestfs-actions.pod:2101 ../libguestfs-1.11.19/src/guestfs-actions.pod:2156 ../libguestfs-1.11.19/src/guestfs-actions.pod:2179 ../libguestfs-1.11.19/src/guestfs-actions.pod:2472 ../libguestfs-1.11.19/src/guestfs-actions.pod:2944 ../libguestfs-1.11.19/src/guestfs-actions.pod:2962 ../libguestfs-1.11.19/src/guestfs-actions.pod:5137 ../libguestfs-1.11.19/src/guestfs-actions.pod:5357 ../libguestfs-1.11.19/src/guestfs-actions.pod:5769 ../libguestfs-1.11.19/src/guestfs-actions.pod:5795 ../libguestfs-1.11.19/src/guestfs-actions.pod:7191 ../libguestfs-1.11.19/src/guestfs-actions.pod:7617 ../libguestfs-1.11.19/src/guestfs-actions.pod:7630 ../libguestfs-1.11.19/src/guestfs-actions.pod:7643 ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350 ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:693 ../src/guestfs-actions.pod:724 ../src/guestfs-actions.pod:742 ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:1380 ../src/guestfs-actions.pod:1736 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:2050 ../src/guestfs-actions.pod:2101 ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:2472 ../src/guestfs-actions.pod:2944 ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:5137 ../src/guestfs-actions.pod:5357 ../src/guestfs-actions.pod:5769 ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:7191 ../src/guestfs-actions.pod:7617 ../src/guestfs-actions.pod:7630 ../src/guestfs-actions.pod:7643 +msgid "On error this function returns -1." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:99 ../src/guestfs-actions.pod:99 +msgid "(Added in 1.7.4)" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:101 ../src/guestfs-actions.pod:101 +msgid "guestfs_add_domain_va" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:103 ../src/guestfs-actions.pod:103 +#, no-wrap msgid "" -"This command has one or more optional arguments. See L</OPTIONAL " -"ARGUMENTS>." +" int\n" +" guestfs_add_domain_va (guestfs_h *g,\n" +" const char *dom,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:108 ../src/guestfs-actions.pod:108 +msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:110 ../libguestfs-1.11.19/src/guestfs-actions.pod:121 ../libguestfs-1.11.19/src/guestfs-actions.pod:214 ../libguestfs-1.11.19/src/guestfs-actions.pod:225 ../libguestfs-1.11.19/src/guestfs-actions.pod:871 ../libguestfs-1.11.19/src/guestfs-actions.pod:882 ../libguestfs-1.11.19/src/guestfs-actions.pod:2910 ../libguestfs-1.11.19/src/guestfs-actions.pod:2922 ../libguestfs-1.11.19/src/guestfs-actions.pod:4707 ../libguestfs-1.11.19/src/guestfs-actions.pod:4719 ../libguestfs-1.11.19/src/guestfs-actions.pod:4989 ../libguestfs-1.11.19/src/guestfs-actions.pod:5001 ../libguestfs-1.11.19/src/guestfs-actions.pod:5227 ../libguestfs-1.11.19/src/guestfs-actions.pod:5238 ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225 ../src/guestfs-actions.pod:871 ../src/guestfs-actions.pod:882 ../src/guestfs-actions.pod:2910 ../src/guestfs-actions.pod:2922 ../src/guestfs-actions.pod:4707 ../src/guestfs-actions.pod:4719 ../src/guestfs-actions.pod:4989 ../src/guestfs-actions.pod:5001 ../src/guestfs-actions.pod:5227 ../src/guestfs-actions.pod:5238 +msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:81 -msgid "add-drive" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:112 ../src/guestfs-actions.pod:112 +msgid "guestfs_add_domain_argv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:83 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:114 #, no-wrap msgid "" -" add-drive filename\n" +" int\n" +" guestfs_add_domain_argv (guestfs_h *g,\n" +" const char *dom,\n" +" const struct guestfs_add_domain_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:119 +msgid "This is the \"argv variant\" of L</guestfs_add_domain>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:123 ../src/guestfs-actions.pod:123 +msgid "guestfs_add_drive" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:125 ../src/guestfs-actions.pod:125 +#, no-wrap +msgid "" +" int\n" +" guestfs_add_drive (guestfs_h *g,\n" +" const char *filename);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:85 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:129 ../src/guestfs-actions.pod:129 msgid "" -"This function is the equivalent of calling L</add-drive-opts> with no " +"This function is the equivalent of calling C<guestfs_add_drive_opts> with no " "optional parameters, so the disk is added writable, with the format being " "detected automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:89 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:133 ../src/guestfs-actions.pod:133 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " "RHBZ#642934. Specifying the format closes this security hole. Therefore " "you should think about replacing calls to this function with calls to " -"L</add-drive-opts>, and specifying the format." +"C<guestfs_add_drive_opts>, and specifying the format." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:96 -msgid "add-drive-opts" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:144 ../src/guestfs-actions.pod:144 +msgid "guestfs_add_drive_opts" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:98 -msgid "add" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:146 ../src/guestfs-actions.pod:146 +#, no-wrap +msgid "" +" int\n" +" guestfs_add_drive_opts (guestfs_h *g,\n" +" const char *filename,\n" +" ...);\n" +"\n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:100 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:156 ../src/guestfs-actions.pod:156 #, no-wrap msgid "" -" add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" +" GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n" +" GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n" +" GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:127 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:185 ../src/guestfs-actions.pod:185 msgid "" -"This forces the image format. If you omit this (or use L</add-drive> or " -"L</add-drive-ro>) then the format is automatically detected. Possible " -"formats include C<raw> and C<qcow2>." +"This forces the image format. If you omit this (or use C<guestfs_add_drive> " +"or C<guestfs_add_drive_ro>) then the format is automatically detected. " +"Possible formats include C<raw> and C<qcow2>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:138 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:196 ../src/guestfs-actions.pod:196 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " -"L</add-drive-with-if> call (q.v.)" +"C<guestfs_add_drive_with_if> call (q.v.)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:203 ../src/guestfs-actions.pod:203 +msgid "(Added in 1.5.23)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:145 -msgid "add-drive-ro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:205 ../src/guestfs-actions.pod:205 +msgid "guestfs_add_drive_opts_va" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:207 ../src/guestfs-actions.pod:207 +#, no-wrap +msgid "" +" int\n" +" guestfs_add_drive_opts_va (guestfs_h *g,\n" +" const char *filename,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:212 ../src/guestfs-actions.pod:212 +msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:147 -msgid "add-ro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:216 ../src/guestfs-actions.pod:216 +msgid "guestfs_add_drive_opts_argv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:149 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:218 ../src/guestfs-actions.pod:218 #, no-wrap msgid "" -" add-drive-ro filename\n" +" int\n" +" guestfs_add_drive_opts_argv (guestfs_h *g,\n" +" const char *filename,\n" +" const struct guestfs_add_drive_opts_argv " +"*optargs);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:151 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:223 ../src/guestfs-actions.pod:223 +msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:227 ../src/guestfs-actions.pod:227 +msgid "guestfs_add_drive_ro" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:229 ../src/guestfs-actions.pod:229 +#, no-wrap msgid "" -"This function is the equivalent of calling L</add-drive-opts> with the " -"optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk " -"is added read-only, with the format being detected automatically." +" int\n" +" guestfs_add_drive_ro (guestfs_h *g,\n" +" const char *filename);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:233 ../src/guestfs-actions.pod:233 +msgid "" +"This function is the equivalent of calling C<guestfs_add_drive_opts> with " +"the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the " +"disk is added read-only, with the format being detected automatically." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:240 ../src/guestfs-actions.pod:240 +msgid "(Added in 1.0.38)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:156 -msgid "add-drive-ro-with-if" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:242 ../src/guestfs-actions.pod:242 +msgid "guestfs_add_drive_ro_with_if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:158 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:244 ../src/guestfs-actions.pod:244 #, no-wrap msgid "" -" add-drive-ro-with-if filename iface\n" +" int\n" +" guestfs_add_drive_ro_with_if (guestfs_h *g,\n" +" const char *filename,\n" +" const char *iface);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:160 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:249 ../src/guestfs-actions.pod:249 msgid "" -"This is the same as L</add-drive-ro> but it allows you to specify the QEMU " -"interface emulation to use at run time." +"This is the same as C<guestfs_add_drive_ro> but it allows you to specify the " +"QEMU interface emulation to use at run time." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:261 ../libguestfs-1.11.19/src/guestfs-actions.pod:282 ../libguestfs-1.11.19/src/guestfs-actions.pod:2431 ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282 ../src/guestfs-actions.pod:2431 +msgid "(Added in 1.0.84)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:170 -msgid "add-drive-with-if" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:263 ../src/guestfs-actions.pod:263 +msgid "guestfs_add_drive_with_if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:172 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:265 ../src/guestfs-actions.pod:265 #, no-wrap msgid "" -" add-drive-with-if filename iface\n" +" int\n" +" guestfs_add_drive_with_if (guestfs_h *g,\n" +" const char *filename,\n" +" const char *iface);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:174 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:270 ../src/guestfs-actions.pod:270 msgid "" -"This is the same as L</add-drive> but it allows you to specify the QEMU " -"interface emulation to use at run time." +"This is the same as C<guestfs_add_drive> but it allows you to specify the " +"QEMU interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:184 -msgid "aug-clear" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:284 ../src/guestfs-actions.pod:284 +msgid "guestfs_aug_clear" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:186 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:286 ../src/guestfs-actions.pod:286 #, no-wrap msgid "" -" aug-clear augpath\n" +" int\n" +" guestfs_aug_clear (guestfs_h *g,\n" +" const char *augpath);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:295 ../libguestfs-1.11.19/src/guestfs-actions.pod:2181 ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2181 +msgid "(Added in 1.3.4)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:191 -msgid "aug-close" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:297 ../src/guestfs-actions.pod:297 +msgid "guestfs_aug_close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:193 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:299 ../src/guestfs-actions.pod:299 #, no-wrap msgid "" -" aug-close\n" +" int\n" +" guestfs_aug_close (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:195 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:302 ../src/guestfs-actions.pod:302 msgid "" "Close the current Augeas handle and free up any resources used by it. After " -"calling this, you have to call L</aug-init> again before you can use any " -"other Augeas functions." +"calling this, you have to call C<guestfs_aug_init> again before you can use " +"any other Augeas functions." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:309 ../libguestfs-1.11.19/src/guestfs-actions.pod:334 ../libguestfs-1.11.19/src/guestfs-actions.pod:352 ../libguestfs-1.11.19/src/guestfs-actions.pod:366 ../libguestfs-1.11.19/src/guestfs-actions.pod:424 ../libguestfs-1.11.19/src/guestfs-actions.pod:444 ../libguestfs-1.11.19/src/guestfs-actions.pod:458 ../libguestfs-1.11.19/src/guestfs-actions.pod:489 ../libguestfs-1.11.19/src/guestfs-actions.pod:503 ../libguestfs-1.11.19/src/guestfs-actions.pod:517 ../libguestfs-1.11.19/src/guestfs-actions.pod:531 ../libguestfs-1.11.19/src/guestfs-actions.pod:549 ../libguestfs-1.11.19/src/guestfs-actions.pod:5846 ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366 ../src/guestfs-actions.pod:424 ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:5846 +msgid "(Added in 0.7)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:200 -msgid "aug-defnode" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:311 ../src/guestfs-actions.pod:311 +msgid "guestfs_aug_defnode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:202 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:313 #, no-wrap msgid "" -" aug-defnode name expr val\n" +" struct guestfs_int_bool *\n" +" guestfs_aug_defnode (guestfs_h *g,\n" +" const char *name,\n" +" const char *expr,\n" +" const char *val);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:207 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:322 ../src/guestfs-actions.pod:322 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " -"calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset " +"calling C<guestfs_aug_set> C<expr>, C<value>. C<name> will be the nodeset " "containing that single node." msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:330 ../src/guestfs-actions.pod:330 +msgid "" +"This function returns a C<struct guestfs_int_bool *>, or NULL if there was " +"an error. I<The caller must call C<guestfs_free_int_bool> after use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:215 -msgid "aug-defvar" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:336 ../src/guestfs-actions.pod:336 +msgid "guestfs_aug_defvar" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:217 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:338 #, no-wrap msgid "" -" aug-defvar name expr\n" +" int\n" +" guestfs_aug_defvar (guestfs_h *g,\n" +" const char *name,\n" +" const char *expr);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:226 -msgid "aug-get" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:354 ../src/guestfs-actions.pod:354 +msgid "guestfs_aug_get" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:228 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:356 ../src/guestfs-actions.pod:356 #, no-wrap msgid "" -" aug-get augpath\n" +" char *\n" +" guestfs_aug_get (guestfs_h *g,\n" +" const char *augpath);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:363 ../libguestfs-1.11.19/src/guestfs-actions.pod:922 ../libguestfs-1.11.19/src/guestfs-actions.pod:940 ../libguestfs-1.11.19/src/guestfs-actions.pod:1000 ../libguestfs-1.11.19/src/guestfs-actions.pod:1016 ../libguestfs-1.11.19/src/guestfs-actions.pod:1119 ../libguestfs-1.11.19/src/guestfs-actions.pod:1249 ../libguestfs-1.11.19/src/guestfs-actions.pod:1266 ../libguestfs-1.11.19/src/guestfs-actions.pod:1285 ../libguestfs-1.11.19/src/guestfs-actions.pod:1419 ../libguestfs-1.11.19/src/guestfs-actions.pod:1607 ../libguestfs-1.11.19/src/guestfs-actions.pod:1719 ../libguestfs-1.11.19/src/guestfs-actions.pod:1882 ../libguestfs-1.11.19/src/guestfs-actions.pod:1899 ../libguestfs-1.11.19/src/guestfs-actions.pod:1966 ../libguestfs-1.11.19/src/guestfs-actions.pod:2002 ../libguestfs-1.11.19/src/guestfs-actions.pod:2023 ../libguestfs-1.11.19/src/guestfs-actions.pod:2204 ../libguestfs-1.11.19/src/guestfs-actions.pod:2396 ../libguestfs-1.11.19/src/guestfs-actions.pod:2600 ../libguestfs-1.11.19/src/guestfs-actions.pod:2690 ../libguestfs-1.11.19/src/guestfs-actions.pod:2794 ../libguestfs-1.11.19/src/guestfs-actions.pod:2813 ../libguestfs-1.11.19/src/guestfs-actions.pod:3027 ../libguestfs-1.11.19/src/guestfs-actions.pod:3055 ../libguestfs-1.11.19/src/guestfs-actions.pod:3076 ../libguestfs-1.11.19/src/guestfs-actions.pod:3110 ../libguestfs-1.11.19/src/guestfs-actions.pod:3169 ../libguestfs-1.11.19/src/guestfs-actions.pod:3189 ../libguestfs-1.11.19/src/guestfs-actions.pod:3209 ../libguestfs-1.11.19/src/guestfs-actions.pod:3836 ../libguestfs-1.11.19/src/guestfs-actions.pod:4189 ../libguestfs-1.11.19/src/guestfs-actions.pod:4359 ../libguestfs-1.11.19/src/guestfs-actions.pod:4469 ../libguestfs-1.11.19/src/guestfs-actions.pod:5375 ../libguestfs-1.11.19/src/guestfs-actions.pod:5574 ../libguestfs-1.11.19/src/guestfs-actions.pod:5744 ../libguestfs-1.11.19/src/guestfs-actions.pod:5922 ../libguestfs-1.11.19/src/guestfs-actions.pod:5971 ../libguestfs-1.11.19/src/guestfs-actions.pod:6627 ../libguestfs-1.11.19/src/guestfs-actions.pod:6643 ../libguestfs-1.11.19/src/guestfs-actions.pod:6660 ../libguestfs-1.11.19/src/guestfs-actions.pod:6691 ../libguestfs-1.11.19/src/guestfs-actions.pod:7365 ../libguestfs-1.11.19/src/guestfs-actions.pod:7384 ../libguestfs-1.11.19/src/guestfs-actions.pod:7402 ../libguestfs-1.11.19/src/guestfs-actions.pod:7576 ../libguestfs-1.11.19/src/guestfs-actions.pod:7878 ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:922 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1249 ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:2023 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2396 ../src/guestfs-actions.pod:2600 ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3055 ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3169 ../src/guestfs-actions.pod:3189 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3836 ../src/guestfs-actions.pod:4189 ../src/guestfs-actions.pod:4359 ../src/guestfs-actions.pod:4469 ../src/guestfs-actions.pod:5375 ../src/guestfs-actions.pod:5574 ../src/guestfs-actions.pod:5744 ../src/guestfs-actions.pod:5922 ../src/guestfs-actions.pod:5971 ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6643 ../src/guestfs-actions.pod:6660 ../src/guestfs-actions.pod:6691 ../src/guestfs-actions.pod:7365 ../src/guestfs-actions.pod:7384 ../src/guestfs-actions.pod:7402 ../src/guestfs-actions.pod:7576 ../src/guestfs-actions.pod:7878 +msgid "" +"This function returns a string, or NULL on error. I<The caller must free " +"the returned string after use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:233 -msgid "aug-init" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:368 ../src/guestfs-actions.pod:368 +msgid "guestfs_aug_init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:235 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:370 ../src/guestfs-actions.pod:370 #, no-wrap msgid "" -" aug-init root flags\n" +" int\n" +" guestfs_aug_init (guestfs_h *g,\n" +" const char *root,\n" +" int flags);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:241 -msgid "You must call this before using any other L</aug-*> commands." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:379 ../src/guestfs-actions.pod:379 +msgid "You must call this before using any other C<guestfs_aug_*> commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:276 -msgid "Do not load the tree in L</aug-init>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:414 ../src/guestfs-actions.pod:414 +msgid "Do not load the tree in C<guestfs_aug_init>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:280 -msgid "To close the handle, you can call L</aug-close>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:418 +msgid "To close the handle, you can call C<guestfs_aug_close>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:284 -msgid "aug-insert" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:426 ../src/guestfs-actions.pod:426 +msgid "guestfs_aug_insert" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:286 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:428 ../src/guestfs-actions.pod:428 #, no-wrap msgid "" -" aug-insert augpath label true|false\n" +" int\n" +" guestfs_aug_insert (guestfs_h *g,\n" +" const char *augpath,\n" +" const char *label,\n" +" int before);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:296 -msgid "aug-load" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:446 ../src/guestfs-actions.pod:446 +msgid "guestfs_aug_load" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:298 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:448 ../src/guestfs-actions.pod:448 #, no-wrap msgid "" -" aug-load\n" +" int\n" +" guestfs_aug_load (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:305 -msgid "aug-ls" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:460 ../src/guestfs-actions.pod:460 +msgid "guestfs_aug_ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:307 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:462 ../src/guestfs-actions.pod:462 #, no-wrap msgid "" -" aug-ls augpath\n" +" char **\n" +" guestfs_aug_ls (guestfs_h *g,\n" +" const char *augpath);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:309 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:466 ../src/guestfs-actions.pod:466 msgid "" -"This is just a shortcut for listing L</aug-match> C<path/*> and sorting the " -"resulting nodes into alphabetical order." +"This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and " +"sorting the resulting nodes into alphabetical order." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:469 ../libguestfs-1.11.19/src/guestfs-actions.pod:485 ../libguestfs-1.11.19/src/guestfs-actions.pod:631 ../libguestfs-1.11.19/src/guestfs-actions.pod:1138 ../libguestfs-1.11.19/src/guestfs-actions.pod:1434 ../libguestfs-1.11.19/src/guestfs-actions.pod:1453 ../libguestfs-1.11.19/src/guestfs-actions.pod:1556 ../libguestfs-1.11.19/src/guestfs-actions.pod:1575 ../libguestfs-1.11.19/src/guestfs-actions.pod:1821 ../libguestfs-1.11.19/src/guestfs-actions.pod:2276 ../libguestfs-1.11.19/src/guestfs-actions.pod:2292 ../libguestfs-1.11.19/src/guestfs-actions.pod:2311 ../libguestfs-1.11.19/src/guestfs-actions.pod:2354 ../libguestfs-1.11.19/src/guestfs-actions.pod:2378 ../libguestfs-1.11.19/src/guestfs-actions.pod:2449 ../libguestfs-1.11.19/src/guestfs-actions.pod:2498 ../libguestfs-1.11.19/src/guestfs-actions.pod:2755 ../libguestfs-1.11.19/src/guestfs-actions.pod:3129 ../libguestfs-1.11.19/src/guestfs-actions.pod:3405 ../libguestfs-1.11.19/src/guestfs-actions.pod:3719 ../libguestfs-1.11.19/src/guestfs-actions.pod:3736 ../libguestfs-1.11.19/src/guestfs-actions.pod:3756 ../libguestfs-1.11.19/src/guestfs-actions.pod:3818 ../libguestfs-1.11.19/src/guestfs-actions.pod:3923 ../libguestfs-1.11.19/src/guestfs-actions.pod:4331 ../libguestfs-1.11.19/src/guestfs-actions.pod:5098 ../libguestfs-1.11.19/src/guestfs-actions.pod:5716 ../libguestfs-1.11.19/src/guestfs-actions.pod:5842 ../libguestfs-1.11.19/src/guestfs-actions.pod:5956 ../libguestfs-1.11.19/src/guestfs-actions.pod:6707 ../libguestfs-1.11.19/src/guestfs-actions.pod:6768 ../libguestfs-1.11.19/src/guestfs-actions.pod:6823 ../libguestfs-1.11.19/src/guestfs-actions.pod:6969 ../libguestfs-1.11.19/src/guestfs-actions.pod:6993 ../libguestfs-1.11.19/src/guestfs-actions.pod:7469 ../libguestfs-1.11.19/src/guestfs-actions.pod:7489 ../libguestfs-1.11.19/src/guestfs-actions.pod:7536 ../libguestfs-1.11.19/src/guestfs-actions.pod:7730 ../libguestfs-1.11.19/src/guestfs-actions.pod:7749 ../libguestfs-1.11.19/src/guestfs-actions.pod:7835 ../libguestfs-1.11.19/src/guestfs-actions.pod:7854 ../libguestfs-1.11.19/src/guestfs-actions.pod:7900 ../libguestfs-1.11.19/src/guestfs-actions.pod:7919 ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:485 ../src/guestfs-actions.pod:631 ../src/guestfs-actions.pod:1138 ../src/guestfs-actions.pod:1434 ../src/guestfs-actions.pod:1453 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:1575 ../src/guestfs-actions.pod:1821 ../src/guestfs-actions.pod:2276 ../src/guestfs-actions.pod:2292 ../src/guestfs-actions.pod:2311 ../src/guestfs-actions.pod:2354 ../src/guestfs-actions.pod:2378 ../src/guestfs-actions.pod:2449 ../src/guestfs-actions.pod:2498 ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:3129 ../src/guestfs-actions.pod:3405 ../src/guestfs-actions.pod:3719 ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3756 ../src/guestfs-actions.pod:3818 ../src/guestfs-actions.pod:3923 ../src/guestfs-actions.pod:4331 ../src/guestfs-actions.pod:5098 ../src/guestfs-actions.pod:5716 ../src/guestfs-actions.pod:5842 ../src/guestfs-actions.pod:5956 ../src/guestfs-actions.pod:6707 ../src/guestfs-actions.pod:6768 ../src/guestfs-actions.pod:6823 ../src/guestfs-actions.pod:6969 ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7469 ../src/guestfs-actions.pod:7489 ../src/guestfs-actions.pod:7536 ../src/guestfs-actions.pod:7730 ../src/guestfs-actions.pod:7749 ../src/guestfs-actions.pod:7835 ../src/guestfs-actions.pod:7854 ../src/guestfs-actions.pod:7900 ../src/guestfs-actions.pod:7919 +msgid "" +"This function returns a NULL-terminated array of strings (like " +"L<environ(3)>), or NULL if there was an error. I<The caller must free the " +"strings and the array after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:473 ../libguestfs-1.11.19/src/guestfs-actions.pod:1063 ../libguestfs-1.11.19/src/guestfs-actions.pod:1081 ../libguestfs-1.11.19/src/guestfs-actions.pod:1491 ../libguestfs-1.11.19/src/guestfs-actions.pod:3483 ../libguestfs-1.11.19/src/guestfs-actions.pod:3514 ../libguestfs-1.11.19/src/guestfs-actions.pod:4172 ../libguestfs-1.11.19/src/guestfs-actions.pod:4222 ../libguestfs-1.11.19/src/guestfs-actions.pod:4409 ../libguestfs-1.11.19/src/guestfs-actions.pod:4442 ../libguestfs-1.11.19/src/guestfs-actions.pod:4605 ../libguestfs-1.11.19/src/guestfs-actions.pod:5102 ../libguestfs-1.11.19/src/guestfs-actions.pod:5657 ../libguestfs-1.11.19/src/guestfs-actions.pod:6054 ../libguestfs-1.11.19/src/guestfs-actions.pod:6068 ../libguestfs-1.11.19/src/guestfs-actions.pod:6080 ../libguestfs-1.11.19/src/guestfs-actions.pod:6548 ../libguestfs-1.11.19/src/guestfs-actions.pod:7207 ../libguestfs-1.11.19/src/guestfs-actions.pod:7220 ../libguestfs-1.11.19/src/guestfs-actions.pod:7453 ../libguestfs-1.11.19/src/guestfs-actions.pod:7718 ../src/guestfs-actions.pod:473 ../src/guestfs-actions.pod:1063 ../src/guestfs-actions.pod:1081 ../src/guestfs-actions.pod:1491 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:3514 ../src/guestfs-actions.pod:4172 ../src/guestfs-actions.pod:4222 ../src/guestfs-actions.pod:4409 ../src/guestfs-actions.pod:4442 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:5102 ../src/guestfs-actions.pod:5657 ../src/guestfs-actions.pod:6054 ../src/guestfs-actions.pod:6068 ../src/guestfs-actions.pod:6080 ../src/guestfs-actions.pod:6548 ../src/guestfs-actions.pod:7207 ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7453 ../src/guestfs-actions.pod:7718 +msgid "(Added in 0.8)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:312 -msgid "aug-match" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:475 ../src/guestfs-actions.pod:475 +msgid "guestfs_aug_match" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:314 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:477 ../src/guestfs-actions.pod:477 #, no-wrap msgid "" -" aug-match augpath\n" +" char **\n" +" guestfs_aug_match (guestfs_h *g,\n" +" const char *augpath);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:320 -msgid "aug-mv" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:491 ../src/guestfs-actions.pod:491 +msgid "guestfs_aug_mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:322 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:493 ../src/guestfs-actions.pod:493 #, no-wrap msgid "" -" aug-mv src dest\n" +" int\n" +" guestfs_aug_mv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:327 -msgid "aug-rm" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:505 ../src/guestfs-actions.pod:505 +msgid "guestfs_aug_rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:329 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:507 ../src/guestfs-actions.pod:507 #, no-wrap msgid "" -" aug-rm augpath\n" +" int\n" +" guestfs_aug_rm (guestfs_h *g,\n" +" const char *augpath);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:335 -msgid "aug-save" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:519 ../src/guestfs-actions.pod:519 +msgid "guestfs_aug_save" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:337 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:521 ../src/guestfs-actions.pod:521 #, no-wrap msgid "" -" aug-save\n" +" int\n" +" guestfs_aug_save (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:341 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:526 ../src/guestfs-actions.pod:526 msgid "" -"The flags which were passed to L</aug-init> affect exactly how files are " -"saved." +"The flags which were passed to C<guestfs_aug_init> affect exactly how files " +"are saved." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:344 -msgid "aug-set" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:533 ../src/guestfs-actions.pod:533 +msgid "guestfs_aug_set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:346 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:535 ../src/guestfs-actions.pod:535 #, no-wrap msgid "" -" aug-set augpath val\n" +" int\n" +" guestfs_aug_set (guestfs_h *g,\n" +" const char *augpath,\n" +" const char *val);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:350 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:542 ../src/guestfs-actions.pod:542 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " -"this call. Instead you must use the L</aug-clear> call." +"this call. Instead you must use the C<guestfs_aug_clear> call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:355 -msgid "available" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:551 ../src/guestfs-actions.pod:551 +msgid "guestfs_available" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:357 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:553 ../src/guestfs-actions.pod:553 #, no-wrap msgid "" -" available 'groups ...'\n" +" int\n" +" guestfs_available (guestfs_h *g,\n" +" char *const *groups);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:363 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:561 ../src/guestfs-actions.pod:561 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " -"runtime by calling L</available-all-groups>." +"runtime by calling C<guestfs_available_all_groups>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:387 -msgid "You must call L</launch> before calling this function." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:585 +msgid "You must call C<guestfs_launch> before calling this function." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:409 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:607 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " -"find out if the daemon implemented it. See also L</version>." +"find out if the daemon implemented it. See also C<guestfs_version>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:616 ../libguestfs-1.11.19/src/guestfs-actions.pod:1236 ../src/guestfs-actions.pod:616 ../src/guestfs-actions.pod:1236 +msgid "(Added in 1.0.80)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:416 -msgid "available-all-groups" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:618 ../src/guestfs-actions.pod:618 +msgid "guestfs_available_all_groups" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:418 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:620 ../src/guestfs-actions.pod:620 #, no-wrap msgid "" -" available-all-groups\n" +" char **\n" +" guestfs_available_all_groups (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:420 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:623 ../src/guestfs-actions.pod:623 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " "out which ones the daemon can actually support you have to call " -"L</available> on each member of the returned list." +"C<guestfs_available> on each member of the returned list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:426 -msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:629 ../src/guestfs-actions.pod:629 +msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:635 ../src/guestfs-actions.pod:635 +msgid "(Added in 1.3.15)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:428 -msgid "base64-in" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:637 ../src/guestfs-actions.pod:637 +msgid "guestfs_base64_in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:430 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:639 ../src/guestfs-actions.pod:639 #, no-wrap msgid "" -" base64-in (base64file|-) filename\n" +" int\n" +" guestfs_base64_in (guestfs_h *g,\n" +" const char *base64file,\n" +" const char *filename);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444 ../fish/guestfish-actions.pod:693 ../fish/guestfish-actions.pod:862 ../fish/guestfish-actions.pod:881 ../fish/guestfish-actions.pod:1255 ../fish/guestfish-actions.pod:4652 ../fish/guestfish-actions.pod:4664 ../fish/guestfish-actions.pod:4675 ../fish/guestfish-actions.pod:4686 ../fish/guestfish-actions.pod:4738 ../fish/guestfish-actions.pod:4747 ../fish/guestfish-actions.pod:4801 ../fish/guestfish-actions.pod:4824 -msgid "Use C<-> instead of a filename to read/write from stdin/stdout." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:649 ../libguestfs-1.11.19/src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:663 +msgid "(Added in 1.3.5)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:437 -msgid "base64-out" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:651 ../src/guestfs-actions.pod:651 +msgid "guestfs_base64_out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:439 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:653 ../src/guestfs-actions.pod:653 #, no-wrap msgid "" -" base64-out filename (base64file|-)\n" +" int\n" +" guestfs_base64_out (guestfs_h *g,\n" +" const char *filename,\n" +" const char *base64file);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:446 -msgid "blockdev-flushbufs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:665 ../src/guestfs-actions.pod:665 +msgid "guestfs_blockdev_flushbufs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:448 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:667 ../src/guestfs-actions.pod:667 #, no-wrap msgid "" -" blockdev-flushbufs device\n" +" int\n" +" guestfs_blockdev_flushbufs (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:678 ../libguestfs-1.11.19/src/guestfs-actions.pod:695 ../libguestfs-1.11.19/src/guestfs-actions.pod:710 ../libguestfs-1.11.19/src/guestfs-actions.pod:726 ../libguestfs-1.11.19/src/guestfs-actions.pod:744 ../libguestfs-1.11.19/src/guestfs-actions.pod:763 ../libguestfs-1.11.19/src/guestfs-actions.pod:777 ../libguestfs-1.11.19/src/guestfs-actions.pod:795 ../libguestfs-1.11.19/src/guestfs-actions.pod:809 ../libguestfs-1.11.19/src/guestfs-actions.pod:823 ../src/guestfs-actions.pod:678 ../src/guestfs-actions.pod:695 ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:726 ../src/guestfs-actions.pod:744 ../src/guestfs-actions.pod:763 ../src/guestfs-actions.pod:777 ../src/guestfs-actions.pod:795 ../src/guestfs-actions.pod:809 ../src/guestfs-actions.pod:823 +msgid "(Added in 0.9.3)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:455 -msgid "blockdev-getbsz" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:680 ../src/guestfs-actions.pod:680 +msgid "guestfs_blockdev_getbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:457 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:682 #, no-wrap msgid "" -" blockdev-getbsz device\n" +" int\n" +" guestfs_blockdev_getbsz (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:466 -msgid "blockdev-getro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:697 ../src/guestfs-actions.pod:697 +msgid "guestfs_blockdev_getro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:468 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:699 ../src/guestfs-actions.pod:699 #, no-wrap msgid "" -" blockdev-getro device\n" +" int\n" +" guestfs_blockdev_getro (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:708 ../libguestfs-1.11.19/src/guestfs-actions.pod:1474 ../libguestfs-1.11.19/src/guestfs-actions.pod:1489 ../libguestfs-1.11.19/src/guestfs-actions.pod:1978 ../libguestfs-1.11.19/src/guestfs-actions.pod:1989 ../libguestfs-1.11.19/src/guestfs-actions.pod:2061 ../libguestfs-1.11.19/src/guestfs-actions.pod:2087 ../libguestfs-1.11.19/src/guestfs-actions.pod:2127 ../libguestfs-1.11.19/src/guestfs-actions.pod:2142 ../libguestfs-1.11.19/src/guestfs-actions.pod:2167 ../libguestfs-1.11.19/src/guestfs-actions.pod:2190 ../libguestfs-1.11.19/src/guestfs-actions.pod:3226 ../libguestfs-1.11.19/src/guestfs-actions.pod:3242 ../libguestfs-1.11.19/src/guestfs-actions.pod:3260 ../libguestfs-1.11.19/src/guestfs-actions.pod:3422 ../libguestfs-1.11.19/src/guestfs-actions.pod:3436 ../libguestfs-1.11.19/src/guestfs-actions.pod:3451 ../libguestfs-1.11.19/src/guestfs-actions.pod:3465 ../libguestfs-1.11.19/src/guestfs-actions.pod:3481 ../libguestfs-1.11.19/src/guestfs-actions.pod:3496 ../libguestfs-1.11.19/src/guestfs-actions.pod:3512 ../libguestfs-1.11.19/src/guestfs-actions.pod:3526 ../libguestfs-1.11.19/src/guestfs-actions.pod:3539 ../libguestfs-1.11.19/src/guestfs-actions.pod:3553 ../libguestfs-1.11.19/src/guestfs-actions.pod:3568 ../libguestfs-1.11.19/src/guestfs-actions.pod:3583 ../libguestfs-1.11.19/src/guestfs-actions.pod:3596 ../libguestfs-1.11.19/src/guestfs-actions.pod:3610 ../libguestfs-1.11.19/src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:708 ../src/guestfs-actions.pod:1474 ../src/guestfs-actions.pod:1489 ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:1989 ../src/guestfs-actions.pod:2061 ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:2142 ../src/guestfs-actions.pod:2167 ../src/guestfs-actions.pod:2190 ../src/guestfs-actions.pod:3226 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3260 ../src/guestfs-actions.pod:3422 ../src/guestfs-actions.pod:3436 ../src/guestfs-actions.pod:3451 ../src/guestfs-actions.pod:3465 ../src/guestfs-actions.pod:3481 ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3512 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3539 ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:3568 ../src/guestfs-actions.pod:3583 ../src/guestfs-actions.pod:3596 ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:5339 +msgid "This function returns a C truth value on success or -1 on error." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:475 -msgid "blockdev-getsize64" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:712 ../src/guestfs-actions.pod:712 +msgid "guestfs_blockdev_getsize64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:477 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:714 ../src/guestfs-actions.pod:714 #, no-wrap msgid "" -" blockdev-getsize64 device\n" +" int64_t\n" +" guestfs_blockdev_getsize64 (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:481 -msgid "See also L</blockdev-getsz>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:720 ../src/guestfs-actions.pod:720 +msgid "See also C<guestfs_blockdev_getsz>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:485 -msgid "blockdev-getss" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:728 ../src/guestfs-actions.pod:728 +msgid "guestfs_blockdev_getss" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:487 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:730 ../src/guestfs-actions.pod:730 #, no-wrap msgid "" -" blockdev-getss device\n" +" int\n" +" guestfs_blockdev_getss (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:492 -msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:737 ../src/guestfs-actions.pod:737 +msgid "" +"(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for " +"that)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:497 -msgid "blockdev-getsz" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:746 ../src/guestfs-actions.pod:746 +msgid "guestfs_blockdev_getsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:499 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:748 ../src/guestfs-actions.pod:748 #, no-wrap msgid "" -" blockdev-getsz device\n" +" int64_t\n" +" guestfs_blockdev_getsz (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:504 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:755 msgid "" -"See also L</blockdev-getss> for the real sector size of the device, and " -"L</blockdev-getsize64> for the more useful I<size in bytes>." +"See also C<guestfs_blockdev_getss> for the real sector size of the device, " +"and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:510 -msgid "blockdev-rereadpt" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:765 ../src/guestfs-actions.pod:765 +msgid "guestfs_blockdev_rereadpt" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:512 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:767 #, no-wrap msgid "" -" blockdev-rereadpt device\n" +" int\n" +" guestfs_blockdev_rereadpt (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:518 -msgid "blockdev-setbsz" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:779 ../src/guestfs-actions.pod:779 +msgid "guestfs_blockdev_setbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:520 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:781 ../src/guestfs-actions.pod:781 #, no-wrap msgid "" -" blockdev-setbsz device blocksize\n" +" int\n" +" guestfs_blockdev_setbsz (guestfs_h *g,\n" +" const char *device,\n" +" int blocksize);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:529 -msgid "blockdev-setro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:797 ../src/guestfs-actions.pod:797 +msgid "guestfs_blockdev_setro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:531 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:799 #, no-wrap msgid "" -" blockdev-setro device\n" +" int\n" +" guestfs_blockdev_setro (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:537 -msgid "blockdev-setrw" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:811 ../src/guestfs-actions.pod:811 +msgid "guestfs_blockdev_setrw" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:539 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:813 ../src/guestfs-actions.pod:813 #, no-wrap msgid "" -" blockdev-setrw device\n" +" int\n" +" guestfs_blockdev_setrw (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:545 -msgid "btrfs-filesystem-resize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:825 ../src/guestfs-actions.pod:825 +msgid "guestfs_btrfs_filesystem_resize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:547 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:827 ../src/guestfs-actions.pod:827 #, no-wrap msgid "" -" btrfs-filesystem-resize mountpoint [size:..]\n" +" int\n" +" guestfs_btrfs_filesystem_resize (guestfs_h *g,\n" +" const char *mountpoint,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:837 ../src/guestfs-actions.pod:837 +#, no-wrap +msgid "" +" GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:860 +msgid "(Added in 1.11.17)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:570 -msgid "case-sensitive-path" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:862 ../src/guestfs-actions.pod:862 +msgid "guestfs_btrfs_filesystem_resize_va" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:572 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:864 ../src/guestfs-actions.pod:864 #, no-wrap msgid "" -" case-sensitive-path path\n" +" int\n" +" guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n" +" const char *mountpoint,\n" +" va_list args);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:596 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:869 ../src/guestfs-actions.pod:869 +msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:873 +msgid "guestfs_btrfs_filesystem_resize_argv" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:875 +#, no-wrap msgid "" -"Thus L</case-sensitive-path> (\"/Windows/System32\") might return " +" int\n" +" guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n" +" const char *mountpoint,\n" +" const struct " +"guestfs_btrfs_filesystem_resize_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:880 ../src/guestfs-actions.pod:880 +msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:884 ../src/guestfs-actions.pod:884 +msgid "guestfs_case_sensitive_path" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:886 ../src/guestfs-actions.pod:886 +#, no-wrap +msgid "" +" char *\n" +" guestfs_case_sensitive_path (guestfs_h *g,\n" +" const char *path);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:912 ../src/guestfs-actions.pod:912 +msgid "" +"Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " "how the directories were originally created under Windows)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:604 -msgid "See also L</realpath>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:920 ../src/guestfs-actions.pod:920 +msgid "See also C<guestfs_realpath>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:925 ../libguestfs-1.11.19/src/guestfs-actions.pod:7387 ../src/guestfs-actions.pod:925 ../src/guestfs-actions.pod:7387 +msgid "(Added in 1.0.75)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:606 -msgid "cat" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:927 ../src/guestfs-actions.pod:927 +msgid "guestfs_cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:608 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:929 ../src/guestfs-actions.pod:929 #, no-wrap msgid "" -" cat path\n" +" char *\n" +" guestfs_cat (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:612 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:935 ../src/guestfs-actions.pod:935 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " -"those you need to use the L</read-file> or L</download> functions which have " -"a more complex interface." +"those you need to use the C<guestfs_read_file> or C<guestfs_download> " +"functions which have a more complex interface." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:946 ../libguestfs-1.11.19/src/guestfs-actions.pod:3740 ../libguestfs-1.11.19/src/guestfs-actions.pod:3822 ../libguestfs-1.11.19/src/guestfs-actions.pod:3839 ../libguestfs-1.11.19/src/guestfs-actions.pod:3927 ../libguestfs-1.11.19/src/guestfs-actions.pod:4335 ../libguestfs-1.11.19/src/guestfs-actions.pod:4349 ../libguestfs-1.11.19/src/guestfs-actions.pod:5720 ../libguestfs-1.11.19/src/guestfs-actions.pod:5734 ../libguestfs-1.11.19/src/guestfs-actions.pod:7540 ../libguestfs-1.11.19/src/guestfs-actions.pod:7554 ../src/guestfs-actions.pod:946 ../src/guestfs-actions.pod:3740 ../src/guestfs-actions.pod:3822 ../src/guestfs-actions.pod:3839 ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:4335 ../src/guestfs-actions.pod:4349 ../src/guestfs-actions.pod:5720 ../src/guestfs-actions.pod:5734 ../src/guestfs-actions.pod:7540 ../src/guestfs-actions.pod:7554 +msgid "(Added in 0.4)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:620 -msgid "checksum" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:948 +msgid "guestfs_checksum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:622 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:950 ../src/guestfs-actions.pod:950 #, no-wrap msgid "" -" checksum csumtype path\n" +" char *\n" +" guestfs_checksum (guestfs_h *g,\n" +" const char *csumtype,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:665 -msgid "To get the checksum for a device, use L</checksum-device>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:996 ../src/guestfs-actions.pod:996 +msgid "To get the checksum for a device, use C<guestfs_checksum_device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:667 -msgid "To get the checksums for many files, use L</checksums-out>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:998 ../src/guestfs-actions.pod:998 +msgid "To get the checksums for many files, use C<guestfs_checksums_out>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1003 ../libguestfs-1.11.19/src/guestfs-actions.pod:1311 ../libguestfs-1.11.19/src/guestfs-actions.pod:2158 ../libguestfs-1.11.19/src/guestfs-actions.pod:3438 ../libguestfs-1.11.19/src/guestfs-actions.pod:3467 ../libguestfs-1.11.19/src/guestfs-actions.pod:3528 ../libguestfs-1.11.19/src/guestfs-actions.pod:3555 ../libguestfs-1.11.19/src/guestfs-actions.pod:7243 ../src/guestfs-actions.pod:1003 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:2158 ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:3528 ../src/guestfs-actions.pod:3555 ../src/guestfs-actions.pod:7243 +msgid "(Added in 1.0.2)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:669 -msgid "checksum-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1005 ../src/guestfs-actions.pod:1005 +msgid "guestfs_checksum_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:671 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1007 ../src/guestfs-actions.pod:1007 #, no-wrap msgid "" -" checksum-device csumtype device\n" +" char *\n" +" guestfs_checksum_device (guestfs_h *g,\n" +" const char *csumtype,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:673 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1012 ../src/guestfs-actions.pod:1012 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C<device>. For the types of checksums supported see the " -"L</checksum> command." +"C<guestfs_checksum> command." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1019 ../libguestfs-1.11.19/src/guestfs-actions.pod:5169 ../libguestfs-1.11.19/src/guestfs-actions.pod:5304 ../libguestfs-1.11.19/src/guestfs-actions.pod:5341 ../libguestfs-1.11.19/src/guestfs-actions.pod:5359 ../libguestfs-1.11.19/src/guestfs-actions.pod:5541 ../libguestfs-1.11.19/src/guestfs-actions.pod:7152 ../libguestfs-1.11.19/src/guestfs-actions.pod:7166 ../libguestfs-1.11.19/src/guestfs-actions.pod:7566 ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:5169 ../src/guestfs-actions.pod:5304 ../src/guestfs-actions.pod:5341 ../src/guestfs-actions.pod:5359 ../src/guestfs-actions.pod:5541 ../src/guestfs-actions.pod:7152 ../src/guestfs-actions.pod:7166 ../src/guestfs-actions.pod:7566 +msgid "(Added in 1.3.2)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:677 -msgid "checksums-out" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1021 +msgid "guestfs_checksums_out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:679 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1023 ../src/guestfs-actions.pod:1023 #, no-wrap msgid "" -" checksums-out csumtype directory (sumsfile|-)\n" +" int\n" +" guestfs_checksums_out (guestfs_h *g,\n" +" const char *csumtype,\n" +" const char *directory,\n" +" const char *sumsfile);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1043 ../src/guestfs-actions.pod:1043 +msgid "(Added in 1.3.7)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:695 -msgid "chmod" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1045 ../src/guestfs-actions.pod:1045 +msgid "guestfs_chmod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:697 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1047 ../src/guestfs-actions.pod:1047 #, no-wrap msgid "" -" chmod mode path\n" +" int\n" +" guestfs_chmod (guestfs_h *g,\n" +" int mode,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:708 -msgid "chown" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1065 ../src/guestfs-actions.pod:1065 +msgid "guestfs_chown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:710 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1067 ../src/guestfs-actions.pod:1067 #, no-wrap msgid "" -" chown owner group path\n" +" int\n" +" guestfs_chown (guestfs_h *g,\n" +" int owner,\n" +" int group,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:718 -msgid "command" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1083 ../src/guestfs-actions.pod:1083 +msgid "guestfs_command" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:720 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1085 ../src/guestfs-actions.pod:1085 #, no-wrap msgid "" -" command 'arguments ...'\n" +" char *\n" +" guestfs_command (guestfs_h *g,\n" +" char *const *arguments);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:727 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1094 ../src/guestfs-actions.pod:1094 msgid "" "The single parameter is an argv-style list of arguments. The first element " "is the name of the program to run. Subsequent elements are parameters. The " "list must be non-empty (ie. must contain a program name). Note that the " -"command runs directly, and is I<not> invoked via the shell (see L</sh>)." +"command runs directly, and is I<not> invoked via the shell (see " +"C<guestfs_sh>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1125 ../libguestfs-1.11.19/src/guestfs-actions.pod:1145 ../libguestfs-1.11.19/src/guestfs-actions.pod:1610 ../src/guestfs-actions.pod:1125 ../src/guestfs-actions.pod:1145 ../src/guestfs-actions.pod:1610 +msgid "(Added in 0.9.1)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:755 -msgid "command-lines" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1127 ../src/guestfs-actions.pod:1127 +msgid "guestfs_command_lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:757 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:1129 #, no-wrap msgid "" -" command-lines 'arguments ...'\n" +" char **\n" +" guestfs_command_lines (guestfs_h *g,\n" +" char *const *arguments);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:759 -msgid "This is the same as L</command>, but splits the result into a list of lines." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:1133 +msgid "" +"This is the same as C<guestfs_command>, but splits the result into a list of " +"lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:762 -msgid "See also: L</sh-lines>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1136 ../src/guestfs-actions.pod:1136 +msgid "See also: C<guestfs_sh_lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:767 -msgid "config" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1147 ../src/guestfs-actions.pod:1147 +msgid "guestfs_config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:769 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1149 #, no-wrap msgid "" -" config qemuparam qemuvalue\n" +" int\n" +" guestfs_config (guestfs_h *g,\n" +" const char *qemuparam,\n" +" const char *qemuvalue);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:780 -msgid "copy-size" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1167 ../src/guestfs-actions.pod:1167 +msgid "guestfs_copy_size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:782 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1169 ../src/guestfs-actions.pod:1169 #, no-wrap msgid "" -" copy-size src dest size\n" +" int\n" +" guestfs_copy_size (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest,\n" +" int64_t size);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1183 ../libguestfs-1.11.19/src/guestfs-actions.pod:1306 ../libguestfs-1.11.19/src/guestfs-actions.pod:1337 ../libguestfs-1.11.19/src/guestfs-actions.pod:1382 ../libguestfs-1.11.19/src/guestfs-actions.pod:1759 ../libguestfs-1.11.19/src/guestfs-actions.pod:1781 ../libguestfs-1.11.19/src/guestfs-actions.pod:3638 ../libguestfs-1.11.19/src/guestfs-actions.pod:7238 ../libguestfs-1.11.19/src/guestfs-actions.pod:7272 ../libguestfs-1.11.19/src/guestfs-actions.pod:7775 ../libguestfs-1.11.19/src/guestfs-actions.pod:7794 ../src/guestfs-actions.pod:1183 ../src/guestfs-actions.pod:1306 ../src/guestfs-actions.pod:1337 ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:1781 ../src/guestfs-actions.pod:3638 ../src/guestfs-actions.pod:7238 ../src/guestfs-actions.pod:7272 ../src/guestfs-actions.pod:7775 ../src/guestfs-actions.pod:7794 +msgid "" +"This long-running command can generate progress notification messages so " +"that the caller can display a progress bar or indicator. To receive these " +"messages, the caller must register a progress event callback. See " +"L<guestfs(3)/GUESTFS_EVENT_PROGRESS>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1188 ../libguestfs-1.11.19/src/guestfs-actions.pod:4362 ../libguestfs-1.11.19/src/guestfs-actions.pod:5747 ../libguestfs-1.11.19/src/guestfs-actions.pod:7473 ../libguestfs-1.11.19/src/guestfs-actions.pod:7493 ../libguestfs-1.11.19/src/guestfs-actions.pod:7579 ../src/guestfs-actions.pod:1188 ../src/guestfs-actions.pod:4362 ../src/guestfs-actions.pod:5747 ../src/guestfs-actions.pod:7473 ../src/guestfs-actions.pod:7493 ../src/guestfs-actions.pod:7579 +msgid "(Added in 1.0.87)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:790 -msgid "cp" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1190 ../src/guestfs-actions.pod:1190 +msgid "guestfs_cp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:792 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1192 ../src/guestfs-actions.pod:1192 #, no-wrap msgid "" -" cp src dest\n" +" int\n" +" guestfs_cp (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1202 ../libguestfs-1.11.19/src/guestfs-actions.pod:1216 ../libguestfs-1.11.19/src/guestfs-actions.pod:1288 ../libguestfs-1.11.19/src/guestfs-actions.pod:1362 ../libguestfs-1.11.19/src/guestfs-actions.pod:1476 ../libguestfs-1.11.19/src/guestfs-actions.pod:5116 ../libguestfs-1.11.19/src/guestfs-actions.pod:5591 ../src/guestfs-actions.pod:1202 ../src/guestfs-actions.pod:1216 ../src/guestfs-actions.pod:1288 ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:1476 ../src/guestfs-actions.pod:5116 ../src/guestfs-actions.pod:5591 +msgid "(Added in 1.0.18)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:797 -msgid "cp-a" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1204 ../src/guestfs-actions.pod:1204 +msgid "guestfs_cp_a" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:799 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1206 ../src/guestfs-actions.pod:1206 #, no-wrap msgid "" -" cp-a src dest\n" +" int\n" +" guestfs_cp_a (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:804 -msgid "dd" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1218 ../src/guestfs-actions.pod:1218 +msgid "guestfs_dd" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:806 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1220 #, no-wrap msgid "" -" dd src dest\n" +" int\n" +" guestfs_dd (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:813 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1230 ../src/guestfs-actions.pod:1230 msgid "" "If the destination is a device, it must be as large or larger than the " "source file or device, otherwise the copy will fail. This command cannot do " -"partial copies (see L</copy-size>)." +"partial copies (see C<guestfs_copy_size>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:817 -msgid "df" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1238 +msgid "guestfs_df" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:819 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1240 ../src/guestfs-actions.pod:1240 #, no-wrap msgid "" -" df\n" +" char *\n" +" guestfs_df (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:823 ../fish/guestfish-actions.pod:834 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1245 ../libguestfs-1.11.19/src/guestfs-actions.pod:1262 ../src/guestfs-actions.pod:1245 ../src/guestfs-actions.pod:1262 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " -"intended that you try to parse the output string. Use L</statvfs> from " -"programs." +"intended that you try to parse the output string. Use C<guestfs_statvfs> " +"from programs." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1252 ../libguestfs-1.11.19/src/guestfs-actions.pod:1269 ../libguestfs-1.11.19/src/guestfs-actions.pod:1387 ../libguestfs-1.11.19/src/guestfs-actions.pod:2361 ../libguestfs-1.11.19/src/guestfs-actions.pod:2385 ../libguestfs-1.11.19/src/guestfs-actions.pod:2453 ../libguestfs-1.11.19/src/guestfs-actions.pod:4472 ../libguestfs-1.11.19/src/guestfs-actions.pod:5016 ../libguestfs-1.11.19/src/guestfs-actions.pod:6976 ../libguestfs-1.11.19/src/guestfs-actions.pod:7000 ../libguestfs-1.11.19/src/guestfs-actions.pod:7619 ../libguestfs-1.11.19/src/guestfs-actions.pod:7632 ../libguestfs-1.11.19/src/guestfs-actions.pod:7645 ../src/guestfs-actions.pod:1252 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:2361 ../src/guestfs-actions.pod:2385 ../src/guestfs-actions.pod:2453 ../src/guestfs-actions.pod:4472 ../src/guestfs-actions.pod:5016 ../src/guestfs-actions.pod:6976 ../src/guestfs-actions.pod:7000 ../src/guestfs-actions.pod:7619 ../src/guestfs-actions.pod:7632 ../src/guestfs-actions.pod:7645 +msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:827 -msgid "df-h" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1254 ../src/guestfs-actions.pod:1254 +msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:829 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1256 ../src/guestfs-actions.pod:1256 #, no-wrap msgid "" -" df-h\n" +" char *\n" +" guestfs_df_h (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:838 -msgid "dmesg" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1271 ../src/guestfs-actions.pod:1271 +msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:840 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1273 ../src/guestfs-actions.pod:1273 #, no-wrap msgid "" -" dmesg\n" +" char *\n" +" guestfs_dmesg (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:846 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1280 ../src/guestfs-actions.pod:1280 msgid "" "Another way to get the same information is to enable verbose messages with " -"L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> " -"before running the program." +"C<guestfs_set_verbose> or by setting the environment variable " +"C<LIBGUESTFS_DEBUG=1> before running the program." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:851 -msgid "download" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1290 ../src/guestfs-actions.pod:1290 +msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:853 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1292 ../src/guestfs-actions.pod:1292 #, no-wrap msgid "" -" download remotefilename (filename|-)\n" +" int\n" +" guestfs_download (guestfs_h *g,\n" +" const char *remotefilename,\n" +" const char *filename);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:860 -msgid "See also L</upload>, L</cat>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1302 ../src/guestfs-actions.pod:1302 +msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:864 -msgid "download-offset" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1313 ../src/guestfs-actions.pod:1313 +msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:866 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1315 ../src/guestfs-actions.pod:1315 #, no-wrap msgid "" -" download-offset remotefilename (filename|-) offset size\n" +" int\n" +" guestfs_download_offset (guestfs_h *g,\n" +" const char *remotefilename,\n" +" const char *filename,\n" +" int64_t offset,\n" +" int64_t size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:874 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1328 ../src/guestfs-actions.pod:1328 msgid "" "Note that there is no limit on the amount of data that can be downloaded " -"with this call, unlike with L</pread>, and this call always reads the full " -"amount unless an error occurs." +"with this call, unlike with C<guestfs_pread>, and this call always reads the " +"full amount unless an error occurs." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:879 -msgid "See also L</download>, L</pread>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1333 ../src/guestfs-actions.pod:1333 +msgid "See also C<guestfs_download>, C<guestfs_pread>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1342 ../libguestfs-1.11.19/src/guestfs-actions.pod:7277 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:7277 +msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:883 -msgid "drop-caches" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1344 ../src/guestfs-actions.pod:1344 +msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:885 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1346 ../src/guestfs-actions.pod:1346 #, no-wrap msgid "" -" drop-caches whattodrop\n" +" int\n" +" guestfs_drop_caches (guestfs_h *g,\n" +" int whattodrop);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:897 -msgid "du" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:1364 +msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:899 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1366 ../src/guestfs-actions.pod:1366 #, no-wrap msgid "" -" du path\n" +" int64_t\n" +" guestfs_du (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:911 -msgid "e2fsck-f" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1389 ../src/guestfs-actions.pod:1389 +msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:913 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1391 ../src/guestfs-actions.pod:1391 #, no-wrap msgid "" -" e2fsck-f device\n" +" int\n" +" guestfs_e2fsck_f (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:919 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1399 ../src/guestfs-actions.pod:1399 msgid "" -"This command is only needed because of L</resize2fs> (q.v.). Normally you " -"should use L</fsck>." +"This command is only needed because of C<guestfs_resize2fs> (q.v.). " +"Normally you should use C<guestfs_fsck>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1404 ../src/guestfs-actions.pod:1404 +msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:922 -msgid "echo-daemon" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1406 ../src/guestfs-actions.pod:1406 +msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:924 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1408 ../src/guestfs-actions.pod:1408 #, no-wrap msgid "" -" echo-daemon 'words ...'\n" +" char *\n" +" guestfs_echo_daemon (guestfs_h *g,\n" +" char *const *words);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:931 -msgid "See also L</ping-daemon>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:1417 +msgid "See also C<guestfs_ping_daemon>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1422 ../libguestfs-1.11.19/src/guestfs-actions.pod:2169 ../libguestfs-1.11.19/src/guestfs-actions.pod:6448 ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:2169 ../src/guestfs-actions.pod:6448 +msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:933 -msgid "egrep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1424 ../src/guestfs-actions.pod:1424 +msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:935 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1426 ../src/guestfs-actions.pod:1426 #, no-wrap msgid "" -" egrep regex path\n" +" char **\n" +" guestfs_egrep (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1441 ../libguestfs-1.11.19/src/guestfs-actions.pod:1460 ../libguestfs-1.11.19/src/guestfs-actions.pod:1517 ../libguestfs-1.11.19/src/guestfs-actions.pod:1563 ../libguestfs-1.11.19/src/guestfs-actions.pod:1582 ../libguestfs-1.11.19/src/guestfs-actions.pod:2299 ../libguestfs-1.11.19/src/guestfs-actions.pod:2318 ../libguestfs-1.11.19/src/guestfs-actions.pod:2474 ../libguestfs-1.11.19/src/guestfs-actions.pod:2487 ../libguestfs-1.11.19/src/guestfs-actions.pod:2502 ../libguestfs-1.11.19/src/guestfs-actions.pod:2548 ../libguestfs-1.11.19/src/guestfs-actions.pod:2570 ../libguestfs-1.11.19/src/guestfs-actions.pod:2583 ../libguestfs-1.11.19/src/guestfs-actions.pod:3852 ../libguestfs-1.11.19/src/guestfs-actions.pod:3866 ../libguestfs-1.11.19/src/guestfs-actions.pod:3879 ../libguestfs-1.11.19/src/guestfs-actions.pod:3893 ../libguestfs-1.11.19/src/guestfs-actions.pod:4894 ../libguestfs-1.11.19/src/guestfs-actions.pod:5925 ../libguestfs-1.11.19/src/guestfs-actions.pod:5974 ../libguestfs-1.11.19/src/guestfs-actions.pod:6844 ../libguestfs-1.11.19/src/guestfs-actions.pod:6856 ../libguestfs-1.11.19/src/guestfs-actions.pod:6869 ../libguestfs-1.11.19/src/guestfs-actions.pod:6882 ../libguestfs-1.11.19/src/guestfs-actions.pod:6904 ../libguestfs-1.11.19/src/guestfs-actions.pod:6917 ../libguestfs-1.11.19/src/guestfs-actions.pod:6930 ../libguestfs-1.11.19/src/guestfs-actions.pod:6943 ../libguestfs-1.11.19/src/guestfs-actions.pod:7737 ../libguestfs-1.11.19/src/guestfs-actions.pod:7756 ../libguestfs-1.11.19/src/guestfs-actions.pod:7842 ../libguestfs-1.11.19/src/guestfs-actions.pod:7861 ../libguestfs-1.11.19/src/guestfs-actions.pod:7907 ../libguestfs-1.11.19/src/guestfs-actions.pod:7926 ../src/guestfs-actions.pod:1441 ../src/guestfs-actions.pod:1460 ../src/guestfs-actions.pod:1517 ../src/guestfs-actions.pod:1563 ../src/guestfs-actions.pod:1582 ../src/guestfs-actions.pod:2299 ../src/guestfs-actions.pod:2318 ../src/guestfs-actions.pod:2474 ../src/guestfs-actions.pod:2487 ../src/guestfs-actions.pod:2502 ../src/guestfs-actions.pod:2548 ../src/guestfs-actions.pod:2570 ../src/guestfs-actions.pod:2583 ../src/guestfs-actions.pod:3852 ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:3879 ../src/guestfs-actions.pod:3893 ../src/guestfs-actions.pod:4894 ../src/guestfs-actions.pod:5925 ../src/guestfs-actions.pod:5974 ../src/guestfs-actions.pod:6844 ../src/guestfs-actions.pod:6856 ../src/guestfs-actions.pod:6869 ../src/guestfs-actions.pod:6882 ../src/guestfs-actions.pod:6904 ../src/guestfs-actions.pod:6917 ../src/guestfs-actions.pod:6930 ../src/guestfs-actions.pod:6943 ../src/guestfs-actions.pod:7737 ../src/guestfs-actions.pod:7756 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7861 ../src/guestfs-actions.pod:7907 ../src/guestfs-actions.pod:7926 +msgid "(Added in 1.0.66)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:943 -msgid "egrepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1443 ../src/guestfs-actions.pod:1443 +msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:945 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1445 ../src/guestfs-actions.pod:1445 #, no-wrap msgid "" -" egrepi regex path\n" +" char **\n" +" guestfs_egrepi (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:953 -msgid "equal" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1462 ../src/guestfs-actions.pod:1462 +msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:955 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1464 #, no-wrap msgid "" -" equal file1 file2\n" +" int\n" +" guestfs_equal (guestfs_h *g,\n" +" const char *file1,\n" +" const char *file2);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:962 -msgid "exists" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1478 ../src/guestfs-actions.pod:1478 +msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:964 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1480 ../src/guestfs-actions.pod:1480 #, no-wrap msgid "" -" exists path\n" +" int\n" +" guestfs_exists (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:969 -msgid "See also L</is-file>, L</is-dir>, L</stat>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1487 ../src/guestfs-actions.pod:1487 +msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:971 -msgid "fallocate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1493 ../src/guestfs-actions.pod:1493 +msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:973 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1495 ../src/guestfs-actions.pod:1495 #, no-wrap msgid "" -" fallocate path len\n" +" int\n" +" guestfs_fallocate (guestfs_h *g,\n" +" const char *path,\n" +" int len);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:990 -msgid "fallocate64" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1519 +msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:992 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1521 ../src/guestfs-actions.pod:1521 #, no-wrap msgid "" -" fallocate64 path len\n" +" int\n" +" guestfs_fallocate64 (guestfs_h *g,\n" +" const char *path,\n" +" int64_t len);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:998 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1530 ../src/guestfs-actions.pod:1530 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " -"file use L</truncate-size> instead." +"file use C<guestfs_truncate_size> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1001 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1533 ../src/guestfs-actions.pod:1533 msgid "" -"The deprecated call L</fallocate> does the same, but owing to an oversight " -"it only allowed 30 bit lengths to be specified, effectively limiting the " -"maximum size of files created through that call to 1GB." +"The deprecated call C<guestfs_fallocate> does the same, but owing to an " +"oversight it only allowed 30 bit lengths to be specified, effectively " +"limiting the maximum size of files created through that call to 1GB." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1544 ../src/guestfs-actions.pod:1544 +msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1010 -msgid "fgrep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1546 ../src/guestfs-actions.pod:1546 +msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1012 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1548 ../src/guestfs-actions.pod:1548 #, no-wrap msgid "" -" fgrep pattern path\n" +" char **\n" +" guestfs_fgrep (guestfs_h *g,\n" +" const char *pattern,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1020 -msgid "fgrepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1565 ../src/guestfs-actions.pod:1565 +msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1022 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1567 ../src/guestfs-actions.pod:1567 #, no-wrap msgid "" -" fgrepi pattern path\n" +" char **\n" +" guestfs_fgrepi (guestfs_h *g,\n" +" const char *pattern,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1030 -msgid "file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:1584 +msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1032 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1586 ../src/guestfs-actions.pod:1586 #, no-wrap msgid "" -" file path\n" +" char *\n" +" guestfs_file (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1048 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1604 ../src/guestfs-actions.pod:1604 msgid "" -"See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> " -"(etc), L</is-zero>." +"See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, " +"C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1051 -msgid "file-architecture" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1612 ../src/guestfs-actions.pod:1612 +msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1053 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1614 ../src/guestfs-actions.pod:1614 #, no-wrap msgid "" -" file-architecture filename\n" +" char *\n" +" guestfs_file_architecture (guestfs_h *g,\n" +" const char *filename);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1722 ../libguestfs-1.11.19/src/guestfs-actions.pod:1885 ../libguestfs-1.11.19/src/guestfs-actions.pod:1902 ../libguestfs-1.11.19/src/guestfs-actions.pod:2603 ../libguestfs-1.11.19/src/guestfs-actions.pod:2693 ../libguestfs-1.11.19/src/guestfs-actions.pod:2759 ../libguestfs-1.11.19/src/guestfs-actions.pod:2946 ../libguestfs-1.11.19/src/guestfs-actions.pod:2964 ../libguestfs-1.11.19/src/guestfs-actions.pod:3004 ../libguestfs-1.11.19/src/guestfs-actions.pod:3079 ../libguestfs-1.11.19/src/guestfs-actions.pod:3172 ../libguestfs-1.11.19/src/guestfs-actions.pod:3409 ../libguestfs-1.11.19/src/guestfs-actions.pod:3541 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1885 ../src/guestfs-actions.pod:1902 ../src/guestfs-actions.pod:2603 ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2759 ../src/guestfs-actions.pod:2946 ../src/guestfs-actions.pod:2964 ../src/guestfs-actions.pod:3004 ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:3172 ../src/guestfs-actions.pod:3409 ../src/guestfs-actions.pod:3541 +msgid "(Added in 1.5.3)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1156 -msgid "filesize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1724 ../src/guestfs-actions.pod:1724 +msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1158 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1726 ../src/guestfs-actions.pod:1726 #, no-wrap msgid "" -" filesize file\n" +" int64_t\n" +" guestfs_filesize (guestfs_h *g,\n" +" const char *file);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1162 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1732 ../src/guestfs-actions.pod:1732 msgid "" -"To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, " -"L</is-file> etc. To get the size of block devices, use " -"L</blockdev-getsize64>." +"To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " +"C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " +"devices, use C<guestfs_blockdev_getsize64>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1738 ../src/guestfs-actions.pod:1738 +msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1166 -msgid "fill" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1740 ../src/guestfs-actions.pod:1740 +msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1168 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1742 ../src/guestfs-actions.pod:1742 #, no-wrap msgid "" -" fill c len path\n" +" int\n" +" guestfs_fill (guestfs_h *g,\n" +" int c,\n" +" int len,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1174 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1752 ../src/guestfs-actions.pod:1752 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " -"L</truncate-size>. To create a file with a pattern of repeating bytes use " -"L</fill-pattern>." +"C<guestfs_truncate_size>. To create a file with a pattern of repeating " +"bytes use C<guestfs_fill_pattern>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1764 ../src/guestfs-actions.pod:1764 +msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1179 -msgid "fill-pattern" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1766 ../src/guestfs-actions.pod:1766 +msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1181 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:1768 #, no-wrap msgid "" -" fill-pattern pattern len path\n" +" int\n" +" guestfs_fill_pattern (guestfs_h *g,\n" +" const char *pattern,\n" +" int len,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1183 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1774 ../src/guestfs-actions.pod:1774 msgid "" -"This function is like L</fill> except that it creates a new file of length " -"C<len> containing the repeating pattern of bytes in C<pattern>. The pattern " -"is truncated if necessary to ensure the length of the file is exactly C<len> " -"bytes." +"This function is like C<guestfs_fill> except that it creates a new file of " +"length C<len> containing the repeating pattern of bytes in C<pattern>. The " +"pattern is truncated if necessary to ensure the length of the file is " +"exactly C<len> bytes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1786 +msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1188 -msgid "find" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1788 +msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1190 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1790 ../src/guestfs-actions.pod:1790 #, no-wrap msgid "" -" find directory\n" +" char **\n" +" guestfs_find (guestfs_h *g,\n" +" const char *directory);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1204 -msgid "then the returned list from L</find> C</tmp> would be 4 elements:" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:1806 +msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1217 -msgid "See also L</find0>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:1819 +msgid "See also C<guestfs_find0>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1828 ../libguestfs-1.11.19/src/guestfs-actions.pod:4299 ../libguestfs-1.11.19/src/guestfs-actions.pod:6009 ../src/guestfs-actions.pod:1828 ../src/guestfs-actions.pod:4299 ../src/guestfs-actions.pod:6009 +msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1222 -msgid "find0" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1830 ../src/guestfs-actions.pod:1830 +msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1224 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1832 ../src/guestfs-actions.pod:1832 #, no-wrap msgid "" -" find0 directory (files|-)\n" +" int\n" +" guestfs_find0 (guestfs_h *g,\n" +" const char *directory,\n" +" const char *files);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1230 -msgid "This command works the same way as L</find> with the following exceptions:" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1841 ../src/guestfs-actions.pod:1841 +msgid "" +"This command works the same way as C<guestfs_find> with the following " +"exceptions:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1868 ../src/guestfs-actions.pod:1868 +msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1257 -msgid "findfs-label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1870 ../src/guestfs-actions.pod:1870 +msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1259 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1872 ../src/guestfs-actions.pod:1872 #, no-wrap msgid "" -" findfs-label label\n" +" char *\n" +" guestfs_findfs_label (guestfs_h *g,\n" +" const char *label);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1265 -msgid "To find the label of a filesystem, use L</vfs-label>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1880 ../src/guestfs-actions.pod:1880 +msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1267 -msgid "findfs-uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1887 ../src/guestfs-actions.pod:1887 +msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1269 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1889 ../src/guestfs-actions.pod:1889 #, no-wrap msgid "" -" findfs-uuid uuid\n" +" char *\n" +" guestfs_findfs_uuid (guestfs_h *g,\n" +" const char *uuid);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1275 -msgid "To find the UUID of a filesystem, use L</vfs-uuid>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:1897 +msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1277 -msgid "fsck" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:1904 +msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1279 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1906 #, no-wrap msgid "" -" fsck fstype device\n" +" int\n" +" guestfs_fsck (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1941 ../libguestfs-1.11.19/src/guestfs-actions.pod:7780 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:7780 +msgid "(Added in 1.0.16)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1309 -msgid "get-append" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:1943 +msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1311 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1945 ../src/guestfs-actions.pod:1945 #, no-wrap msgid "" -" get-append\n" +" const char *\n" +" guestfs_get_append (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1953 ../src/guestfs-actions.pod:1953 +msgid "" +"This function returns a string which may be NULL. There is no way to return " +"an error from this function. The string is owned by the guest handle and " +"must I<not> be freed." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1957 ../libguestfs-1.11.19/src/guestfs-actions.pod:5687 ../libguestfs-1.11.19/src/guestfs-actions.pod:6169 ../libguestfs-1.11.19/src/guestfs-actions.pod:6611 ../libguestfs-1.11.19/src/guestfs-actions.pod:6630 ../libguestfs-1.11.19/src/guestfs-actions.pod:6646 ../libguestfs-1.11.19/src/guestfs-actions.pod:6670 ../libguestfs-1.11.19/src/guestfs-actions.pod:7424 ../libguestfs-1.11.19/src/guestfs-actions.pod:7439 ../libguestfs-1.11.19/src/guestfs-actions.pod:7823 ../src/guestfs-actions.pod:1957 ../src/guestfs-actions.pod:5687 ../src/guestfs-actions.pod:6169 ../src/guestfs-actions.pod:6611 ../src/guestfs-actions.pod:6630 ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6670 ../src/guestfs-actions.pod:7424 ../src/guestfs-actions.pod:7439 ../src/guestfs-actions.pod:7823 +msgid "(Added in 1.0.26)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1318 -msgid "get-attach-method" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:1959 +msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1320 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1961 ../src/guestfs-actions.pod:1961 #, no-wrap msgid "" -" get-attach-method\n" +" char *\n" +" guestfs_get_attach_method (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1322 -msgid "Return the current attach method. See L</set-attach-method>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1964 ../src/guestfs-actions.pod:1964 +msgid "Return the current attach method. See C<guestfs_set_attach_method>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1969 ../libguestfs-1.11.19/src/guestfs-actions.pod:6199 ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:6199 +msgid "(Added in 1.9.8)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1324 -msgid "get-autosync" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:1971 +msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1326 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1973 ../src/guestfs-actions.pod:1973 #, no-wrap msgid "" -" get-autosync\n" +" int\n" +" guestfs_get_autosync (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1330 -msgid "get-direct" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1982 ../src/guestfs-actions.pod:1982 +msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1332 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1984 ../src/guestfs-actions.pod:1984 #, no-wrap msgid "" -" get-direct\n" +" int\n" +" guestfs_get_direct (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1991 ../libguestfs-1.11.19/src/guestfs-actions.pod:6240 ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:6240 +msgid "(Added in 1.0.72)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1336 -msgid "get-e2label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1993 ../src/guestfs-actions.pod:1993 +msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1338 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:1995 ../src/guestfs-actions.pod:1995 #, no-wrap msgid "" -" get-e2label device\n" +" char *\n" +" guestfs_get_e2label (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2012 ../libguestfs-1.11.19/src/guestfs-actions.pod:2033 ../libguestfs-1.11.19/src/guestfs-actions.pod:6258 ../libguestfs-1.11.19/src/guestfs-actions.pod:6277 ../src/guestfs-actions.pod:2012 ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:6258 ../src/guestfs-actions.pod:6277 +msgid "(Added in 1.0.15)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1350 -msgid "get-e2uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2014 ../src/guestfs-actions.pod:2014 +msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1352 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2016 ../src/guestfs-actions.pod:2016 #, no-wrap msgid "" -" get-e2uuid device\n" +" char *\n" +" guestfs_get_e2uuid (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1364 -msgid "get-memsize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2035 ../src/guestfs-actions.pod:2035 +msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1366 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2037 #, no-wrap msgid "" -" get-memsize\n" +" int\n" +" guestfs_get_memsize (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1371 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2043 ../src/guestfs-actions.pod:2043 msgid "" -"If L</set-memsize> was not called on this handle, and if " +"If C<guestfs_set_memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " "value for memsize." msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2052 ../libguestfs-1.11.19/src/guestfs-actions.pod:4590 ../libguestfs-1.11.19/src/guestfs-actions.pod:4799 ../libguestfs-1.11.19/src/guestfs-actions.pod:4818 ../libguestfs-1.11.19/src/guestfs-actions.pod:4837 ../libguestfs-1.11.19/src/guestfs-actions.pod:4849 ../libguestfs-1.11.19/src/guestfs-actions.pod:4866 ../libguestfs-1.11.19/src/guestfs-actions.pod:4879 ../libguestfs-1.11.19/src/guestfs-actions.pod:5912 ../libguestfs-1.11.19/src/guestfs-actions.pod:6298 ../libguestfs-1.11.19/src/guestfs-actions.pod:6578 ../libguestfs-1.11.19/src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:4590 ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4818 ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:4849 ../src/guestfs-actions.pod:4866 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:5912 ../src/guestfs-actions.pod:6298 ../src/guestfs-actions.pod:6578 ../src/guestfs-actions.pod:7193 +msgid "(Added in 1.0.55)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1378 -msgid "get-network" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2054 +msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1380 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2056 ../src/guestfs-actions.pod:2056 #, no-wrap msgid "" -" get-network\n" +" int\n" +" guestfs_get_network (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2063 ../libguestfs-1.11.19/src/guestfs-actions.pod:6317 ../src/guestfs-actions.pod:2063 ../src/guestfs-actions.pod:6317 +msgid "(Added in 1.5.4)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1384 -msgid "get-path" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2065 ../src/guestfs-actions.pod:2065 +msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1386 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2067 ../src/guestfs-actions.pod:2067 #, no-wrap msgid "" -" get-path\n" +" const char *\n" +" guestfs_get_path (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2075 ../libguestfs-1.11.19/src/guestfs-actions.pod:2115 ../src/guestfs-actions.pod:2075 ../src/guestfs-actions.pod:2115 +msgid "" +"This function returns a string, or NULL on error. The string is owned by " +"the guest handle and must I<not> be freed." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1393 -msgid "get-pgroup" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2080 ../src/guestfs-actions.pod:2080 +msgid "guestfs_get_pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1395 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2082 ../src/guestfs-actions.pod:2082 #, no-wrap msgid "" -" get-pgroup\n" +" int\n" +" guestfs_get_pgroup (guestfs_h *g);\n" "\n" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1399 -msgid "get-pid" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2089 ../libguestfs-1.11.19/src/guestfs-actions.pod:6353 ../libguestfs-1.11.19/src/guestfs-actions.pod:7685 ../src/guestfs-actions.pod:2089 ../src/guestfs-actions.pod:6353 ../src/guestfs-actions.pod:7685 +msgid "(Added in 1.11.18)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1401 -msgid "pid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2091 ../src/guestfs-actions.pod:2091 +msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1403 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2093 ../src/guestfs-actions.pod:2093 #, no-wrap msgid "" -" get-pid\n" +" int\n" +" guestfs_get_pid (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2103 ../src/guestfs-actions.pod:2103 +msgid "(Added in 1.0.56)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1410 -msgid "get-qemu" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2105 ../src/guestfs-actions.pod:2105 +msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1412 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2107 ../src/guestfs-actions.pod:2107 #, no-wrap msgid "" -" get-qemu\n" +" const char *\n" +" guestfs_get_qemu (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2118 ../libguestfs-1.11.19/src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:2118 ../src/guestfs-actions.pod:6381 +msgid "(Added in 1.0.6)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1419 -msgid "get-recovery-proc" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2120 ../src/guestfs-actions.pod:2120 +msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1421 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2122 ../src/guestfs-actions.pod:2122 #, no-wrap msgid "" -" get-recovery-proc\n" +" int\n" +" guestfs_get_recovery_proc (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2129 ../libguestfs-1.11.19/src/guestfs-actions.pod:3663 ../libguestfs-1.11.19/src/guestfs-actions.pod:3994 ../libguestfs-1.11.19/src/guestfs-actions.pod:4397 ../libguestfs-1.11.19/src/guestfs-actions.pod:4429 ../libguestfs-1.11.19/src/guestfs-actions.pod:5617 ../libguestfs-1.11.19/src/guestfs-actions.pod:5960 ../libguestfs-1.11.19/src/guestfs-actions.pod:6405 ../libguestfs-1.11.19/src/guestfs-actions.pod:7096 ../libguestfs-1.11.19/src/guestfs-actions.pod:7116 ../libguestfs-1.11.19/src/guestfs-actions.pod:7308 ../src/guestfs-actions.pod:2129 ../src/guestfs-actions.pod:3663 ../src/guestfs-actions.pod:3994 ../src/guestfs-actions.pod:4397 ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:5617 ../src/guestfs-actions.pod:5960 ../src/guestfs-actions.pod:6405 ../src/guestfs-actions.pod:7096 ../src/guestfs-actions.pod:7116 ../src/guestfs-actions.pod:7308 +msgid "(Added in 1.0.77)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1425 -msgid "get-selinux" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2131 ../src/guestfs-actions.pod:2131 +msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1427 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2133 ../src/guestfs-actions.pod:2133 #, no-wrap msgid "" -" get-selinux\n" +" int\n" +" guestfs_get_selinux (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1429 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2136 ../src/guestfs-actions.pod:2136 msgid "" "This returns the current setting of the selinux flag which is passed to the " -"appliance at boot time. See L</set-selinux>." +"appliance at boot time. See C<guestfs_set_selinux>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2144 ../libguestfs-1.11.19/src/guestfs-actions.pod:2207 ../libguestfs-1.11.19/src/guestfs-actions.pod:6424 ../libguestfs-1.11.19/src/guestfs-actions.pod:6482 ../src/guestfs-actions.pod:2144 ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:6424 ../src/guestfs-actions.pod:6482 +msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1435 -msgid "get-state" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2146 ../src/guestfs-actions.pod:2146 +msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1437 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:2148 #, no-wrap msgid "" -" get-state\n" +" int\n" +" guestfs_get_state (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1444 -msgid "get-trace" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2160 ../src/guestfs-actions.pod:2160 +msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1446 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2162 ../src/guestfs-actions.pod:2162 #, no-wrap msgid "" -" get-trace\n" +" int\n" +" guestfs_get_trace (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1450 -msgid "get-umask" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2171 ../src/guestfs-actions.pod:2171 +msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1452 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2173 ../src/guestfs-actions.pod:2173 #, no-wrap msgid "" -" get-umask\n" +" int\n" +" guestfs_get_umask (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1454 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2176 ../src/guestfs-actions.pod:2176 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " -"set by calling L</umask>." +"set by calling C<guestfs_umask>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1457 -msgid "get-verbose" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2183 ../src/guestfs-actions.pod:2183 +msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1459 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2185 ../src/guestfs-actions.pod:2185 #, no-wrap msgid "" -" get-verbose\n" +" int\n" +" guestfs_get_verbose (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1463 -msgid "getcon" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2194 ../src/guestfs-actions.pod:2194 +msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1465 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2196 #, no-wrap msgid "" -" getcon\n" +" char *\n" +" guestfs_getcon (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1469 -msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2201 ../src/guestfs-actions.pod:2201 +msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1472 -msgid "getxattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2209 ../src/guestfs-actions.pod:2209 +msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1474 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2211 ../src/guestfs-actions.pod:2211 #, no-wrap msgid "" -" getxattr path name\n" +" char *\n" +" guestfs_getxattr (guestfs_h *g,\n" +" const char *path,\n" +" const char *name,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1476 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2217 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " -"symlink itself, use L</lgetxattr>." +"symlink itself, use C<guestfs_lgetxattr>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:2507 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2221 ../libguestfs-1.11.19/src/guestfs-actions.pod:3677 ../src/guestfs-actions.pod:2221 ../src/guestfs-actions.pod:3677 msgid "" "Normally it is better to get all extended attributes from a file in one go " -"by calling L</getxattrs>. However some Linux filesystem implementations are " -"buggy and do not provide a way to list out attributes. For these " -"filesystems (notably ntfs-3g) you have to know the names of the extended " -"attributes you want in advance and call this function." +"by calling C<guestfs_getxattrs>. However some Linux filesystem " +"implementations are buggy and do not provide a way to list out attributes. " +"For these filesystems (notably ntfs-3g) you have to know the names of the " +"extended attributes you want in advance and call this function." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1490 -msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2231 ../src/guestfs-actions.pod:2231 +msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2233 ../libguestfs-1.11.19/src/guestfs-actions.pod:2424 ../libguestfs-1.11.19/src/guestfs-actions.pod:2894 ../libguestfs-1.11.19/src/guestfs-actions.pod:3689 ../libguestfs-1.11.19/src/guestfs-actions.pod:5610 ../libguestfs-1.11.19/src/guestfs-actions.pod:5636 ../libguestfs-1.11.19/src/guestfs-actions.pod:5817 ../src/guestfs-actions.pod:2233 ../src/guestfs-actions.pod:2424 ../src/guestfs-actions.pod:2894 ../src/guestfs-actions.pod:3689 ../src/guestfs-actions.pod:5610 ../src/guestfs-actions.pod:5636 ../src/guestfs-actions.pod:5817 +msgid "" +"This function returns a buffer, or NULL on error. The size of the returned " +"buffer is written to C<*size_r>. I<The caller must free the returned buffer " +"after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2237 ../libguestfs-1.11.19/src/guestfs-actions.pod:3693 ../src/guestfs-actions.pod:2237 ../src/guestfs-actions.pod:3693 +msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1492 -msgid "getxattrs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2239 ../src/guestfs-actions.pod:2239 +msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1494 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2241 ../src/guestfs-actions.pod:2241 #, no-wrap msgid "" -" getxattrs path\n" +" struct guestfs_xattr_list *\n" +" guestfs_getxattrs (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1502 -msgid "See also: L</lgetxattrs>, L<attr(5)>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2251 ../src/guestfs-actions.pod:2251 +msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2253 ../libguestfs-1.11.19/src/guestfs-actions.pod:3705 ../libguestfs-1.11.19/src/guestfs-actions.pod:4393 ../src/guestfs-actions.pod:2253 ../src/guestfs-actions.pod:3705 ../src/guestfs-actions.pod:4393 +msgid "" +"This function returns a C<struct guestfs_xattr_list *>, or NULL if there was " +"an error. I<The caller must call C<guestfs_free_xattr_list> after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2257 ../libguestfs-1.11.19/src/guestfs-actions.pod:3709 ../libguestfs-1.11.19/src/guestfs-actions.pod:3908 ../libguestfs-1.11.19/src/guestfs-actions.pod:3944 ../libguestfs-1.11.19/src/guestfs-actions.pod:5990 ../libguestfs-1.11.19/src/guestfs-actions.pod:6501 ../libguestfs-1.11.19/src/guestfs-actions.pod:7888 ../src/guestfs-actions.pod:2257 ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:3908 ../src/guestfs-actions.pod:3944 ../src/guestfs-actions.pod:5990 ../src/guestfs-actions.pod:6501 ../src/guestfs-actions.pod:7888 +msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1504 -msgid "glob-expand" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2259 ../src/guestfs-actions.pod:2259 +msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1506 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2261 ../src/guestfs-actions.pod:2261 #, no-wrap msgid "" -" glob-expand pattern\n" +" char **\n" +" guestfs_glob_expand (guestfs_h *g,\n" +" const char *pattern);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2280 ../libguestfs-1.11.19/src/guestfs-actions.pod:6694 ../libguestfs-1.11.19/src/guestfs-actions.pod:6711 ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:6694 ../src/guestfs-actions.pod:6711 +msgid "(Added in 1.0.50)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1519 -msgid "grep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2282 ../src/guestfs-actions.pod:2282 +msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1521 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2284 ../src/guestfs-actions.pod:2284 #, no-wrap msgid "" -" grep regex path\n" +" char **\n" +" guestfs_grep (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1529 -msgid "grepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2301 +msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1531 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2303 ../src/guestfs-actions.pod:2303 #, no-wrap msgid "" -" grepi regex path\n" +" char **\n" +" guestfs_grepi (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1539 -msgid "grub-install" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2320 ../src/guestfs-actions.pod:2320 +msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1541 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2322 ../src/guestfs-actions.pod:2322 #, no-wrap msgid "" -" grub-install root device\n" +" int\n" +" guestfs_grub_install (guestfs_h *g,\n" +" const char *root,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2343 ../src/guestfs-actions.pod:2343 +msgid "(Added in 1.0.17)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1557 -msgid "head" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2345 ../src/guestfs-actions.pod:2345 +msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1559 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2347 ../src/guestfs-actions.pod:2347 #, no-wrap msgid "" -" head path\n" +" char **\n" +" guestfs_head (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1567 -msgid "head-n" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2363 ../src/guestfs-actions.pod:2363 +msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1569 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2365 ../src/guestfs-actions.pod:2365 #, no-wrap msgid "" -" head-n nrlines path\n" +" char **\n" +" guestfs_head_n (guestfs_h *g,\n" +" int nrlines,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1582 -msgid "hexdump" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2387 ../src/guestfs-actions.pod:2387 +msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1584 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2389 ../src/guestfs-actions.pod:2389 #, no-wrap msgid "" -" hexdump path\n" +" char *\n" +" guestfs_hexdump (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2402 ../libguestfs-1.11.19/src/guestfs-actions.pod:6775 ../libguestfs-1.11.19/src/guestfs-actions.pod:6830 ../src/guestfs-actions.pod:2402 ../src/guestfs-actions.pod:6775 ../src/guestfs-actions.pod:6830 +msgid "(Added in 1.0.22)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1592 -msgid "initrd-cat" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2404 ../src/guestfs-actions.pod:2404 +msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1594 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2406 ../src/guestfs-actions.pod:2406 #, no-wrap msgid "" -" initrd-cat initrdpath filename\n" +" char *\n" +" guestfs_initrd_cat (guestfs_h *g,\n" +" const char *initrdpath,\n" +" const char *filename,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1606 -msgid "See also L</initrd-list>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2422 +msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1611 -msgid "initrd-list" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2433 ../src/guestfs-actions.pod:2433 +msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1613 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2435 ../src/guestfs-actions.pod:2435 #, no-wrap msgid "" -" initrd-list path\n" +" char **\n" +" guestfs_initrd_list (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1625 -msgid "inotify-add-watch" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2455 ../src/guestfs-actions.pod:2455 +msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1627 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2457 ../src/guestfs-actions.pod:2457 #, no-wrap msgid "" -" inotify-add-watch path mask\n" +" int64_t\n" +" guestfs_inotify_add_watch (guestfs_h *g,\n" +" const char *path,\n" +" int mask);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1639 -msgid "inotify-close" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2476 ../src/guestfs-actions.pod:2476 +msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1641 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2478 ../src/guestfs-actions.pod:2478 #, no-wrap msgid "" -" inotify-close\n" +" int\n" +" guestfs_inotify_close (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1647 -msgid "inotify-files" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2489 ../src/guestfs-actions.pod:2489 +msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1649 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2491 ../src/guestfs-actions.pod:2491 #, no-wrap msgid "" -" inotify-files\n" +" char **\n" +" guestfs_inotify_files (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1651 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2494 ../src/guestfs-actions.pod:2494 msgid "" -"This function is a helpful wrapper around L</inotify-read> which just " +"This function is a helpful wrapper around C<guestfs_inotify_read> which just " "returns a list of pathnames of objects that were touched. The returned " "pathnames are sorted and deduplicated." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1655 -msgid "inotify-init" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2504 ../src/guestfs-actions.pod:2504 +msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1657 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:2506 #, no-wrap msgid "" -" inotify-init maxevents\n" +" int\n" +" guestfs_inotify_init (guestfs_h *g,\n" +" int maxevents);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1663 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2514 ../src/guestfs-actions.pod:2514 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " -"calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, " -"then the kernel (or previously set) default is used. For Linux 2.6.29 the " -"default was 16384 events. Beyond this limit, the kernel throws away events, " -"but records the fact that it threw them away by setting a flag " -"C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)." +"calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " +"passed as C<0>, then the kernel (or previously set) default is used. For " +"Linux 2.6.29 the default was 16384 events. Beyond this limit, the kernel " +"throws away events, but records the fact that it threw them away by setting " +"a flag C<IN_Q_OVERFLOW> in the returned structure list (see " +"C<guestfs_inotify_read>)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1673 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2524 ../src/guestfs-actions.pod:2524 msgid "" "Before any events are generated, you have to add some watches to the " -"internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and " -"L</inotify-watch-all>." +"internal watch list. See: C<guestfs_inotify_add_watch>, " +"C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1679 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2530 ../src/guestfs-actions.pod:2530 msgid "" -"Queued up events should be read periodically by calling L</inotify-read> (or " -"L</inotify-files> which is just a helpful wrapper around L</inotify-read>). " -"If you don't read the events out often enough then you risk the internal " -"queue overflowing." +"Queued up events should be read periodically by calling " +"C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " +"wrapper around C<guestfs_inotify_read>). If you don't read the events out " +"often enough then you risk the internal queue overflowing." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1686 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2537 ../src/guestfs-actions.pod:2537 msgid "" -"The handle should be closed after use by calling L</inotify-close>. This " -"also removes any watches automatically." +"The handle should be closed after use by calling C<guestfs_inotify_close>. " +"This also removes any watches automatically." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1695 -msgid "inotify-read" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:2550 +msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1697 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2552 ../src/guestfs-actions.pod:2552 #, no-wrap msgid "" -" inotify-read\n" +" struct guestfs_inotify_event_list *\n" +" guestfs_inotify_read (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2566 ../src/guestfs-actions.pod:2566 +msgid "" +"This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " +"there was an error. I<The caller must call " +"C<guestfs_free_inotify_event_list> after use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1710 -msgid "inotify-rm-watch" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2572 ../src/guestfs-actions.pod:2572 +msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1712 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2574 ../src/guestfs-actions.pod:2574 #, no-wrap msgid "" -" inotify-rm-watch wd\n" +" int\n" +" guestfs_inotify_rm_watch (guestfs_h *g,\n" +" int wd);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1714 -msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2578 ../src/guestfs-actions.pod:2578 +msgid "" +"Remove a previously defined inotify watch. See " +"C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1717 -msgid "inspect-get-arch" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2585 ../src/guestfs-actions.pod:2585 +msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1719 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2587 ../src/guestfs-actions.pod:2587 #, no-wrap msgid "" -" inspect-get-arch root\n" +" char *\n" +" guestfs_inspect_get_arch (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1721 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2591 ../src/guestfs-actions.pod:2591 msgid "" "This returns the architecture of the inspected operating system. The " -"possible return values are listed under L</file-architecture>." +"possible return values are listed under C<guestfs_file_architecture>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1730 -msgid "inspect-get-distro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2605 ../src/guestfs-actions.pod:2605 +msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1732 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2607 #, no-wrap msgid "" -" inspect-get-distro root\n" +" char *\n" +" guestfs_inspect_get_distro (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1813 -msgid "inspect-get-drive-mappings" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2695 ../src/guestfs-actions.pod:2695 +msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1815 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2697 #, no-wrap msgid "" -" inspect-get-drive-mappings root\n" +" char **\n" +" guestfs_inspect_get_drive_mappings (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1842 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2726 ../src/guestfs-actions.pod:2726 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"L</inspect-get-mountpoints>, L</inspect-get-filesystems>." +"C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2730 ../libguestfs-1.11.19/src/guestfs-actions.pod:2998 ../libguestfs-1.11.19/src/guestfs-actions.pod:3796 ../libguestfs-1.11.19/src/guestfs-actions.pod:5078 ../libguestfs-1.11.19/src/guestfs-actions.pod:7132 ../src/guestfs-actions.pod:2730 ../src/guestfs-actions.pod:2998 ../src/guestfs-actions.pod:3796 ../src/guestfs-actions.pod:5078 ../src/guestfs-actions.pod:7132 +msgid "" +"This function returns a NULL-terminated array of strings, or NULL if there " +"was an error. The array of strings will always have length C<2n+1>, where " +"C<n> keys and values alternate, followed by the trailing NULL entry. I<The " +"caller must free the strings and the array after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2736 ../libguestfs-1.11.19/src/guestfs-actions.pod:3192 ../src/guestfs-actions.pod:2736 ../src/guestfs-actions.pod:3192 +msgid "(Added in 1.9.17)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1846 -msgid "inspect-get-filesystems" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2738 ../src/guestfs-actions.pod:2738 +msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1848 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:2740 #, no-wrap msgid "" -" inspect-get-filesystems root\n" +" char **\n" +" guestfs_inspect_get_filesystems (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1858 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2752 ../src/guestfs-actions.pod:2752 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"L</inspect-get-mountpoints>." +"C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1861 -msgid "inspect-get-format" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2761 ../src/guestfs-actions.pod:2761 +msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1863 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2763 ../src/guestfs-actions.pod:2763 #, no-wrap msgid "" -" inspect-get-format root\n" +" char *\n" +" guestfs_inspect_get_format (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2797 ../libguestfs-1.11.19/src/guestfs-actions.pod:3228 ../libguestfs-1.11.19/src/guestfs-actions.pod:3244 ../libguestfs-1.11.19/src/guestfs-actions.pod:3262 ../libguestfs-1.11.19/src/guestfs-actions.pod:6028 ../src/guestfs-actions.pod:2797 ../src/guestfs-actions.pod:3228 ../src/guestfs-actions.pod:3244 ../src/guestfs-actions.pod:3262 ../src/guestfs-actions.pod:6028 +msgid "(Added in 1.9.4)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1892 -msgid "inspect-get-hostname" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2799 ../src/guestfs-actions.pod:2799 +msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1894 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2801 ../src/guestfs-actions.pod:2801 #, no-wrap msgid "" -" inspect-get-hostname root\n" +" char *\n" +" guestfs_inspect_get_hostname (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2816 +msgid "(Added in 1.7.9)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1904 -msgid "inspect-get-icon" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2818 ../src/guestfs-actions.pod:2818 +msgid "guestfs_inspect_get_icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1906 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2820 ../src/guestfs-actions.pod:2820 #, no-wrap msgid "" -" inspect-get-icon root [favicon:..] [highquality:..]\n" +" char *\n" +" guestfs_inspect_get_icon (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2831 ../src/guestfs-actions.pod:2831 +#, no-wrap +msgid "" +" GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" +" GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2898 ../libguestfs-1.11.19/src/guestfs-actions.pod:3723 ../libguestfs-1.11.19/src/guestfs-actions.pod:4977 ../src/guestfs-actions.pod:2898 ../src/guestfs-actions.pod:3723 ../src/guestfs-actions.pod:4977 +msgid "(Added in 1.11.12)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1970 -msgid "inspect-get-major-version" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2900 ../src/guestfs-actions.pod:2900 +msgid "guestfs_inspect_get_icon_va" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1972 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2902 ../src/guestfs-actions.pod:2902 #, no-wrap msgid "" -" inspect-get-major-version root\n" +" char *\n" +" guestfs_inspect_get_icon_va (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" va_list args);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:2908 +msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:1988 -msgid "inspect-get-minor-version" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2912 ../src/guestfs-actions.pod:2912 +msgid "guestfs_inspect_get_icon_argv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1990 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2914 ../src/guestfs-actions.pod:2914 #, no-wrap msgid "" -" inspect-get-minor-version root\n" +" char *\n" +" guestfs_inspect_get_icon_argv (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" const struct guestfs_inspect_get_icon_argv " +"*optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2920 ../src/guestfs-actions.pod:2920 +msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2924 ../src/guestfs-actions.pod:2924 +msgid "guestfs_inspect_get_major_version" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2926 ../src/guestfs-actions.pod:2926 +#, no-wrap +msgid "" +" int\n" +" guestfs_inspect_get_major_version (guestfs_h *g,\n" +" const char *root);\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2948 ../src/guestfs-actions.pod:2948 +msgid "guestfs_inspect_get_minor_version" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2950 ../src/guestfs-actions.pod:2950 +#, no-wrap +msgid "" +" int\n" +" guestfs_inspect_get_minor_version (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1997 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2959 ../src/guestfs-actions.pod:2959 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"L</inspect-get-major-version>." +"C<guestfs_inspect_get_major_version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2000 -msgid "inspect-get-mountpoints" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2966 ../src/guestfs-actions.pod:2966 +msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2002 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2968 ../src/guestfs-actions.pod:2968 #, no-wrap msgid "" -" inspect-get-mountpoints root\n" +" char **\n" +" guestfs_inspect_get_mountpoints (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2021 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2989 ../src/guestfs-actions.pod:2989 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C</>. For " "information about the mapping of drive letters to partitions, see " -"L</inspect-get-drive-mappings>." +"C<guestfs_inspect_get_drive_mappings>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2027 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:2995 ../src/guestfs-actions.pod:2995 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"L</inspect-get-filesystems>." +"C<guestfs_inspect_get_filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2030 -msgid "inspect-get-package-format" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3006 ../src/guestfs-actions.pod:3006 +msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2032 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3008 ../src/guestfs-actions.pod:3008 #, no-wrap msgid "" -" inspect-get-package-format root\n" +" char *\n" +" guestfs_inspect_get_package_format (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2034 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3012 msgid "" -"This function and L</inspect-get-package-management> return the package " -"format and package management tool used by the inspected operating system. " -"For example for Fedora these functions would return C<rpm> (package format) " -"and C<yum> (package management)." +"This function and C<guestfs_inspect_get_package_management> return the " +"package format and package management tool used by the inspected operating " +"system. For example for Fedora these functions would return C<rpm> (package " +"format) and C<yum> (package management)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3030 ../libguestfs-1.11.19/src/guestfs-actions.pod:3058 ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3058 +msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2049 -msgid "inspect-get-package-management" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:3032 +msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2051 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3034 ../src/guestfs-actions.pod:3034 #, no-wrap msgid "" -" inspect-get-package-management root\n" +" char *\n" +" guestfs_inspect_get_package_management (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2053 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3038 ../src/guestfs-actions.pod:3038 msgid "" -"L</inspect-get-package-format> and this function return the package format " -"and package management tool used by the inspected operating system. For " -"example for Fedora these functions would return C<rpm> (package format) and " -"C<yum> (package management)." +"C<guestfs_inspect_get_package_format> and this function return the package " +"format and package management tool used by the inspected operating system. " +"For example for Fedora these functions would return C<rpm> (package format) " +"and C<yum> (package management)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2070 -msgid "inspect-get-product-name" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3060 ../src/guestfs-actions.pod:3060 +msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2072 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3062 ../src/guestfs-actions.pod:3062 #, no-wrap msgid "" -" inspect-get-product-name root\n" +" char *\n" +" guestfs_inspect_get_product_name (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2084 -msgid "inspect-get-product-variant" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3081 ../src/guestfs-actions.pod:3081 +msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2086 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3083 ../src/guestfs-actions.pod:3083 #, no-wrap msgid "" -" inspect-get-product-variant root\n" +" char *\n" +" guestfs_inspect_get_product_variant (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2107 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3106 ../src/guestfs-actions.pod:3106 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " -"L</inspect-get-product-name>, L</inspect-get-major-version>." +"C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3113 ../src/guestfs-actions.pod:3113 +msgid "(Added in 1.9.13)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2111 -msgid "inspect-get-roots" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3115 ../src/guestfs-actions.pod:3115 +msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2113 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3117 ../src/guestfs-actions.pod:3117 #, no-wrap msgid "" -" inspect-get-roots\n" +" char **\n" +" guestfs_inspect_get_roots (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2115 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3120 ../src/guestfs-actions.pod:3120 msgid "" "This function is a convenient way to get the list of root devices, as " -"returned from a previous call to L</inspect-os>, but without redoing the " -"whole inspection process." +"returned from a previous call to C<guestfs_inspect_os>, but without redoing " +"the whole inspection process." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2119 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3124 ../src/guestfs-actions.pod:3124 msgid "" "This returns an empty list if either no root devices were found or the " -"caller has not called L</inspect-os>." +"caller has not called C<guestfs_inspect_os>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3133 ../src/guestfs-actions.pod:3133 +msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2124 -msgid "inspect-get-type" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3135 ../src/guestfs-actions.pod:3135 +msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2126 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3137 ../src/guestfs-actions.pod:3137 #, no-wrap msgid "" -" inspect-get-type root\n" +" char *\n" +" guestfs_inspect_get_type (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2156 -msgid "inspect-get-windows-current-control-set" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3174 ../src/guestfs-actions.pod:3174 +msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2158 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3176 ../src/guestfs-actions.pod:3176 #, no-wrap msgid "" -" inspect-get-windows-current-control-set root\n" +" char *\n" +" guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2169 -msgid "inspect-get-windows-systemroot" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3194 +msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2171 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3196 ../src/guestfs-actions.pod:3196 #, no-wrap msgid "" -" inspect-get-windows-systemroot root\n" +" char *\n" +" guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3212 ../src/guestfs-actions.pod:3212 +msgid "(Added in 1.5.25)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2182 -msgid "inspect-is-live" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3214 ../src/guestfs-actions.pod:3214 +msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2184 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3216 ../src/guestfs-actions.pod:3216 #, no-wrap msgid "" -" inspect-is-live root\n" +" int\n" +" guestfs_inspect_is_live (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2186 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3220 ../src/guestfs-actions.pod:3220 msgid "" -"If L</inspect-get-format> returns C<installer> (this is an install disk), " -"then this returns true if a live image was detected on the disk." +"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " +"disk), then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2192 -msgid "inspect-is-multipart" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3230 ../src/guestfs-actions.pod:3230 +msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2194 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3232 ../src/guestfs-actions.pod:3232 #, no-wrap msgid "" -" inspect-is-multipart root\n" +" int\n" +" guestfs_inspect_is_multipart (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2196 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3236 ../src/guestfs-actions.pod:3236 msgid "" -"If L</inspect-get-format> returns C<installer> (this is an install disk), " -"then this returns true if the disk is part of a set." +"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " +"disk), then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2202 -msgid "inspect-is-netinst" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3246 ../src/guestfs-actions.pod:3246 +msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2204 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3248 ../src/guestfs-actions.pod:3248 #, no-wrap msgid "" -" inspect-is-netinst root\n" +" int\n" +" guestfs_inspect_is_netinst (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2206 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3252 msgid "" -"If L</inspect-get-format> returns C<installer> (this is an install disk), " -"then this returns true if the disk is a network installer, ie. not a " +"If C<guestfs_inspect_get_format> returns C<installer> (this is an install " +"disk), then this returns true if the disk is a network installer, ie. not a " "self-contained install CD but one which is likely to require network access " "to complete the install." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2214 -msgid "inspect-list-applications" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3264 ../src/guestfs-actions.pod:3264 +msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2216 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3266 ../src/guestfs-actions.pod:3266 #, no-wrap msgid "" -" inspect-list-applications root\n" +" struct guestfs_application_list *\n" +" guestfs_inspect_list_applications (guestfs_h *g,\n" +" const char *root);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2220 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3272 ../src/guestfs-actions.pod:3272 msgid "" "I<Note:> This call works differently from other parts of the inspection " -"API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, " -"then mount up the disks, before calling this. Listing applications is a " -"significantly more difficult operation which requires access to the full " -"filesystem. Also note that unlike the other L</inspect-get-*> calls which " -"are just returning data cached in the libguestfs handle, this call actually " -"reads parts of the mounted filesystems during the call." +"API. You have to call C<guestfs_inspect_os>, then " +"C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling " +"this. Listing applications is a significantly more difficult operation " +"which requires access to the full filesystem. Also note that unlike the " +"other C<guestfs_inspect_get_*> calls which are just returning data cached in " +"the libguestfs handle, this call actually reads parts of the mounted " +"filesystems during the call." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3362 ../src/guestfs-actions.pod:3362 +msgid "" +"This function returns a C<struct guestfs_application_list *>, or NULL if " +"there was an error. I<The caller must call C<guestfs_free_application_list> " +"after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3366 ../src/guestfs-actions.pod:3366 +msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2310 -msgid "inspect-os" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3368 ../src/guestfs-actions.pod:3368 +msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2312 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3370 ../src/guestfs-actions.pod:3370 #, no-wrap msgid "" -" inspect-os\n" +" char **\n" +" guestfs_inspect_os (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2327 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3386 ../src/guestfs-actions.pod:3386 msgid "" -"You can pass the root string(s) returned to other L</inspect-get-*> " +"You can pass the root string(s) returned to other C<guestfs_inspect_get_*> " "functions in order to query further information about each operating system, " "such as the name and version." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2332 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3391 ../src/guestfs-actions.pod:3391 msgid "" -"This function uses other libguestfs features such as L</mount-ro> and " -"L</umount-all> in order to mount and unmount filesystems and look at the " -"contents. This should be called with no disks currently mounted. The " +"This function uses other libguestfs features such as C<guestfs_mount_ro> and " +"C<guestfs_umount_all> in order to mount and unmount filesystems and look at " +"the contents. This should be called with no disks currently mounted. The " "function may also use Augeas, so any existing Augeas handle will be closed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2344 ../fish/guestfish-actions.pod:2542 ../fish/guestfish-actions.pod:2601 -msgid "See also L</list-filesystems>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3403 ../libguestfs-1.11.19/src/guestfs-actions.pod:3734 ../libguestfs-1.11.19/src/guestfs-actions.pod:3816 ../src/guestfs-actions.pod:3403 ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3816 +msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2346 -msgid "is-blockdev" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3411 ../src/guestfs-actions.pod:3411 +msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2348 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3413 ../src/guestfs-actions.pod:3413 #, no-wrap msgid "" -" is-blockdev path\n" +" int\n" +" guestfs_is_blockdev (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2353 ../fish/guestfish-actions.pod:2371 ../fish/guestfish-actions.pod:2390 ../fish/guestfish-actions.pod:2399 ../fish/guestfish-actions.pod:2409 ../fish/guestfish-actions.pod:2443 ../fish/guestfish-actions.pod:2452 -msgid "See also L</stat>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3420 ../libguestfs-1.11.19/src/guestfs-actions.pod:3449 ../libguestfs-1.11.19/src/guestfs-actions.pod:3479 ../libguestfs-1.11.19/src/guestfs-actions.pod:3494 ../libguestfs-1.11.19/src/guestfs-actions.pod:3510 ../libguestfs-1.11.19/src/guestfs-actions.pod:3566 ../libguestfs-1.11.19/src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3420 ../src/guestfs-actions.pod:3449 ../src/guestfs-actions.pod:3479 ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3510 ../src/guestfs-actions.pod:3566 ../src/guestfs-actions.pod:3581 +msgid "See also C<guestfs_stat>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3424 ../libguestfs-1.11.19/src/guestfs-actions.pod:3453 ../libguestfs-1.11.19/src/guestfs-actions.pod:3498 ../libguestfs-1.11.19/src/guestfs-actions.pod:3570 ../libguestfs-1.11.19/src/guestfs-actions.pod:3585 ../src/guestfs-actions.pod:3424 ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3570 ../src/guestfs-actions.pod:3585 +msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2355 -msgid "is-busy" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3426 ../src/guestfs-actions.pod:3426 +msgid "guestfs_is_busy" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2357 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3428 ../src/guestfs-actions.pod:3428 #, no-wrap msgid "" -" is-busy\n" +" int\n" +" guestfs_is_busy (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2364 -msgid "is-chardev" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3440 ../src/guestfs-actions.pod:3440 +msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2366 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3442 ../src/guestfs-actions.pod:3442 #, no-wrap msgid "" -" is-chardev path\n" +" int\n" +" guestfs_is_chardev (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2373 -msgid "is-config" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3455 ../src/guestfs-actions.pod:3455 +msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2375 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3457 ../src/guestfs-actions.pod:3457 #, no-wrap msgid "" -" is-config\n" +" int\n" +" guestfs_is_config (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2382 -msgid "is-dir" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3469 ../src/guestfs-actions.pod:3469 +msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2384 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3471 #, no-wrap msgid "" -" is-dir path\n" +" int\n" +" guestfs_is_dir (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2392 -msgid "is-fifo" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:3485 +msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2394 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3487 ../src/guestfs-actions.pod:3487 #, no-wrap msgid "" -" is-fifo path\n" +" int\n" +" guestfs_is_fifo (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2401 -msgid "is-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:3500 +msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2403 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3502 ../src/guestfs-actions.pod:3502 #, no-wrap msgid "" -" is-file path\n" +" int\n" +" guestfs_is_file (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2411 -msgid "is-launching" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3516 ../src/guestfs-actions.pod:3516 +msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2413 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3518 ../src/guestfs-actions.pod:3518 #, no-wrap msgid "" -" is-launching\n" +" int\n" +" guestfs_is_launching (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2420 -msgid "is-lv" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3530 ../src/guestfs-actions.pod:3530 +msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2422 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3532 ../src/guestfs-actions.pod:3532 #, no-wrap msgid "" -" is-lv device\n" +" int\n" +" guestfs_is_lv (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2427 -msgid "is-ready" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3543 ../src/guestfs-actions.pod:3543 +msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2429 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3545 ../src/guestfs-actions.pod:3545 #, no-wrap msgid "" -" is-ready\n" +" int\n" +" guestfs_is_ready (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2436 -msgid "is-socket" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3557 ../src/guestfs-actions.pod:3557 +msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2438 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3559 ../src/guestfs-actions.pod:3559 #, no-wrap msgid "" -" is-socket path\n" +" int\n" +" guestfs_is_socket (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2445 -msgid "is-symlink" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3572 ../src/guestfs-actions.pod:3572 +msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2447 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3574 ../src/guestfs-actions.pod:3574 #, no-wrap msgid "" -" is-symlink path\n" +" int\n" +" guestfs_is_symlink (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2454 -msgid "is-zero" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3587 ../src/guestfs-actions.pod:3587 +msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2456 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3589 ../src/guestfs-actions.pod:3589 #, no-wrap msgid "" -" is-zero path\n" +" int\n" +" guestfs_is_zero (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3598 ../libguestfs-1.11.19/src/guestfs-actions.pod:3612 ../src/guestfs-actions.pod:3598 ../src/guestfs-actions.pod:3612 +msgid "(Added in 1.11.8)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2461 -msgid "is-zero-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3600 ../src/guestfs-actions.pod:3600 +msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2463 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:3602 #, no-wrap msgid "" -" is-zero-device device\n" +" int\n" +" guestfs_is_zero_device (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2469 -msgid "kill-subprocess" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3614 ../src/guestfs-actions.pod:3614 +msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2471 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3616 ../src/guestfs-actions.pod:3616 #, no-wrap msgid "" -" kill-subprocess\n" +" int\n" +" guestfs_kill_subprocess (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2475 -msgid "launch" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2477 -msgid "run" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3625 ../src/guestfs-actions.pod:3625 +msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2479 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3627 ../src/guestfs-actions.pod:3627 #, no-wrap msgid "" -" launch\n" +" int\n" +" guestfs_launch (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2487 -msgid "lchown" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3645 ../src/guestfs-actions.pod:3645 +msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2489 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3647 ../src/guestfs-actions.pod:3647 #, no-wrap msgid "" -" lchown owner group path\n" +" int\n" +" guestfs_lchown (guestfs_h *g,\n" +" int owner,\n" +" int group,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2491 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3653 ../src/guestfs-actions.pod:3653 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " -"L</chown> but if C<path> is a symlink then the link itself is changed, not " -"the target." +"C<guestfs_chown> but if C<path> is a symlink then the link itself is " +"changed, not the target." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2499 -msgid "lgetxattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3665 ../src/guestfs-actions.pod:3665 +msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2501 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3667 ../src/guestfs-actions.pod:3667 #, no-wrap msgid "" -" lgetxattr path name\n" +" char *\n" +" guestfs_lgetxattr (guestfs_h *g,\n" +" const char *path,\n" +" const char *name,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2517 -msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:3687 +msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2519 -msgid "lgetxattrs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3695 ../src/guestfs-actions.pod:3695 +msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2521 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3697 ../src/guestfs-actions.pod:3697 #, no-wrap msgid "" -" lgetxattrs path\n" +" struct guestfs_xattr_list *\n" +" guestfs_lgetxattrs (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2523 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3701 ../src/guestfs-actions.pod:3701 msgid "" -"This is the same as L</getxattrs>, but if C<path> is a symbolic link, then " -"it returns the extended attributes of the link itself." +"This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, " +"then it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2527 -msgid "list-9p" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3711 +msgid "guestfs_list_9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2529 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3713 ../src/guestfs-actions.pod:3713 #, no-wrap msgid "" -" list-9p\n" +" char **\n" +" guestfs_list_9p (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2534 -msgid "list-devices" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3725 ../src/guestfs-actions.pod:3725 +msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2536 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3727 ../src/guestfs-actions.pod:3727 #, no-wrap msgid "" -" list-devices\n" +" char **\n" +" guestfs_list_devices (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2544 -msgid "list-dm-devices" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3742 ../src/guestfs-actions.pod:3742 +msgid "guestfs_list_dm_devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2546 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3744 ../src/guestfs-actions.pod:3744 #, no-wrap msgid "" -" list-dm-devices\n" +" char **\n" +" guestfs_list_dm_devices (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2550 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3749 ../src/guestfs-actions.pod:3749 msgid "" "The returned list contains C</dev/mapper/*> devices, eg. ones created by a " -"previous call to L</luks-open>." +"previous call to C<guestfs_luks_open>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2553 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3752 ../src/guestfs-actions.pod:3752 msgid "" "Device mapper devices which correspond to logical volumes are I<not> " -"returned in this list. Call L</lvs> if you want to list logical volumes." +"returned in this list. Call C<guestfs_lvs> if you want to list logical " +"volumes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3760 ../libguestfs-1.11.19/src/guestfs-actions.pod:5216 ../src/guestfs-actions.pod:3760 ../src/guestfs-actions.pod:5216 +msgid "(Added in 1.11.15)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2557 -msgid "list-filesystems" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3762 ../src/guestfs-actions.pod:3762 +msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2559 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3764 ../src/guestfs-actions.pod:3764 #, no-wrap msgid "" -" list-filesystems\n" +" char **\n" +" guestfs_list_filesystems (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2578 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3784 ../src/guestfs-actions.pod:3784 msgid "" -"This command runs other libguestfs commands, which might include L</mount> " -"and L</umount>, and therefore you should use this soon after launch and only " -"when nothing is mounted." +"This command runs other libguestfs commands, which might include " +"C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " +"soon after launch and only when nothing is mounted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2582 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3788 ../src/guestfs-actions.pod:3788 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " "each filesystem found is valid and mountable, and some filesystems might be " "mountable but require special options. Filesystems may not all belong to a " -"single logical operating system (use L</inspect-os> to look for OSes)." +"single logical operating system (use C<guestfs_inspect_os> to look for " +"OSes)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3802 ../libguestfs-1.11.19/src/guestfs-actions.pod:5577 ../src/guestfs-actions.pod:3802 ../src/guestfs-actions.pod:5577 +msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2590 -msgid "list-partitions" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3804 ../src/guestfs-actions.pod:3804 +msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2592 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3806 ../src/guestfs-actions.pod:3806 #, no-wrap msgid "" -" list-partitions\n" +" char **\n" +" guestfs_list_partitions (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2598 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3813 msgid "" "This does not return logical volumes. For that you will need to call " -"L</lvs>." +"C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2603 -msgid "ll" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:3824 +msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2605 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3826 ../src/guestfs-actions.pod:3826 #, no-wrap msgid "" -" ll directory\n" +" char *\n" +" guestfs_ll (guestfs_h *g,\n" +" const char *directory);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2613 -msgid "ln" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3841 ../src/guestfs-actions.pod:3841 +msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2615 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3843 ../src/guestfs-actions.pod:3843 #, no-wrap msgid "" -" ln target linkname\n" +" int\n" +" guestfs_ln (guestfs_h *g,\n" +" const char *target,\n" +" const char *linkname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2619 -msgid "ln-f" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3854 ../src/guestfs-actions.pod:3854 +msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2621 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3856 ../src/guestfs-actions.pod:3856 #, no-wrap msgid "" -" ln-f target linkname\n" +" int\n" +" guestfs_ln_f (guestfs_h *g,\n" +" const char *target,\n" +" const char *linkname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2626 -msgid "ln-s" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3868 ../src/guestfs-actions.pod:3868 +msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2628 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3870 ../src/guestfs-actions.pod:3870 #, no-wrap msgid "" -" ln-s target linkname\n" +" int\n" +" guestfs_ln_s (guestfs_h *g,\n" +" const char *target,\n" +" const char *linkname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2632 -msgid "ln-sf" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3881 ../src/guestfs-actions.pod:3881 +msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2634 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3883 ../src/guestfs-actions.pod:3883 #, no-wrap msgid "" -" ln-sf target linkname\n" +" int\n" +" guestfs_ln_sf (guestfs_h *g,\n" +" const char *target,\n" +" const char *linkname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2639 -msgid "lremovexattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3895 ../src/guestfs-actions.pod:3895 +msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2641 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3897 ../src/guestfs-actions.pod:3897 #, no-wrap msgid "" -" lremovexattr xattr path\n" +" int\n" +" guestfs_lremovexattr (guestfs_h *g,\n" +" const char *xattr,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2643 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3902 ../src/guestfs-actions.pod:3902 msgid "" -"This is the same as L</removexattr>, but if C<path> is a symbolic link, then " -"it removes an extended attribute of the link itself." +"This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic " +"link, then it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2647 -msgid "ls" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3910 ../src/guestfs-actions.pod:3910 +msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2649 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3912 ../src/guestfs-actions.pod:3912 #, no-wrap msgid "" -" ls directory\n" +" char **\n" +" guestfs_ls (guestfs_h *g,\n" +" const char *directory);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2655 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3920 ../src/guestfs-actions.pod:3920 msgid "" "This command is mostly useful for interactive sessions. Programs should " -"probably use L</readdir> instead." +"probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2658 -msgid "lsetxattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3929 ../src/guestfs-actions.pod:3929 +msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2660 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3931 ../src/guestfs-actions.pod:3931 #, no-wrap msgid "" -" lsetxattr xattr val vallen path\n" +" int\n" +" guestfs_lsetxattr (guestfs_h *g,\n" +" const char *xattr,\n" +" const char *val,\n" +" int vallen,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2662 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3938 ../src/guestfs-actions.pod:3938 msgid "" -"This is the same as L</setxattr>, but if C<path> is a symbolic link, then it " -"sets an extended attribute of the link itself." +"This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, " +"then it sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2666 -msgid "lstat" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3946 ../src/guestfs-actions.pod:3946 +msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2668 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3948 ../src/guestfs-actions.pod:3948 #, no-wrap msgid "" -" lstat path\n" +" struct guestfs_stat *\n" +" guestfs_lstat (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2672 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3954 ../src/guestfs-actions.pod:3954 msgid "" -"This is the same as L</stat> except that if C<path> is a symbolic link, then " -"the link is stat-ed, not the file it refers to." +"This is the same as C<guestfs_stat> except that if C<path> is a symbolic " +"link, then the link is stat-ed, not the file it refers to." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3960 ../libguestfs-1.11.19/src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:3960 ../src/guestfs-actions.pod:6735 +msgid "" +"This function returns a C<struct guestfs_stat *>, or NULL if there was an " +"error. I<The caller must call C<guestfs_free_stat> after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3964 ../libguestfs-1.11.19/src/guestfs-actions.pod:6739 ../libguestfs-1.11.19/src/guestfs-actions.pod:6757 ../libguestfs-1.11.19/src/guestfs-actions.pod:7138 ../src/guestfs-actions.pod:3964 ../src/guestfs-actions.pod:6739 ../src/guestfs-actions.pod:6757 ../src/guestfs-actions.pod:7138 +msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2678 -msgid "lstatlist" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3966 ../src/guestfs-actions.pod:3966 +msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2680 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3968 ../src/guestfs-actions.pod:3968 #, no-wrap msgid "" -" lstatlist path 'names ...'\n" +" struct guestfs_stat_list *\n" +" guestfs_lstatlist (guestfs_h *g,\n" +" const char *path,\n" +" char *const *names);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2682 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3973 ../src/guestfs-actions.pod:3973 msgid "" -"This call allows you to perform the L</lstat> operation on multiple files, " -"where all files are in the directory C<path>. C<names> is the list of files " -"from this directory." +"This call allows you to perform the C<guestfs_lstat> operation on multiple " +"files, where all files are in the directory C<path>. C<names> is the list " +"of files from this directory." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2691 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:3982 msgid "" "This call is intended for programs that want to efficiently list a directory " -"contents without making many round-trips. See also L</lxattrlist> for a " -"similarly efficient call for getting extended attributes. Very long " +"contents without making many round-trips. See also C<guestfs_lxattrlist> " +"for a similarly efficient call for getting extended attributes. Very long " "directory listings might cause the protocol message size to be exceeded, " "causing this call to fail. The caller must split up such requests into " "smaller groups of names." msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3990 ../src/guestfs-actions.pod:3990 +msgid "" +"This function returns a C<struct guestfs_stat_list *>, or NULL if there was " +"an error. I<The caller must call C<guestfs_free_stat_list> after use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2699 -msgid "luks-add-key" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3996 ../src/guestfs-actions.pod:3996 +msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2701 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:3998 ../src/guestfs-actions.pod:3998 #, no-wrap msgid "" -" luks-add-key device keyslot\n" +" int\n" +" guestfs_luks_add_key (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" const char *newkey,\n" +" int keyslot);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2708 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4010 ../src/guestfs-actions.pod:4010 msgid "" "Note that if C<keyslot> already contains a key, then this command will " -"fail. You have to use L</luks-kill-slot> first to remove that key." +"fail. You have to use C<guestfs_luks_kill_slot> first to remove that key." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2712 ../fish/guestfish-actions.pod:2734 ../fish/guestfish-actions.pod:2747 ../fish/guestfish-actions.pod:2761 ../fish/guestfish-actions.pod:2787 ../fish/guestfish-actions.pod:2797 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4016 ../libguestfs-1.11.19/src/guestfs-actions.pod:4056 ../libguestfs-1.11.19/src/guestfs-actions.pod:4079 ../libguestfs-1.11.19/src/guestfs-actions.pod:4099 ../libguestfs-1.11.19/src/guestfs-actions.pod:4134 ../libguestfs-1.11.19/src/guestfs-actions.pod:4153 ../src/guestfs-actions.pod:4016 ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4079 ../src/guestfs-actions.pod:4099 ../src/guestfs-actions.pod:4134 ../src/guestfs-actions.pod:4153 msgid "" -"This command has one or more key or passphrase parameters. Guestfish will " -"prompt for these separately." +"This function takes a key or passphrase parameter which could contain " +"sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " +"information." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4020 ../libguestfs-1.11.19/src/guestfs-actions.pod:4060 ../libguestfs-1.11.19/src/guestfs-actions.pod:4083 ../libguestfs-1.11.19/src/guestfs-actions.pod:4103 ../src/guestfs-actions.pod:4020 ../src/guestfs-actions.pod:4060 ../src/guestfs-actions.pod:4083 ../src/guestfs-actions.pod:4103 +msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2715 -msgid "luks-close" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:4022 +msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2717 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4024 ../src/guestfs-actions.pod:4024 #, no-wrap msgid "" -" luks-close device\n" +" int\n" +" guestfs_luks_close (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2719 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4028 ../src/guestfs-actions.pod:4028 msgid "" -"This closes a LUKS device that was created earlier by L</luks-open> or " -"L</luks-open-ro>. The C<device> parameter must be the name of the LUKS " -"mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the " +"This closes a LUKS device that was created earlier by C<guestfs_luks_open> " +"or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the " +"LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the " "underlying block device." msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4036 ../libguestfs-1.11.19/src/guestfs-actions.pod:4138 ../libguestfs-1.11.19/src/guestfs-actions.pod:4157 ../libguestfs-1.11.19/src/guestfs-actions.pod:4207 ../libguestfs-1.11.19/src/guestfs-actions.pod:4255 ../src/guestfs-actions.pod:4036 ../src/guestfs-actions.pod:4138 ../src/guestfs-actions.pod:4157 ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4255 +msgid "(Added in 1.5.1)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2725 -msgid "luks-format" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4038 ../src/guestfs-actions.pod:4038 +msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2727 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4040 ../src/guestfs-actions.pod:4040 #, no-wrap msgid "" -" luks-format device keyslot\n" +" int\n" +" guestfs_luks_format (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" int keyslot);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2740 -msgid "luks-format-cipher" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4062 ../src/guestfs-actions.pod:4062 +msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2742 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4064 ../src/guestfs-actions.pod:4064 #, no-wrap msgid "" -" luks-format-cipher device keyslot cipher\n" +" int\n" +" guestfs_luks_format_cipher (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" int keyslot,\n" +" const char *cipher);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2744 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4071 ../src/guestfs-actions.pod:4071 msgid "" -"This command is the same as L</luks-format> but it also allows you to set " -"the C<cipher> used." +"This command is the same as C<guestfs_luks_format> but it also allows you to " +"set the C<cipher> used." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2753 -msgid "luks-kill-slot" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:4085 +msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2755 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:4087 #, no-wrap msgid "" -" luks-kill-slot device keyslot\n" +" int\n" +" guestfs_luks_kill_slot (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" int keyslot);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2764 -msgid "luks-open" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4105 ../src/guestfs-actions.pod:4105 +msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2766 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4107 ../src/guestfs-actions.pod:4107 #, no-wrap msgid "" -" luks-open device mapname\n" +" int\n" +" guestfs_luks_open (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" const char *mapname);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2780 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4125 ../src/guestfs-actions.pod:4125 msgid "" -"If this block device contains LVM volume groups, then calling L</vgscan> " -"followed by L</vg-activate-all> will make them visible." +"If this block device contains LVM volume groups, then calling " +"C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " +"visible." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2784 -msgid "Use L</list-dm-devices> to list all device mapper devices." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4129 ../src/guestfs-actions.pod:4129 +msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2790 -msgid "luks-open-ro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4140 ../src/guestfs-actions.pod:4140 +msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2792 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4142 ../src/guestfs-actions.pod:4142 #, no-wrap msgid "" -" luks-open-ro device mapname\n" +" int\n" +" guestfs_luks_open_ro (guestfs_h *g,\n" +" const char *device,\n" +" const char *key,\n" +" const char *mapname);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2794 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4148 ../src/guestfs-actions.pod:4148 msgid "" -"This is the same as L</luks-open> except that a read-only mapping is " +"This is the same as C<guestfs_luks_open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2800 -msgid "lvcreate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4159 ../src/guestfs-actions.pod:4159 +msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2802 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4161 ../src/guestfs-actions.pod:4161 #, no-wrap msgid "" -" lvcreate logvol volgroup mbytes\n" +" int\n" +" guestfs_lvcreate (guestfs_h *g,\n" +" const char *logvol,\n" +" const char *volgroup,\n" +" int mbytes);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2807 -msgid "lvm-canonical-lv-name" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4174 ../src/guestfs-actions.pod:4174 +msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2809 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4176 ../src/guestfs-actions.pod:4176 #, no-wrap msgid "" -" lvm-canonical-lv-name lvname\n" +" char *\n" +" guestfs_lvm_canonical_lv_name (guestfs_h *g,\n" +" const char *lvname);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2818 -msgid "See also L</is-lv>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4187 ../src/guestfs-actions.pod:4187 +msgid "See also C<guestfs_is_lv>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4192 ../src/guestfs-actions.pod:4192 +msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2820 -msgid "lvm-clear-filter" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4194 ../src/guestfs-actions.pod:4194 +msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2822 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4196 ../src/guestfs-actions.pod:4196 #, no-wrap msgid "" -" lvm-clear-filter\n" +" int\n" +" guestfs_lvm_clear_filter (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2824 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4199 ../src/guestfs-actions.pod:4199 msgid "" -"This undoes the effect of L</lvm-set-filter>. LVM will be able to see every " -"block device." +"This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to " +"see every block device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2830 -msgid "lvm-remove-all" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4209 ../src/guestfs-actions.pod:4209 +msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2832 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4211 ../src/guestfs-actions.pod:4211 #, no-wrap msgid "" -" lvm-remove-all\n" +" int\n" +" guestfs_lvm_remove_all (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2840 -msgid "lvm-set-filter" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4224 ../src/guestfs-actions.pod:4224 +msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2842 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4226 ../src/guestfs-actions.pod:4226 #, no-wrap msgid "" -" lvm-set-filter 'devices ...'\n" +" int\n" +" guestfs_lvm_set_filter (guestfs_h *g,\n" +" char *const *devices);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2867 -msgid "lvremove" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4257 ../src/guestfs-actions.pod:4257 +msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2869 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4259 ../src/guestfs-actions.pod:4259 #, no-wrap msgid "" -" lvremove device\n" +" int\n" +" guestfs_lvremove (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4271 ../libguestfs-1.11.19/src/guestfs-actions.pod:5674 ../libguestfs-1.11.19/src/guestfs-actions.pod:7508 ../src/guestfs-actions.pod:4271 ../src/guestfs-actions.pod:5674 ../src/guestfs-actions.pod:7508 +msgid "(Added in 1.0.13)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2877 -msgid "lvrename" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4273 ../src/guestfs-actions.pod:4273 +msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2879 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4275 ../src/guestfs-actions.pod:4275 #, no-wrap msgid "" -" lvrename logvol newlogvol\n" +" int\n" +" guestfs_lvrename (guestfs_h *g,\n" +" const char *logvol,\n" +" const char *newlogvol);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4284 ../libguestfs-1.11.19/src/guestfs-actions.pod:7521 ../src/guestfs-actions.pod:4284 ../src/guestfs-actions.pod:7521 +msgid "(Added in 1.0.83)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2883 -msgid "lvresize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4286 ../src/guestfs-actions.pod:4286 +msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2885 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4288 ../src/guestfs-actions.pod:4288 #, no-wrap msgid "" -" lvresize device mbytes\n" +" int\n" +" guestfs_lvresize (guestfs_h *g,\n" +" const char *device,\n" +" int mbytes);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2891 -msgid "lvresize-free" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4301 ../src/guestfs-actions.pod:4301 +msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2893 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4303 ../src/guestfs-actions.pod:4303 #, no-wrap msgid "" -" lvresize-free lv percent\n" +" int\n" +" guestfs_lvresize_free (guestfs_h *g,\n" +" const char *lv,\n" +" int percent);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4316 ../src/guestfs-actions.pod:4316 +msgid "(Added in 1.3.3)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2901 -msgid "lvs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4318 +msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2903 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4320 ../src/guestfs-actions.pod:4320 #, no-wrap msgid "" -" lvs\n" +" char **\n" +" guestfs_lvs (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2911 -msgid "See also L</lvs-full>, L</list-filesystems>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4329 +msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2913 -msgid "lvs-full" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4337 ../src/guestfs-actions.pod:4337 +msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2915 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4339 ../src/guestfs-actions.pod:4339 #, no-wrap msgid "" -" lvs-full\n" +" struct guestfs_lvm_lv_list *\n" +" guestfs_lvs_full (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4345 ../src/guestfs-actions.pod:4345 +msgid "" +"This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there " +"was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after " +"use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:2920 -msgid "lvuuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4351 ../src/guestfs-actions.pod:4351 +msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2922 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4353 ../src/guestfs-actions.pod:4353 #, no-wrap msgid "" -" lvuuid device\n" +" char *\n" +" guestfs_lvuuid (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2926 -msgid "lxattrlist" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4364 ../src/guestfs-actions.pod:4364 +msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2928 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4366 ../src/guestfs-actions.pod:4366 #, no-wrap msgid "" -" lxattrlist path 'names ...'\n" +" struct guestfs_xattr_list *\n" +" guestfs_lxattrlist (guestfs_h *g,\n" +" const char *path,\n" +" char *const *names);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2944 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4385 ../src/guestfs-actions.pod:4385 msgid "" "This call is intended for programs that want to efficiently list a directory " -"contents without making many round-trips. See also L</lstatlist> for a " -"similarly efficient call for getting standard stats. Very long directory " +"contents without making many round-trips. See also C<guestfs_lstatlist> for " +"a similarly efficient call for getting standard stats. Very long directory " "listings might cause the protocol message size to be exceeded, causing this " "call to fail. The caller must split up such requests into smaller groups of " "names." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2952 -msgid "mkdir" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4399 ../src/guestfs-actions.pod:4399 +msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2954 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4401 ../src/guestfs-actions.pod:4401 #, no-wrap msgid "" -" mkdir path\n" +" int\n" +" guestfs_mkdir (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2958 -msgid "mkdir-mode" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4411 ../src/guestfs-actions.pod:4411 +msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2960 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4413 #, no-wrap msgid "" -" mkdir-mode path mode\n" +" int\n" +" guestfs_mkdir_mode (guestfs_h *g,\n" +" const char *path,\n" +" int mode);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2969 -msgid "See also L</mkdir>, L</umask>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4425 ../src/guestfs-actions.pod:4425 +msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2971 -msgid "mkdir-p" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4431 ../src/guestfs-actions.pod:4431 +msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2973 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4433 ../src/guestfs-actions.pod:4433 #, no-wrap msgid "" -" mkdir-p path\n" +" int\n" +" guestfs_mkdir_p (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2978 -msgid "mkdtemp" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4444 ../src/guestfs-actions.pod:4444 +msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2980 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4446 ../src/guestfs-actions.pod:4446 #, no-wrap msgid "" -" mkdtemp template\n" +" char *\n" +" guestfs_mkdtemp (guestfs_h *g,\n" +" const char *template);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3001 -msgid "mke2fs-J" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4474 ../src/guestfs-actions.pod:4474 +msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3003 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4476 ../src/guestfs-actions.pod:4476 #, no-wrap msgid "" -" mke2fs-J fstype blocksize device journal\n" +" int\n" +" guestfs_mke2fs_J (guestfs_h *g,\n" +" const char *fstype,\n" +" int blocksize,\n" +" const char *device,\n" +" const char *journal);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3011 -msgid "See also L</mke2journal>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4489 ../src/guestfs-actions.pod:4489 +msgid "See also C<guestfs_mke2journal>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4493 ../libguestfs-1.11.19/src/guestfs-actions.pod:4511 ../libguestfs-1.11.19/src/guestfs-actions.pod:4529 ../libguestfs-1.11.19/src/guestfs-actions.pod:4545 ../libguestfs-1.11.19/src/guestfs-actions.pod:4559 ../libguestfs-1.11.19/src/guestfs-actions.pod:4573 ../libguestfs-1.11.19/src/guestfs-actions.pod:4632 ../libguestfs-1.11.19/src/guestfs-actions.pod:4909 ../src/guestfs-actions.pod:4493 ../src/guestfs-actions.pod:4511 ../src/guestfs-actions.pod:4529 ../src/guestfs-actions.pod:4545 ../src/guestfs-actions.pod:4559 ../src/guestfs-actions.pod:4573 ../src/guestfs-actions.pod:4632 ../src/guestfs-actions.pod:4909 +msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3013 -msgid "mke2fs-JL" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4495 ../src/guestfs-actions.pod:4495 +msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3015 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4497 ../src/guestfs-actions.pod:4497 #, no-wrap msgid "" -" mke2fs-JL fstype blocksize device label\n" +" int\n" +" guestfs_mke2fs_JL (guestfs_h *g,\n" +" const char *fstype,\n" +" int blocksize,\n" +" const char *device,\n" +" const char *label);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3020 -msgid "See also L</mke2journal-L>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4507 +msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3022 -msgid "mke2fs-JU" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4513 ../src/guestfs-actions.pod:4513 +msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3024 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4515 ../src/guestfs-actions.pod:4515 #, no-wrap msgid "" -" mke2fs-JU fstype blocksize device uuid\n" +" int\n" +" guestfs_mke2fs_JU (guestfs_h *g,\n" +" const char *fstype,\n" +" int blocksize,\n" +" const char *device,\n" +" const char *uuid);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3029 -msgid "See also L</mke2journal-U>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4525 ../src/guestfs-actions.pod:4525 +msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3031 -msgid "mke2journal" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4531 ../src/guestfs-actions.pod:4531 +msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3033 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4533 ../src/guestfs-actions.pod:4533 #, no-wrap msgid "" -" mke2journal blocksize device\n" +" int\n" +" guestfs_mke2journal (guestfs_h *g,\n" +" int blocksize,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3040 -msgid "mke2journal-L" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4547 ../src/guestfs-actions.pod:4547 +msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3042 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4549 ../src/guestfs-actions.pod:4549 #, no-wrap msgid "" -" mke2journal-L blocksize label device\n" +" int\n" +" guestfs_mke2journal_L (guestfs_h *g,\n" +" int blocksize,\n" +" const char *label,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3046 -msgid "mke2journal-U" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4561 ../src/guestfs-actions.pod:4561 +msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3048 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4563 ../src/guestfs-actions.pod:4563 #, no-wrap msgid "" -" mke2journal-U blocksize uuid device\n" +" int\n" +" guestfs_mke2journal_U (guestfs_h *g,\n" +" int blocksize,\n" +" const char *uuid,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3052 -msgid "mkfifo" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4575 ../src/guestfs-actions.pod:4575 +msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3054 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4577 ../src/guestfs-actions.pod:4577 #, no-wrap msgid "" -" mkfifo mode path\n" +" int\n" +" guestfs_mkfifo (guestfs_h *g,\n" +" int mode,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3056 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4582 ../src/guestfs-actions.pod:4582 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " -"is just a convenient wrapper around L</mknod>." +"is just a convenient wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3062 -msgid "mkfs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4592 ../src/guestfs-actions.pod:4592 +msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3064 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4594 ../src/guestfs-actions.pod:4594 #, no-wrap msgid "" -" mkfs fstype device\n" +" int\n" +" guestfs_mkfs (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3070 -msgid "mkfs-b" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4607 +msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3072 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4609 ../src/guestfs-actions.pod:4609 #, no-wrap msgid "" -" mkfs-b fstype blocksize device\n" +" int\n" +" guestfs_mkfs_b (guestfs_h *g,\n" +" const char *fstype,\n" +" int blocksize,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3074 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4615 ../src/guestfs-actions.pod:4615 msgid "" -"This call is similar to L</mkfs>, but it allows you to control the block " -"size of the resulting filesystem. Supported block sizes depend on the " +"This call is similar to C<guestfs_mkfs>, but it allows you to control the " +"block size of the resulting filesystem. Supported block sizes depend on the " "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3089 -msgid "mkfs-opts" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4634 ../src/guestfs-actions.pod:4634 +msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3091 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4636 ../src/guestfs-actions.pod:4636 #, no-wrap msgid "" -" mkfs-opts fstype device [blocksize:..] [features:..] [inode:..] " -"[sectorsize:..]\n" +" int\n" +" guestfs_mkfs_opts (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" ...);\n" "\n" msgstr "" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4647 ../src/guestfs-actions.pod:4647 +#, no-wrap +msgid "" +" GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" +" GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n" +" GUESTFS_MKFS_OPTS_INODE, int inode,\n" +" GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4695 ../src/guestfs-actions.pod:4695 +msgid "(Added in 1.7.19)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:3136 -msgid "mkmountpoint" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4697 ../src/guestfs-actions.pod:4697 +msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3138 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4699 ../src/guestfs-actions.pod:4699 #, no-wrap msgid "" -" mkmountpoint exemptpath\n" +" int\n" +" guestfs_mkfs_opts_va (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" va_list args);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3140 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4705 ../src/guestfs-actions.pod:4705 +msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:4709 +msgid "guestfs_mkfs_opts_argv" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4711 ../src/guestfs-actions.pod:4711 +#, no-wrap msgid "" -"L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used " -"to create extra mountpoints before mounting the first filesystem." +" int\n" +" guestfs_mkfs_opts_argv (guestfs_h *g,\n" +" const char *fstype,\n" +" const char *device,\n" +" const struct guestfs_mkfs_opts_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4717 ../src/guestfs-actions.pod:4717 +msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4721 ../src/guestfs-actions.pod:4721 +msgid "guestfs_mkmountpoint" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4723 ../src/guestfs-actions.pod:4723 +#, no-wrap +msgid "" +" int\n" +" guestfs_mkmountpoint (guestfs_h *g,\n" +" const char *exemptpath);\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3164 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4727 ../src/guestfs-actions.pod:4727 msgid "" -"L</mkmountpoint> is not compatible with L</umount-all>. You may get " -"unexpected errors if you try to mix these calls. It is safest to manually " -"unmount filesystems and remove mountpoints after use." +"C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " +"that can be used to create extra mountpoints before mounting the first " +"filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3168 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4751 ../src/guestfs-actions.pod:4751 msgid "" -"L</umount-all> unmounts filesystems by sorting the paths longest first, so " -"for this to work for manual mountpoints, you must ensure that the innermost " -"mountpoints have the longest pathnames, as in the example code above." +"C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You " +"may get unexpected errors if you try to mix these calls. It is safest to " +"manually unmount filesystems and remove mountpoints after use." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3175 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4755 msgid "" -"Autosync [see L</set-autosync>, this is set by default on handles] can cause " -"L</umount-all> to be called when the handle is closed which can also trigger " -"these issues." +"C<guestfs_umount_all> unmounts filesystems by sorting the paths longest " +"first, so for this to work for manual mountpoints, you must ensure that the " +"innermost mountpoints have the longest pathnames, as in the example code " +"above." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4762 ../src/guestfs-actions.pod:4762 +msgid "" +"Autosync [see C<guestfs_set_autosync>, this is set by default on handles] " +"can cause C<guestfs_umount_all> to be called when the handle is closed which " +"can also trigger these issues." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4768 ../libguestfs-1.11.19/src/guestfs-actions.pod:5084 ../libguestfs-1.11.19/src/guestfs-actions.pod:6094 ../src/guestfs-actions.pod:4768 ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:6094 +msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3179 -msgid "mknod" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4770 ../src/guestfs-actions.pod:4770 +msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3181 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4772 ../src/guestfs-actions.pod:4772 #, no-wrap msgid "" -" mknod mode devmajor devminor path\n" +" int\n" +" guestfs_mknod (guestfs_h *g,\n" +" int mode,\n" +" int devmajor,\n" +" int devminor,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3191 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4787 ../src/guestfs-actions.pod:4787 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " "regular file). These constants are available in the standard Linux header " -"files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are " -"wrappers around this command which bitwise OR in the appropriate constant " -"for you." +"files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or " +"C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in " +"the appropriate constant for you." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3201 -msgid "mknod-b" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4801 ../src/guestfs-actions.pod:4801 +msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3203 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4803 ../src/guestfs-actions.pod:4803 #, no-wrap msgid "" -" mknod-b mode devmajor devminor path\n" +" int\n" +" guestfs_mknod_b (guestfs_h *g,\n" +" int mode,\n" +" int devmajor,\n" +" int devminor,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3205 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4810 ../src/guestfs-actions.pod:4810 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " -"wrapper around L</mknod>." +"wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3211 -msgid "mknod-c" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4820 ../src/guestfs-actions.pod:4820 +msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3213 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4822 ../src/guestfs-actions.pod:4822 #, no-wrap msgid "" -" mknod-c mode devmajor devminor path\n" +" int\n" +" guestfs_mknod_c (guestfs_h *g,\n" +" int mode,\n" +" int devmajor,\n" +" int devminor,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3215 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4829 ../src/guestfs-actions.pod:4829 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " -"wrapper around L</mknod>." +"wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3221 -msgid "mkswap" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4839 ../src/guestfs-actions.pod:4839 +msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3223 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4841 ../src/guestfs-actions.pod:4841 #, no-wrap msgid "" -" mkswap device\n" +" int\n" +" guestfs_mkswap (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3227 -msgid "mkswap-L" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4851 ../src/guestfs-actions.pod:4851 +msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3229 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4853 ../src/guestfs-actions.pod:4853 #, no-wrap msgid "" -" mkswap-L label device\n" +" int\n" +" guestfs_mkswap_L (guestfs_h *g,\n" +" const char *label,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3237 -msgid "mkswap-U" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4868 ../src/guestfs-actions.pod:4868 +msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3239 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4870 ../src/guestfs-actions.pod:4870 #, no-wrap msgid "" -" mkswap-U uuid device\n" +" int\n" +" guestfs_mkswap_U (guestfs_h *g,\n" +" const char *uuid,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3243 -msgid "mkswap-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:4881 +msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3245 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4883 ../src/guestfs-actions.pod:4883 #, no-wrap msgid "" -" mkswap-file path\n" +" int\n" +" guestfs_mkswap_file (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3249 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4889 ../src/guestfs-actions.pod:4889 msgid "" "This command just writes a swap file signature to an existing file. To " -"create the file itself, use something like L</fallocate>." +"create the file itself, use something like C<guestfs_fallocate>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3252 -msgid "modprobe" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4896 ../src/guestfs-actions.pod:4896 +msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3254 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4898 ../src/guestfs-actions.pod:4898 #, no-wrap msgid "" -" modprobe modulename\n" +" int\n" +" guestfs_modprobe (guestfs_h *g,\n" +" const char *modulename);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3261 -msgid "mount" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4911 ../src/guestfs-actions.pod:4911 +msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3263 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4913 ../src/guestfs-actions.pod:4913 #, no-wrap msgid "" -" mount device mountpoint\n" +" int\n" +" guestfs_mount (guestfs_h *g,\n" +" const char *device,\n" +" const char *mountpoint);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3279 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4932 ../src/guestfs-actions.pod:4932 msgid "" "B<Important note:> When you use this call, the filesystem options C<sync> " "and C<noatime> are set implicitly. This was originally done because we " "thought it would improve reliability, but it turns out that I<-o sync> has a " "very large negative performance impact and negligible effect on " -"reliability. Therefore we recommend that you avoid using L</mount> in any " -"code that needs performance, and instead use L</mount-options> (use an empty " -"string for the first parameter if you don't want any options)." +"reliability. Therefore we recommend that you avoid using C<guestfs_mount> " +"in any code that needs performance, and instead use C<guestfs_mount_options> " +"(use an empty string for the first parameter if you don't want any options)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3296 -msgid "mount-9p" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4953 ../src/guestfs-actions.pod:4953 +msgid "guestfs_mount_9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3298 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4955 ../src/guestfs-actions.pod:4955 #, no-wrap msgid "" -" mount-9p mounttag mountpoint [options:..]\n" +" int\n" +" guestfs_mount_9p (guestfs_h *g,\n" +" const char *mounttag,\n" +" const char *mountpoint,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4966 ../src/guestfs-actions.pod:4966 +#, no-wrap +msgid "" +" GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3309 -msgid "mount-loop" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4979 ../src/guestfs-actions.pod:4979 +msgid "guestfs_mount_9p_va" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3311 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4981 ../src/guestfs-actions.pod:4981 #, no-wrap msgid "" -" mount-loop file mountpoint\n" +" int\n" +" guestfs_mount_9p_va (guestfs_h *g,\n" +" const char *mounttag,\n" +" const char *mountpoint,\n" +" va_list args);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4987 ../src/guestfs-actions.pod:4987 +msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:3317 -msgid "mount-options" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4991 ../src/guestfs-actions.pod:4991 +msgid "guestfs_mount_9p_argv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3319 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4993 ../src/guestfs-actions.pod:4993 #, no-wrap msgid "" -" mount-options options device mountpoint\n" +" int\n" +" guestfs_mount_9p_argv (guestfs_h *g,\n" +" const char *mounttag,\n" +" const char *mountpoint,\n" +" const struct guestfs_mount_9p_argv *optargs);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3321 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:4999 +msgid "This is the \"argv variant\" of L</guestfs_mount_9p>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5003 ../src/guestfs-actions.pod:5003 +msgid "guestfs_mount_loop" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5005 ../src/guestfs-actions.pod:5005 +#, no-wrap msgid "" -"This is the same as the L</mount> command, but it allows you to set the " -"mount options as for the L<mount(8)> I<-o> flag." +" int\n" +" guestfs_mount_loop (guestfs_h *g,\n" +" const char *file,\n" +" const char *mountpoint);\n" +"\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3329 -msgid "mount-ro" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5018 ../src/guestfs-actions.pod:5018 +msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3331 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5020 ../src/guestfs-actions.pod:5020 #, no-wrap msgid "" -" mount-ro device mountpoint\n" +" int\n" +" guestfs_mount_options (guestfs_h *g,\n" +" const char *options,\n" +" const char *device,\n" +" const char *mountpoint);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3333 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5026 ../src/guestfs-actions.pod:5026 msgid "" -"This is the same as the L</mount> command, but it mounts the filesystem with " -"the read-only (I<-o ro>) flag." +"This is the same as the C<guestfs_mount> command, but it allows you to set " +"the mount options as for the L<mount(8)> I<-o> flag." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5036 ../libguestfs-1.11.19/src/guestfs-actions.pod:5050 ../libguestfs-1.11.19/src/guestfs-actions.pod:5067 ../src/guestfs-actions.pod:5036 ../src/guestfs-actions.pod:5050 ../src/guestfs-actions.pod:5067 +msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3336 -msgid "mount-vfs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5038 ../src/guestfs-actions.pod:5038 +msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3338 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5040 ../src/guestfs-actions.pod:5040 #, no-wrap msgid "" -" mount-vfs options vfstype device mountpoint\n" +" int\n" +" guestfs_mount_ro (guestfs_h *g,\n" +" const char *device,\n" +" const char *mountpoint);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3340 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5045 msgid "" -"This is the same as the L</mount> command, but it allows you to set both the " -"mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags." +"This is the same as the C<guestfs_mount> command, but it mounts the " +"filesystem with the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3344 -msgid "mountpoints" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5052 ../src/guestfs-actions.pod:5052 +msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3346 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5054 ../src/guestfs-actions.pod:5054 #, no-wrap msgid "" -" mountpoints\n" +" int\n" +" guestfs_mount_vfs (guestfs_h *g,\n" +" const char *options,\n" +" const char *vfstype,\n" +" const char *device,\n" +" const char *mountpoint);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3348 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5061 ../src/guestfs-actions.pod:5061 msgid "" -"This call is similar to L</mounts>. That call returns a list of devices. " -"This one returns a hash table (map) of device name to directory where the " -"device is mounted." +"This is the same as the C<guestfs_mount> command, but it allows you to set " +"both the mount options and the vfstype as for the L<mount(8)> I<-o> and " +"I<-t> flags." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3352 -msgid "mounts" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5069 ../src/guestfs-actions.pod:5069 +msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3354 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5071 ../src/guestfs-actions.pod:5071 #, no-wrap msgid "" -" mounts\n" +" char **\n" +" guestfs_mountpoints (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3361 -msgid "See also: L</mountpoints>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5074 +msgid "" +"This call is similar to C<guestfs_mounts>. That call returns a list of " +"devices. This one returns a hash table (map) of device name to directory " +"where the device is mounted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3363 -msgid "mv" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5086 ../src/guestfs-actions.pod:5086 +msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3365 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5088 ../src/guestfs-actions.pod:5088 #, no-wrap msgid "" -" mv src dest\n" +" char **\n" +" guestfs_mounts (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5096 ../src/guestfs-actions.pod:5096 +msgid "See also: C<guestfs_mountpoints>" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5104 ../src/guestfs-actions.pod:5104 +msgid "guestfs_mv" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5106 ../src/guestfs-actions.pod:5106 +#, no-wrap +msgid "" +" int\n" +" guestfs_mv (guestfs_h *g,\n" +" const char *src,\n" +" const char *dest);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3370 -msgid "ntfs-3g-probe" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5118 ../src/guestfs-actions.pod:5118 +msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3372 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5120 ../src/guestfs-actions.pod:5120 #, no-wrap msgid "" -" ntfs-3g-probe true|false device\n" +" int\n" +" guestfs_ntfs_3g_probe (guestfs_h *g,\n" +" int rw,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5139 ../src/guestfs-actions.pod:5139 +msgid "(Added in 1.0.43)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:3386 -msgid "ntfsresize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5141 ../src/guestfs-actions.pod:5141 +msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3388 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5143 ../src/guestfs-actions.pod:5143 #, no-wrap msgid "" -" ntfsresize device\n" +" int\n" +" guestfs_ntfsresize (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3410 -msgid "ntfsresize-opts" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5171 ../src/guestfs-actions.pod:5171 +msgid "guestfs_ntfsresize_opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3412 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5173 ../src/guestfs-actions.pod:5173 #, no-wrap msgid "" -" ntfsresize-opts device [size:..] [force:..]\n" +" int\n" +" guestfs_ntfsresize_opts (guestfs_h *g,\n" +" const char *device,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5183 ../src/guestfs-actions.pod:5183 +#, no-wrap +msgid "" +" GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n" +" GUESTFS_NTFSRESIZE_OPTS_FORCE, int force,\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3431 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5203 ../src/guestfs-actions.pod:5203 msgid "" "After the resize operation, the filesystem is always marked as requiring a " "consistency check (for safety). You have to boot into Windows to perform " "this check and clear this condition. If you I<don't> set the C<force> " -"option then it is not possible to call L</ntfsresize-opts> multiple times on " -"a single filesystem without booting into Windows between each resize." +"option then it is not possible to call C<guestfs_ntfsresize_opts> multiple " +"times on a single filesystem without booting into Windows between each " +"resize." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3444 -msgid "ntfsresize-size" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5218 ../src/guestfs-actions.pod:5218 +msgid "guestfs_ntfsresize_opts_va" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3446 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5220 ../src/guestfs-actions.pod:5220 #, no-wrap msgid "" -" ntfsresize-size device size\n" +" int\n" +" guestfs_ntfsresize_opts_va (guestfs_h *g,\n" +" const char *device,\n" +" va_list args);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3448 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5225 ../src/guestfs-actions.pod:5225 +msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5229 ../src/guestfs-actions.pod:5229 +msgid "guestfs_ntfsresize_opts_argv" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5231 ../src/guestfs-actions.pod:5231 +#, no-wrap msgid "" -"This command is the same as L</ntfsresize> except that it allows you to " -"specify the new size (in bytes) explicitly." +" int\n" +" guestfs_ntfsresize_opts_argv (guestfs_h *g,\n" +" const char *device,\n" +" const struct guestfs_ntfsresize_opts_argv " +"*optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5236 ../src/guestfs-actions.pod:5236 +msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3458 -msgid "part-add" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5240 ../src/guestfs-actions.pod:5240 +msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3460 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5242 ../src/guestfs-actions.pod:5242 #, no-wrap msgid "" -" part-add device prlogex startsect endsect\n" +" int\n" +" guestfs_ntfsresize_size (guestfs_h *g,\n" +" const char *device,\n" +" int64_t size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3462 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5247 ../src/guestfs-actions.pod:5247 +msgid "" +"This command is the same as C<guestfs_ntfsresize> except that it allows you " +"to specify the new size (in bytes) explicitly." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5259 ../libguestfs-1.11.19/src/guestfs-actions.pod:5701 ../libguestfs-1.11.19/src/guestfs-actions.pod:5774 ../libguestfs-1.11.19/src/guestfs-actions.pod:6042 ../libguestfs-1.11.19/src/guestfs-actions.pod:7665 ../src/guestfs-actions.pod:5259 ../src/guestfs-actions.pod:5701 ../src/guestfs-actions.pod:5774 ../src/guestfs-actions.pod:6042 ../src/guestfs-actions.pod:7665 +msgid "(Added in 1.3.14)" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5261 ../src/guestfs-actions.pod:5261 +msgid "guestfs_part_add" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5263 ../src/guestfs-actions.pod:5263 +#, no-wrap +msgid "" +" int\n" +" guestfs_part_add (guestfs_h *g,\n" +" const char *device,\n" +" const char *prlogex,\n" +" int64_t startsect,\n" +" int64_t endsect);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5270 ../src/guestfs-actions.pod:5270 msgid "" "This command adds a partition to C<device>. If there is no partition table " -"on the device, call L</part-init> first." +"on the device, call C<guestfs_part_init> first." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3474 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5282 ../src/guestfs-actions.pod:5282 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " -"L</part-disk> to do that." +"C<guestfs_part_disk> to do that." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5287 ../libguestfs-1.11.19/src/guestfs-actions.pod:5325 ../libguestfs-1.11.19/src/guestfs-actions.pod:5378 ../libguestfs-1.11.19/src/guestfs-actions.pod:5462 ../libguestfs-1.11.19/src/guestfs-actions.pod:5500 ../libguestfs-1.11.19/src/guestfs-actions.pod:5519 ../libguestfs-1.11.19/src/guestfs-actions.pod:5559 ../src/guestfs-actions.pod:5287 ../src/guestfs-actions.pod:5325 ../src/guestfs-actions.pod:5378 ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:5500 ../src/guestfs-actions.pod:5519 ../src/guestfs-actions.pod:5559 +msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3477 -msgid "part-del" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5289 ../src/guestfs-actions.pod:5289 +msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3479 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5291 ../src/guestfs-actions.pod:5291 #, no-wrap msgid "" -" part-del device partnum\n" +" int\n" +" guestfs_part_del (guestfs_h *g,\n" +" const char *device,\n" +" int partnum);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3487 -msgid "part-disk" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:5306 +msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3489 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5308 ../src/guestfs-actions.pod:5308 #, no-wrap msgid "" -" part-disk device parttype\n" +" int\n" +" guestfs_part_disk (guestfs_h *g,\n" +" const char *device,\n" +" const char *parttype);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3491 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5313 ../src/guestfs-actions.pod:5313 msgid "" -"This command is simply a combination of L</part-init> followed by " -"L</part-add> to create a single primary partition covering the whole disk." +"This command is simply a combination of C<guestfs_part_init> followed by " +"C<guestfs_part_add> to create a single primary partition covering the whole " +"disk." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3495 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5317 ../src/guestfs-actions.pod:5317 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " -"possible values are described in L</part-init>." +"possible values are described in C<guestfs_part_init>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3501 -msgid "part-get-bootable" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:5327 +msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3503 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5329 #, no-wrap msgid "" -" part-get-bootable device partnum\n" +" int\n" +" guestfs_part_get_bootable (guestfs_h *g,\n" +" const char *device,\n" +" int partnum);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3508 -msgid "See also L</part-set-bootable>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5337 ../src/guestfs-actions.pod:5337 +msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3510 -msgid "part-get-mbr-id" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5343 ../src/guestfs-actions.pod:5343 +msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3512 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5345 ../src/guestfs-actions.pod:5345 #, no-wrap msgid "" -" part-get-mbr-id device partnum\n" +" int\n" +" guestfs_part_get_mbr_id (guestfs_h *g,\n" +" const char *device,\n" +" int partnum);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3517 ../fish/guestfish-actions.pod:3655 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5353 ../libguestfs-1.11.19/src/guestfs-actions.pod:5535 ../src/guestfs-actions.pod:5353 ../src/guestfs-actions.pod:5535 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " -"L</part-get-parttype>)." +"C<guestfs_part_get_parttype>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3521 -msgid "part-get-parttype" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5361 ../src/guestfs-actions.pod:5361 +msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3523 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5363 ../src/guestfs-actions.pod:5363 #, no-wrap msgid "" -" part-get-parttype device\n" +" char *\n" +" guestfs_part_get_parttype (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3528 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5370 ../src/guestfs-actions.pod:5370 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " -"possible, although unusual. See L</part-init> for a full list." +"possible, although unusual. See C<guestfs_part_init> for a full list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3533 -msgid "part-init" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5380 ../src/guestfs-actions.pod:5380 +msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3535 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5382 ../src/guestfs-actions.pod:5382 #, no-wrap msgid "" -" part-init device parttype\n" +" int\n" +" guestfs_part_init (guestfs_h *g,\n" +" const char *device,\n" +" const char *parttype);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3541 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5391 ../src/guestfs-actions.pod:5391 msgid "" "Initially there are no partitions. Following this, you should call " -"L</part-add> for each partition required." +"C<guestfs_part_add> for each partition required." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3604 -msgid "part-list" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5464 ../src/guestfs-actions.pod:5464 +msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3606 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5466 #, no-wrap msgid "" -" part-list device\n" +" struct guestfs_partition_list *\n" +" guestfs_part_list (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3621 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5483 ../src/guestfs-actions.pod:5483 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " -"the device's sector size, see L</blockdev-getss>." +"the device's sector size, see C<guestfs_blockdev_getss>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5496 ../src/guestfs-actions.pod:5496 +msgid "" +"This function returns a C<struct guestfs_partition_list *>, or NULL if there " +"was an error. I<The caller must call C<guestfs_free_partition_list> after " +"use>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3634 -msgid "part-set-bootable" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5502 ../src/guestfs-actions.pod:5502 +msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3636 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5504 ../src/guestfs-actions.pod:5504 #, no-wrap msgid "" -" part-set-bootable device partnum true|false\n" +" int\n" +" guestfs_part_set_bootable (guestfs_h *g,\n" +" const char *device,\n" +" int partnum,\n" +" int bootable);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3645 -msgid "part-set-mbr-id" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5521 ../src/guestfs-actions.pod:5521 +msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3647 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5523 ../src/guestfs-actions.pod:5523 #, no-wrap msgid "" -" part-set-mbr-id device partnum idbyte\n" +" int\n" +" guestfs_part_set_mbr_id (guestfs_h *g,\n" +" const char *device,\n" +" int partnum,\n" +" int idbyte);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3659 -msgid "part-set-name" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5543 ../src/guestfs-actions.pod:5543 +msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3661 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5545 ../src/guestfs-actions.pod:5545 #, no-wrap msgid "" -" part-set-name device partnum name\n" +" int\n" +" guestfs_part_set_name (guestfs_h *g,\n" +" const char *device,\n" +" int partnum,\n" +" const char *name);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3669 -msgid "part-to-dev" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5561 ../src/guestfs-actions.pod:5561 +msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3671 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5563 ../src/guestfs-actions.pod:5563 #, no-wrap msgid "" -" part-to-dev partition\n" +" char *\n" +" guestfs_part_to_dev (guestfs_h *g,\n" +" const char *partition);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3677 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5571 ../src/guestfs-actions.pod:5571 msgid "" "The named partition must exist, for example as a string returned from " -"L</list-partitions>." +"C<guestfs_list_partitions>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3680 -msgid "ping-daemon" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5579 ../src/guestfs-actions.pod:5579 +msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3682 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5581 ../src/guestfs-actions.pod:5581 #, no-wrap msgid "" -" ping-daemon\n" +" int\n" +" guestfs_ping_daemon (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3689 -msgid "pread" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5593 ../src/guestfs-actions.pod:5593 +msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3691 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5595 ../src/guestfs-actions.pod:5595 #, no-wrap msgid "" -" pread path count offset\n" +" char *\n" +" guestfs_pread (guestfs_h *g,\n" +" const char *path,\n" +" int count,\n" +" int64_t offset,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3699 -msgid "See also L</pwrite>, L</pread-device>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5608 ../src/guestfs-actions.pod:5608 +msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3704 -msgid "pread-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5619 ../src/guestfs-actions.pod:5619 +msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3706 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5621 ../src/guestfs-actions.pod:5621 #, no-wrap msgid "" -" pread-device device count offset\n" +" char *\n" +" guestfs_pread_device (guestfs_h *g,\n" +" const char *device,\n" +" int count,\n" +" int64_t offset,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3714 -msgid "See also L</pread>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5634 +msgid "See also C<guestfs_pread>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5643 ../src/guestfs-actions.pod:5643 +msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3719 -msgid "pvcreate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5645 ../src/guestfs-actions.pod:5645 +msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3721 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5647 ../src/guestfs-actions.pod:5647 #, no-wrap msgid "" -" pvcreate device\n" +" int\n" +" guestfs_pvcreate (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3727 -msgid "pvremove" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5659 ../src/guestfs-actions.pod:5659 +msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3729 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5661 ../src/guestfs-actions.pod:5661 #, no-wrap msgid "" -" pvremove device\n" +" int\n" +" guestfs_pvremove (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3738 -msgid "pvresize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5676 ../src/guestfs-actions.pod:5676 +msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3740 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5678 ../src/guestfs-actions.pod:5678 #, no-wrap msgid "" -" pvresize device\n" +" int\n" +" guestfs_pvresize (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3745 -msgid "pvresize-size" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5689 ../src/guestfs-actions.pod:5689 +msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3747 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5691 ../src/guestfs-actions.pod:5691 #, no-wrap msgid "" -" pvresize-size device size\n" +" int\n" +" guestfs_pvresize_size (guestfs_h *g,\n" +" const char *device,\n" +" int64_t size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3749 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5696 ../src/guestfs-actions.pod:5696 msgid "" -"This command is the same as L</pvresize> except that it allows you to " +"This command is the same as C<guestfs_pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3752 -msgid "pvs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5703 ../src/guestfs-actions.pod:5703 +msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3754 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5705 ../src/guestfs-actions.pod:5705 #, no-wrap msgid "" -" pvs\n" +" char **\n" +" guestfs_pvs (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3762 -msgid "See also L</pvs-full>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5714 ../src/guestfs-actions.pod:5714 +msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3764 -msgid "pvs-full" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5722 ../src/guestfs-actions.pod:5722 +msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3766 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5724 ../src/guestfs-actions.pod:5724 #, no-wrap msgid "" -" pvs-full\n" +" struct guestfs_lvm_pv_list *\n" +" guestfs_pvs_full (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5730 ../src/guestfs-actions.pod:5730 +msgid "" +"This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there " +"was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after " +"use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:3771 -msgid "pvuuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5736 ../src/guestfs-actions.pod:5736 +msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3773 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5738 ../src/guestfs-actions.pod:5738 #, no-wrap msgid "" -" pvuuid device\n" +" char *\n" +" guestfs_pvuuid (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3777 -msgid "pwrite" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5749 ../src/guestfs-actions.pod:5749 +msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3779 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5751 ../src/guestfs-actions.pod:5751 #, no-wrap msgid "" -" pwrite path content offset\n" +" int\n" +" guestfs_pwrite (guestfs_h *g,\n" +" const char *path,\n" +" const char *content,\n" +" size_t content_size,\n" +" int64_t offset);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3790 -msgid "See also L</pread>, L</pwrite-device>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5767 ../src/guestfs-actions.pod:5767 +msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3795 -msgid "pwrite-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5776 +msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3797 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5778 ../src/guestfs-actions.pod:5778 #, no-wrap msgid "" -" pwrite-device device content offset\n" +" int\n" +" guestfs_pwrite_device (guestfs_h *g,\n" +" const char *device,\n" +" const char *content,\n" +" size_t content_size,\n" +" int64_t offset);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3807 -msgid "See also L</pwrite>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5793 ../src/guestfs-actions.pod:5793 +msgid "See also C<guestfs_pwrite>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5800 ../src/guestfs-actions.pod:5800 +msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3812 -msgid "read-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5802 ../src/guestfs-actions.pod:5802 +msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3814 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5804 ../src/guestfs-actions.pod:5804 #, no-wrap msgid "" -" read-file path\n" +" char *\n" +" guestfs_read_file (guestfs_h *g,\n" +" const char *path,\n" +" size_t *size_r);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3819 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5812 ../src/guestfs-actions.pod:5812 msgid "" -"Unlike L</cat>, this function can correctly handle files that contain " -"embedded ASCII NUL characters. However unlike L</download>, this function " -"is limited in the total size of file that can be handled." +"Unlike C<guestfs_cat>, this function can correctly handle files that contain " +"embedded ASCII NUL characters. However unlike C<guestfs_download>, this " +"function is limited in the total size of file that can be handled." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5824 ../src/guestfs-actions.pod:5824 +msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3827 -msgid "read-lines" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5826 ../src/guestfs-actions.pod:5826 +msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3829 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5828 ../src/guestfs-actions.pod:5828 #, no-wrap msgid "" -" read-lines path\n" +" char **\n" +" guestfs_read_lines (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3836 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5837 ../src/guestfs-actions.pod:5837 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " -"those you need to use the L</read-file> function which has a more complex " -"interface." +"those you need to use the C<guestfs_read_file> function which has a more " +"complex interface." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3841 -msgid "readdir" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5848 ../src/guestfs-actions.pod:5848 +msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3843 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5850 ../src/guestfs-actions.pod:5850 #, no-wrap msgid "" -" readdir dir\n" +" struct guestfs_dirent_list *\n" +" guestfs_readdir (guestfs_h *g,\n" +" const char *dir);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3895 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:5904 msgid "" "This function is primarily intended for use by programs. To get a simple " -"list of names, use L</ls>. To get a printable directory for human " -"consumption, use L</ll>." +"list of names, use C<guestfs_ls>. To get a printable directory for human " +"consumption, use C<guestfs_ll>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5908 ../src/guestfs-actions.pod:5908 +msgid "" +"This function returns a C<struct guestfs_dirent_list *>, or NULL if there " +"was an error. I<The caller must call C<guestfs_free_dirent_list> after " +"use>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3899 -msgid "readlink" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5914 ../src/guestfs-actions.pod:5914 +msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3901 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5916 ../src/guestfs-actions.pod:5916 #, no-wrap msgid "" -" readlink path\n" +" char *\n" +" guestfs_readlink (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3905 -msgid "readlinklist" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5927 ../src/guestfs-actions.pod:5927 +msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3907 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5929 ../src/guestfs-actions.pod:5929 #, no-wrap msgid "" -" readlinklist path 'names ...'\n" +" char **\n" +" guestfs_readlinklist (guestfs_h *g,\n" +" const char *path,\n" +" char *const *names);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3931 -msgid "realpath" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5962 ../src/guestfs-actions.pod:5962 +msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3933 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5964 ../src/guestfs-actions.pod:5964 #, no-wrap msgid "" -" realpath path\n" +" char *\n" +" guestfs_realpath (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3938 -msgid "removexattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5976 ../src/guestfs-actions.pod:5976 +msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3940 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5978 ../src/guestfs-actions.pod:5978 #, no-wrap msgid "" -" removexattr xattr path\n" +" int\n" +" guestfs_removexattr (guestfs_h *g,\n" +" const char *xattr,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3945 -msgid "See also: L</lremovexattr>, L<attr(5)>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5986 ../src/guestfs-actions.pod:5986 +msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3947 -msgid "resize2fs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5992 ../src/guestfs-actions.pod:5992 +msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3949 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:5994 ../src/guestfs-actions.pod:5994 #, no-wrap msgid "" -" resize2fs device\n" +" int\n" +" guestfs_resize2fs (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3954 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6001 ../src/guestfs-actions.pod:6001 msgid "" -"I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> " -"before calling this command. For unknown reasons C<resize2fs> sometimes " -"gives an error about this and sometimes not. In any case, it is always safe " -"to call L</e2fsck-f> before calling this function." +"I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the " +"C<device> before calling this command. For unknown reasons C<resize2fs> " +"sometimes gives an error about this and sometimes not. In any case, it is " +"always safe to call C<guestfs_e2fsck_f> before calling this function." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3960 -msgid "resize2fs-M" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6011 ../src/guestfs-actions.pod:6011 +msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3962 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6013 ../src/guestfs-actions.pod:6013 #, no-wrap msgid "" -" resize2fs-M device\n" +" int\n" +" guestfs_resize2fs_M (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3964 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6017 ../src/guestfs-actions.pod:6017 msgid "" -"This command is the same as L</resize2fs>, but the filesystem is resized to " -"its minimum size. This works like the I<-M> option to the C<resize2fs> " -"command." +"This command is the same as C<guestfs_resize2fs>, but the filesystem is " +"resized to its minimum size. This works like the I<-M> option to the " +"C<resize2fs> command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3968 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6021 ../src/guestfs-actions.pod:6021 msgid "" -"To get the resulting size of the filesystem you should call L</tune2fs-l> " -"and read the C<Block size> and C<Block count> values. These two numbers, " -"multiplied together, give the resulting size of the minimal filesystem in " -"bytes." +"To get the resulting size of the filesystem you should call " +"C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. " +"These two numbers, multiplied together, give the resulting size of the " +"minimal filesystem in bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3973 -msgid "resize2fs-size" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6030 ../src/guestfs-actions.pod:6030 +msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3975 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6032 #, no-wrap msgid "" -" resize2fs-size device size\n" +" int\n" +" guestfs_resize2fs_size (guestfs_h *g,\n" +" const char *device,\n" +" int64_t size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3977 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6037 ../src/guestfs-actions.pod:6037 msgid "" -"This command is the same as L</resize2fs> except that it allows you to " -"specify the new size (in bytes) explicitly." +"This command is the same as C<guestfs_resize2fs> except that it allows you " +"to specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3980 -msgid "rm" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6044 ../src/guestfs-actions.pod:6044 +msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3982 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6046 ../src/guestfs-actions.pod:6046 #, no-wrap msgid "" -" rm path\n" +" int\n" +" guestfs_rm (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3986 -msgid "rm-rf" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6056 ../src/guestfs-actions.pod:6056 +msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3988 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6058 #, no-wrap msgid "" -" rm-rf path\n" +" int\n" +" guestfs_rm_rf (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3994 -msgid "rmdir" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6070 ../src/guestfs-actions.pod:6070 +msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3996 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6072 ../src/guestfs-actions.pod:6072 #, no-wrap msgid "" -" rmdir path\n" +" int\n" +" guestfs_rmdir (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4000 -msgid "rmmountpoint" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6082 ../src/guestfs-actions.pod:6082 +msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4002 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6084 #, no-wrap msgid "" -" rmmountpoint exemptpath\n" +" int\n" +" guestfs_rmmountpoint (guestfs_h *g,\n" +" const char *exemptpath);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4004 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6088 ../src/guestfs-actions.pod:6088 msgid "" "This calls removes a mountpoint that was previously created with " -"L</mkmountpoint>. See L</mkmountpoint> for full details." +"C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4008 -msgid "scrub-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6096 ../src/guestfs-actions.pod:6096 +msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4010 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6098 ../src/guestfs-actions.pod:6098 #, no-wrap msgid "" -" scrub-device device\n" +" int\n" +" guestfs_scrub_device (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6113 ../libguestfs-1.11.19/src/guestfs-actions.pod:6131 ../libguestfs-1.11.19/src/guestfs-actions.pod:6150 ../src/guestfs-actions.pod:6113 ../src/guestfs-actions.pod:6131 ../src/guestfs-actions.pod:6150 +msgid "(Added in 1.0.52)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:4021 -msgid "scrub-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6115 ../src/guestfs-actions.pod:6115 +msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4023 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6117 ../src/guestfs-actions.pod:6117 #, no-wrap msgid "" -" scrub-file file\n" +" int\n" +" guestfs_scrub_file (guestfs_h *g,\n" +" const char *file);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4033 -msgid "scrub-freespace" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6133 ../src/guestfs-actions.pod:6133 +msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4035 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6135 ../src/guestfs-actions.pod:6135 #, no-wrap msgid "" -" scrub-freespace dir\n" +" int\n" +" guestfs_scrub_freespace (guestfs_h *g,\n" +" const char *dir);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4037 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6139 ../src/guestfs-actions.pod:6139 msgid "" "This command creates the directory C<dir> and then fills it with files until " -"the filesystem is full, and scrubs the files as for L</scrub-file>, and " -"deletes them. The intention is to scrub any free space on the partition " +"the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, " +"and deletes them. The intention is to scrub any free space on the partition " "containing C<dir>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4046 -msgid "set-append" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4048 -msgid "append" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6152 ../src/guestfs-actions.pod:6152 +msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4050 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6154 ../src/guestfs-actions.pod:6154 #, no-wrap msgid "" -" set-append append\n" +" int\n" +" guestfs_set_append (guestfs_h *g,\n" +" const char *append);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4061 -msgid "set-attach-method" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4063 -msgid "attach-method" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6171 ../src/guestfs-actions.pod:6171 +msgid "guestfs_set_attach_method" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4065 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6173 #, no-wrap msgid "" -" set-attach-method attachmethod\n" +" int\n" +" guestfs_set_attach_method (guestfs_h *g,\n" +" const char *attachmethod);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4087 -msgid "set-autosync" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4089 -msgid "autosync" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6201 ../src/guestfs-actions.pod:6201 +msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4091 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6203 ../src/guestfs-actions.pod:6203 #, no-wrap msgid "" -" set-autosync true|false\n" +" int\n" +" guestfs_set_autosync (guestfs_h *g,\n" +" int autosync);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4101 -msgid "set-direct" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4103 -msgid "direct" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6219 +msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4105 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6221 ../src/guestfs-actions.pod:6221 #, no-wrap msgid "" -" set-direct true|false\n" +" int\n" +" guestfs_set_direct (guestfs_h *g,\n" +" int direct);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4111 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6229 ../src/guestfs-actions.pod:6229 msgid "" "One consequence of this is that log messages aren't caught by the library " -"and handled by L</set-log-message-callback>, but go straight to stdout." +"and handled by C<guestfs_set_log_message_callback>, but go straight to " +"stdout." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4120 -msgid "set-e2label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6242 ../src/guestfs-actions.pod:6242 +msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4122 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6244 ../src/guestfs-actions.pod:6244 #, no-wrap msgid "" -" set-e2label device label\n" +" int\n" +" guestfs_set_e2label (guestfs_h *g,\n" +" const char *device,\n" +" const char *label);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4128 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6253 ../src/guestfs-actions.pod:6253 msgid "" -"You can use either L</tune2fs-l> or L</get-e2label> to return the existing " -"label on a filesystem." +"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " +"the existing label on a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4131 -msgid "set-e2uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6260 ../src/guestfs-actions.pod:6260 +msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4133 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6262 ../src/guestfs-actions.pod:6262 #, no-wrap msgid "" -" set-e2uuid device uuid\n" +" int\n" +" guestfs_set_e2uuid (guestfs_h *g,\n" +" const char *device,\n" +" const char *uuid);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4140 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6272 ../src/guestfs-actions.pod:6272 msgid "" -"You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing " -"UUID of a filesystem." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4143 -msgid "set-memsize" +"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " +"the existing UUID of a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4145 -msgid "memsize" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6279 ../src/guestfs-actions.pod:6279 +msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4147 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6281 ../src/guestfs-actions.pod:6281 #, no-wrap msgid "" -" set-memsize memsize\n" +" int\n" +" guestfs_set_memsize (guestfs_h *g,\n" +" int memsize);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4149 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6285 ../src/guestfs-actions.pod:6285 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " -"This only has any effect if called before L</launch>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4160 -msgid "set-network" +"This only has any effect if called before C<guestfs_launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4162 -msgid "network" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6300 ../src/guestfs-actions.pod:6300 +msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4164 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6302 ../src/guestfs-actions.pod:6302 #, no-wrap msgid "" -" set-network true|false\n" +" int\n" +" guestfs_set_network (guestfs_h *g,\n" +" int network);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4172 -msgid "You must call this before calling L</launch>, otherwise it has no effect." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4175 -msgid "set-path" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6312 ../src/guestfs-actions.pod:6312 +msgid "" +"You must call this before calling C<guestfs_launch>, otherwise it has no " +"effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4177 -msgid "path" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6319 ../src/guestfs-actions.pod:6319 +msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4179 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6321 ../src/guestfs-actions.pod:6321 #, no-wrap msgid "" -" set-path searchpath\n" +" int\n" +" guestfs_set_path (guestfs_h *g,\n" +" const char *searchpath);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4188 -msgid "set-pgroup" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4190 -msgid "pgroup" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6336 ../src/guestfs-actions.pod:6336 +msgid "guestfs_set_pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4192 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6338 ../src/guestfs-actions.pod:6338 #, no-wrap msgid "" -" set-pgroup true|false\n" +" int\n" +" guestfs_set_pgroup (guestfs_h *g,\n" +" int pgroup);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4203 -msgid "set-qemu" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4205 -msgid "qemu" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6355 ../src/guestfs-actions.pod:6355 +msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4207 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6357 ../src/guestfs-actions.pod:6357 #, no-wrap msgid "" -" set-qemu qemu\n" +" int\n" +" guestfs_set_qemu (guestfs_h *g,\n" +" const char *qemu);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4227 -msgid "set-recovery-proc" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4229 -msgid "recovery-proc" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6383 ../src/guestfs-actions.pod:6383 +msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4231 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6385 ../src/guestfs-actions.pod:6385 #, no-wrap msgid "" -" set-recovery-proc true|false\n" +" int\n" +" guestfs_set_recovery_proc (guestfs_h *g,\n" +" int recoveryproc);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4233 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6389 ../src/guestfs-actions.pod:6389 msgid "" -"If this is called with the parameter C<false> then L</launch> does not " -"create a recovery process. The purpose of the recovery process is to stop " -"runaway qemu processes in the case where the main program aborts abruptly." +"If this is called with the parameter C<false> then C<guestfs_launch> does " +"not create a recovery process. The purpose of the recovery process is to " +"stop runaway qemu processes in the case where the main program aborts " +"abruptly." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4238 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6394 ../src/guestfs-actions.pod:6394 msgid "" -"This only has any effect if called before L</launch>, and the default is " -"true." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4247 -msgid "set-selinux" +"This only has any effect if called before C<guestfs_launch>, and the default " +"is true." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4249 -msgid "selinux" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6407 ../src/guestfs-actions.pod:6407 +msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4251 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6409 ../src/guestfs-actions.pod:6409 #, no-wrap msgid "" -" set-selinux true|false\n" +" int\n" +" guestfs_set_selinux (guestfs_h *g,\n" +" int selinux);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4262 -msgid "set-trace" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4264 -msgid "trace" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6426 ../src/guestfs-actions.pod:6426 +msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4266 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6428 ../src/guestfs-actions.pod:6428 #, no-wrap msgid "" -" set-trace true|false\n" +" int\n" +" guestfs_set_trace (guestfs_h *g,\n" +" int trace);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4278 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6442 ../src/guestfs-actions.pod:6442 msgid "" "Trace messages are normally sent to C<stderr>, unless you register a " -"callback to send them somewhere else (see L</set-event-callback>)." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4282 -msgid "set-verbose" +"callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4284 -msgid "verbose" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6450 ../src/guestfs-actions.pod:6450 +msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4286 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6452 ../src/guestfs-actions.pod:6452 #, no-wrap msgid "" -" set-verbose true|false\n" +" int\n" +" guestfs_set_verbose (guestfs_h *g,\n" +" int verbose);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4293 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6461 ../src/guestfs-actions.pod:6461 msgid "" "Verbose messages are normally sent to C<stderr>, unless you register a " -"callback to send them somewhere else (see L</set-event-callback>)." +"callback to send them somewhere else (see C<guestfs_set_event_callback>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4297 -msgid "setcon" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6469 ../src/guestfs-actions.pod:6469 +msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4299 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6471 ../src/guestfs-actions.pod:6471 #, no-wrap msgid "" -" setcon context\n" +" int\n" +" guestfs_setcon (guestfs_h *g,\n" +" const char *context);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4306 -msgid "setxattr" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6484 ../src/guestfs-actions.pod:6484 +msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4308 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6486 ../src/guestfs-actions.pod:6486 #, no-wrap msgid "" -" setxattr xattr val vallen path\n" +" int\n" +" guestfs_setxattr (guestfs_h *g,\n" +" const char *xattr,\n" +" const char *val,\n" +" int vallen,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4314 -msgid "See also: L</lsetxattr>, L<attr(5)>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6497 ../src/guestfs-actions.pod:6497 +msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4316 -msgid "sfdisk" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6503 ../src/guestfs-actions.pod:6503 +msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4318 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6505 ../src/guestfs-actions.pod:6505 #, no-wrap msgid "" -" sfdisk device cyls heads sectors 'lines ...'\n" +" int\n" +" guestfs_sfdisk (guestfs_h *g,\n" +" const char *device,\n" +" int cyls,\n" +" int heads,\n" +" int sectors,\n" +" char *const *lines);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4340 -msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6533 ../src/guestfs-actions.pod:6533 +msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4353 -msgid "sfdiskM" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6550 ../src/guestfs-actions.pod:6550 +msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4355 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6552 ../src/guestfs-actions.pod:6552 #, no-wrap msgid "" -" sfdiskM device 'lines ...'\n" +" int\n" +" guestfs_sfdiskM (guestfs_h *g,\n" +" const char *device,\n" +" char *const *lines);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4357 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6557 ../src/guestfs-actions.pod:6557 msgid "" -"This is a simplified interface to the L</sfdisk> command, where partition " -"sizes are specified in megabytes only (rounded to the nearest cylinder) and " -"you don't need to specify the cyls, heads and sectors parameters which were " -"rarely if ever used anyway." +"This is a simplified interface to the C<guestfs_sfdisk> command, where " +"partition sizes are specified in megabytes only (rounded to the nearest " +"cylinder) and you don't need to specify the cyls, heads and sectors " +"parameters which were rarely if ever used anyway." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4363 -msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6563 ../src/guestfs-actions.pod:6563 +msgid "" +"See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " +"C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4376 -msgid "sfdisk-N" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6580 ../src/guestfs-actions.pod:6580 +msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4378 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6582 ../src/guestfs-actions.pod:6582 #, no-wrap msgid "" -" sfdisk-N device partnum cyls heads sectors line\n" +" int\n" +" guestfs_sfdisk_N (guestfs_h *g,\n" +" const char *device,\n" +" int partnum,\n" +" int cyls,\n" +" int heads,\n" +" int sectors,\n" +" const char *line);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4383 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6594 ../src/guestfs-actions.pod:6594 msgid "" -"For other parameters, see L</sfdisk>. You should usually pass C<0> for the " -"cyls/heads/sectors parameters." +"For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " +"for the cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4386 -msgid "See also: L</part-add>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6597 ../src/guestfs-actions.pod:6597 +msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4398 -msgid "sfdisk-disk-geometry" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6613 ../src/guestfs-actions.pod:6613 +msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4400 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6615 ../src/guestfs-actions.pod:6615 #, no-wrap msgid "" -" sfdisk-disk-geometry device\n" +" char *\n" +" guestfs_sfdisk_disk_geometry (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4402 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6619 ../src/guestfs-actions.pod:6619 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " "this can be different from the kernel's idea of the geometry (see " -"L</sfdisk-kernel-geometry>)." +"C<guestfs_sfdisk_kernel_geometry>)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4410 -msgid "sfdisk-kernel-geometry" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6632 ../src/guestfs-actions.pod:6632 +msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4412 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6634 ../src/guestfs-actions.pod:6634 #, no-wrap msgid "" -" sfdisk-kernel-geometry device\n" +" char *\n" +" guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4419 -msgid "sfdisk-l" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6648 ../src/guestfs-actions.pod:6648 +msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4421 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6650 ../src/guestfs-actions.pod:6650 #, no-wrap msgid "" -" sfdisk-l device\n" +" char *\n" +" guestfs_sfdisk_l (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4427 -msgid "See also: L</part-list>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6658 +msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4436 -msgid "sh" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6672 ../src/guestfs-actions.pod:6672 +msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4438 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6674 ../src/guestfs-actions.pod:6674 #, no-wrap msgid "" -" sh command\n" +" char *\n" +" guestfs_sh (guestfs_h *g,\n" +" const char *command);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4443 -msgid "This is like L</command>, but passes the command to:" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6681 ../src/guestfs-actions.pod:6681 +msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4451 -msgid "All the provisos about L</command> apply to this call." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6689 ../src/guestfs-actions.pod:6689 +msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4453 -msgid "sh-lines" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6696 ../src/guestfs-actions.pod:6696 +msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4455 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6698 ../src/guestfs-actions.pod:6698 #, no-wrap msgid "" -" sh-lines command\n" +" char **\n" +" guestfs_sh_lines (guestfs_h *g,\n" +" const char *command);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4457 -msgid "This is the same as L</sh>, but splits the result into a list of lines." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6702 ../src/guestfs-actions.pod:6702 +msgid "" +"This is the same as C<guestfs_sh>, but splits the result into a list of " +"lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4460 -msgid "See also: L</command-lines>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6705 ../src/guestfs-actions.pod:6705 +msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4462 -msgid "sleep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6713 ../src/guestfs-actions.pod:6713 +msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4464 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6715 ../src/guestfs-actions.pod:6715 #, no-wrap msgid "" -" sleep secs\n" +" int\n" +" guestfs_sleep (guestfs_h *g,\n" +" int secs);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6723 +msgid "(Added in 1.0.41)" +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:4468 -msgid "stat" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6725 ../libguestfs-1.11.19/src/guestfs-structs.pod:109 ../src/guestfs-actions.pod:6725 ../src/guestfs-structs.pod:109 +msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4470 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6727 ../src/guestfs-actions.pod:6727 #, no-wrap msgid "" -" stat path\n" +" struct guestfs_stat *\n" +" guestfs_stat (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4476 -msgid "statvfs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6741 ../libguestfs-1.11.19/src/guestfs-structs.pod:135 ../src/guestfs-actions.pod:6741 ../src/guestfs-structs.pod:135 +msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4478 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6743 ../src/guestfs-actions.pod:6743 #, no-wrap msgid "" -" statvfs path\n" +" struct guestfs_statvfs *\n" +" guestfs_statvfs (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6753 ../src/guestfs-actions.pod:6753 +msgid "" +"This function returns a C<struct guestfs_statvfs *>, or NULL if there was an " +"error. I<The caller must call C<guestfs_free_statvfs> after use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:4486 -msgid "strings" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6759 ../src/guestfs-actions.pod:6759 +msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4488 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6761 ../src/guestfs-actions.pod:6761 #, no-wrap msgid "" -" strings path\n" +" char **\n" +" guestfs_strings (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4496 -msgid "strings-e" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6777 ../src/guestfs-actions.pod:6777 +msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4498 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6779 ../src/guestfs-actions.pod:6779 #, no-wrap msgid "" -" strings-e encoding path\n" +" char **\n" +" guestfs_strings_e (guestfs_h *g,\n" +" const char *encoding,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4500 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6784 ../src/guestfs-actions.pod:6784 msgid "" -"This is like the L</strings> command, but allows you to specify the encoding " -"of strings that are looked for in the source file C<path>." +"This is like the C<guestfs_strings> command, but allows you to specify the " +"encoding of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4510 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6794 ../src/guestfs-actions.pod:6794 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " -"ISO-8859-X (this is what L</strings> uses)." +"ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4542 -msgid "swapoff-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6832 +msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4544 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6834 ../src/guestfs-actions.pod:6834 #, no-wrap msgid "" -" swapoff-device device\n" +" int\n" +" guestfs_swapoff_device (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4546 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6838 ../src/guestfs-actions.pod:6838 msgid "" "This command disables the libguestfs appliance swap device or partition " -"named C<device>. See L</swapon-device>." +"named C<device>. See C<guestfs_swapon_device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4550 -msgid "swapoff-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6846 ../src/guestfs-actions.pod:6846 +msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4552 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6848 ../src/guestfs-actions.pod:6848 #, no-wrap msgid "" -" swapoff-file file\n" +" int\n" +" guestfs_swapoff_file (guestfs_h *g,\n" +" const char *file);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4556 -msgid "swapoff-label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6858 ../src/guestfs-actions.pod:6858 +msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4558 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6860 ../src/guestfs-actions.pod:6860 #, no-wrap msgid "" -" swapoff-label label\n" +" int\n" +" guestfs_swapoff_label (guestfs_h *g,\n" +" const char *label);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4563 -msgid "swapoff-uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6871 ../src/guestfs-actions.pod:6871 +msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4565 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6873 ../src/guestfs-actions.pod:6873 #, no-wrap msgid "" -" swapoff-uuid uuid\n" +" int\n" +" guestfs_swapoff_uuid (guestfs_h *g,\n" +" const char *uuid);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4570 -msgid "swapon-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6884 ../src/guestfs-actions.pod:6884 +msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4572 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6886 ../src/guestfs-actions.pod:6886 #, no-wrap msgid "" -" swapon-device device\n" +" int\n" +" guestfs_swapon_device (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4574 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6890 ../src/guestfs-actions.pod:6890 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " -"commands, for example those run using L</command> or L</sh>." +"commands, for example those run using C<guestfs_command> or C<guestfs_sh>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4586 -msgid "swapon-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6906 ../src/guestfs-actions.pod:6906 +msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4588 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6908 ../src/guestfs-actions.pod:6908 #, no-wrap msgid "" -" swapon-file file\n" +" int\n" +" guestfs_swapon_file (guestfs_h *g,\n" +" const char *file);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4590 -msgid "This command enables swap to a file. See L</swapon-device> for other notes." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6912 ../src/guestfs-actions.pod:6912 +msgid "" +"This command enables swap to a file. See C<guestfs_swapon_device> for other " +"notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4593 -msgid "swapon-label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6919 ../src/guestfs-actions.pod:6919 +msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4595 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6921 ../src/guestfs-actions.pod:6921 #, no-wrap msgid "" -" swapon-label label\n" +" int\n" +" guestfs_swapon_label (guestfs_h *g,\n" +" const char *label);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4597 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6925 ../src/guestfs-actions.pod:6925 msgid "" "This command enables swap to a labeled swap partition. See " -"L</swapon-device> for other notes." +"C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4600 -msgid "swapon-uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6932 ../src/guestfs-actions.pod:6932 +msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4602 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6934 ../src/guestfs-actions.pod:6934 #, no-wrap msgid "" -" swapon-uuid uuid\n" +" int\n" +" guestfs_swapon_uuid (guestfs_h *g,\n" +" const char *uuid);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4604 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6938 ../src/guestfs-actions.pod:6938 msgid "" "This command enables swap to a swap partition with the given UUID. See " -"L</swapon-device> for other notes." +"C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4607 -msgid "sync" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6945 ../src/guestfs-actions.pod:6945 +msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4609 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6947 ../src/guestfs-actions.pod:6947 #, no-wrap msgid "" -" sync\n" +" int\n" +" guestfs_sync (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4617 -msgid "tail" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6960 ../src/guestfs-actions.pod:6960 +msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4619 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6962 ../src/guestfs-actions.pod:6962 #, no-wrap msgid "" -" tail path\n" +" char **\n" +" guestfs_tail (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4627 -msgid "tail-n" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6978 ../src/guestfs-actions.pod:6978 +msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4629 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:6980 ../src/guestfs-actions.pod:6980 #, no-wrap msgid "" -" tail-n nrlines path\n" +" char **\n" +" guestfs_tail_n (guestfs_h *g,\n" +" int nrlines,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4642 -msgid "tar-in" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7002 ../src/guestfs-actions.pod:7002 +msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4644 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7004 ../src/guestfs-actions.pod:7004 #, no-wrap msgid "" -" tar-in (tarfile|-) directory\n" +" int\n" +" guestfs_tar_in (guestfs_h *g,\n" +" const char *tarfile,\n" +" const char *directory);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4649 -msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7012 ../src/guestfs-actions.pod:7012 +msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7017 ../libguestfs-1.11.19/src/guestfs-actions.pod:7034 ../libguestfs-1.11.19/src/guestfs-actions.pod:7050 ../libguestfs-1.11.19/src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7017 ../src/guestfs-actions.pod:7034 ../src/guestfs-actions.pod:7050 ../src/guestfs-actions.pod:7066 +msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4654 -msgid "tar-out" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7019 ../src/guestfs-actions.pod:7019 +msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4656 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7021 ../src/guestfs-actions.pod:7021 #, no-wrap msgid "" -" tar-out directory (tarfile|-)\n" +" int\n" +" guestfs_tar_out (guestfs_h *g,\n" +" const char *directory,\n" +" const char *tarfile);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4661 -msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7029 ../src/guestfs-actions.pod:7029 +msgid "" +"To download a compressed tarball, use C<guestfs_tgz_out> or " +"C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4666 -msgid "tgz-in" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7036 ../src/guestfs-actions.pod:7036 +msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4668 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7038 ../src/guestfs-actions.pod:7038 #, no-wrap msgid "" -" tgz-in (tarball|-) directory\n" +" int\n" +" guestfs_tgz_in (guestfs_h *g,\n" +" const char *tarball,\n" +" const char *directory);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4673 -msgid "To upload an uncompressed tarball, use L</tar-in>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7046 ../src/guestfs-actions.pod:7046 +msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4677 -msgid "tgz-out" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7052 ../src/guestfs-actions.pod:7052 +msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4679 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7054 ../src/guestfs-actions.pod:7054 #, no-wrap msgid "" -" tgz-out directory (tarball|-)\n" +" int\n" +" guestfs_tgz_out (guestfs_h *g,\n" +" const char *directory,\n" +" const char *tarball);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4684 -msgid "To download an uncompressed tarball, use L</tar-out>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7062 ../src/guestfs-actions.pod:7062 +msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4688 -msgid "touch" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7068 ../src/guestfs-actions.pod:7068 +msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4690 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7070 ../src/guestfs-actions.pod:7070 #, no-wrap msgid "" -" touch path\n" +" int\n" +" guestfs_touch (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4699 -msgid "truncate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7085 ../src/guestfs-actions.pod:7085 +msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4701 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7087 ../src/guestfs-actions.pod:7087 #, no-wrap msgid "" -" truncate path\n" +" int\n" +" guestfs_truncate (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4706 -msgid "truncate-size" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7098 ../src/guestfs-actions.pod:7098 +msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4708 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7100 ../src/guestfs-actions.pod:7100 #, no-wrap msgid "" -" truncate-size path size\n" +" int\n" +" guestfs_truncate_size (guestfs_h *g,\n" +" const char *path,\n" +" int64_t size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4713 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7108 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " "blocks are not allocated for the file until you write to it). To create a " -"non-sparse file of zeroes, use L</fallocate64> instead." +"non-sparse file of zeroes, use C<guestfs_fallocate64> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4719 -msgid "tune2fs-l" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7118 ../src/guestfs-actions.pod:7118 +msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4721 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7120 ../src/guestfs-actions.pod:7120 #, no-wrap msgid "" -" tune2fs-l device\n" +" char **\n" +" guestfs_tune2fs_l (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4731 -msgid "txz-in" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7140 ../src/guestfs-actions.pod:7140 +msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4733 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7142 ../src/guestfs-actions.pod:7142 #, no-wrap msgid "" -" txz-in (tarball|-) directory\n" +" int\n" +" guestfs_txz_in (guestfs_h *g,\n" +" const char *tarball,\n" +" const char *directory);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4740 -msgid "txz-out" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7154 +msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4742 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7156 #, no-wrap msgid "" -" txz-out directory (tarball|-)\n" +" int\n" +" guestfs_txz_out (guestfs_h *g,\n" +" const char *directory,\n" +" const char *tarball);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4749 -msgid "umask" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7168 ../src/guestfs-actions.pod:7168 +msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4751 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7170 ../src/guestfs-actions.pod:7170 #, no-wrap msgid "" -" umask mask\n" +" int\n" +" guestfs_umask (guestfs_h *g,\n" +" int mask);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4765 -msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4770 -msgid "umount" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7186 ../src/guestfs-actions.pod:7186 +msgid "" +"See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " +"C<guestfs_mkdir>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4772 -msgid "unmount" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7195 ../src/guestfs-actions.pod:7195 +msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4774 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7197 ../src/guestfs-actions.pod:7197 #, no-wrap msgid "" -" umount pathordevice\n" +" int\n" +" guestfs_umount (guestfs_h *g,\n" +" const char *pathordevice);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4780 -msgid "umount-all" -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:4782 -msgid "unmount-all" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7209 ../src/guestfs-actions.pod:7209 +msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4784 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7211 ../src/guestfs-actions.pod:7211 #, no-wrap msgid "" -" umount-all\n" +" int\n" +" guestfs_umount_all (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4790 -msgid "upload" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7222 ../src/guestfs-actions.pod:7222 +msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4792 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7224 ../src/guestfs-actions.pod:7224 #, no-wrap msgid "" -" upload (filename|-) remotefilename\n" +" int\n" +" guestfs_upload (guestfs_h *g,\n" +" const char *filename,\n" +" const char *remotefilename);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4799 -msgid "See also L</download>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7234 ../src/guestfs-actions.pod:7234 +msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4803 -msgid "upload-offset" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7245 ../src/guestfs-actions.pod:7245 +msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4805 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7247 ../src/guestfs-actions.pod:7247 #, no-wrap msgid "" -" upload-offset (filename|-) remotefilename offset\n" +" int\n" +" guestfs_upload_offset (guestfs_h *g,\n" +" const char *filename,\n" +" const char *remotefilename,\n" +" int64_t offset);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4817 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7263 ../src/guestfs-actions.pod:7263 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " -"this call, unlike with L</pwrite>, and this call always writes the full " -"amount unless an error occurs." +"this call, unlike with C<guestfs_pwrite>, and this call always writes the " +"full amount unless an error occurs." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4822 -msgid "See also L</upload>, L</pwrite>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7268 ../src/guestfs-actions.pod:7268 +msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4826 -msgid "utimens" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7279 ../src/guestfs-actions.pod:7279 +msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4828 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7281 ../src/guestfs-actions.pod:7281 #, no-wrap msgid "" -" utimens path atsecs atnsecs mtsecs mtnsecs\n" +" int\n" +" guestfs_utimens (guestfs_h *g,\n" +" const char *path,\n" +" int64_t atsecs,\n" +" int64_t atnsecs,\n" +" int64_t mtsecs,\n" +" int64_t mtnsecs);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4847 -msgid "version" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7310 ../libguestfs-1.11.19/src/guestfs-structs.pod:175 ../src/guestfs-actions.pod:7310 ../src/guestfs-structs.pod:175 +msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4849 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7312 ../src/guestfs-actions.pod:7312 #, no-wrap msgid "" -" version\n" +" struct guestfs_version *\n" +" guestfs_version (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4876 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7340 ../src/guestfs-actions.pod:7340 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " "earlier versions, making this an unreliable way to test for features. Use " -"L</available> instead." +"C<guestfs_available> instead." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7346 ../src/guestfs-actions.pod:7346 +msgid "" +"This function returns a C<struct guestfs_version *>, or NULL if there was an " +"error. I<The caller must call C<guestfs_free_version> after use>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7350 ../src/guestfs-actions.pod:7350 +msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4882 -msgid "vfs-label" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7352 ../src/guestfs-actions.pod:7352 +msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4884 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7354 ../src/guestfs-actions.pod:7354 #, no-wrap msgid "" -" vfs-label device\n" +" char *\n" +" guestfs_vfs_label (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4891 -msgid "To find a filesystem from the label, use L</findfs-label>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7363 ../src/guestfs-actions.pod:7363 +msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7368 ../libguestfs-1.11.19/src/guestfs-actions.pod:7405 ../src/guestfs-actions.pod:7368 ../src/guestfs-actions.pod:7405 +msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4893 -msgid "vfs-type" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7370 ../src/guestfs-actions.pod:7370 +msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4895 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7372 ../src/guestfs-actions.pod:7372 #, no-wrap msgid "" -" vfs-type device\n" +" char *\n" +" guestfs_vfs_type (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4905 -msgid "vfs-uuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7389 ../src/guestfs-actions.pod:7389 +msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4907 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7391 ../src/guestfs-actions.pod:7391 #, no-wrap msgid "" -" vfs-uuid device\n" +" char *\n" +" guestfs_vfs_uuid (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4914 -msgid "To find a filesystem from the UUID, use L</findfs-uuid>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7400 ../src/guestfs-actions.pod:7400 +msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4916 -msgid "vg-activate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7407 ../src/guestfs-actions.pod:7407 +msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4918 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7409 ../src/guestfs-actions.pod:7409 #, no-wrap msgid "" -" vg-activate true|false 'volgroups ...'\n" +" int\n" +" guestfs_vg_activate (guestfs_h *g,\n" +" int activate,\n" +" char *const *volgroups);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4928 -msgid "vg-activate-all" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7426 ../src/guestfs-actions.pod:7426 +msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4930 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7428 ../src/guestfs-actions.pod:7428 #, no-wrap msgid "" -" vg-activate-all true|false\n" +" int\n" +" guestfs_vg_activate_all (guestfs_h *g,\n" +" int activate);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4937 -msgid "vgcreate" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7441 +msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4939 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7443 ../src/guestfs-actions.pod:7443 #, no-wrap msgid "" -" vgcreate volgroup 'physvols ...'\n" +" int\n" +" guestfs_vgcreate (guestfs_h *g,\n" +" const char *volgroup,\n" +" char *const *physvols);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4944 -msgid "vglvuuids" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7455 ../src/guestfs-actions.pod:7455 +msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4946 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7457 ../src/guestfs-actions.pod:7457 #, no-wrap msgid "" -" vglvuuids vgname\n" +" char **\n" +" guestfs_vglvuuids (guestfs_h *g,\n" +" const char *vgname);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4951 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7464 ../src/guestfs-actions.pod:7464 msgid "" -"You can use this along with L</lvs> and L</lvuuid> calls to associate " -"logical volumes and volume groups." +"You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " +"associate logical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4954 -msgid "See also L</vgpvuuids>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7467 ../src/guestfs-actions.pod:7467 +msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4956 -msgid "vgpvuuids" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7475 ../src/guestfs-actions.pod:7475 +msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4958 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7477 ../src/guestfs-actions.pod:7477 #, no-wrap msgid "" -" vgpvuuids vgname\n" +" char **\n" +" guestfs_vgpvuuids (guestfs_h *g,\n" +" const char *vgname);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4963 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7484 ../src/guestfs-actions.pod:7484 msgid "" -"You can use this along with L</pvs> and L</pvuuid> calls to associate " -"physical volumes and volume groups." +"You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " +"associate physical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4966 -msgid "See also L</vglvuuids>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7487 ../src/guestfs-actions.pod:7487 +msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4968 -msgid "vgremove" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7495 ../src/guestfs-actions.pod:7495 +msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4970 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7497 ../src/guestfs-actions.pod:7497 #, no-wrap msgid "" -" vgremove vgname\n" +" int\n" +" guestfs_vgremove (guestfs_h *g,\n" +" const char *vgname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4977 -msgid "vgrename" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7510 ../src/guestfs-actions.pod:7510 +msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4979 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7512 ../src/guestfs-actions.pod:7512 #, no-wrap msgid "" -" vgrename volgroup newvolgroup\n" +" int\n" +" guestfs_vgrename (guestfs_h *g,\n" +" const char *volgroup,\n" +" const char *newvolgroup);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4983 -msgid "vgs" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7523 ../src/guestfs-actions.pod:7523 +msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4985 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7525 ../src/guestfs-actions.pod:7525 #, no-wrap msgid "" -" vgs\n" +" char **\n" +" guestfs_vgs (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4993 -msgid "See also L</vgs-full>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7534 ../src/guestfs-actions.pod:7534 +msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4995 -msgid "vgs-full" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7542 ../src/guestfs-actions.pod:7542 +msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4997 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7544 ../src/guestfs-actions.pod:7544 #, no-wrap msgid "" -" vgs-full\n" +" struct guestfs_lvm_vg_list *\n" +" guestfs_vgs_full (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7550 ../src/guestfs-actions.pod:7550 +msgid "" +"This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there " +"was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after " +"use>." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:5002 -msgid "vgscan" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7556 ../src/guestfs-actions.pod:7556 +msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5004 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7558 ../src/guestfs-actions.pod:7558 #, no-wrap msgid "" -" vgscan\n" +" int\n" +" guestfs_vgscan (guestfs_h *g);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5009 -msgid "vguuid" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7568 ../src/guestfs-actions.pod:7568 +msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5011 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7570 ../src/guestfs-actions.pod:7570 #, no-wrap msgid "" -" vguuid vgname\n" +" char *\n" +" guestfs_vguuid (guestfs_h *g,\n" +" const char *vgname);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5015 -msgid "wc-c" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7581 ../src/guestfs-actions.pod:7581 +msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5017 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7583 ../src/guestfs-actions.pod:7583 #, no-wrap msgid "" -" wc-c path\n" +" int\n" +" guestfs_wait_ready (guestfs_h *g);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7586 ../src/guestfs-actions.pod:7586 +msgid "This function is a no op." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7588 ../src/guestfs-actions.pod:7588 +msgid "" +"In versions of the API E<lt> 1.0.71 you had to call this function just after " +"calling C<guestfs_launch> to wait for the launch to complete. However this " +"is no longer necessary because C<guestfs_launch> now does the waiting." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7593 ../src/guestfs-actions.pod:7593 +msgid "" +"If you see any calls to this function in code then you can just remove them, " +"unless you want to retain compatibility with older versions of the API." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7599 ../src/guestfs-actions.pod:7599 +msgid "This function is deprecated. In new code, use the C<launch> call instead." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:5022 -msgid "wc-l" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7608 ../src/guestfs-actions.pod:7608 +msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5024 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7610 ../src/guestfs-actions.pod:7610 #, no-wrap msgid "" -" wc-l path\n" +" int\n" +" guestfs_wc_c (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5029 -msgid "wc-w" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7621 ../src/guestfs-actions.pod:7621 +msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5031 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7623 ../src/guestfs-actions.pod:7623 #, no-wrap msgid "" -" wc-w path\n" +" int\n" +" guestfs_wc_l (guestfs_h *g,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5036 -msgid "write" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7634 ../src/guestfs-actions.pod:7634 +msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5038 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7636 ../src/guestfs-actions.pod:7636 #, no-wrap msgid "" -" write path content\n" +" int\n" +" guestfs_wc_w (guestfs_h *g,\n" +" const char *path);\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7647 ../src/guestfs-actions.pod:7647 +msgid "guestfs_write" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7649 ../src/guestfs-actions.pod:7649 +#, no-wrap +msgid "" +" int\n" +" guestfs_write (guestfs_h *g,\n" +" const char *path,\n" +" const char *content,\n" +" size_t content_size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5043 -msgid "See also L</write-append>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7658 ../src/guestfs-actions.pod:7658 +msgid "See also C<guestfs_write_append>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5048 -msgid "write-append" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7667 ../src/guestfs-actions.pod:7667 +msgid "guestfs_write_append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5050 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7669 ../src/guestfs-actions.pod:7669 #, no-wrap msgid "" -" write-append path content\n" +" int\n" +" guestfs_write_append (guestfs_h *g,\n" +" const char *path,\n" +" const char *content,\n" +" size_t content_size);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5055 -msgid "See also L</write>." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7678 ../src/guestfs-actions.pod:7678 +msgid "See also C<guestfs_write>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5060 -msgid "write-file" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7687 ../src/guestfs-actions.pod:7687 +msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5062 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7689 ../src/guestfs-actions.pod:7689 #, no-wrap msgid "" -" write-file path content size\n" +" int\n" +" guestfs_write_file (guestfs_h *g,\n" +" const char *path,\n" +" const char *content,\n" +" int size);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5085 -msgid "zegrep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7720 ../src/guestfs-actions.pod:7720 +msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5087 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7722 ../src/guestfs-actions.pod:7722 #, no-wrap msgid "" -" zegrep regex path\n" +" char **\n" +" guestfs_zegrep (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5095 -msgid "zegrepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7739 ../src/guestfs-actions.pod:7739 +msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5097 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7741 ../src/guestfs-actions.pod:7741 #, no-wrap msgid "" -" zegrepi regex path\n" +" char **\n" +" guestfs_zegrepi (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5105 -msgid "zero" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7758 ../src/guestfs-actions.pod:7758 +msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5107 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7760 ../src/guestfs-actions.pod:7760 #, no-wrap msgid "" -" zero device\n" +" int\n" +" guestfs_zero (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5115 -msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7770 ../src/guestfs-actions.pod:7770 +msgid "" +"See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, " +"C<guestfs_is_zero_device>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5118 -msgid "zero-device" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7782 ../src/guestfs-actions.pod:7782 +msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5120 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7784 ../src/guestfs-actions.pod:7784 #, no-wrap msgid "" -" zero-device device\n" +" int\n" +" guestfs_zero_device (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5122 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7788 ../src/guestfs-actions.pod:7788 msgid "" -"This command writes zeroes over the entire C<device>. Compare with L</zero> " -"which just zeroes the first few blocks of a device." +"This command writes zeroes over the entire C<device>. Compare with " +"C<guestfs_zero> which just zeroes the first few blocks of a device." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7802 ../src/guestfs-actions.pod:7802 +msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5129 -msgid "zerofree" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7804 ../src/guestfs-actions.pod:7804 +msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5131 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7806 ../src/guestfs-actions.pod:7806 #, no-wrap msgid "" -" zerofree device\n" +" int\n" +" guestfs_zerofree (guestfs_h *g,\n" +" const char *device);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5144 -msgid "zfgrep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7825 ../src/guestfs-actions.pod:7825 +msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5146 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7827 ../src/guestfs-actions.pod:7827 #, no-wrap msgid "" -" zfgrep pattern path\n" +" char **\n" +" guestfs_zfgrep (guestfs_h *g,\n" +" const char *pattern,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5154 -msgid "zfgrepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7844 ../src/guestfs-actions.pod:7844 +msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5156 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7846 ../src/guestfs-actions.pod:7846 #, no-wrap msgid "" -" zfgrepi pattern path\n" +" char **\n" +" guestfs_zfgrepi (guestfs_h *g,\n" +" const char *pattern,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5164 -msgid "zfile" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7863 ../src/guestfs-actions.pod:7863 +msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5166 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7865 ../src/guestfs-actions.pod:7865 #, no-wrap msgid "" -" zfile meth path\n" +" char *\n" +" guestfs_zfile (guestfs_h *g,\n" +" const char *meth,\n" +" const char *path);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:5173 -msgid "Since 1.0.63, use L</file> instead which can now process compressed files." +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7875 ../src/guestfs-actions.pod:7875 +msgid "" +"Since 1.0.63, use C<guestfs_file> instead which can now process compressed " +"files." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5183 -msgid "zgrep" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7890 ../src/guestfs-actions.pod:7890 +msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5185 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7892 ../src/guestfs-actions.pod:7892 #, no-wrap msgid "" -" zgrep regex path\n" +" char **\n" +" guestfs_zgrep (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:5193 -msgid "zgrepi" +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7909 ../src/guestfs-actions.pod:7909 +msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:5195 +#: ../libguestfs-1.11.19/src/guestfs-actions.pod:7911 ../src/guestfs-actions.pod:7911 #, no-wrap msgid "" -" zgrepi regex path\n" +" char **\n" +" guestfs_zgrepi (guestfs_h *g,\n" +" const char *regex,\n" +" const char *path);\n" "\n" msgstr "" -#. type: =head2 -#: ../fish/guestfish-commands.pod:1 -msgid "alloc" +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:3 ../src/guestfs-availability.pod:3 +msgid "B<augeas>" msgstr "" -#. type: =head2 -#: ../fish/guestfish-commands.pod:3 -msgid "allocate" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:5 ../src/guestfs-availability.pod:5 +msgid "" +"The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> " +"L</guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> " +"L</guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> " +"L</guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> " +"L</guestfs_aug_rm> L</guestfs_aug_save> L</guestfs_aug_set>" msgstr "" -#. type: verbatim -#: ../fish/guestfish-commands.pod:5 -#, no-wrap +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:21 ../src/guestfs-availability.pod:21 +msgid "B<btrfs>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:23 ../src/guestfs-availability.pod:23 +msgid "The following functions: L</guestfs_btrfs_filesystem_resize>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:26 ../src/guestfs-availability.pod:26 +msgid "B<inotify>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:28 ../src/guestfs-availability.pod:28 msgid "" -" alloc filename size\n" -"\n" +"The following functions: L</guestfs_inotify_add_watch> " +"L</guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> " +"L</guestfs_inotify_read> L</guestfs_inotify_rm_watch>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:36 ../src/guestfs-availability.pod:36 +msgid "B<linuxfsuuid>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:7 +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:38 ../src/guestfs-availability.pod:38 msgid "" -"This creates an empty (zeroed) file of the given size, and then adds so it " -"can be further examined." +"The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> " +"L</guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:45 ../src/guestfs-availability.pod:45 +msgid "B<linuxmodules>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:182 -msgid "For more advanced image creation, see L<qemu-img(1)> utility." +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:47 ../src/guestfs-availability.pod:47 +msgid "The following functions: L</guestfs_modprobe>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:50 ../src/guestfs-availability.pod:50 +msgid "B<linuxxattrs>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:184 -msgid "Size can be specified using standard suffixes, eg. C<1M>." +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:52 ../src/guestfs-availability.pod:52 +msgid "" +"The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> " +"L</guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> " +"L</guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> " +"L</guestfs_setxattr>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:63 ../src/guestfs-availability.pod:63 +msgid "B<luks>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:14 +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:65 ../src/guestfs-availability.pod:65 msgid "" -"To create a sparse file, use L</sparse> instead. To create a prepared disk " -"image, see L</PREPARED DISK IMAGES>." +"The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> " +"L</guestfs_luks_format> L</guestfs_luks_format_cipher> " +"L</guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>" msgstr "" -#. type: =head2 -#: ../fish/guestfish-commands.pod:17 -msgid "copy-in" +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:74 ../src/guestfs-availability.pod:74 +msgid "B<lvm2>" msgstr "" -#. type: verbatim -#: ../fish/guestfish-commands.pod:19 -#, no-wrap +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:76 ../src/guestfs-availability.pod:76 msgid "" -" copy-in local [local ...] /remotedir\n" -"\n" +"The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> " +"L</guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> " +"L</guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> " +"L</guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> " +"L</guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> " +"L</guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> " +"L</guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> " +"L</guestfs_vgs_full>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:99 ../src/guestfs-availability.pod:99 +msgid "B<mknod>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:21 +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:101 ../src/guestfs-availability.pod:101 msgid "" -"C<copy-in> copies local files or directories recursively into the disk " -"image, placing them in the directory called C</remotedir> (which must " -"exist). This guestfish meta-command turns into a sequence of L</tar-in> and " -"other commands as necessary." +"The following functions: L</guestfs_mkfifo> L</guestfs_mknod> " +"L</guestfs_mknod_b> L</guestfs_mknod_c>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:107 ../src/guestfs-availability.pod:107 +msgid "B<ntfs3g>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:109 ../src/guestfs-availability.pod:109 +msgid "The following functions: L</guestfs_ntfs_3g_probe>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:112 ../src/guestfs-availability.pod:112 +msgid "B<ntfsprogs>" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:26 +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:114 ../src/guestfs-availability.pod:114 msgid "" -"Multiple local files and directories can be specified, but the last " -"parameter must always be a remote directory. Wildcards cannot be used." +"The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> " +"L</guestfs_ntfsresize_size>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:119 ../src/guestfs-availability.pod:119 +msgid "B<realpath>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:121 ../src/guestfs-availability.pod:121 +msgid "The following functions: L</guestfs_realpath>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:124 ../src/guestfs-availability.pod:124 +msgid "B<scrub>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:126 ../src/guestfs-availability.pod:126 +msgid "" +"The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> " +"L</guestfs_scrub_freespace>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:131 ../src/guestfs-availability.pod:131 +msgid "B<selinux>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:133 ../src/guestfs-availability.pod:133 +msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:137 ../src/guestfs-availability.pod:137 +msgid "B<xz>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:139 ../src/guestfs-availability.pod:139 +msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:143 ../src/guestfs-availability.pod:143 +msgid "B<zerofree>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs-availability.pod:145 ../src/guestfs-availability.pod:145 +msgid "The following functions: L</guestfs_zerofree>" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:30 -msgid "copy-out" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:1 ../src/guestfs-structs.pod:1 +msgid "guestfs_int_bool" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:32 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:3 ../src/guestfs-structs.pod:3 #, no-wrap msgid "" -" copy-out remote [remote ...] localdir\n" +" struct guestfs_int_bool {\n" +" int32_t i;\n" +" int32_t b;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:8 ../src/guestfs-structs.pod:8 +#, no-wrap +msgid "" +" struct guestfs_int_bool_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_int_bool *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:13 ../src/guestfs-structs.pod:13 +#, no-wrap +msgid "" +" void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n" +" void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:34 +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:16 ../src/guestfs-structs.pod:16 +msgid "guestfs_lvm_pv" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:18 ../src/guestfs-structs.pod:18 +#, no-wrap msgid "" -"C<copy-out> copies remote files or directories recursively out of the disk " -"image, placing them on the host disk in a local directory called C<localdir> " -"(which must exist). This guestfish meta-command turns into a sequence of " -"L</download>, L</tar-out> and other commands as necessary." +" struct guestfs_lvm_pv {\n" +" char *pv_name;\n" +" /* The next field is NOT nul-terminated, be careful when printing it: " +"*/\n" +" char pv_uuid[32];\n" +" char *pv_fmt;\n" +" uint64_t pv_size;\n" +" uint64_t dev_size;\n" +" uint64_t pv_free;\n" +" uint64_t pv_used;\n" +" char *pv_attr;\n" +" int64_t pv_pe_count;\n" +" int64_t pv_pe_alloc_count;\n" +" char *pv_tags;\n" +" uint64_t pe_start;\n" +" int64_t pv_mda_count;\n" +" uint64_t pv_mda_free;\n" +" };\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:40 +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:36 ../src/guestfs-structs.pod:36 +#, no-wrap msgid "" -"Multiple remote files and directories can be specified, but the last " -"parameter must always be a local directory. To download to the current " -"directory, use C<.> as in:" +" struct guestfs_lvm_pv_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_lvm_pv *val; /* Elements. */\n" +" };\n" +" \n" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:44 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:41 ../src/guestfs-structs.pod:41 #, no-wrap msgid "" -" copy-out /home .\n" +" void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n" +" void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:46 +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:44 ../src/guestfs-structs.pod:44 +msgid "guestfs_lvm_vg" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:46 ../src/guestfs-structs.pod:46 +#, no-wrap msgid "" -"Wildcards cannot be used in the ordinary command, but you can use them with " -"the help of L</glob> like this:" +" struct guestfs_lvm_vg {\n" +" char *vg_name;\n" +" /* The next field is NOT nul-terminated, be careful when printing it: " +"*/\n" +" char vg_uuid[32];\n" +" char *vg_fmt;\n" +" char *vg_attr;\n" +" uint64_t vg_size;\n" +" uint64_t vg_free;\n" +" char *vg_sysid;\n" +" uint64_t vg_extent_size;\n" +" int64_t vg_extent_count;\n" +" int64_t vg_free_count;\n" +" int64_t max_lv;\n" +" int64_t max_pv;\n" +" int64_t pv_count;\n" +" int64_t lv_count;\n" +" int64_t snap_count;\n" +" int64_t vg_seqno;\n" +" char *vg_tags;\n" +" int64_t vg_mda_count;\n" +" uint64_t vg_mda_free;\n" +" };\n" +" \n" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:49 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:69 ../src/guestfs-structs.pod:69 #, no-wrap msgid "" -" glob copy-out /home/* .\n" +" struct guestfs_lvm_vg_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_lvm_vg *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:74 ../src/guestfs-structs.pod:74 +#, no-wrap +msgid "" +" void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n" +" void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n" "\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:51 -msgid "display" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:77 ../src/guestfs-structs.pod:77 +msgid "guestfs_lvm_lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:53 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:79 ../src/guestfs-structs.pod:79 #, no-wrap msgid "" -" display filename\n" +" struct guestfs_lvm_lv {\n" +" char *lv_name;\n" +" /* The next field is NOT nul-terminated, be careful when printing it: " +"*/\n" +" char lv_uuid[32];\n" +" char *lv_attr;\n" +" int64_t lv_major;\n" +" int64_t lv_minor;\n" +" int64_t lv_kernel_major;\n" +" int64_t lv_kernel_minor;\n" +" uint64_t lv_size;\n" +" int64_t seg_count;\n" +" char *origin;\n" +" /* The next field is [0..100] or -1 meaning 'not present': */\n" +" float snap_percent;\n" +" /* The next field is [0..100] or -1 meaning 'not present': */\n" +" float copy_percent;\n" +" char *move_pv;\n" +" char *lv_tags;\n" +" char *mirror_log;\n" +" char *modules;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:101 ../src/guestfs-structs.pod:101 +#, no-wrap +msgid "" +" struct guestfs_lvm_lv_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_lvm_lv *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:106 ../src/guestfs-structs.pod:106 +#, no-wrap +msgid "" +" void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n" +" void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:55 +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:111 ../src/guestfs-structs.pod:111 +#, no-wrap msgid "" -"Use C<display> (a graphical display program) to display an image file. It " -"downloads the file, and runs C<display> on it." +" struct guestfs_stat {\n" +" int64_t dev;\n" +" int64_t ino;\n" +" int64_t mode;\n" +" int64_t nlink;\n" +" int64_t uid;\n" +" int64_t gid;\n" +" int64_t rdev;\n" +" int64_t size;\n" +" int64_t blksize;\n" +" int64_t blocks;\n" +" int64_t atime;\n" +" int64_t mtime;\n" +" int64_t ctime;\n" +" };\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:58 +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:127 ../src/guestfs-structs.pod:127 +#, no-wrap msgid "" -"To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE> " -"environment variable. For example to use the GNOME display program:" +" struct guestfs_stat_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_stat *val; /* Elements. */\n" +" };\n" +" \n" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:61 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:132 ../src/guestfs-structs.pod:132 #, no-wrap msgid "" -" export GUESTFISH_DISPLAY_IMAGE=eog\n" +" void guestfs_free_stat (struct guestfs_free_stat *);\n" +" void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:63 -msgid "See also L<display(1)>." +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:137 ../src/guestfs-structs.pod:137 +#, no-wrap +msgid "" +" struct guestfs_statvfs {\n" +" int64_t bsize;\n" +" int64_t frsize;\n" +" int64_t blocks;\n" +" int64_t bfree;\n" +" int64_t bavail;\n" +" int64_t files;\n" +" int64_t ffree;\n" +" int64_t favail;\n" +" int64_t fsid;\n" +" int64_t flag;\n" +" int64_t namemax;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:151 ../src/guestfs-structs.pod:151 +#, no-wrap +msgid "" +" struct guestfs_statvfs_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_statvfs *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:156 ../src/guestfs-structs.pod:156 +#, no-wrap +msgid "" +" void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n" +" void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n" +"\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:65 -msgid "echo" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:159 ../src/guestfs-structs.pod:159 +msgid "guestfs_dirent" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:67 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:161 ../src/guestfs-structs.pod:161 #, no-wrap msgid "" -" echo [params ...]\n" +" struct guestfs_dirent {\n" +" int64_t ino;\n" +" char ftyp;\n" +" char *name;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:167 ../src/guestfs-structs.pod:167 +#, no-wrap +msgid "" +" struct guestfs_dirent_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_dirent *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:172 ../src/guestfs-structs.pod:172 +#, no-wrap +msgid "" +" void guestfs_free_dirent (struct guestfs_free_dirent *);\n" +" void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-commands.pod:69 -msgid "This echos the parameters to the terminal." +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:177 ../src/guestfs-structs.pod:177 +#, no-wrap +msgid "" +" struct guestfs_version {\n" +" int64_t major;\n" +" int64_t minor;\n" +" int64_t release;\n" +" char *extra;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:184 ../src/guestfs-structs.pod:184 +#, no-wrap +msgid "" +" struct guestfs_version_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_version *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:189 ../src/guestfs-structs.pod:189 +#, no-wrap +msgid "" +" void guestfs_free_version (struct guestfs_free_version *);\n" +" void guestfs_free_version_list (struct guestfs_free_version_list *);\n" +"\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:71 -msgid "edit" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:192 ../src/guestfs-structs.pod:192 +msgid "guestfs_xattr" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:194 ../src/guestfs-structs.pod:194 +#, no-wrap +msgid "" +" struct guestfs_xattr {\n" +" char *attrname;\n" +" /* The next two fields describe a byte array. */\n" +" uint32_t attrval_len;\n" +" char *attrval;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:201 ../src/guestfs-structs.pod:201 +#, no-wrap +msgid "" +" struct guestfs_xattr_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_xattr *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:206 ../src/guestfs-structs.pod:206 +#, no-wrap +msgid "" +" void guestfs_free_xattr (struct guestfs_free_xattr *);\n" +" void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n" +"\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:73 -msgid "vi" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:209 ../src/guestfs-structs.pod:209 +msgid "guestfs_inotify_event" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:211 ../src/guestfs-structs.pod:211 +#, no-wrap +msgid "" +" struct guestfs_inotify_event {\n" +" int64_t in_wd;\n" +" uint32_t in_mask;\n" +" uint32_t in_cookie;\n" +" char *in_name;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:218 ../src/guestfs-structs.pod:218 +#, no-wrap +msgid "" +" struct guestfs_inotify_event_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_inotify_event *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:223 ../src/guestfs-structs.pod:223 +#, no-wrap +msgid "" +" void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n" +" void guestfs_free_inotify_event_list (struct " +"guestfs_free_inotify_event_list *);\n" +"\n" msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:75 -msgid "emacs" +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:226 ../src/guestfs-structs.pod:226 +msgid "guestfs_partition" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:77 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:228 ../src/guestfs-structs.pod:228 #, no-wrap msgid "" -" edit filename\n" +" struct guestfs_partition {\n" +" int32_t part_num;\n" +" uint64_t part_start;\n" +" uint64_t part_end;\n" +" uint64_t part_size;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:235 ../src/guestfs-structs.pod:235 +#, no-wrap +msgid "" +" struct guestfs_partition_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_partition *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:240 ../src/guestfs-structs.pod:240 +#, no-wrap +msgid "" +" void guestfs_free_partition (struct guestfs_free_partition *);\n" +" void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:243 ../src/guestfs-structs.pod:243 +msgid "guestfs_application" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:245 ../src/guestfs-structs.pod:245 +#, no-wrap +msgid "" +" struct guestfs_application {\n" +" char *app_name;\n" +" char *app_display_name;\n" +" int32_t app_epoch;\n" +" char *app_version;\n" +" char *app_release;\n" +" char *app_install_path;\n" +" char *app_trans_path;\n" +" char *app_publisher;\n" +" char *app_url;\n" +" char *app_source_package;\n" +" char *app_summary;\n" +" char *app_description;\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:260 ../src/guestfs-structs.pod:260 +#, no-wrap +msgid "" +" struct guestfs_application_list {\n" +" uint32_t len; /* Number of elements in list. */\n" +" struct guestfs_application *val; /* Elements. */\n" +" };\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs-structs.pod:265 ../src/guestfs-structs.pod:265 +#, no-wrap +msgid "" +" void guestfs_free_application (struct guestfs_free_application *);\n" +" void guestfs_free_application_list (struct guestfs_free_application_list " +"*);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:79 +#: ../libguestfs-1.11.19/src/guestfs.pod:5 ../src/guestfs.pod:5 +msgid "guestfs - Library for accessing and modifying virtual machine images" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:11 ../src/guestfs.pod:11 +#, no-wrap msgid "" -"This is used to edit a file. It downloads the file, edits it locally using " -"your editor, then uploads the result." +" 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" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:82 +#: ../libguestfs-1.11.19/src/guestfs.pod:25 ../src/guestfs.pod:25 msgid "" -"The editor is C<$EDITOR>. However if you use the alternate commands C<vi> " -"or C<emacs> you will get those corresponding editors." +"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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:33 ../src/guestfs.pod:33 +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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:38 ../src/guestfs.pod:38 +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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:43 ../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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:48 ../src/guestfs.pod:48 +msgid "" +"You don't need to be root to use libguestfs, although obviously you do need " +"enough permissions to access the disk images." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:51 ../src/guestfs.pod:51 +msgid "" +"Libguestfs is a large API because it can do many things. For a gentle " +"introduction, please read the L</API OVERVIEW> section next." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:54 ../src/guestfs.pod:54 +msgid "" +"There are also some example programs in the L<guestfs-examples(3)> manual " +"page." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:57 ../src/guestfs.pod:57 +msgid "API OVERVIEW" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:59 ../src/guestfs.pod:59 +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." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:86 -msgid "glob" +#: ../libguestfs-1.11.19/src/guestfs.pod:64 ../src/guestfs.pod:64 +msgid "HANDLES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:66 ../src/guestfs.pod:66 +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<g> for the name of the " +"handle variable, although of course you can use any name you want." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:73 ../src/guestfs.pod:73 +msgid "The general structure of all libguestfs-using programs looks like this:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:88 +#: ../libguestfs-1.11.19/src/guestfs.pod:76 ../src/guestfs.pod:76 #, no-wrap msgid "" -" glob command args...\n" +" guestfs_h *g = guestfs_create ();\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:78 ../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" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:83 ../src/guestfs.pod:83 +#, 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" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:89 ../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" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:94 ../src/guestfs.pod:94 +#, no-wrap +msgid "" +" /* To access a filesystem in the image, you must mount it.\n" +" */\n" +" guestfs_mount (g, \"/dev/sda1\", \"/\");\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:98 ../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" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:103 ../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" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:109 ../src/guestfs.pod:109 +#, no-wrap +msgid "" +" /* Close the handle 'g'. */\n" +" guestfs_close (g);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:90 +#: ../libguestfs-1.11.19/src/guestfs.pod:112 ../src/guestfs.pod:112 msgid "" -"Expand wildcards in any paths in the args list, and run C<command> " -"repeatedly on each matching path." +"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<NULL> on error. See section L</ERROR HANDLING> 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<guestfs-examples(3)> for fully worked examples." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:121 ../src/guestfs.pod:121 +msgid "DISK IMAGES" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:93 -msgid "See L</WILDCARDS AND GLOBBING>." +#: ../libguestfs-1.11.19/src/guestfs.pod:123 ../src/guestfs.pod:123 +msgid "" +"The image filename (C<\"guest.img\"> in the example above) could be a disk " +"image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an " +"actual block device, or simply an empty file of zeroes that you have created " +"through L<posix_fallocate(3)>. Libguestfs lets you do useful things to all " +"of these." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:129 ../src/guestfs.pod:129 +msgid "" +"The call you should use in modern code for adding drives is " +"L</guestfs_add_drive_opts>. To add a disk image, allowing writes, and " +"specifying that the format is raw, do:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:133 ../src/guestfs.pod:133 +#, no-wrap +msgid "" +" guestfs_add_drive_opts (g, filename,\n" +" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n" +" -1);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:137 ../src/guestfs.pod:137 +msgid "You can add a disk read-only using:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:139 ../src/guestfs.pod:139 +#, 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" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:144 ../src/guestfs.pod:144 +msgid "" +"or by calling the older function L</guestfs_add_drive_ro>. In either case " +"libguestfs won't modify the file." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:147 ../src/guestfs.pod:147 +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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:151 ../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</dev/sda> (for the " +"first one you added), C</dev/sdb> (for the second one you added), etc." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:156 ../src/guestfs.pod:156 +msgid "" +"Once L</guestfs_launch> has been called you cannot add any more images. You " +"can call L</guestfs_list_devices> to get a list of the device names, in the " +"order that you added them. See also L</BLOCK DEVICE NAMING> below." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:95 -msgid "hexedit" +#: ../libguestfs-1.11.19/src/guestfs.pod:161 ../src/guestfs.pod:161 +msgid "MOUNTING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:163 ../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</guestfs_mount_options> or L</guestfs_mount_ro>. 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:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:97 +#: ../libguestfs-1.11.19/src/guestfs.pod:170 ../src/guestfs.pod:170 #, no-wrap msgid "" -" hexedit <filename|device>\n" -" hexedit <filename|device> <max>\n" -" hexedit <filename|device> <start> <max>\n" +" guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:101 +#: ../libguestfs-1.11.19/src/guestfs.pod:172 ../src/guestfs.pod:172 msgid "" -"Use hexedit (a hex editor) to edit all or part of a binary file or block " -"device." +"where C</dev/sda1> means literally the first partition (C<1>) of the first " +"disk image that we added (C</dev/sda>). If the disk contains Linux LVM2 " +"logical volumes you could refer to those instead (eg. C</dev/VG/LV>). Note " +"that these are libguestfs virtual devices, and are nothing to do with host " +"devices." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:104 +#: ../libguestfs-1.11.19/src/guestfs.pod:178 ../src/guestfs.pod:178 msgid "" -"This command works by downloading potentially the whole file or device, " -"editing it locally, then uploading it. If the file or device is large, you " -"have to specify which part you wish to edit by using C<max> and/or C<start> " -"C<max> parameters. C<start> and C<max> are specified in bytes, with the " -"usual modifiers allowed such as C<1M> (1 megabyte)." +"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</guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions " +"and LVs, and either try mounting each to see what is mountable, or else " +"examine them with L</guestfs_vfs_type> or L</guestfs_file>. To list just " +"filesystems, use L</guestfs_list_filesystems>." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:111 -msgid "For example to edit the first few sectors of a disk you might do:" +#: ../libguestfs-1.11.19/src/guestfs.pod:186 ../src/guestfs.pod:186 +msgid "" +"Libguestfs also has a set of APIs for inspection of unknown disk images (see " +"L</INSPECTION> below). But you might find it easier to look at higher level " +"programs built on top of libguestfs, in particular L<virt-inspector(1)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:191 ../src/guestfs.pod:191 +msgid "" +"To mount a filesystem read-only, use L</guestfs_mount_ro>. There are " +"several other variations of the C<guestfs_mount_*> call." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:194 ../src/guestfs.pod:194 +msgid "FILESYSTEM ACCESS AND MODIFICATION" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:196 ../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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:202 ../src/guestfs.pod:202 +msgid "" +"Specify filenames as full paths, starting with C<\"/\"> and including the " +"mount point." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:205 ../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:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:114 +#: ../libguestfs-1.11.19/src/guestfs.pod:208 ../src/guestfs.pod:208 #, no-wrap msgid "" -" hexedit /dev/sda 1M\n" +" char *data = guestfs_cat (g, \"/etc/passwd\");\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:116 +#: ../libguestfs-1.11.19/src/guestfs.pod:210 ../src/guestfs.pod:210 msgid "" -"which would allow you to edit anywhere within the first megabyte of the " -"disk." +"This would return C<data> as a newly allocated buffer containing the full " +"content of that file (with some conditions: see also L</DOWNLOADING> below), " +"or C<NULL> if there was an error." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:119 -msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:" +#: ../libguestfs-1.11.19/src/guestfs.pod:214 ../src/guestfs.pod:214 +msgid "" +"As another example, to create a top-level directory on that filesystem " +"called C<\"var\"> you would do:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:121 +#: ../libguestfs-1.11.19/src/guestfs.pod:217 ../src/guestfs.pod:217 #, no-wrap msgid "" -" hexedit /dev/sda1 0x400 0x400\n" +" guestfs_mkdir (g, \"/var\");\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:123 -msgid "(assuming the superblock is in the standard location)." +#: ../libguestfs-1.11.19/src/guestfs.pod:219 ../src/guestfs.pod:219 +msgid "To create a symlink you could do:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:221 ../src/guestfs.pod:221 +#, no-wrap +msgid "" +" guestfs_ln_s (g, \"/etc/init.d/portmap\",\n" +" \"/etc/rc3.d/S30portmap\");\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:125 +#: ../libguestfs-1.11.19/src/guestfs.pod:224 ../src/guestfs.pod:224 msgid "" -"This command requires the external L<hexedit(1)> program. You can specify " -"another program to use by setting the C<HEXEDITOR> environment variable." +"Libguestfs will reject attempts to use relative paths and there is no " +"concept of a current working directory." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:129 -msgid "See also L</hexdump>." +#: ../libguestfs-1.11.19/src/guestfs.pod:227 ../src/guestfs.pod:227 +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)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:233 ../src/guestfs.pod:233 +msgid "" +"File writes are affected by the per-handle umask, set by calling " +"L</guestfs_umask> and defaulting to 022. See L</UMASK>." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:131 -msgid "lcd" +#: ../libguestfs-1.11.19/src/guestfs.pod:236 ../src/guestfs.pod:236 +msgid "PARTITIONING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:238 ../src/guestfs.pod:238 +msgid "" +"Libguestfs contains API calls to read, create and modify partition tables on " +"disk images." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:241 ../src/guestfs.pod:241 +msgid "" +"In the common case where you want to create a single partition covering the " +"whole disk, you should use the L</guestfs_part_disk> call:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:133 +#: ../libguestfs-1.11.19/src/guestfs.pod:245 ../src/guestfs.pod:245 #, no-wrap msgid "" -" lcd directory\n" +" const char *parttype = \"mbr\";\n" +" if (disk_is_larger_than_2TB)\n" +" parttype = \"gpt\";\n" +" guestfs_part_disk (g, \"/dev/sda\", parttype);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:135 -msgid "Change the local directory, ie. the current directory of guestfish itself." +#: ../libguestfs-1.11.19/src/guestfs.pod:250 ../src/guestfs.pod:250 +msgid "" +"Obviously this effectively wipes anything that was on that disk image " +"before." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:253 ../src/guestfs.pod:253 +msgid "LVM2" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:138 -msgid "Note that C<!cd> won't do what you might expect." +#: ../libguestfs-1.11.19/src/guestfs.pod:255 ../src/guestfs.pod:255 +msgid "" +"Libguestfs provides access to a large part of the LVM2 API, such as " +"L</guestfs_lvcreate> and L</guestfs_vgremove>. It won't make much sense " +"unless you familiarize yourself with the concepts of physical volumes, " +"volume groups and logical volumes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:260 ../src/guestfs.pod:260 +msgid "" +"This author strongly recommends reading the LVM HOWTO, online at " +"L<http://tldp.org/HOWTO/LVM-HOWTO/>." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:140 -msgid "man" +#: ../libguestfs-1.11.19/src/guestfs.pod:263 ../src/guestfs.pod:263 +msgid "DOWNLOADING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:265 ../src/guestfs.pod:265 +msgid "" +"Use L</guestfs_cat> 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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:269 ../src/guestfs.pod:269 +msgid "" +"L</guestfs_read_file> 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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:273 ../src/guestfs.pod:273 +msgid "" +"L</guestfs_download> can be used to download any file, with no limits on " +"content or size (even files larger than 4 GB)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:276 ../src/guestfs.pod:276 +msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:142 -msgid "manual" +#: ../libguestfs-1.11.19/src/guestfs.pod:279 ../src/guestfs.pod:279 +msgid "UPLOADING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:281 ../src/guestfs.pod:281 +msgid "" +"It's often the case that you want to write a file or files to the disk " +"image." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:284 ../src/guestfs.pod:284 +msgid "" +"To write a small file with fixed content, use L</guestfs_write>. To create " +"a file of all zeroes, use L</guestfs_truncate_size> (sparse) or " +"L</guestfs_fallocate64> (with all disk blocks allocated). There are a " +"variety of other functions for creating test files, for example " +"L</guestfs_fill> and L</guestfs_fill_pattern>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:290 ../src/guestfs.pod:290 +msgid "" +"To upload a single file, use L</guestfs_upload>. This call has no limits on " +"file content or size (even files larger than 4 GB)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:293 ../src/guestfs.pod:293 +msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:295 ../src/guestfs.pod:295 +msgid "" +"However the fastest way to upload I<large numbers of arbitrary files> is to " +"turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and " +"L<mkisofs(8)>), then attach this using L</guestfs_add_drive_ro>. 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</guestfs_list_devices> and mount it " +"directly using L</guestfs_mount_ro>. 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." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:306 ../src/guestfs.pod:306 +msgid "COPYING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:308 ../src/guestfs.pod:308 +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." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:314 ../src/guestfs.pod:314 +msgid "B<file> to B<file>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:316 ../src/guestfs.pod:316 +msgid "" +"Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy " +"directories recursively." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:319 ../src/guestfs.pod:319 +msgid "B<file or device> to B<file or device>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:321 ../src/guestfs.pod:321 +msgid "" +"Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and " +"devices in the guest." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:324 ../src/guestfs.pod:324 +msgid "Example: duplicate the contents of an LV:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:144 +#: ../libguestfs-1.11.19/src/guestfs.pod:326 ../src/guestfs.pod:326 #, no-wrap msgid "" -" man\n" +" guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:146 -msgid "Opens the manual page for guestfish." +#: ../libguestfs-1.11.19/src/guestfs.pod:328 ../src/guestfs.pod:328 +msgid "" +"The destination (C</dev/VG/Copy>) must be at least as large as the source " +"(C</dev/VG/Original>). To copy less than the whole source device, use " +"L</guestfs_copy_size>." msgstr "" -#. type: =head2 -#: ../fish/guestfish-commands.pod:148 -msgid "more" +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:332 ../src/guestfs.pod:332 +msgid "B<file on the host> to B<file or device>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:334 ../src/guestfs.pod:334 +msgid "Use L</guestfs_upload>. See L</UPLOADING> above." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:336 ../src/guestfs.pod:336 +msgid "B<file or device> to B<file on the host>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:338 ../src/guestfs.pod:338 +msgid "Use L</guestfs_download>. See L</DOWNLOADING> above." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:150 -msgid "less" +#: ../libguestfs-1.11.19/src/guestfs.pod:342 ../src/guestfs.pod:342 +msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:344 ../src/guestfs.pod:344 +msgid "" +"Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, " +"L</guestfs_tar_out> 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</dev/stdin>, C</dev/stdout>, " +"C</dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, " +"stderr, and arbitrary file descriptor N." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:352 ../src/guestfs.pod:352 +msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:152 +#: ../libguestfs-1.11.19/src/guestfs.pod:355 ../src/guestfs.pod:355 #, no-wrap msgid "" -" more filename\n" +" guestfs_download (g, filename, \"/dev/stdout\");\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:357 ../src/guestfs.pod:357 +msgid "and you can write tar output to a file descriptor C<fd> by doing:" +msgstr "" + #. type: verbatim -#: ../fish/guestfish-commands.pod:154 +#: ../libguestfs-1.11.19/src/guestfs.pod:359 ../src/guestfs.pod:359 #, no-wrap msgid "" -" less filename\n" +" char devfd[64];\n" +" snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n" +" guestfs_tar_out (g, \"/\", devfd);\n" "\n" msgstr "" +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:363 ../src/guestfs.pod:363 +msgid "LISTING FILES" +msgstr "" + #. type: textblock -#: ../fish/guestfish-commands.pod:156 -msgid "This is used to view a file." +#: ../libguestfs-1.11.19/src/guestfs.pod:365 ../src/guestfs.pod:365 +msgid "" +"L</guestfs_ll> is just designed for humans to read (mainly when using the " +"L<guestfish(1)>-equivalent command C<ll>)." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:158 +#: ../libguestfs-1.11.19/src/guestfs.pod:368 ../src/guestfs.pod:368 msgid "" -"The default viewer is C<$PAGER>. However if you use the alternate command " -"C<less> you will get the C<less> command specifically." +"L</guestfs_ls> is a quick way to get a list of files in a directory from " +"programs, as a flat list of strings." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:371 ../src/guestfs.pod:371 +msgid "" +"L</guestfs_readdir> 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<readdir(3)> call on a local filesystem." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:375 ../src/guestfs.pod:375 +msgid "" +"L</guestfs_find> and L</guestfs_find0> can be used to recursively list " +"files." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:161 -msgid "reopen" +#: ../libguestfs-1.11.19/src/guestfs.pod:378 ../src/guestfs.pod:378 +msgid "RUNNING COMMANDS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:380 ../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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:384 ../src/guestfs.pod:384 +msgid "There are many limitations to this:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:390 ../src/guestfs.pod:390 +msgid "" +"The kernel version that the command runs under will be different from what " +"it expects." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:395 ../src/guestfs.pod:395 +msgid "" +"If the command needs to communicate with daemons, then most likely they " +"won't be running." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:400 ../src/guestfs.pod:400 +msgid "The command will be running in limited memory." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:404 ../src/guestfs.pod:404 +msgid "" +"The network may not be available unless you enable it (see " +"L</guestfs_set_network>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:409 ../src/guestfs.pod:409 +msgid "Only supports Linux guests (not Windows, BSD, etc)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:413 ../src/guestfs.pod:413 +msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:418 ../src/guestfs.pod:418 +msgid "" +"For SELinux guests, you may need to enable SELinux and load policy first. " +"See L</SELINUX> in this manpage." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:423 ../src/guestfs.pod:423 +msgid "" +"I<Security:> 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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:432 ../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</SECURITY>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:440 ../src/guestfs.pod:440 +msgid "" +"The two main API calls to run commands are L</guestfs_command> and " +"L</guestfs_sh> (there are also variations)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:443 ../src/guestfs.pod:443 +msgid "" +"The difference is that L</guestfs_sh> runs commands using the shell, so any " +"shell globs, redirections, etc will work." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:446 ../src/guestfs.pod:446 +msgid "CONFIGURATION FILES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:448 ../src/guestfs.pod:448 +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." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:453 ../src/guestfs.pod:453 +msgid "" +"The main Augeas calls are bound through the C<guestfs_aug_*> APIs. We don't " +"document Augeas itself here because there is excellent documentation on the " +"L<http://augeas.net/> website." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:457 ../src/guestfs.pod:457 +msgid "" +"If you don't want to use Augeas (you fool!) then try calling " +"L</guestfs_read_lines> to get the file as a list of lines which you can " +"iterate over." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:461 ../src/guestfs.pod:461 +msgid "SELINUX" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:463 ../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:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:471 ../src/guestfs.pod:471 +msgid "Before launching, do:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:163 +#: ../libguestfs-1.11.19/src/guestfs.pod:473 ../src/guestfs.pod:473 #, no-wrap msgid "" -" reopen\n" +" guestfs_set_selinux (g, 1);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:165 +#: ../libguestfs-1.11.19/src/guestfs.pod:477 ../src/guestfs.pod:477 msgid "" -"Close and reopen the libguestfs handle. It is not necessary to use this " -"normally, because the handle is closed properly when guestfish exits. " -"However this is occasionally useful for testing." +"After mounting the guest's filesystem(s), load the policy. This is best " +"done by running the L<load_policy(8)> command in the guest itself:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-commands.pod:169 -msgid "sparse" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:481 ../src/guestfs.pod:481 +#, no-wrap +msgid "" +" guestfs_sh (g, \"/usr/sbin/load_policy\");\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:483 ../src/guestfs.pod:483 +msgid "" +"(Older versions of C<load_policy> require you to specify the name of the " +"policy file)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:488 ../src/guestfs.pod:488 +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:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:171 +#: ../libguestfs-1.11.19/src/guestfs.pod:492 ../src/guestfs.pod:492 #, no-wrap msgid "" -" sparse filename size\n" +" guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:173 +#: ../libguestfs-1.11.19/src/guestfs.pod:496 ../src/guestfs.pod:496 +msgid "This will work for running commands and editing existing files." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:498 ../src/guestfs.pod:498 msgid "" -"This creates an empty sparse file of the given size, and then adds so it can " -"be further examined." +"When new files are created, you may need to label them explicitly, for " +"example by running the external command C<restorecon pathname>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:502 ../src/guestfs.pod:502 +msgid "UMASK" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:176 +#: ../libguestfs-1.11.19/src/guestfs.pod:504 ../src/guestfs.pod:504 msgid "" -"In all respects it works the same as the L</alloc> command, except that the " -"image file is allocated sparsely, which means that disk blocks are not " -"assigned to the file until they are needed. Sparse disk files only use " -"space when written to, but they are slower and there is a danger you could " -"run out of real disk space during a write operation." +"Certain calls are affected by the current file mode creation mask (the " +"\"umask\"). In particular ones which create files or directories, such as " +"L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>. This affects " +"either the default mode that the file is created with or modifies the mode " +"that you supply." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:510 ../src/guestfs.pod:510 +msgid "" +"The default umask is C<022>, so files are created with modes such as C<0644> " +"and directories with C<0755>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:513 ../src/guestfs.pod:513 +msgid "" +"There are two ways to avoid being affected by umask. Either set umask to 0 " +"(call C<guestfs_umask (g, 0)> early after launching). Or call " +"L</guestfs_chmod> after creating each file or directory." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:517 ../src/guestfs.pod:517 +msgid "For more information about umask, see L<umask(2)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:521 ../src/guestfs.pod:521 +msgid "" +"Libguestfs allows you to access Linux guests which have been encrypted using " +"whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) " +"standard. This includes nearly all whole disk encryption systems used by " +"modern Linux guests." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:527 ../src/guestfs.pod:527 +msgid "" +"Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it " +"returns the string C<crypto_LUKS>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:530 ../src/guestfs.pod:530 +msgid "" +"Then open these devices by calling L</guestfs_luks_open>. Obviously you " +"will require the passphrase!" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:533 ../src/guestfs.pod:533 +msgid "" +"Opening a LUKS device creates a new device mapper device called " +"C</dev/mapper/mapname> (where C<mapname> is the string you supply to " +"L</guestfs_luks_open>). Reads and writes to this mapper device are " +"decrypted from and encrypted to the underlying block device respectively." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:539 ../src/guestfs.pod:539 +msgid "" +"LVM volume groups on the device can be made visible by calling " +"L</guestfs_vgscan> followed by L</guestfs_vg_activate_all>. The logical " +"volume(s) can now be mounted in the usual way." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:543 ../src/guestfs.pod:543 +msgid "" +"Use the reverse process to close a LUKS device. Unmount any logical volumes " +"on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, " +"[\"/dev/VG\"])>. Then close the mapper device by calling " +"L</guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the " +"underlying encrypted block device)." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:186 -msgid "supported" +#: ../libguestfs-1.11.19/src/guestfs.pod:550 ../src/guestfs.pod:550 +msgid "INSPECTION" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:552 ../src/guestfs.pod:552 +msgid "" +"Libguestfs has APIs for inspecting an unknown disk image to find out if it " +"contains operating systems, an install CD or a live CD. (These APIs used to " +"be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since " +"version 1.5.3 the most frequently used part of this library has been " +"rewritten in C and moved into the core code)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:559 ../src/guestfs.pod:559 +msgid "" +"Add all disks belonging to the unknown virtual machine and call " +"L</guestfs_launch> in the usual way." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:562 ../src/guestfs.pod:562 +msgid "" +"Then call L</guestfs_inspect_os>. This function uses other libguestfs calls " +"and certain heuristics, and returns a list of operating systems that were " +"found. An empty list means none were found. A single element is the root " +"filesystem of the operating system. For dual- or multi-boot guests, " +"multiple roots can be returned, each one corresponding to a separate " +"operating system. (Multi-boot virtual machines are extremely rare in the " +"world of virtualization, but since this scenario can happen, we have built " +"libguestfs to deal with it.)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:571 ../src/guestfs.pod:571 +msgid "" +"For each root, you can then call various C<guestfs_inspect_get_*> functions " +"to get additional details about that operating system. For example, call " +"L</guestfs_inspect_get_type> to return the string C<windows> or C<linux> for " +"Windows and Linux-based operating systems respectively." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:577 ../src/guestfs.pod:577 +msgid "" +"Un*x-like and Linux-based operating systems usually consist of several " +"filesystems which are mounted at boot time (for example, a separate boot " +"partition mounted on C</boot>). The inspection rules are able to detect how " +"filesystems correspond to mount points. Call " +"C<guestfs_inspect_get_mountpoints> to get this mapping. It might return a " +"hash table like this example:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:188 +#: ../libguestfs-1.11.19/src/guestfs.pod:584 ../src/guestfs.pod:584 #, no-wrap msgid "" -" supported\n" +" /boot => /dev/sda1\n" +" / => /dev/vg_guest/lv_root\n" +" /usr => /dev/vg_guest/lv_usr\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:190 +#: ../libguestfs-1.11.19/src/guestfs.pod:588 ../src/guestfs.pod:588 msgid "" -"This command returns a list of the optional groups known to the daemon, and " -"indicates which ones are supported by this build of the libguestfs " -"appliance." +"The caller can then make calls to L</guestfs_mount_options> to mount the " +"filesystems as suggested." msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:194 -msgid "See also L<guestfs(3)/AVAILABILITY>." +#: ../libguestfs-1.11.19/src/guestfs.pod:591 ../src/guestfs.pod:591 +msgid "" +"Be careful to mount filesystems in the right order (eg. C</> before " +"C</usr>). Sorting the keys of the hash by length, shortest first, should " +"work." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:595 ../src/guestfs.pod:595 +msgid "" +"Inspection currently only works for some common operating systems. " +"Contributors are welcome to send patches for other operating systems that we " +"currently cannot detect." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:599 ../src/guestfs.pod:599 +msgid "" +"Encrypted disks must be opened before inspection. See L</ENCRYPTED DISKS> " +"for more details. The L</guestfs_inspect_os> function just ignores any " +"encrypted devices." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:603 ../src/guestfs.pod:603 +msgid "" +"A note on the implementation: The call L</guestfs_inspect_os> performs " +"inspection and caches the results in the guest handle. Subsequent calls to " +"C<guestfs_inspect_get_*> return this cached information, but I<do not> " +"re-read the disks. If you change the content of the guest disks, you can " +"redo inspection by calling L</guestfs_inspect_os> again. " +"(L</guestfs_inspect_list_applications> works a little differently from the " +"other calls and does read the disks. See documentation for that function " +"for details)." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:612 ../src/guestfs.pod:612 +msgid "INSPECTING INSTALL DISKS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:614 ../src/guestfs.pod:614 +msgid "" +"Libguestfs (since 1.9.4) can detect some install disks, install CDs, live " +"CDs and more." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:617 ../src/guestfs.pod:617 +msgid "" +"Call L</guestfs_inspect_get_format> to return the format of the operating " +"system, which currently can be C<installed> (a regular operating system) or " +"C<installer> (some sort of install disk)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:621 ../src/guestfs.pod:621 +msgid "" +"Further information is available about the operating system that can be " +"installed using the regular inspection APIs like " +"L</guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> " +"etc." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:626 ../src/guestfs.pod:626 +msgid "" +"Some additional information specific to installer disks is also available " +"from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and " +"L</guestfs_inspect_is_multipart> calls." msgstr "" #. type: =head2 -#: ../fish/guestfish-commands.pod:196 -msgid "time" +#: ../libguestfs-1.11.19/src/guestfs.pod:631 ../src/guestfs.pod:631 +msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:633 ../src/guestfs.pod:633 +msgid "" +"Libguestfs can mount NTFS partitions. It does this using the " +"L<http://www.ntfs-3g.org/> driver." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:636 ../src/guestfs.pod:636 +msgid "DRIVE LETTERS AND PATHS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:638 ../src/guestfs.pod:638 +msgid "" +"DOS and Windows still use drive letters, and the filesystems are always " +"treated as case insensitive by Windows itself, and therefore you might find " +"a Windows configuration file referring to a path like " +"C<c:\\windows\\system32>. When the filesystem is mounted in libguestfs, " +"that directory might be referred to as C</WINDOWS/System32>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:644 ../src/guestfs.pod:644 +msgid "" +"Drive letter mappings can be found using inspection (see L</INSPECTION> and " +"L</guestfs_inspect_get_drive_mappings>)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:647 ../src/guestfs.pod:647 +msgid "" +"Dealing with separator characters (backslash vs forward slash) is outside " +"the scope of libguestfs, but usually a simple character replacement will " +"work." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:651 ../src/guestfs.pod:651 +msgid "" +"To resolve the case insensitivity of paths, call " +"L</guestfs_case_sensitive_path>." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:654 ../src/guestfs.pod:654 +msgid "ACCESSING THE WINDOWS REGISTRY" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:656 ../src/guestfs.pod:656 +msgid "" +"Libguestfs also provides some help for decoding Windows Registry \"hive\" " +"files, through the library C<hivex> which is part of the libguestfs project " +"although ships as a separate tarball. You have to locate and download the " +"hive file(s) yourself, and then pass them to C<hivex> functions. See also " +"the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and " +"L<virt-win-reg(1)> for more help on this issue." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:664 ../src/guestfs.pod:664 +msgid "SYMLINKS ON NTFS-3G FILESYSTEMS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:666 ../src/guestfs.pod:666 +msgid "" +"Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to " +"provide something which looks like a Linux symlink. The way it tries to do " +"the rewriting is described here:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:670 ../src/guestfs.pod:670 +msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:672 ../src/guestfs.pod:672 +msgid "" +"The essential problem is that ntfs-3g simply does not have enough " +"information to do a correct job. NTFS links can contain drive letters and " +"references to external device GUIDs that ntfs-3g has no way of resolving. " +"It is almost certainly the case that libguestfs callers should ignore what " +"ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:679 ../src/guestfs.pod:679 +msgid "" +"Instead if you encounter a symbolic link on an ntfs-3g filesystem, use " +"L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended " +"attribute, and read the raw reparse data from that (you can find the format " +"documented in various places around the web)." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:684 ../src/guestfs.pod:684 +msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:686 ../src/guestfs.pod:686 +msgid "" +"There are other useful extended attributes that can be read from ntfs-3g " +"filesystems (using L</guestfs_getxattr>). See:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:689 ../src/guestfs.pod:689 +msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:691 ../src/guestfs.pod:691 +msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:693 ../src/guestfs.pod:693 +msgid "" +"Although we don't want to discourage you from using the C API, we will " +"mention here that the same API is also available in other languages." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:696 ../src/guestfs.pod:696 +msgid "" +"The API is broadly identical in all supported languages. This means that " +"the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> " +"in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in " +"OCaml. In other words, a straightforward, predictable isomorphism between " +"each language." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:702 ../src/guestfs.pod:702 +msgid "" +"Error messages are automatically transformed into exceptions if the language " +"supports it." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:705 ../src/guestfs.pod:705 +msgid "" +"We don't try to \"object orientify\" parts of the API in OO languages, " +"although contributors are welcome to write higher level APIs above what we " +"provide in their favourite languages if they wish." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:711 ../src/guestfs.pod:711 +msgid "B<C++>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:713 ../src/guestfs.pod:713 +msgid "" +"You can use the I<guestfs.h> header file from C++ programs. The C++ API is " +"identical to the C API. C++ classes and exceptions are not used." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:717 ../src/guestfs.pod:717 +msgid "B<C#>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:719 ../src/guestfs.pod:719 +msgid "" +"The C# bindings are highly experimental. Please read the warnings at the " +"top of C<csharp/Libguestfs.cs>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:722 ../src/guestfs.pod:722 +msgid "B<Haskell>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:724 ../src/guestfs.pod:724 +msgid "" +"This is the only language binding that is working but incomplete. Only " +"calls which return simple integers have been bound in Haskell, and we are " +"looking for help to complete this binding." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:728 ../src/guestfs.pod:728 +msgid "B<Java>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:730 ../src/guestfs.pod:730 +msgid "" +"Full documentation is contained in the Javadoc which is distributed with " +"libguestfs." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:733 ../src/guestfs.pod:733 +msgid "B<OCaml>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:735 ../src/guestfs.pod:735 +msgid "See L<guestfs-ocaml(3)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:737 ../src/guestfs.pod:737 +msgid "B<Perl>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:739 ../src/guestfs.pod:739 +msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:741 ../src/guestfs.pod:741 +msgid "B<PHP>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:743 ../src/guestfs.pod:743 +msgid "" +"For documentation see C<README-PHP> supplied with libguestfs sources or in " +"the php-libguestfs package for your distribution." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:746 ../src/guestfs.pod:746 +msgid "The PHP binding only works correctly on 64 bit machines." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:748 ../src/guestfs.pod:748 +msgid "B<Python>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:750 ../src/guestfs.pod:750 +msgid "See L<guestfs-python(3)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:752 ../src/guestfs.pod:752 +msgid "B<Ruby>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:754 ../src/guestfs.pod:754 +msgid "See L<guestfs-ruby(3)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:756 ../src/guestfs.pod:756 +msgid "B<shell scripts>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:758 ../src/guestfs.pod:758 +msgid "See L<guestfish(1)>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:762 ../src/guestfs.pod:762 +msgid "LIBGUESTFS GOTCHAS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:764 ../src/guestfs.pod:764 +msgid "" +"L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a " +"system [...] that works in the way it is documented but is counterintuitive " +"and almost invites mistakes.\"" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:768 ../src/guestfs.pod:768 +msgid "" +"Since we developed libguestfs and the associated tools, there are several " +"things we would have designed differently, but are now stuck with for " +"backwards compatibility or other reasons. If there is ever a libguestfs 2.0 " +"release, you can expect these to change. Beware of them." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:776 ../src/guestfs.pod:776 +msgid "Autosync / forgetting to sync." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:778 ../src/guestfs.pod:778 +msgid "" +"I<Update:> Autosync is enabled by default for all API users starting from " +"libguestfs 1.5.24. This section only applies to older versions." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:781 ../src/guestfs.pod:781 +msgid "" +"When modifying a filesystem from C or another language, you B<must> unmount " +"all filesystems and call L</guestfs_sync> explicitly before you close the " +"libguestfs handle. You can also call:" msgstr "" #. type: verbatim -#: ../fish/guestfish-commands.pod:198 +#: ../libguestfs-1.11.19/src/guestfs.pod:785 ../src/guestfs.pod:785 #, no-wrap msgid "" -" time command args...\n" +" guestfs_set_autosync (g, 1);\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-commands.pod:200 +#: ../libguestfs-1.11.19/src/guestfs.pod:787 ../src/guestfs.pod:787 msgid "" -"Run the command as usual, but print the elapsed time afterwards. This can " -"be useful for benchmarking operations." +"to have the unmount/sync done automatically for you when the handle 'g' is " +"closed. (This feature is called \"autosync\", L</guestfs_set_autosync> " +"q.v.)" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:5 -msgid "libguestfs-test-tool - End user tests for libguestfs" +#: ../libguestfs-1.11.19/src/guestfs.pod:791 ../src/guestfs.pod:791 +msgid "" +"If you forget to do this, then it is entirely possible that your changes " +"won't be written out, or will be partially written, or (very rarely) that " +"you'll get disk corruption." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:795 ../src/guestfs.pod:795 +msgid "" +"Note that in L<guestfish(3)> autosync is the default. So quick and dirty " +"guestfish scripts that forget to sync will work just fine, which can make " +"this very puzzling if you are trying to debug a problem." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:799 ../src/guestfs.pod:799 +msgid "Mount option C<-o sync> should not be the default." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:801 ../src/guestfs.pod:801 +msgid "" +"If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. " +"However C<-o sync> does not add any reliability benefit, but does have a " +"very large performance impact." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:805 ../src/guestfs.pod:805 +msgid "" +"The work around is to use L</guestfs_mount_options> and set the mount " +"options that you actually want to use." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:808 ../src/guestfs.pod:808 +msgid "Read-only should be the default." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:810 ../src/guestfs.pod:810 +msgid "" +"In L<guestfish(3)>, I<--ro> should be the default, and you should have to " +"specify I<--rw> if you want to make changes to the image." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:813 ../src/guestfs.pod:813 +msgid "This would reduce the potential to corrupt live VM images." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:815 ../src/guestfs.pod:815 +msgid "" +"Note that many filesystems change the disk when you just mount and unmount, " +"even if you didn't perform any writes. You need to use " +"L</guestfs_add_drive_ro> to guarantee that the disk is not changed." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:819 ../src/guestfs.pod:819 +msgid "guestfish command line is hard to use." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:821 ../src/guestfs.pod:821 +msgid "" +"C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for " +"examination). It tries to run a guestfish command C<disk.img> which doesn't " +"exist, so it fails. In earlier versions of guestfish the error message was " +"also unintuitive, but we have corrected this since. Like the Bourne shell, " +"we should have used C<guestfish -c command> to run commands." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:828 ../src/guestfs.pod:828 +msgid "guestfish megabyte modifiers don't work right on all commands" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:830 ../src/guestfs.pod:830 +msgid "" +"In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for " +"other modifiers). What guestfish actually does is to multiply the number " +"part by the modifier part and pass the result to the C API. However this " +"doesn't work for a few APIs which aren't expecting bytes, but are already " +"expecting some other unit (eg. megabytes)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:837 ../src/guestfs.pod:837 +msgid "The most common is L</guestfs_lvcreate>. The guestfish command:" msgstr "" #. type: verbatim -#: ../test-tool/libguestfs-test-tool.pod:9 +#: ../libguestfs-1.11.19/src/guestfs.pod:839 ../src/guestfs.pod:839 #, no-wrap msgid "" -" libguestfs-test-tool [--options]\n" +" lvcreate LV VG 100M\n" "\n" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:13 +#: ../libguestfs-1.11.19/src/guestfs.pod:841 ../src/guestfs.pod:841 msgid "" -"libguestfs-test-tool is a test program shipped with libguestfs to end users " -"and developers, to allow them to check basic libguestfs functionality is " -"working. This is needed because libguestfs occasionally breaks for reasons " -"beyond our control: usually because of changes in the underlying qemu or " -"kernel packages, or the host environment." +"does not do what you might expect. Instead because L</guestfs_lvcreate> is " +"already expecting megabytes, this tries to create a 100 I<terabyte> (100 " +"megabytes * megabytes) logical volume. The error message you get from this " +"is also a little obscure." msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:20 -msgid "If you suspect a problem in libguestfs, then just run:" +#: ../libguestfs-1.11.19/src/guestfs.pod:846 ../src/guestfs.pod:846 +msgid "" +"This could be fixed in the generator by specially marking parameters and " +"return values which take bytes or other units." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:849 ../src/guestfs.pod:849 +msgid "Ambiguity between devices and paths" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:851 ../src/guestfs.pod:851 +msgid "" +"There is a subtle ambiguity in the API between a device name " +"(eg. C</dev/sdb2>) and a similar pathname. A file might just happen to be " +"called C<sdb2> in the directory C</dev> (consider some non-Unix VM image)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:856 ../src/guestfs.pod:856 +msgid "" +"In the current API we usually resolve this ambiguity by having two separate " +"calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>. " +"Some API calls are ambiguous and (incorrectly) resolve the problem by " +"detecting if the path supplied begins with C</dev/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:862 ../src/guestfs.pod:862 +msgid "" +"To avoid both the ambiguity and the need to duplicate some calls, we could " +"make paths/devices into structured names. One way to do this would be to " +"use a notation like grub (C<hd(0,0)>), although nobody really likes this " +"aspect of grub. Another way would be to use a structured type, equivalent " +"to this OCaml type:" msgstr "" #. type: verbatim -#: ../test-tool/libguestfs-test-tool.pod:22 +#: ../libguestfs-1.11.19/src/guestfs.pod:868 ../src/guestfs.pod:868 #, no-wrap msgid "" -" libguestfs-test-tool\n" +" type path = Path of string | Device of int | Partition of int * int\n" "\n" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:24 -msgid "It will print lots of diagnostic messages." +#: ../libguestfs-1.11.19/src/guestfs.pod:870 ../src/guestfs.pod:870 +msgid "which would allow you to pass arguments like:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:872 ../src/guestfs.pod:872 +#, no-wrap +msgid "" +" Path \"/foo/bar\"\n" +" Device 1 (* /dev/sdb, or perhaps /dev/sda *)\n" +" Partition (1, 2) (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n" +" Path \"/dev/sdb2\" (* not a device *)\n" +"\n" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:26 -msgid "If it runs to completion successfully, you will see this near the end:" +#: ../libguestfs-1.11.19/src/guestfs.pod:877 ../src/guestfs.pod:877 +msgid "" +"As you can see there are still problems to resolve even with this " +"representation. Also consider how it might work in guestfish." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:882 ../src/guestfs.pod:882 +msgid "KEYS AND PASSPHRASES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:884 ../src/guestfs.pod:884 +msgid "" +"Certain libguestfs calls take a parameter that contains sensitive key " +"material, passed in as a C string." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:887 ../src/guestfs.pod:887 +msgid "" +"In the future we would hope to change the libguestfs implementation so that " +"keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in " +"swap. However this is I<not> done at the moment, because of the complexity " +"of such an implementation." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:892 ../src/guestfs.pod:892 +msgid "" +"Therefore you should be aware that any key parameter you pass to libguestfs " +"might end up being written out to the swap partition. If this is a concern, " +"scrub the swap partition or don't use libguestfs on encrypted devices." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:897 ../src/guestfs.pod:897 +msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:899 ../src/guestfs.pod:899 +msgid "" +"All high-level libguestfs actions are synchronous. If you want to use " +"libguestfs asynchronously then you must create a thread." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:902 ../src/guestfs.pod:902 +msgid "" +"Only use the handle from a single thread. Either use the handle exclusively " +"from one thread, or provide your own mutex so that two threads cannot issue " +"calls on the same handle at the same time." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:906 ../src/guestfs.pod:906 +msgid "" +"See the graphical program guestfs-browser for one possible architecture for " +"multithreaded programs using libvirt and libguestfs." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:909 ../src/guestfs.pod:909 +msgid "PATH" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:911 ../src/guestfs.pod:911 +msgid "" +"Libguestfs needs a supermin appliance, which it finds by looking along an " +"internal path." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:914 ../src/guestfs.pod:914 +msgid "" +"By default it looks for these in the directory C<$libdir/guestfs> " +"(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:917 ../src/guestfs.pod:917 +msgid "" +"Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> " +"to change the directories that libguestfs will search in. The value is a " +"colon-separated list of paths. The current directory is I<not> searched " +"unless the path contains an empty element or C<.>. For example " +"C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and " +"then C</usr/lib/guestfs>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:924 ../src/guestfs.pod:924 +msgid "QEMU WRAPPERS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:926 ../src/guestfs.pod:926 +msgid "" +"If you want to compile your own qemu, run qemu from a non-standard location, " +"or pass extra arguments to qemu, then you can write a shell-script wrapper " +"around qemu." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:930 ../src/guestfs.pod:930 +msgid "" +"There is one important rule to remember: you I<must C<exec qemu>> as the " +"last command in the shell script (so that qemu replaces the shell and " +"becomes the direct child of the libguestfs-using program). If you don't do " +"this, then the qemu process won't be cleaned up correctly." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:935 ../src/guestfs.pod:935 +msgid "" +"Here is an example of a wrapper, where I have built my own copy of qemu from " +"source:" msgstr "" #. type: verbatim -#: ../test-tool/libguestfs-test-tool.pod:28 +#: ../libguestfs-1.11.19/src/guestfs.pod:938 ../src/guestfs.pod:938 #, no-wrap msgid "" -" ===== TEST FINISHED OK =====\n" +" #!/bin/sh -\n" +" qemudir=/home/rjones/d/qemu\n" +" exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios " +"\"$@\"\n" "\n" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:30 -msgid "and the test tool will exit with code 0." +#: ../libguestfs-1.11.19/src/guestfs.pod:942 ../src/guestfs.pod:942 +msgid "" +"Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and " +"then use it by setting the LIBGUESTFS_QEMU environment variable. For " +"example:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:946 ../src/guestfs.pod:946 +#, no-wrap +msgid "" +" LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" +"\n" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:32 +#: ../libguestfs-1.11.19/src/guestfs.pod:948 ../src/guestfs.pod:948 msgid "" -"If it fails (and/or exits with non-zero error code), please paste the " -"B<complete, unedited> output of the test tool into a bug report. More " -"information about reporting bugs can be found on the " -"L<http://libguestfs.org/> website." +"Note that libguestfs also calls qemu with the -help and -version options in " +"order to determine features." msgstr "" -#. type: =item -#: ../test-tool/libguestfs-test-tool.pod:41 -msgid "I<--help>" +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:951 ../src/guestfs.pod:951 +msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:43 -msgid "Display short usage information and exit." +#: ../libguestfs-1.11.19/src/guestfs.pod:953 ../src/guestfs.pod:953 +msgid "" +"I<Note (1):> This is B<highly experimental> and has a tendency to eat " +"babies. Use with caution." msgstr "" -#. type: =item -#: ../test-tool/libguestfs-test-tool.pod:45 -msgid "I<--qemu qemu_binary>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:956 ../src/guestfs.pod:956 +msgid "" +"I<Note (2):> This section explains how to attach to a running daemon from a " +"low level perspective. For most users, simply using virt tools such as " +"L<guestfish(1)> with the I<--live> option will \"just work\"." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:960 ../src/guestfs.pod:960 +msgid "Using guestfs_set_attach_method" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:47 +#: ../libguestfs-1.11.19/src/guestfs.pod:962 ../src/guestfs.pod:962 msgid "" -"If you have downloaded another qemu binary, point this option at the full " -"path of the binary to try it." +"By calling L</guestfs_set_attach_method> you can change how the library " +"connects to the C<guestfsd> daemon in L</guestfs_launch> (read " +"L</ARCHITECTURE> for some background)." msgstr "" -#. type: =item -#: ../test-tool/libguestfs-test-tool.pod:50 -msgid "I<--qemudir qemu_source_dir>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:966 ../src/guestfs.pod:966 +msgid "" +"The normal attach method is C<appliance>, where a small appliance is created " +"containing the daemon, and then the library connects to this." msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:52 +#: ../libguestfs-1.11.19/src/guestfs.pod:969 ../src/guestfs.pod:969 msgid "" -"If you have compiled qemu from source, point this option at the source " -"directory to try it." +"Setting attach method to C<unix:I<path>> (where I<path> is the path of a " +"Unix domain socket) causes L</guestfs_launch> to connect to an existing " +"daemon over the Unix domain socket." msgstr "" -#. type: =item -#: ../test-tool/libguestfs-test-tool.pod:55 -msgid "I<--timeout N>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:973 ../src/guestfs.pod:973 +msgid "" +"The normal use for this is to connect to a running virtual machine that " +"contains a C<guestfsd> daemon, and send commands so you can read and write " +"files inside the live virtual machine." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:977 ../src/guestfs.pod:977 +msgid "Using guestfs_add_domain with live flag" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:57 +#: ../libguestfs-1.11.19/src/guestfs.pod:979 ../src/guestfs.pod:979 msgid "" -"Set the launch timeout to C<N> seconds. The default is 120 seconds which " -"does not usually need to be adjusted unless your machine is very slow." +"L</guestfs_add_domain> provides some help for getting the correct attach " +"method. If you pass the C<live> option to this function, then (if the " +"virtual machine is running) it will examine the libvirt XML looking for a " +"virtio-serial channel to connect to:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:985 ../src/guestfs.pod:985 +#, no-wrap +msgid "" +" <domain>\n" +" ...\n" +" <devices>\n" +" ...\n" +" <channel type='unix'>\n" +" <source mode='bind' path='/path/to/socket'/>\n" +" <target type='virtio' name='org.libguestfs.channel.0'/>\n" +" </channel>\n" +" ...\n" +" </devices>\n" +" </domain>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:997 ../src/guestfs.pod:997 +msgid "" +"L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach " +"method to C<unix:/path/to/socket>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1000 ../src/guestfs.pod:1000 +msgid "" +"Some of the libguestfs tools (including guestfish) support a I<--live> " +"option which is passed through to L</guestfs_add_domain> thus allowing you " +"to attach to and modify live virtual machines." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1004 ../src/guestfs.pod:1004 +msgid "" +"The virtual machine needs to have been set up beforehand so that it has the " +"virtio-serial channel and so that guestfsd is running inside it." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1008 ../src/guestfs.pod:1008 +msgid "ABI GUARANTEE" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1010 ../src/guestfs.pod:1010 +msgid "" +"We guarantee the libguestfs ABI (binary interface), for public, high-level " +"actions as outlined in this section. Although we will deprecate some " +"actions, for example if they get replaced by newer calls, we will keep the " +"old actions forever. This allows you the developer to program in confidence " +"against the libguestfs API." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1016 ../src/guestfs.pod:1016 +msgid "BLOCK DEVICE NAMING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1018 ../src/guestfs.pod:1018 +msgid "" +"In the kernel there is now quite a profusion of schemata for naming block " +"devices (in this context, by I<block device> I mean a physical or virtual " +"hard drive). The original Linux IDE driver used names starting with " +"C</dev/hd*>. SCSI devices have historically used a different naming scheme, " +"C</dev/sd*>. When the Linux kernel I<libata> driver became a popular " +"replacement for the old IDE driver (particularly for SATA devices) those " +"devices also used the C</dev/sd*> scheme. Additionally we now have virtual " +"machines with paravirtualized drivers. This has created several different " +"naming systems, such as C</dev/vd*> for virtio disks and C</dev/xvd*> for " +"Xen PV disks." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1030 ../src/guestfs.pod:1030 +msgid "" +"As discussed above, libguestfs uses a qemu appliance running an embedded " +"Linux kernel to access block devices. We can run a variety of appliances " +"based on a variety of Linux kernels." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1034 ../src/guestfs.pod:1034 +msgid "" +"This causes a problem for libguestfs because many API calls use device or " +"partition names. Working scripts and the recipe (example) scripts that we " +"make available over the internet could fail if the naming scheme changes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1039 ../src/guestfs.pod:1039 +msgid "" +"Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. " +"Internally C</dev/sd*> names are translated, if necessary, to other names as " +"required. For example, under RHEL 5 which uses the C</dev/hd*> scheme, any " +"device parameter C</dev/sda2> is translated to C</dev/hda2> transparently." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1045 ../src/guestfs.pod:1045 +msgid "" +"Note that this I<only> applies to parameters. The L</guestfs_list_devices>, " +"L</guestfs_list_partitions> and similar calls return the true names of the " +"devices and partitions as known to the appliance." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1050 ../src/guestfs.pod:1050 +msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1052 ../src/guestfs.pod:1052 +msgid "" +"Usually this translation is transparent. However in some (very rare) cases " +"you may need to know the exact algorithm. Such cases include where you use " +"L</guestfs_config> to add a mixture of virtio and IDE devices to the " +"qemu-based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> " +"devices." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1058 ../src/guestfs.pod:1058 +msgid "" +"The algorithm is applied only to I<parameters> which are known to be either " +"device or partition names. Return values from functions such as " +"L</guestfs_list_devices> are never changed." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1066 ../src/guestfs.pod:1066 +msgid "Is the string a parameter which is a device or partition name?" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1070 ../src/guestfs.pod:1070 +msgid "Does the string begin with C</dev/sd>?" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1074 ../src/guestfs.pod:1074 +msgid "" +"Does the named device exist? If so, we use that device. However if I<not> " +"then we continue with this algorithm." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1079 ../src/guestfs.pod:1079 +msgid "Replace initial C</dev/sd> string with C</dev/hd>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1081 ../src/guestfs.pod:1081 +msgid "For example, change C</dev/sda2> to C</dev/hda2>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1083 ../src/guestfs.pod:1083 +msgid "If that named device exists, use it. If not, continue." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1087 ../src/guestfs.pod:1087 +msgid "Replace initial C</dev/sd> string with C</dev/vd>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1089 ../src/guestfs.pod:1089 +msgid "If that named device exists, use it. If not, return an error." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1093 ../src/guestfs.pod:1093 +msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1095 ../src/guestfs.pod:1095 +msgid "" +"Although the standard naming scheme and automatic translation is useful for " +"simple programs and guestfish scripts, for larger programs it is best not to " +"rely on this mechanism." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1099 ../src/guestfs.pod:1099 +msgid "" +"Where possible for maximum future portability programs using libguestfs " +"should use these future-proof techniques:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1106 ../src/guestfs.pod:1106 +msgid "" +"Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual " +"device names, and then use those names directly." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1109 ../src/guestfs.pod:1109 +msgid "Since those device names exist by definition, they will never be translated." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1114 ../src/guestfs.pod:1114 +msgid "" +"Use higher level ways to identify filesystems, such as LVM names, UUIDs and " +"filesystem labels." msgstr "" #. type: =head1 -#: ../test-tool/libguestfs-test-tool.pod:63 -msgid "TRYING OUT A DIFFERENT VERSION OF QEMU" +#: ../libguestfs-1.11.19/src/guestfs.pod:1119 ../src/guestfs.pod:1119 +msgid "SECURITY" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:65 +#: ../libguestfs-1.11.19/src/guestfs.pod:1121 ../src/guestfs.pod:1121 msgid "" -"If you have compiled another version of qemu from source and would like to " -"try that, then you can use the I<--qemudir> option to point to the qemu " -"source directory." +"This section discusses security implications of using libguestfs, " +"particularly with untrusted or malicious guests or disk images." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1124 ../src/guestfs.pod:1124 +msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:69 +#: ../libguestfs-1.11.19/src/guestfs.pod:1126 ../src/guestfs.pod:1126 msgid "" -"If you have downloaded a qemu binary from somewhere, use the I<--qemu> " -"option to point to the binary." +"Be careful with any files or data that you download from a guest (by " +"\"download\" we mean not just the L</guestfs_download> command but any " +"command that reads files, filenames, directories or anything else from a " +"disk image). An attacker could manipulate the data to fool your program " +"into doing the wrong thing. Consider cases such as:" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:72 +#: ../libguestfs-1.11.19/src/guestfs.pod:1136 ../src/guestfs.pod:1136 +msgid "the data (file etc) not being present" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1140 ../src/guestfs.pod:1140 +msgid "being present but empty" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1144 ../src/guestfs.pod:1144 +msgid "being much larger than normal" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1148 ../src/guestfs.pod:1148 +msgid "containing arbitrary 8 bit data" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1152 ../src/guestfs.pod:1152 +msgid "being in an unexpected character encoding" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1156 ../src/guestfs.pod:1156 +msgid "containing homoglyphs." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1160 ../src/guestfs.pod:1160 +msgid "SECURITY OF MOUNTING FILESYSTEMS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1162 ../src/guestfs.pod:1162 msgid "" -"When using an alternate qemu with libguestfs, usually you would need to " -"write a qemu wrapper script (see section I<QEMU WRAPPERS> in " -"L<guestfs(3)>). libguestfs-test-tool writes a temporary qemu wrapper script " -"when you use either of the I<--qemudir> or I<--qemu> options." +"When you mount a filesystem under Linux, mistakes in the kernel filesystem " +"(VFS) module can sometimes be escalated into exploits by deliberately " +"creating a malicious, malformed filesystem. These exploits are very severe " +"for two reasons. Firstly there are very many filesystem drivers in the " +"kernel, and many of them are infrequently used and not much developer " +"attention has been paid to the code. Linux userspace helps potential " +"crackers by detecting the filesystem type and automatically choosing the " +"right VFS driver, even if that filesystem type is obscure or unexpected for " +"the administrator. Secondly, a kernel-level exploit is like a local root " +"exploit (worse in some ways), giving immediate and total access to the " +"system right down to the hardware level." msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:79 +#: ../libguestfs-1.11.19/src/guestfs.pod:1175 ../src/guestfs.pod:1175 msgid "" -"libguestfs-test-tool returns I<0> if the tests completed without error, or " -"I<1> if there was an error." +"That explains why you should never mount a filesystem from an untrusted " +"guest on your host kernel. How about libguestfs? We run a Linux kernel " +"inside a qemu virtual machine, usually running as a non-root user. The " +"attacker would need to write a filesystem which first exploited the kernel, " +"and then exploited either qemu virtualization (eg. a faulty qemu driver) or " +"the libguestfs protocol, and finally to be as serious as the host kernel " +"exploit it would need to escalate its privileges to root. This multi-step " +"escalation, performed by a static piece of data, is thought to be extremely " +"hard to do, although we never say 'never' about security issues." msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:84 +#: ../libguestfs-1.11.19/src/guestfs.pod:1186 ../src/guestfs.pod:1186 msgid "" -"For the full list of environment variables which may affect libguestfs, " -"please see the L<guestfs(3)> manual page." +"In any case callers can reduce the attack surface by forcing the filesystem " +"type when mounting (use L</guestfs_mount_vfs>)." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1189 ../src/guestfs.pod:1189 +msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../test-tool/libguestfs-test-tool.pod:89 -msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>." +#: ../libguestfs-1.11.19/src/guestfs.pod:1191 ../src/guestfs.pod:1191 +msgid "" +"The protocol is designed to be secure, being based on RFC 4506 (XDR) with a " +"defined upper message size. However a program that uses libguestfs must " +"also take care - for example you can write a program that downloads a binary " +"from a disk image and executes it locally, and no amount of protocol " +"security will save you from the consequences." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1197 ../src/guestfs.pod:1197 +msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:5 -msgid "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs" +#: ../libguestfs-1.11.19/src/guestfs.pod:1199 ../src/guestfs.pod:1199 +msgid "" +"Parts of the inspection API (see L</INSPECTION>) return untrusted strings " +"directly from the guest, and these could contain any 8 bit data. Callers " +"should be careful to escape these before printing them to a structured file " +"(for example, use HTML escaping if creating a web page)." msgstr "" -#. type: verbatim -#: ../fuse/guestmount.pod:9 -#, no-wrap +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1205 ../src/guestfs.pod:1205 msgid "" -" guestmount [--options] -a disk.img -m device [--ro] mountpoint\n" -"\n" +"Guest configuration may be altered in unusual ways by the administrator of " +"the virtual machine, and may not reflect reality (particularly for untrusted " +"or actively malicious guests). For example we parse the hostname from " +"configuration files like C</etc/sysconfig/network> that we find in the " +"guest, but the guest administrator can easily manipulate these files to " +"provide the wrong hostname." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1213 ../src/guestfs.pod:1213 +msgid "" +"The inspection API parses guest configuration using two external libraries: " +"Augeas (Linux configuration) and hivex (Windows Registry). Both are " +"designed to be robust in the face of malicious data, although denial of " +"service attacks are still possible, for example with oversized configuration " +"files." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1219 ../src/guestfs.pod:1219 +msgid "RUNNING UNTRUSTED GUEST COMMANDS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1221 ../src/guestfs.pod:1221 +msgid "" +"Be very cautious about running commands from the guest. By running a " +"command in the guest, you are giving CPU time to a binary that you do not " +"control, under the same user account as the library, albeit wrapped in qemu " +"virtualization. More information and alternatives can be found in the " +"section L</RUNNING COMMANDS>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1227 ../src/guestfs.pod:1227 +msgid "CVE-2010-3851" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1229 ../src/guestfs.pod:1229 +msgid "https://bugzilla.redhat.com/642934" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1231 ../src/guestfs.pod:1231 +msgid "" +"This security bug concerns the automatic disk format detection that qemu " +"does on disk images." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1234 ../src/guestfs.pod:1234 +msgid "" +"A raw disk image is just the raw bytes, there is no header. Other disk " +"images like qcow2 contain a special header. Qemu deals with this by looking " +"for one of the known headers, and if none is found then assuming the disk " +"image must be raw." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1239 ../src/guestfs.pod:1239 +msgid "" +"This allows a guest which has been given a raw disk image to write some " +"other header. At next boot (or when the disk image is accessed by " +"libguestfs) qemu would do autodetection and think the disk image format was, " +"say, qcow2 based on the header written by the guest." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1244 ../src/guestfs.pod:1244 +msgid "" +"This in itself would not be a problem, but qcow2 offers many features, one " +"of which is to allow a disk image to refer to another image (called the " +"\"backing disk\"). It does this by placing the path to the backing disk " +"into the qcow2 header. This path is not validated and could point to any " +"host file (eg. \"/etc/passwd\"). The backing disk is then exposed through " +"\"holes\" in the qcow2 disk image, which of course is completely under the " +"control of the attacker." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1252 ../src/guestfs.pod:1252 +msgid "In libguestfs this is rather hard to exploit except under two circumstances:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1259 ../src/guestfs.pod:1259 +msgid "You have enabled the network or have opened the disk in write mode." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1263 ../src/guestfs.pod:1263 +msgid "" +"You are also running untrusted code from the guest (see L</RUNNING " +"COMMANDS>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1268 ../src/guestfs.pod:1268 +msgid "" +"The way to avoid this is to specify the expected disk format when adding " +"disks (the optional C<format> option to L</guestfs_add_drive_opts>). You " +"should always do this if the disk is raw format, and it's a good idea for " +"other cases too." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1273 ../src/guestfs.pod:1273 +msgid "" +"For disks added from libvirt using calls like L</guestfs_add_domain>, the " +"format is fetched from libvirt and passed through." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1276 ../src/guestfs.pod:1276 +msgid "" +"For libguestfs tools, use the I<--format> command line parameter as " +"appropriate." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1279 ../src/guestfs.pod:1279 +msgid "CONNECTION MANAGEMENT" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1281 ../src/guestfs.pod:1281 +msgid "guestfs_h *" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1283 ../src/guestfs.pod:1283 +msgid "" +"C<guestfs_h> is the opaque type representing a connection handle. Create a " +"handle by calling L</guestfs_create>. Call L</guestfs_close> to free the " +"handle and release all resources used." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1287 ../src/guestfs.pod:1287 +msgid "" +"For information on using multiple handles and threads, see the section " +"L</MULTIPLE HANDLES AND MULTIPLE THREADS> above." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1290 ../src/guestfs.pod:1290 +msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:11 +#: ../libguestfs-1.11.19/src/guestfs.pod:1292 ../src/guestfs.pod:1292 #, no-wrap msgid "" -" guestmount [--options] -a disk.img -i [--ro] mountpoint\n" +" guestfs_h *guestfs_create (void);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1294 ../src/guestfs.pod:1294 +msgid "Create a connection handle." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1296 ../src/guestfs.pod:1296 +msgid "" +"On success this returns a non-NULL pointer to a handle. On error it returns " +"NULL." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1299 ../src/guestfs.pod:1299 +msgid "" +"You have to \"configure\" the handle after creating it. This includes " +"calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the " +"handle at least once." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1303 ../src/guestfs.pod:1303 +msgid "After configuring the handle, you have to call L</guestfs_launch>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1305 ../src/guestfs.pod:1305 +msgid "" +"You may also want to configure error handling for the handle. See the " +"L</ERROR HANDLING> section below." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1308 ../src/guestfs.pod:1308 +msgid "guestfs_close" +msgstr "" + #. type: verbatim -#: ../fuse/guestmount.pod:13 +#: ../libguestfs-1.11.19/src/guestfs.pod:1310 ../src/guestfs.pod:1310 #, no-wrap msgid "" -" guestmount [--options] -d Guest -i [--ro] mountpoint\n" +" void guestfs_close (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:17 +#: ../libguestfs-1.11.19/src/guestfs.pod:1312 ../src/guestfs.pod:1312 +msgid "This closes the connection handle and frees up all resources used." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1314 ../src/guestfs.pod:1314 msgid "" -"You must I<not> use C<guestmount> in read-write mode on live virtual " -"machines. If you do this, you risk disk corruption in the VM." +"If autosync was set on the handle and the handle was launched, then this " +"implicitly calls various functions to unmount filesystems and sync the " +"disk. See L</guestfs_set_autosync> for more details." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1318 ../src/guestfs.pod:1318 +msgid "If a close callback was set on the handle, then it is called." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1320 ../src/guestfs.pod:1320 +msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:22 +#: ../libguestfs-1.11.19/src/guestfs.pod:1322 ../src/guestfs.pod:1322 msgid "" -"The guestmount program can be used to mount virtual machine filesystems and " -"other disk images on the host. It uses libguestfs for access to the guest " -"filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as " -"a mountable device." +"API functions can return errors. For example, almost all functions that " +"return C<int> will return C<-1> to indicate an error." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:27 +#: ../libguestfs-1.11.19/src/guestfs.pod:1325 ../src/guestfs.pod:1325 msgid "" -"Along with other options, you have to give at least one device (I<-a> " -"option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> " -"option) or use the I<-i> inspection option. How this works is better " -"explained in the L<guestfish(1)> manual page, or by looking at the examples " -"below." +"Additional information is available for errors: an error message string and " +"optionally an error number (errno) if the thing that failed was a system " +"call." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:33 +#: ../libguestfs-1.11.19/src/guestfs.pod:1329 ../src/guestfs.pod:1329 msgid "" -"FUSE lets you mount filesystems as non-root. The mountpoint must be owned " -"by you, and the filesystem will not be visible to any other users unless you " -"make certain global configuration changes to C</etc/fuse.conf>. To unmount " -"the filesystem, use the C<fusermount -u> command." +"You can get at the additional information about the last error on the handle " +"by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting " +"up an error handler with L</guestfs_set_error_handler>." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:41 +#: ../libguestfs-1.11.19/src/guestfs.pod:1334 ../src/guestfs.pod:1334 msgid "" -"For a typical Windows guest which has its main filesystem on the first " -"partition:" +"When the handle is created, a default error handler is installed which " +"prints the error message string to C<stderr>. For small short-running " +"command line programs it is sufficient to do:" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:44 +#: ../libguestfs-1.11.19/src/guestfs.pod:1338 ../src/guestfs.pod:1338 #, no-wrap msgid "" -" guestmount -a windows.img -m /dev/sda1 --ro /mnt\n" +" if (guestfs_launch (g) == -1)\n" +" exit (EXIT_FAILURE);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:46 +#: ../libguestfs-1.11.19/src/guestfs.pod:1341 ../src/guestfs.pod:1341 msgid "" -"For a typical Linux guest which has a /boot filesystem on the first " -"partition, and the root filesystem on a logical volume:" +"since the default error handler will ensure that an error message has been " +"printed to C<stderr> before the program exits." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1344 ../src/guestfs.pod:1344 +msgid "" +"For other programs the caller will almost certainly want to install an " +"alternate error handler or do error handling in-line like this:" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:49 +#: ../libguestfs-1.11.19/src/guestfs.pod:1347 ../src/guestfs.pod:1347 #, no-wrap msgid "" -" guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n" +" g = guestfs_create ();\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1349 ../src/guestfs.pod:1349 +#, no-wrap +msgid "" +" /* This disables the default behaviour of printing errors\n" +" on stderr. */\n" +" guestfs_set_error_handler (g, NULL, NULL);\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1353 ../src/guestfs.pod:1353 +#, no-wrap +msgid "" +" if (guestfs_launch (g) == -1) {\n" +" /* Examine the error message and print it etc. */\n" +" char *msg = guestfs_last_error (g);\n" +" int errnum = guestfs_last_errno (g);\n" +" fprintf (stderr, \"%s\\n\", msg);\n" +" /* ... */\n" +" }\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:51 -msgid "To get libguestfs to detect guest mountpoints for you:" +#: ../libguestfs-1.11.19/src/guestfs.pod:1361 ../src/guestfs.pod:1361 +msgid "" +"Out of memory errors are handled differently. The default action is to call " +"L<abort(3)>. If this is undesirable, then you can set a handler using " +"L</guestfs_set_out_of_memory_handler>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1365 ../src/guestfs.pod:1365 +msgid "" +"L</guestfs_create> returns C<NULL> if the handle cannot be created, and " +"because there is no handle if this happens there is no way to get additional " +"error information. However L</guestfs_create> is supposed to be a " +"lightweight operation which can only fail because of insufficient memory (it " +"returns NULL in this case)." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1371 ../src/guestfs.pod:1371 +msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:53 +#: ../libguestfs-1.11.19/src/guestfs.pod:1373 ../src/guestfs.pod:1373 #, no-wrap msgid "" -" guestmount -a guest.img -i --ro /mnt\n" +" const char *guestfs_last_error (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:55 -msgid "For a libvirt guest called \"Guest\" you could do:" +#: ../libguestfs-1.11.19/src/guestfs.pod:1375 ../src/guestfs.pod:1375 +msgid "" +"This returns the last error message that happened on C<g>. If there has not " +"been an error since the handle was created, then this returns C<NULL>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1379 ../src/guestfs.pod:1379 +msgid "" +"The lifetime of the returned string is until the next error occurs, or " +"L</guestfs_close> is called." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1382 ../src/guestfs.pod:1382 +msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:57 +#: ../libguestfs-1.11.19/src/guestfs.pod:1384 ../src/guestfs.pod:1384 #, no-wrap msgid "" -" guestmount -d Guest -i --ro /mnt\n" +" int guestfs_last_errno (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:59 +#: ../libguestfs-1.11.19/src/guestfs.pod:1386 ../src/guestfs.pod:1386 +msgid "This returns the last error number (errno) that happened on C<g>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1388 ../src/guestfs.pod:1388 +msgid "If successful, an errno integer not equal to zero is returned." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1390 ../src/guestfs.pod:1390 +msgid "If no error, this returns 0. This call can return 0 in three situations:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1397 ../src/guestfs.pod:1397 +msgid "There has not been any error on the handle." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1401 ../src/guestfs.pod:1401 msgid "" -"If you don't know what filesystems are contained in a guest or disk image, " -"use L<virt-filesystems(1)> first:" +"There has been an error but the errno was meaningless. This corresponds to " +"the case where the error did not come from a failed system call, but for " +"some other reason." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1407 ../src/guestfs.pod:1407 +msgid "" +"There was an error from a failed system call, but for some reason the errno " +"was not captured and returned. This usually indicates a bug in libguestfs." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1413 ../src/guestfs.pod:1413 +msgid "" +"Libguestfs tries to convert the errno from inside the applicance into a " +"corresponding errno for the caller (not entirely trivial: the appliance " +"might be running a completely different operating system from the library " +"and error numbers are not standardized across Un*xen). If this could not be " +"done, then the error is translated to C<EINVAL>. In practice this should " +"only happen in very rare circumstances." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1421 ../src/guestfs.pod:1421 +msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:62 +#: ../libguestfs-1.11.19/src/guestfs.pod:1423 ../src/guestfs.pod:1423 #, no-wrap msgid "" -" virt-filesystems MyGuest\n" +" typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" +" void *opaque,\n" +" const char *msg);\n" +" void guestfs_set_error_handler (guestfs_h *g,\n" +" guestfs_error_handler_cb cb,\n" +" void *opaque);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:64 +#: ../libguestfs-1.11.19/src/guestfs.pod:1430 ../src/guestfs.pod:1430 msgid "" -"If you want to trace the libguestfs calls but without excessive debugging " -"information, we recommend:" +"The callback C<cb> will be called if there is an error. The parameters " +"passed to the callback are an opaque data pointer and the error message " +"string." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1434 ../src/guestfs.pod:1434 +msgid "" +"C<errno> is not passed to the callback. To get that the callback must call " +"L</guestfs_last_errno>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1437 ../src/guestfs.pod:1437 +msgid "" +"Note that the message string C<msg> is freed as soon as the callback " +"function returns, so if you want to stash it somewhere you must make your " +"own copy." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1441 ../src/guestfs.pod:1441 +msgid "The default handler prints messages on C<stderr>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1443 ../src/guestfs.pod:1443 +msgid "If you set C<cb> to C<NULL> then I<no> handler is called." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1445 ../src/guestfs.pod:1445 +msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:67 +#: ../libguestfs-1.11.19/src/guestfs.pod:1447 ../src/guestfs.pod:1447 #, no-wrap msgid "" -" guestmount [...] --trace /mnt\n" +" guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" +" void **opaque_rtn);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:69 -msgid "If you want to debug the program, we recommend:" +#: ../libguestfs-1.11.19/src/guestfs.pod:1450 ../src/guestfs.pod:1450 +msgid "Returns the current error handler callback." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1452 ../src/guestfs.pod:1452 +msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:71 +#: ../libguestfs-1.11.19/src/guestfs.pod:1454 ../src/guestfs.pod:1454 #, no-wrap msgid "" -" guestmount [...] --trace --verbose /mnt\n" +" typedef void (*guestfs_abort_cb) (void);\n" +" int guestfs_set_out_of_memory_handler (guestfs_h *g,\n" +" guestfs_abort_cb);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1458 ../src/guestfs.pod:1458 +msgid "" +"The callback C<cb> will be called if there is an out of memory situation. " +"I<Note this callback must not return>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1461 ../src/guestfs.pod:1461 +msgid "The default is to call L<abort(3)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1463 ../src/guestfs.pod:1463 +msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1466 ../src/guestfs.pod:1466 +msgid "guestfs_get_out_of_memory_handler" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1468 ../src/guestfs.pod:1468 +#, no-wrap +msgid "" +" guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1470 ../src/guestfs.pod:1470 +msgid "This returns the current out of memory handler." +msgstr "" + #. type: =head1 -#: ../fuse/guestmount.pod:73 -msgid "NOTES" +#: ../libguestfs-1.11.19/src/guestfs.pod:1472 ../src/guestfs.pod:1472 +msgid "API CALLS" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1476 ../src/guestfs.pod:1476 +msgid "STRUCTURES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1478 ../src/guestfs.pod:1478 +msgid "@STRUCTS@" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1480 ../src/guestfs.pod:1480 +msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../fuse/guestmount.pod:75 -msgid "Other users cannot see the filesystem by default" +#: ../libguestfs-1.11.19/src/guestfs.pod:1482 ../src/guestfs.pod:1482 +msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:77 +#: ../libguestfs-1.11.19/src/guestfs.pod:1484 ../src/guestfs.pod:1484 msgid "" -"If you mount a filesystem as one user (eg. root), then other users will not " -"be able to see it by default. The fix is to add the FUSE C<allow_other> " -"option when mounting:" +"Using L</guestfs_available> you can test availability of the following " +"groups of functions. This test queries the appliance to see if the " +"appliance you are currently using supports the functionality." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1489 ../src/guestfs.pod:1489 +msgid "@AVAILABILITY@" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1491 ../src/guestfs.pod:1491 +msgid "GUESTFISH supported COMMAND" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1493 ../src/guestfs.pod:1493 +msgid "" +"In L<guestfish(3)> there is a handy interactive command C<supported> which " +"prints out the available groups and whether they are supported by this build " +"of libguestfs. Note however that you have to do C<run> first." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1498 ../src/guestfs.pod:1498 +msgid "SINGLE CALLS AT COMPILE TIME" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1500 ../src/guestfs.pod:1500 +msgid "" +"Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API " +"function, such as:" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:81 +#: ../libguestfs-1.11.19/src/guestfs.pod:1503 ../src/guestfs.pod:1503 #, no-wrap msgid "" -" sudo guestmount [...] -o allow_other /mnt\n" +" #define LIBGUESTFS_HAVE_DD 1\n" "\n" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:87 -msgid "B<-a image> | B<--add image>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1505 ../src/guestfs.pod:1505 +msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:89 -msgid "Add a block device or virtual machine image." +#: ../libguestfs-1.11.19/src/guestfs.pod:1507 ../src/guestfs.pod:1507 +msgid "" +"Before version 1.5.8, if you needed to test whether a single libguestfs " +"function is available at compile time, we recommended using build tools such " +"as autoconf or cmake. For example in autotools you could use:" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:94 -msgid "B<-c URI> | B<--connect URI>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1512 ../src/guestfs.pod:1512 +#, no-wrap +msgid "" +" AC_CHECK_LIB([guestfs],[guestfs_create])\n" +" AC_CHECK_FUNCS([guestfs_dd])\n" +"\n" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:100 -msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1515 ../src/guestfs.pod:1515 +msgid "" +"which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " +"in your program." msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:108 -msgid "B<--dir-cache-timeout N>" +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1518 ../src/guestfs.pod:1518 +msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:110 +#: ../libguestfs-1.11.19/src/guestfs.pod:1520 ../src/guestfs.pod:1520 msgid "" -"Set the readdir cache timeout to I<N> seconds, the default being 60 " -"seconds. The readdir cache [actually, there are several semi-independent " -"caches] is populated after a readdir(2) call with the stat and extended " -"attributes of the files in the directory, in anticipation that they will be " -"requested soon after." +"Testing at compile time doesn't guarantee that a function really exists in " +"the library. The reason is that you might be dynamically linked against a " +"previous I<libguestfs.so> (dynamic library) which doesn't have the call. " +"This situation unfortunately results in a segmentation fault, which is a " +"shortcoming of the C dynamic linking system itself." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:116 +#: ../libguestfs-1.11.19/src/guestfs.pod:1527 ../src/guestfs.pod:1527 msgid "" -"There is also a different attribute cache implemented by FUSE (see the FUSE " -"option I<-o attr_timeout>), but the FUSE cache does not anticipate future " -"requests, only cache existing ones." +"You can use L<dlopen(3)> to test if a function is available at run time, as " +"in this example program (note that you still need the compile time check as " +"well):" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:127 -msgid "B<--format=raw|qcow2|..> | B<--format>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1531 ../src/guestfs.pod:1531 +#, no-wrap +msgid "" +" #include <stdio.h>\n" +" #include <stdlib.h>\n" +" #include <unistd.h>\n" +" #include <dlfcn.h>\n" +" #include <guestfs.h>\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1537 ../src/guestfs.pod:1537 +#, no-wrap +msgid "" +" main ()\n" +" {\n" +" #ifdef LIBGUESTFS_HAVE_DD\n" +" void *dl;\n" +" int has_function;\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1543 ../src/guestfs.pod:1543 +#, no-wrap +msgid "" +" /* Test if the function guestfs_dd is really available. */\n" +" dl = dlopen (NULL, RTLD_LAZY);\n" +" if (!dl) {\n" +" fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n" +" exit (EXIT_FAILURE);\n" +" }\n" +" has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n" +" dlclose (dl);\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1552 ../src/guestfs.pod:1552 +#, no-wrap +msgid "" +" if (!has_function)\n" +" printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n" +" else {\n" +" printf (\"this libguestfs.so has guestfs_dd function\\n\");\n" +" /* Now it's safe to call\n" +" guestfs_dd (g, \"foo\", \"bar\");\n" +" */\n" +" }\n" +" #else\n" +" printf (\"guestfs_dd function was not found at compile time\\n\");\n" +" #endif\n" +" }\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:134 +#: ../libguestfs-1.11.19/src/guestfs.pod:1565 ../src/guestfs.pod:1565 msgid "" -"If you have untrusted raw-format guest disk images, you should use this " -"option to specify the disk format. This avoids a possible security problem " -"with malicious guests (CVE-2010-3851). See also " -"L<guestfs(3)/guestfs_add_drive_opts>." +"You may think the above is an awful lot of hassle, and it is. There are " +"other ways outside of the C linking system to ensure that this kind of " +"incompatibility never arises, such as using package versioning:" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:139 -msgid "B<--fuse-help>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1570 ../src/guestfs.pod:1570 +#, no-wrap +msgid "" +" Requires: libguestfs >= 1.0.80\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1572 ../src/guestfs.pod:1572 +msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:141 -msgid "Display help on special FUSE options (see I<-o> below)." +#: ../libguestfs-1.11.19/src/guestfs.pod:1574 ../src/guestfs.pod:1574 +msgid "" +"A recent feature of the API is the introduction of calls which take optional " +"arguments. In C these are declared 3 ways. The main way is as a call which " +"takes variable arguments (ie. C<...>), as in this example:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1579 ../src/guestfs.pod:1579 +#, no-wrap +msgid "" +" int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:145 -msgid "Display brief help and exit." +#: ../libguestfs-1.11.19/src/guestfs.pod:1581 ../src/guestfs.pod:1581 +msgid "" +"Call this with a list of optional arguments, terminated by C<-1>. So to " +"call with no optional arguments specified:" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:147 -msgid "B<-i> | B<--inspector>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1584 ../src/guestfs.pod:1584 +#, no-wrap +msgid "" +" guestfs_add_drive_opts (g, filename, -1);\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:167 +#: ../libguestfs-1.11.19/src/guestfs.pod:1586 ../src/guestfs.pod:1586 +msgid "With a single optional argument:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1588 ../src/guestfs.pod:1588 +#, no-wrap msgid "" -"Mount the named partition or logical volume on the given mountpoint B<in the " -"guest> (this has nothing to do with mountpoints in the host)." +" guestfs_add_drive_opts (g, filename,\n" +" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n" +" -1);\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:170 +#: ../libguestfs-1.11.19/src/guestfs.pod:1592 ../src/guestfs.pod:1592 +msgid "With two:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1594 ../src/guestfs.pod:1594 +#, no-wrap msgid "" -"If the mountpoint is omitted, it defaults to C</>. You have to mount " -"something on C</>." +" guestfs_add_drive_opts (g, filename,\n" +" GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n" +" GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n" +" -1);\n" +"\n" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:183 -msgid "B<-n> | B<--no-sync>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1599 ../src/guestfs.pod:1599 +msgid "" +"and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " +"happen!" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1602 ../src/guestfs.pod:1602 +msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:185 +#: ../libguestfs-1.11.19/src/guestfs.pod:1604 ../src/guestfs.pod:1604 msgid "" -"By default, we attempt to sync the guest disk when the FUSE mountpoint is " -"unmounted. If you specify this option, then we don't attempt to sync the " -"disk. See the discussion of autosync in the L<guestfs(3)> manpage." +"The second variant has the same name with the suffix C<_va>, which works the " +"same way but takes a C<va_list>. See the C manual for details. For the " +"example function, this is declared:" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:190 -msgid "B<-o option> | B<--option option>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1608 ../src/guestfs.pod:1608 +#, no-wrap +msgid "" +" int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1611 ../src/guestfs.pod:1611 +msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:192 -msgid "Pass extra options to FUSE." +#: ../libguestfs-1.11.19/src/guestfs.pod:1613 ../src/guestfs.pod:1613 +msgid "" +"The third variant is useful where you need to construct these calls. You " +"pass in a structure where you fill in the optional fields. The structure " +"has a bitmask as the first element which you must set to indicate which " +"fields you have filled in. For our example function the structure and call " +"are declared:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1619 ../src/guestfs.pod:1619 +#, no-wrap +msgid "" +" struct guestfs_add_drive_opts_argv {\n" +" uint64_t bitmask;\n" +" int readonly;\n" +" const char *format;\n" +" /* ... */\n" +" };\n" +" int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n" +" const struct guestfs_add_drive_opts_argv *optargs);\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:194 +#: ../libguestfs-1.11.19/src/guestfs.pod:1628 ../src/guestfs.pod:1628 +msgid "You could call it like this:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1630 ../src/guestfs.pod:1630 +#, no-wrap msgid "" -"To get a list of all the extra options supported by FUSE, use the command " -"below. Note that only the FUSE I<-o> options can be passed, and only some " -"of them are a good idea." +" struct guestfs_add_drive_opts_argv optargs = {\n" +" .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n" +" GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n" +" .readonly = 1,\n" +" .format = \"qcow2\"\n" +" };\n" +" \n" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:198 +#: ../libguestfs-1.11.19/src/guestfs.pod:1637 ../src/guestfs.pod:1637 #, no-wrap msgid "" -" guestmount --fuse-help\n" +" guestfs_add_drive_opts_argv (g, filename, &optargs);\n" "\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:200 -msgid "Some potentially useful FUSE options:" +#: ../libguestfs-1.11.19/src/guestfs.pod:1645 ../src/guestfs.pod:1645 +msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:204 -msgid "B<-o allow_other>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1650 ../src/guestfs.pod:1650 +msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:206 -msgid "Allow other users to see the filesystem." +#: ../libguestfs-1.11.19/src/guestfs.pod:1654 ../src/guestfs.pod:1654 +msgid "" +"There must be a one-to-one correspondence between fields of the structure " +"that are filled in, and bits set in the bitmask." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1659 ../src/guestfs.pod:1659 +msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1661 ../src/guestfs.pod:1661 +msgid "" +"In other languages, optional arguments are expressed in the way that is " +"natural for that language. We refer you to the language-specific " +"documentation for more details on that." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1665 ../src/guestfs.pod:1665 +msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1667 ../src/guestfs.pod:1667 +msgid "SETTING CALLBACKS TO HANDLE EVENTS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1669 ../src/guestfs.pod:1669 +msgid "" +"B<Note:> This section documents the generic event mechanism introduced in " +"libguestfs 1.10, which you should use in new code if possible. The old " +"functions C<guestfs_set_log_message_callback>, " +"C<guestfs_set_subprocess_quit_callback>, " +"C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and " +"C<guestfs_set_progress_callback> are no longer documented in this manual " +"page. Because of the ABI guarantee, the old functions continue to work." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1678 ../src/guestfs.pod:1678 +msgid "" +"Handles generate events when certain things happen, such as log messages " +"being generated, progress messages during long-running operations, or the " +"handle being closed. The API calls described below let you register a " +"callback to be called when events happen. You can register multiple " +"callbacks (for the same, different or overlapping sets of events), and " +"individually remove callbacks. If callbacks are not removed, then they " +"remain in force until the handle is closed." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1686 ../src/guestfs.pod:1686 +msgid "" +"In the current implementation, events are only generated synchronously: that " +"means that events (and hence callbacks) can only happen while you are in the " +"middle of making another libguestfs call. The callback is called in the " +"same thread." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1691 ../src/guestfs.pod:1691 +msgid "" +"Events may contain a payload, usually nothing (void), an array of 64 bit " +"unsigned integers, or a message buffer. Payloads are discussed later on." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1695 ../src/guestfs.pod:1695 +msgid "CLASSES OF EVENTS" msgstr "" #. type: =item -#: ../fuse/guestmount.pod:208 -msgid "B<-o attr_timeout=N>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1699 ../src/guestfs.pod:1699 +msgid "GUESTFS_EVENT_CLOSE (payload type: void)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:210 -msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds." +#: ../libguestfs-1.11.19/src/guestfs.pod:1702 ../src/guestfs.pod:1702 +msgid "" +"The callback function will be called while the handle is being closed " +"(synchronously from L</guestfs_close>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1705 ../src/guestfs.pod:1705 +msgid "" +"Note that libguestfs installs an L<atexit(3)> handler to try to clean up " +"handles that are open when the program exits. This means that this callback " +"might be called indirectly from L<exit(3)>, which can cause unexpected " +"problems in higher-level languages (eg. if your HLL interpreter has already " +"been cleaned up by the time this is called, and if your callback then jumps " +"into some HLL function)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1712 ../src/guestfs.pod:1712 +msgid "" +"If no callback is registered: the handle is closed without any callback " +"being invoked." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:212 -msgid "B<-o kernel_cache>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1715 ../src/guestfs.pod:1715 +msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:214 +#: ../libguestfs-1.11.19/src/guestfs.pod:1718 ../src/guestfs.pod:1718 msgid "" -"Allow the kernel to cache files (reduces the number of reads that have to go " -"through the L<guestfs(3)> API). This is generally a good idea if you can " -"afford the extra memory usage." +"The callback function will be called when the child process quits, either " +"asynchronously or if killed by L</guestfs_kill_subprocess>. (This " +"corresponds to a transition from any state to the CONFIG state)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1722 ../libguestfs-1.11.19/src/guestfs.pod:1731 ../src/guestfs.pod:1722 ../src/guestfs.pod:1731 +msgid "If no callback is registered: the event is ignored." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:218 -msgid "B<-o uid=N> B<-o gid=N>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1724 ../src/guestfs.pod:1724 +msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:220 +#: ../libguestfs-1.11.19/src/guestfs.pod:1727 ../src/guestfs.pod:1727 msgid "" -"Use these options to map all UIDs and GIDs inside the guest filesystem to " -"the chosen values." +"The callback function will be called when the child process becomes ready " +"first time after it has been launched. (This corresponds to a transition " +"from LAUNCHING to the READY state)." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:225 -msgid "B<-r> | B<--ro>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1733 ../src/guestfs.pod:1733 +msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:227 +#: ../libguestfs-1.11.19/src/guestfs.pod:1736 ../src/guestfs.pod:1736 msgid "" -"Add devices and mount everything read-only. Also disallow writes and make " -"the disk appear read-only to FUSE." +"Some long-running operations can generate progress messages. If this " +"callback is registered, then it will be called each time a progress message " +"is generated (usually two seconds after the operation started, and three " +"times per second thereafter until it completes, although the frequency may " +"change in future versions)." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:230 +#: ../libguestfs-1.11.19/src/guestfs.pod:1742 ../src/guestfs.pod:1742 msgid "" -"This is highly recommended if you are not going to edit the guest disk. If " -"the guest is running and this option is I<not> supplied, then there is a " -"strong risk of disk corruption in the guest. We try to prevent this from " -"happening, but it is not always possible." +"The callback receives in the payload four unsigned 64 bit numbers which are " +"(in order): C<proc_nr>, C<serial>, C<position>, C<total>." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:235 -msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>." +#: ../libguestfs-1.11.19/src/guestfs.pod:1745 ../src/guestfs.pod:1745 +msgid "" +"The units of C<total> are not defined, although for some operations C<total> " +"may relate in some way to the amount of data to be transferred (eg. in bytes " +"or megabytes), and C<position> may be the portion which has been " +"transferred." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:239 -msgid "Enable SELinux support for the guest." +#: ../libguestfs-1.11.19/src/guestfs.pod:1750 ../src/guestfs.pod:1750 +msgid "The only defined and stable parts of the API are:" msgstr "" -#. type: =item -#: ../fuse/guestmount.pod:241 -msgid "B<-v> | B<--verbose>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1756 ../src/guestfs.pod:1756 +msgid "" +"The callback can display to the user some type of progress bar or indicator " +"which shows the ratio of C<position>:C<total>." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:243 -msgid "Enable verbose messages from underlying libguestfs." +#: ../libguestfs-1.11.19/src/guestfs.pod:1761 ../src/guestfs.pod:1761 +msgid "0 E<lt>= C<position> E<lt>= C<total>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1765 ../src/guestfs.pod:1765 +msgid "" +"If any progress notification is sent during a call, then a final progress " +"notification is always sent when C<position> = C<total> (I<unless> the call " +"fails with an error)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1769 ../src/guestfs.pod:1769 +msgid "" +"This is to simplify caller code, so callers can easily set the progress " +"indicator to \"100%\" at the end of the operation, without requiring special " +"code to detect this case." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1775 ../src/guestfs.pod:1775 +msgid "" +"For some calls we are unable to estimate the progress of the call, but we " +"can still generate progress messages to indicate activity. This is known as " +"\"pulse mode\", and is directly supported by certain progress bar " +"implementations (eg. GtkProgressBar)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1780 ../src/guestfs.pod:1780 +msgid "" +"For these calls, zero or more progress messages are generated with " +"C<position = 0> and C<total = 1>, followed by a final message with " +"C<position = total = 1>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1784 ../src/guestfs.pod:1784 +msgid "" +"As noted above, if the call fails with an error then the final message may " +"not be generated." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1789 ../src/guestfs.pod:1789 +msgid "" +"The callback also receives the procedure number (C<proc_nr>) and serial " +"number (C<serial>) of the call. These are only useful for debugging " +"protocol issues, and the callback can normally ignore them. The callback " +"may want to print these numbers in error messages or debugging messages." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1795 ../src/guestfs.pod:1795 +msgid "If no callback is registered: progress messages are discarded." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:245 -msgid "B<-V> | B<--version>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1797 ../src/guestfs.pod:1797 +msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:247 -msgid "Display the program version and exit." +#: ../libguestfs-1.11.19/src/guestfs.pod:1800 ../src/guestfs.pod:1800 +msgid "" +"The callback function is called whenever a log message is generated by qemu, " +"the appliance kernel, guestfsd (daemon), or utility programs." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1803 ../src/guestfs.pod:1803 +msgid "" +"If the verbose flag (L</guestfs_set_verbose>) is set before launch " +"(L</guestfs_launch>) then additional debug messages are generated." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1806 ../libguestfs-1.11.19/src/guestfs.pod:1820 ../src/guestfs.pod:1806 ../src/guestfs.pod:1820 +msgid "" +"If no callback is registered: the messages are discarded unless the verbose " +"flag is set in which case they are sent to stderr. You can override the " +"printing of verbose messages to stderr by setting up a callback." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:249 -msgid "B<-w> | B<--rw>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1811 ../src/guestfs.pod:1811 +msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:254 ../fuse/guestmount.pod:275 -msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>." +#: ../libguestfs-1.11.19/src/guestfs.pod:1814 ../src/guestfs.pod:1814 +msgid "" +"The callback function is called whenever a log message is generated by the " +"library part of libguestfs." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1817 ../src/guestfs.pod:1817 +msgid "" +"If the verbose flag (L</guestfs_set_verbose>) is set then additional debug " +"messages are generated." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:256 -msgid "B<-x> | B<--trace>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1825 ../src/guestfs.pod:1825 +msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:258 -msgid "Trace libguestfs calls and entry into each FUSE function." +#: ../libguestfs-1.11.19/src/guestfs.pod:1828 ../src/guestfs.pod:1828 +msgid "" +"The callback function is called whenever a trace message is generated. This " +"only applies if the trace flag (L</guestfs_set_trace>) is set." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:260 -msgid "This also stops the daemon from forking into the background." +#: ../libguestfs-1.11.19/src/guestfs.pod:1831 ../src/guestfs.pod:1831 +msgid "" +"If no callback is registered: the messages are sent to stderr. You can " +"override the printing of trace messages to stderr by setting up a callback." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1837 ../src/guestfs.pod:1837 +msgid "guestfs_set_event_callback" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:1839 ../src/guestfs.pod:1839 +#, no-wrap +msgid "" +" int guestfs_set_event_callback (guestfs_h *g,\n" +" guestfs_event_callback cb,\n" +" uint64_t event_bitmask,\n" +" int flags,\n" +" void *opaque);\n" +"\n" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:281 +#: ../libguestfs-1.11.19/src/guestfs.pod:1845 ../src/guestfs.pod:1845 msgid "" -"L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " -"L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, " -"L<http://fuse.sf.net/>." +"This function registers a callback (C<cb>) for all event classes in the " +"C<event_bitmask>." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:296 -msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>" +#: ../libguestfs-1.11.19/src/guestfs.pod:1848 ../src/guestfs.pod:1848 +msgid "" +"For example, to register for all log message events, you could call this " +"function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>. " +"To register a single callback for all possible classes of events, use " +"C<GUESTFS_EVENT_ALL>." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:37 +#: ../libguestfs-1.11.19/src/guestfs.pod:1854 ../src/guestfs.pod:1854 +msgid "C<flags> should always be passed as 0." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1856 ../src/guestfs.pod:1856 msgid "" -"virt-win-reg - Export and merge Windows Registry entries from a Windows " -"guest" +"C<opaque> is an opaque pointer which is passed to the callback. You can use " +"it for any purpose." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1859 ../src/guestfs.pod:1859 +msgid "" +"The return value is the event handle (an integer) which you can use to " +"delete the callback (see below)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1862 ../src/guestfs.pod:1862 +msgid "" +"If there is an error, this function returns C<-1>, and sets the error in the " +"handle in the usual way (see L</guestfs_last_error> etc.)" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1865 ../src/guestfs.pod:1865 +msgid "" +"Callbacks remain in effect until they are deleted, or until the handle is " +"closed." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1868 ../src/guestfs.pod:1868 +msgid "" +"In the case where multiple callbacks are registered for a particular event " +"class, all of the callbacks are called. The order in which multiple " +"callbacks are called is not defined." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1872 ../src/guestfs.pod:1872 +msgid "guestfs_delete_event_callback" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:41 +#: ../libguestfs-1.11.19/src/guestfs.pod:1874 ../src/guestfs.pod:1874 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" +" void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1876 ../src/guestfs.pod:1876 +msgid "" +"Delete a callback that was previously registered. C<event_handle> should be " +"the integer that was returned by a previous call to " +"C<guestfs_set_event_callback> on the same handle." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1880 ../src/guestfs.pod:1880 +msgid "guestfs_event_callback" +msgstr "" + #. type: verbatim -#: ../tools/virt-win-reg.pl:43 +#: ../libguestfs-1.11.19/src/guestfs.pod:1882 ../src/guestfs.pod:1882 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" +" typedef void (*guestfs_event_callback) (\n" +" guestfs_h *g,\n" +" void *opaque,\n" +" uint64_t event,\n" +" int event_handle,\n" +" int flags,\n" +" const char *buf, size_t buf_len,\n" +" const uint64_t *array, size_t array_len);\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1891 ../src/guestfs.pod:1891 +msgid "This is the type of the event callback function that you have to provide." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1894 ../src/guestfs.pod:1894 +msgid "" +"The basic parameters are: the handle (C<g>), the opaque user pointer " +"(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event " +"handle, and C<flags> which in the current API you should ignore." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1898 ../src/guestfs.pod:1898 +msgid "" +"The remaining parameters contain the event payload (if any). Each event may " +"contain a payload, which usually relates to the event class, but for future " +"proofing your code should be written to handle any payload for any event " +"class." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1903 ../src/guestfs.pod:1903 +msgid "" +"C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then " +"there is no message buffer). Note that this message buffer can contain " +"arbitrary 8 bit data, including NUL bytes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1907 ../src/guestfs.pod:1907 +msgid "" +"C<array> and C<array_len> is an array of 64 bit unsigned integers. At the " +"moment this is only used for progress messages." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:1910 ../src/guestfs.pod:1910 +msgid "EXAMPLE: CAPTURING LOG MESSAGES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1912 ../src/guestfs.pod:1912 +msgid "" +"One motivation for the generic event API was to allow GUI programs to " +"capture debug and other messages. In libguestfs E<le> 1.8 these were sent " +"unconditionally to C<stderr>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1916 ../src/guestfs.pod:1916 +msgid "" +"Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, " +"C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>. (Note that error " +"messages are not events; you must capture error messages separately)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1921 ../src/guestfs.pod:1921 +msgid "" +"Programs have to set up a callback to capture the classes of events of " +"interest:" +msgstr "" + #. type: verbatim -#: ../tools/virt-win-reg.pl:45 +#: ../libguestfs-1.11.19/src/guestfs.pod:1924 ../src/guestfs.pod:1924 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" +" int eh =\n" +" guestfs_set_event_callback\n" +" (g, message_callback,\n" +" GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n" +" GUESTFS_EVENT_TRACE,\n" +" 0, NULL) == -1)\n" +" if (eh == -1) {\n" +" // handle error in the usual way\n" +" }\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1934 ../src/guestfs.pod:1934 +msgid "" +"The callback can then direct messages to the appropriate place. In this " +"example, messages are directed to syslog:" +msgstr "" + #. type: verbatim -#: ../tools/virt-win-reg.pl:47 +#: ../libguestfs-1.11.19/src/guestfs.pod:1937 ../src/guestfs.pod:1937 #, no-wrap msgid "" -" virt-win-reg --merge domname [input.reg ...]\n" +" static void\n" +" message_callback (\n" +" guestfs_h *g,\n" +" void *opaque,\n" +" uint64_t event,\n" +" int event_handle,\n" +" int flags,\n" +" const char *buf, size_t buf_len,\n" +" const uint64_t *array, size_t array_len)\n" +" {\n" +" const int priority = LOG_USER|LOG_INFO;\n" +" if (buf_len > 0)\n" +" syslog (priority, \"event 0x%lx: %s\", event, buf);\n" +" }\n" "\n" msgstr "" +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1952 ../src/guestfs.pod:1952 +msgid "CANCELLING LONG TRANSFERS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1954 ../src/guestfs.pod:1954 +msgid "" +"Some operations can be cancelled by the caller while they are in progress. " +"Currently only operations that involve uploading or downloading data can be " +"cancelled (technically: operations that have C<FileIn> or C<FileOut> " +"parameters in the generator)." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:1959 ../src/guestfs.pod:1959 +msgid "guestfs_user_cancel" +msgstr "" + #. type: verbatim -#: ../tools/virt-win-reg.pl:49 +#: ../libguestfs-1.11.19/src/guestfs.pod:1961 ../src/guestfs.pod:1961 #, no-wrap msgid "" -" virt-win-reg [--options] disk.img ... # instead of domname\n" +" void guestfs_user_cancel (guestfs_h *g);\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:53 +#: ../libguestfs-1.11.19/src/guestfs.pod:1963 ../src/guestfs.pod:1963 +msgid "C<guestfs_user_cancel> cancels the current upload or download operation." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1966 ../src/guestfs.pod:1966 msgid "" -"You must I<not> use C<virt-win-reg> with the I<--merge> option on live " -"virtual machines. If you do this, you I<will> get irreversible disk " -"corruption in the VM. C<virt-win-reg> tries to stop you from doing this, " -"but doesn't catch all cases." +"Unlike most other libguestfs calls, this function is signal safe and thread " +"safe. You can call it from a signal handler or from another thread, without " +"needing to do any locking." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:58 +#: ../libguestfs-1.11.19/src/guestfs.pod:1970 ../src/guestfs.pod:1970 msgid "" -"Modifying the Windows Registry is an inherently risky operation. The format " -"is deliberately obscure and undocumented, and Registry changes can leave the " -"system unbootable. Therefore when using the I<--merge> option, make sure " -"you have a reliable backup first." +"The transfer that was in progress (if there is one) will stop shortly " +"afterwards, and will return an error. The errno (see " +"L</guestfs_last_errno>) is set to C<EINTR>, so you can test for this to find " +"out if the operation was cancelled or failed because of another error." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:65 +#: ../libguestfs-1.11.19/src/guestfs.pod:1976 ../src/guestfs.pod:1976 msgid "" -"This program can export and merge Windows Registry entries from a Windows " -"guest." +"No cleanup is performed: for example, if a file was being uploaded then " +"after cancellation there may be a partially uploaded file. It is the " +"caller's responsibility to clean up if necessary." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:68 +#: ../libguestfs-1.11.19/src/guestfs.pod:1980 ../src/guestfs.pod:1980 +msgid "There are two common places that you might call C<guestfs_user_cancel>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1982 ../src/guestfs.pod:1982 msgid "" -"The first parameter is the libvirt guest name or the raw disk image of a " -"Windows guest." +"In an interactive text-based program, you might call it from a C<SIGINT> " +"signal handler so that pressing C<^C> cancels the current operation. (You " +"also need to call L</guestfs_set_pgroup> so that child processes don't " +"receive the C<^C> signal)." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:71 +#: ../libguestfs-1.11.19/src/guestfs.pod:1987 ../src/guestfs.pod:1987 msgid "" -"If I<--merge> is I<not> specified, then the chosen registry key is " -"displayed/exported (recursively). For example:" +"In a graphical program, when the main thread is displaying a progress bar " +"with a cancel button, wire up the cancel button to call this function." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:1991 ../src/guestfs.pod:1991 +msgid "PRIVATE DATA AREA" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1993 ../src/guestfs.pod:1993 +msgid "" +"You can attach named pieces of private data to the libguestfs handle, fetch " +"them by name, and walk over them, for the lifetime of the handle. This is " +"called the private data area and is only available from the C API." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:1998 ../src/guestfs.pod:1998 +msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:74 +#: ../libguestfs-1.11.19/src/guestfs.pod:2000 ../src/guestfs.pod:2000 #, no-wrap msgid "" -" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" +" void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:76 -msgid "You can also display single values from within registry keys, for example:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2002 ../src/guestfs.pod:2002 +msgid "" +"C<key> is the name to associate with this data, and C<data> is an arbitrary " +"pointer (which can be C<NULL>). Any previous item with the same key is " +"overwritten." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2006 ../src/guestfs.pod:2006 +msgid "" +"You can use any C<key> you want, but your key should I<not> start with an " +"underscore character. Keys beginning with an underscore character are " +"reserved for internal libguestfs purposes (eg. for implementing language " +"bindings). It is recommended that you prefix the key with some unique " +"string to avoid collisions with other users." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2012 ../src/guestfs.pod:2012 +msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:79 +#: ../libguestfs-1.11.19/src/guestfs.pod:2014 ../src/guestfs.pod:2014 #, no-wrap msgid "" -" $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n" -" $ virt-win-reg Windows7 $cvkey ProductName\n" -" Windows 7 Enterprise\n" +" void *guestfs_get_private (guestfs_h *g, const char *key);\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:83 +#: ../libguestfs-1.11.19/src/guestfs.pod:2016 ../src/guestfs.pod:2016 msgid "" -"With I<--merge>, you can merge a textual regedit file into the Windows " -"Registry:" +"This function returns C<NULL> if either no data is found associated with " +"C<key>, or if the user previously set the C<key>'s C<data> pointer to " +"C<NULL>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2020 ../src/guestfs.pod:2020 +msgid "" +"Libguestfs does not try to look at or interpret the C<data> pointer in any " +"way. As far as libguestfs is concerned, it need not be a valid pointer at " +"all. In particular, libguestfs does I<not> try to free the data when the " +"handle is closed. If the data must be freed, then the caller must either " +"free it before calling L</guestfs_close> or must set up a close callback to " +"do it (see L</GUESTFS_EVENT_CLOSE>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2027 ../src/guestfs.pod:2027 +msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:86 +#: ../libguestfs-1.11.19/src/guestfs.pod:2029 ../src/guestfs.pod:2029 #, no-wrap msgid "" -" $ virt-win-reg --merge Windows7 changes.reg\n" +" void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" "\n" msgstr "" -#. type: =head1 -#: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45 -msgid "NOTE" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2031 ../src/guestfs.pod:2031 +#, no-wrap +msgid "" +" void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:90 +#: ../libguestfs-1.11.19/src/guestfs.pod:2033 ../src/guestfs.pod:2033 msgid "" -"This program is only meant for simple access to the registry. If you want " -"to do complicated things with the registry, we suggest you download the " -"Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> " -"and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or " -"L<hivexregedit(1)>." +"C<guestfs_first_private> returns the first key, pointer pair (\"first\" does " +"not have any particular meaning -- keys are not returned in any defined " +"order). A pointer to the key is returned in C<*key_rtn> and the " +"corresponding data pointer is returned from the function. C<NULL> is " +"returned if there are no keys stored in the handle." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:106 ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113 ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64 -msgid "Display brief help." +#: ../libguestfs-1.11.19/src/guestfs.pod:2039 ../src/guestfs.pod:2039 +msgid "" +"C<guestfs_next_private> returns the next key, pointer pair. The return " +"value of this function is also C<NULL> is there are no further entries to " +"return." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:114 ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121 ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72 -msgid "Display version number and exit." +#: ../libguestfs-1.11.19/src/guestfs.pod:2043 ../src/guestfs.pod:2043 +msgid "Notes about walking over entries:" msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177 -msgid "B<--debug>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2049 ../src/guestfs.pod:2049 +msgid "You must not call C<guestfs_set_private> while walking over the entries." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:122 -msgid "Enable debugging messages." +#: ../libguestfs-1.11.19/src/guestfs.pod:2054 ../src/guestfs.pod:2054 +msgid "" +"The handle maintains an internal iterator which is reset when you call " +"C<guestfs_first_private>. This internal iterator is invalidated when you " +"call C<guestfs_set_private>." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:128 ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127 ../tools/virt-list-partitions.pl:78 -msgid "B<--connect URI> | B<-c URI>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2060 ../src/guestfs.pod:2060 +msgid "If you have set the data pointer associated with a key to C<NULL>, ie:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2062 ../src/guestfs.pod:2062 +#, no-wrap +msgid "" +" guestfs_set_private (g, key, NULL);\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:130 ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129 ../tools/virt-list-partitions.pl:80 +#: ../libguestfs-1.11.19/src/guestfs.pod:2064 ../src/guestfs.pod:2064 +msgid "then that C<key> is not returned when walking." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2068 ../src/guestfs.pod:2068 msgid "" -"If using libvirt, connect to the given I<URI>. If omitted, then we connect " -"to the default libvirt hypervisor." +"C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, " +"C<guestfs_next_private> or C<guestfs_set_private>." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:133 ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132 ../tools/virt-list-partitions.pl:83 +#: ../libguestfs-1.11.19/src/guestfs.pod:2074 ../src/guestfs.pod:2074 msgid "" -"If you specify guest block devices directly, then libvirt is not used at " -"all." +"The following example code shows how to print all keys and data pointers " +"that are associated with the handle C<g>:" msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:140 ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139 ../tools/virt-list-partitions.pl:90 -msgid "B<--format> raw" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2077 ../src/guestfs.pod:2077 +#, no-wrap +msgid "" +" const char *key;\n" +" void *data = guestfs_first_private (g, &key);\n" +" while (data != NULL)\n" +" {\n" +" printf (\"key = %s, data = %p\\n\", key, data);\n" +" data = guestfs_next_private (g, &key);\n" +" }\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:142 ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141 ../tools/virt-list-partitions.pl:92 +#: ../libguestfs-1.11.19/src/guestfs.pod:2085 ../src/guestfs.pod:2085 msgid "" -"Specify the format of disk images given on the command line. If this is " -"omitted then the format is autodetected from the content of the disk image." +"More commonly you are only interested in keys that begin with an " +"application-specific prefix C<foo_>. Modify the loop like so:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2088 ../src/guestfs.pod:2088 +#, no-wrap +msgid "" +" const char *key;\n" +" void *data = guestfs_first_private (g, &key);\n" +" while (data != NULL)\n" +" {\n" +" if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n" +" printf (\"key = %s, data = %p\\n\", key, data);\n" +" data = guestfs_next_private (g, &key);\n" +" }\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:146 ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145 ../tools/virt-list-partitions.pl:96 +#: ../libguestfs-1.11.19/src/guestfs.pod:2097 ../src/guestfs.pod:2097 msgid "" -"If disk images are requested from libvirt, then this program asks libvirt " -"for this information. In this case, the value of the format parameter is " -"ignored." +"If you need to modify keys while walking, then you have to jump back to the " +"beginning of the loop. For example, to delete all keys prefixed with " +"C<foo_>:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2101 ../src/guestfs.pod:2101 +#, no-wrap +msgid "" +" const char *key;\n" +" void *data;\n" +" again:\n" +" data = guestfs_first_private (g, &key);\n" +" while (data != NULL)\n" +" {\n" +" if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n" +" {\n" +" guestfs_set_private (g, key, NULL);\n" +" /* note that 'key' pointer is now invalid, and so is\n" +" the internal iterator */\n" +" goto again;\n" +" }\n" +" data = guestfs_next_private (g, &key);\n" +" }\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:150 ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149 ../tools/virt-list-partitions.pl:100 +#: ../libguestfs-1.11.19/src/guestfs.pod:2117 ../src/guestfs.pod:2117 msgid "" -"If working with untrusted raw-format guest disk images, you should ensure " -"the format is always specified." +"Note that the above loop is guaranteed to terminate because the keys are " +"being deleted, but other manipulations of keys within the loop might not " +"terminate unless you also maintain an indication of which keys have been " +"visited." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:157 -msgid "B<--merge>" +#. type: =end +#: ../libguestfs-1.11.19/src/guestfs.pod:2122 ../libguestfs-1.11.19/src/guestfs.pod:2127 ../src/guestfs.pod:2122 ../src/guestfs.pod:2127 +msgid "html" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:159 +#: ../libguestfs-1.11.19/src/guestfs.pod:2124 ../src/guestfs.pod:2124 msgid "" -"In merge mode, this merges a textual regedit file into the Windows Registry " -"of the virtual machine. If this flag is I<not> given then virt-win-reg " -"displays or exports Registry entries instead." +"<!-- old anchor for the next section --> <a " +"name=\"state_machine_and_low_level_event_api\"/>" +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:2129 ../src/guestfs.pod:2129 +msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:163 +#: ../libguestfs-1.11.19/src/guestfs.pod:2131 ../src/guestfs.pod:2131 msgid "" -"Note that I<--merge> is I<unsafe> to use on live virtual machines, and will " -"result in disk corruption. However exporting (without this flag) is always " -"safe." +"Internally, libguestfs is implemented by running an appliance (a special " +"type of small virtual machine) using L<qemu(1)>. Qemu runs as a child " +"process of the main program." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:171 -msgid "B<--encoding> UTF-16LE|ASCII" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2135 ../src/guestfs.pod:2135 +#, no-wrap +msgid "" +" ___________________\n" +" / \\\n" +" | main program |\n" +" | |\n" +" | | child process / appliance\n" +" | | __________________________\n" +" | | / qemu \\\n" +" +-------------------+ RPC | +-----------------+ |\n" +" | libguestfs <--------------------> guestfsd | |\n" +" | | | +-----------------+ |\n" +" \\___________________/ | | Linux kernel | |\n" +" | +--^--------------+ |\n" +" \\_________|________________/\n" +" |\n" +" _______v______\n" +" / \\\n" +" | Device or |\n" +" | disk image |\n" +" \\______________/\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:173 +#: ../libguestfs-1.11.19/src/guestfs.pod:2155 ../src/guestfs.pod:2155 msgid "" -"When merging (only), you may need to specify the encoding for strings to be " -"used in the hive file. This is explained in detail in " -"L<Win::Hivex::Regedit(3)/ENCODING STRINGS>." +"The library, linked to the main program, creates the child process and hence " +"the appliance in the L</guestfs_launch> function." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:177 +#: ../libguestfs-1.11.19/src/guestfs.pod:2158 ../src/guestfs.pod:2158 msgid "" -"The default is to use UTF-16LE, which should work with recent versions of " -"Windows." +"Inside the appliance is a Linux kernel and a complete stack of userspace " +"tools (such as LVM and ext2 programs) and a small controlling daemon called " +"L</guestfsd>. The library talks to L</guestfsd> using remote procedure " +"calls (RPC). There is a mostly one-to-one correspondence between libguestfs " +"API calls and RPC calls to the daemon. Lastly the disk image(s) are " +"attached to the qemu process which translates device access by the " +"appliance's Linux kernel into accesses to the image." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:184 -msgid "B<--unsafe-printable-strings>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2167 ../src/guestfs.pod:2167 +msgid "" +"A common misunderstanding is that the appliance \"is\" the virtual machine. " +"Although the disk image you are attached to might also be used by some " +"virtual machine, libguestfs doesn't know or care about this. (But you will " +"care if both libguestfs's qemu process and your virtual machine are trying " +"to update the disk image at the same time, since these usually results in " +"massive disk corruption)." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:2174 ../src/guestfs.pod:2174 +msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:186 +#: ../libguestfs-1.11.19/src/guestfs.pod:2176 ../src/guestfs.pod:2176 +msgid "libguestfs uses a state machine to model the child process:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2178 ../src/guestfs.pod:2178 +#, no-wrap msgid "" -"When exporting (only), assume strings are UTF-16LE and print them as strings " -"instead of hex sequences. Remove the final zero codepoint from strings if " -"present." +" |\n" +" guestfs_create\n" +" |\n" +" |\n" +" ____V_____\n" +" / \\\n" +" | CONFIG |\n" +" \\__________/\n" +" ^ ^ ^ \\\n" +" / | \\ \\ guestfs_launch\n" +" / | _\\__V______\n" +" / | / \\\n" +" / | | LAUNCHING |\n" +" / | \\___________/\n" +" / | /\n" +" / | guestfs_launch\n" +" / | /\n" +" ______ / __|____V\n" +" / \\ ------> / \\\n" +" | BUSY | | READY |\n" +" \\______/ <------ \\________/\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:190 +#: ../libguestfs-1.11.19/src/guestfs.pod:2200 ../src/guestfs.pod:2200 msgid "" -"This is unsafe and does not preserve the fidelity of strings in the original " -"Registry for various reasons:" +"The normal transitions are (1) CONFIG (when the handle is created, but there " +"is no child process), (2) LAUNCHING (when the child process is booting up), " +"(3) alternating between READY and BUSY as commands are issued to, and " +"carried out by, the child process." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:197 +#: ../libguestfs-1.11.19/src/guestfs.pod:2205 ../src/guestfs.pod:2205 msgid "" -"Assumes the original encoding is UTF-16LE. ASCII strings and strings in " -"other encodings will be corrupted by this transformation." +"The guest may be killed by L</guestfs_kill_subprocess>, or may die " +"asynchronously at any time (eg. due to some internal error), and that causes " +"the state to transition back to CONFIG." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:202 +#: ../libguestfs-1.11.19/src/guestfs.pod:2209 ../src/guestfs.pod:2209 msgid "" -"Assumes that everything which has type 1 or 2 is really a string and that " -"everything else is not a string, but the type field in real Registries is " -"not reliable." +"Configuration commands for qemu such as L</guestfs_add_drive> can only be " +"issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:208 +#: ../libguestfs-1.11.19/src/guestfs.pod:2212 ../src/guestfs.pod:2212 msgid "" -"Loses information about whether a zero codepoint followed the string in the " -"Registry or not." +"The API offers one call that goes from CONFIG through LAUNCHING to READY. " +"L</guestfs_launch> blocks until the child process is READY to accept " +"commands (or until some failure or timeout). L</guestfs_launch> internally " +"moves the state from CONFIG to LAUNCHING while it is running." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:213 +#: ../libguestfs-1.11.19/src/guestfs.pod:2218 ../src/guestfs.pod:2218 msgid "" -"This all happens because the Registry itself contains no information about " -"how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)." +"API actions such as L</guestfs_mount> can only be issued when in the READY " +"state. These API calls block waiting for the command to be carried out " +"(ie. the state to transition to BUSY and then back to READY). There are no " +"non-blocking versions, and no way to issue more than one command per handle " +"at the same time." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:217 +#: ../libguestfs-1.11.19/src/guestfs.pod:2224 ../src/guestfs.pod:2224 msgid "" -"You should only use this option for quick hacking and debugging of the " -"Registry contents, and I<never> use it if the output is going to be passed " -"into another program or stored in another Registry." +"Finally, the child process sends asynchronous messages back to the main " +"program, such as kernel log messages. You can register a callback to " +"receive these messages." msgstr "" #. type: =head1 -#: ../tools/virt-win-reg.pl:554 -msgid "SUPPORTED SYSTEMS" +#: ../libguestfs-1.11.19/src/guestfs.pod:2228 ../src/guestfs.pod:2228 +msgid "INTERNALS" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2230 ../src/guestfs.pod:2230 +msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:556 +#: ../libguestfs-1.11.19/src/guestfs.pod:2232 ../src/guestfs.pod:2232 msgid "" -"The program currently supports Windows NT-derived guests starting with " -"Windows XP through to at least Windows 7." +"Don't rely on using this protocol directly. This section documents how it " +"currently works, but it may change at any time." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:559 -msgid "The following Registry keys are supported:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2235 ../src/guestfs.pod:2235 +msgid "" +"The protocol used to talk between the library and the daemon running inside " +"the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC " +"1014, RFC 1832, RFC 4506)." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:563 -msgid "C<HKEY_LOCAL_MACHINE\\SAM>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2239 ../src/guestfs.pod:2239 +msgid "" +"The detailed format of structures is in C<src/guestfs_protocol.x> (note: " +"this file is automatically generated)." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:565 -msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2242 ../src/guestfs.pod:2242 +msgid "" +"There are two broad cases, ordinary functions that don't have any C<FileIn> " +"and C<FileOut> parameters, which are handled with very simple request/reply " +"messages. Then there are functions that have any C<FileIn> or C<FileOut> " +"parameters, which use the same request and reply messages, but they may also " +"be followed by files sent using a chunked encoding." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:567 -msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>" +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:2249 ../src/guestfs.pod:2249 +msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:569 -msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2251 ../src/guestfs.pod:2251 +msgid "For ordinary functions, the request message is:" msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:571 -msgid "C<HKEY_USERS\\.DEFAULT>" +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2253 ../src/guestfs.pod:2253 +#, no-wrap +msgid "" +" total length (header + arguments,\n" +" but not including the length word itself)\n" +" struct guestfs_message_header (encoded as XDR)\n" +" struct guestfs_<foo>_args (encoded as XDR)\n" +"\n" msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:573 -msgid "C<HKEY_USERS\\I<SID>>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2258 ../src/guestfs.pod:2258 +msgid "" +"The total length field allows the daemon to allocate a fixed size buffer " +"into which it slurps the rest of the message. As a result, the total length " +"is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the " +"effective size of any request is limited to somewhere under this size." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:575 -msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)." +#: ../libguestfs-1.11.19/src/guestfs.pod:2264 ../src/guestfs.pod:2264 +msgid "" +"Note also that many functions don't take any arguments, in which case the " +"C<guestfs_I<foo>_args> is completely omitted." msgstr "" -#. type: =item -#: ../tools/virt-win-reg.pl:577 -msgid "C<HKEY_USERS\\I<username>>" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2267 ../src/guestfs.pod:2267 +msgid "" +"The header contains the procedure number (C<guestfs_proc>) which is how the " +"receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:579 -msgid "where I<username> is a local user name (this is a libguestfs extension)." +#: ../libguestfs-1.11.19/src/guestfs.pod:2271 ../src/guestfs.pod:2271 +msgid "" +"For functions that take optional arguments, the optional arguments are " +"encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary " +"arguments. A bitmask in the header indicates which optional arguments are " +"meaningful. The bitmask is also checked to see if it contains bits set " +"which the daemon does not know about (eg. if more optional arguments were " +"added in a later version of the library), and this causes the call to be " +"rejected." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:583 +#: ../libguestfs-1.11.19/src/guestfs.pod:2279 ../src/guestfs.pod:2279 +msgid "The reply message for ordinary functions is:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2281 ../src/guestfs.pod:2281 +#, no-wrap msgid "" -"You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for " -"C<HKEY_USERS>." +" total length (header + ret,\n" +" but not including the length word itself)\n" +" struct guestfs_message_header (encoded as XDR)\n" +" struct guestfs_<foo>_ret (encoded as XDR)\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:586 +#: ../libguestfs-1.11.19/src/guestfs.pod:2286 ../src/guestfs.pod:2286 msgid "" -"The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not " -"supported (there is no \"current user\")." +"As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " +"functions that return no formal return values." msgstr "" -#. type: =head1 -#: ../tools/virt-win-reg.pl:589 -msgid "ENCODING" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2289 ../src/guestfs.pod:2289 +msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:591 +#: ../libguestfs-1.11.19/src/guestfs.pod:2292 ../src/guestfs.pod:2292 msgid "" -"C<virt-win-reg> expects that regedit files have already been reencoded in " -"the local encoding. Usually on Linux hosts, this means UTF-8 with " -"Unix-style line endings. Since Windows regedit files are often in UTF-16LE " -"with Windows-style line endings, you may need to reencode the whole file " -"before or after processing." +"In the case of an error, a flag is set in the header, and the reply message " +"is slightly changed:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2295 ../src/guestfs.pod:2295 +#, no-wrap +msgid "" +" total length (header + error,\n" +" but not including the length word itself)\n" +" struct guestfs_message_header (encoded as XDR)\n" +" struct guestfs_message_error (encoded as XDR)\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:597 +#: ../libguestfs-1.11.19/src/guestfs.pod:2300 ../src/guestfs.pod:2300 msgid "" -"To reencode a file from Windows format to Linux (before processing it with " -"the I<--merge> option), you would do something like this:" +"The C<guestfs_message_error> structure contains the error message as a " +"string." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:2303 ../src/guestfs.pod:2303 +msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2305 ../src/guestfs.pod:2305 +msgid "" +"A C<FileIn> parameter indicates that we transfer a file I<into> the guest. " +"The normal request message is sent (see above). However this is followed by " +"a sequence of file chunks." msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:600 +#: ../libguestfs-1.11.19/src/guestfs.pod:2309 ../src/guestfs.pod:2309 #, no-wrap msgid "" -" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" +" total length (header + arguments,\n" +" but not including the length word itself,\n" +" and not including the chunks)\n" +" struct guestfs_message_header (encoded as XDR)\n" +" struct guestfs_<foo>_args (encoded as XDR)\n" +" sequence of chunks for FileIn param #0\n" +" sequence of chunks for FileIn param #1 etc.\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:602 -msgid "" -"To go in the opposite direction, after exporting and before sending the file " -"to a Windows user, do something like this:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2317 ../src/guestfs.pod:2317 +msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:605 +#: ../libguestfs-1.11.19/src/guestfs.pod:2319 ../src/guestfs.pod:2319 #, no-wrap msgid "" -" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" +" length of chunk (not including length word itself)\n" +" struct guestfs_chunk (encoded as XDR)\n" +" length of chunk\n" +" struct guestfs_chunk (encoded as XDR)\n" +" ...\n" +" length of chunk\n" +" struct guestfs_chunk (with data.data_len == 0)\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:607 -msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." +#: ../libguestfs-1.11.19/src/guestfs.pod:2327 ../src/guestfs.pod:2327 +msgid "" +"The final chunk has the C<data_len> field set to zero. Additionally a flag " +"is set in the final chunk to indicate either successful completion or early " +"cancellation." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:609 +#: ../libguestfs-1.11.19/src/guestfs.pod:2331 ../src/guestfs.pod:2331 msgid "" -"If you are unsure about the current encoding, use the L<file(1)> command. " -"Recent versions of Windows regedit.exe produce a UTF-16LE file with " -"Windows-style (CRLF) line endings, like this:" +"At time of writing there are no functions that have more than one FileIn " +"parameter. However this is (theoretically) supported, by sending the " +"sequence of chunks for each FileIn parameter one after another (from left to " +"right)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2336 ../src/guestfs.pod:2336 +msgid "" +"Both the library (sender) I<and> the daemon (receiver) may cancel the " +"transfer. The library does this by sending a chunk with a special flag set " +"to indicate cancellation. When the daemon sees this, it cancels the whole " +"RPC, does I<not> send any reply, and goes back to reading the next request." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2342 ../src/guestfs.pod:2342 +msgid "" +"The daemon may also cancel. It does this by writing a special word " +"C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during " +"the transfer, and if it gets it, it will cancel the transfer (it sends a " +"cancel chunk). The special word is chosen so that even if cancellation " +"happens right at the end of the transfer (after the library has finished " +"writing and has started listening for the reply), the \"spurious\" cancel " +"flag will not be confused with the reply message." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2351 ../src/guestfs.pod:2351 +msgid "" +"This protocol allows the transfer of arbitrary sized files (no 32 bit " +"limit), and also files where the size is not known in advance (eg. from " +"pipes or sockets). However the chunks are rather small " +"(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need " +"to keep much in memory." +msgstr "" + +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:2357 ../src/guestfs.pod:2357 +msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2359 ../src/guestfs.pod:2359 +msgid "" +"The protocol for FileOut parameters is exactly the same as for FileIn " +"parameters, but with the roles of daemon and library reversed." msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:613 +#: ../libguestfs-1.11.19/src/guestfs.pod:2362 ../src/guestfs.pod:2362 #, no-wrap msgid "" -" $ file software.reg\n" -" software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n" -" with CRLF line terminators\n" +" total length (header + ret,\n" +" but not including the length word itself,\n" +" and not including the chunks)\n" +" struct guestfs_message_header (encoded as XDR)\n" +" struct guestfs_<foo>_ret (encoded as XDR)\n" +" sequence of chunks for FileOut param #0\n" +" sequence of chunks for FileOut param #1 etc.\n" "\n" msgstr "" +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:2370 ../src/guestfs.pod:2370 +msgid "INITIAL MESSAGE" +msgstr "" + #. type: textblock -#: ../tools/virt-win-reg.pl:617 -msgid "This file would need conversion before you could I<--merge> it." +#: ../libguestfs-1.11.19/src/guestfs.pod:2372 ../src/guestfs.pod:2372 +msgid "" +"When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) " +"which indicates that the guest and daemon is alive. This is what " +"L</guestfs_launch> waits for." msgstr "" -#. type: =head1 -#: ../tools/virt-win-reg.pl:619 -msgid "CurrentControlSet etc." +#. type: =head3 +#: ../libguestfs-1.11.19/src/guestfs.pod:2376 ../src/guestfs.pod:2376 +msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:621 +#: ../libguestfs-1.11.19/src/guestfs.pod:2378 ../src/guestfs.pod:2378 msgid "" -"Registry keys like C<CurrentControlSet> don't really exist in the Windows " -"Registry at the level of the hive file, and therefore you cannot modify " -"these." +"The daemon may send progress notification messages at any time. These are " +"distinguished by the normal length word being replaced by " +"C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:625 +#: ../libguestfs-1.11.19/src/guestfs.pod:2382 ../src/guestfs.pod:2382 msgid "" -"C<CurrentControlSet> is usually an alias for C<ControlSet001>. In some " -"circumstances it might refer to another control set. The way to find out is " -"to look at the C<HKLM\\SYSTEM\\Select> key:" +"The library turns them into progress callbacks (see " +"L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards " +"them if not." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2386 ../src/guestfs.pod:2386 +msgid "" +"The daemon self-limits the frequency of progress messages it sends (see " +"C<daemon/proto.c:notify_progress>). Not all calls generate progress " +"messages." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:2390 ../src/guestfs.pod:2390 +msgid "LIBGUESTFS VERSION NUMBERS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2392 ../src/guestfs.pod:2392 +msgid "" +"Since April 2010, libguestfs has started to make separate development and " +"stable releases, along with corresponding branches in our git repository. " +"These separate releases can be identified by version number:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:629 +#: ../libguestfs-1.11.19/src/guestfs.pod:2397 ../src/guestfs.pod:2397 #, no-wrap msgid "" -" # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n" -" [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n" -" \"Current\"=dword:00000001\n" -" \"Default\"=dword:00000001\n" -" \"Failed\"=dword:00000000\n" -" \"LastKnownGood\"=dword:00000002\n" +" even numbers for stable: 1.2.x, 1.4.x, ...\n" +" .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n" +" |\n" +" v\n" +" 1 . 3 . 5\n" +" ^ ^\n" +" | |\n" +" | `-------- sub-version\n" +" |\n" +" `------ always '1' because we don't change the ABI\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:636 -msgid "\"Current\" is the one which Windows will choose when it boots." +#: ../libguestfs-1.11.19/src/guestfs.pod:2408 ../src/guestfs.pod:2408 +msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:638 -msgid "Similarly, other C<Current...> keys in the path may need to be replaced." +#: ../libguestfs-1.11.19/src/guestfs.pod:2410 ../src/guestfs.pod:2410 +msgid "" +"As time passes we cherry pick fixes from the development branch and backport " +"those into the stable branch, the effect being that the stable branch should " +"get more stable and less buggy over time. So the stable releases are ideal " +"for people who don't need new features but would just like the software to " +"work." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2416 ../src/guestfs.pod:2416 +msgid "Our criteria for backporting changes are:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2422 ../src/guestfs.pod:2422 +msgid "" +"Documentation changes which don't affect any code are backported unless the " +"documentation refers to a future feature which is not in stable." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2428 ../src/guestfs.pod:2428 +msgid "" +"Bug fixes which are not controversial, fix obvious problems, and have been " +"well tested are backported." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2433 ../src/guestfs.pod:2433 +msgid "" +"Simple rearrangements of code which shouldn't affect how it works get " +"backported. This is so that the code in the two branches doesn't get too " +"far out of step, allowing us to backport future fixes more easily." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2439 ../src/guestfs.pod:2439 +msgid "" +"We I<don't> backport new features, new APIs, new tools etc, except in one " +"exceptional case: the new feature is required in order to implement an " +"important bug fix." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2445 ../src/guestfs.pod:2445 +msgid "" +"A new stable branch starts when we think the new features in development are " +"substantial and compelling enough over the current stable branch to warrant " +"it. When that happens we create new stable and development versions 1.N.0 " +"and 1.(N+1).0 [N is even]. The new dot-oh release won't necessarily be so " +"stable at this point, but by backporting fixes from development, that branch " +"will stabilize over time." msgstr "" #. type: =head1 -#: ../tools/virt-win-reg.pl:641 -msgid "WINDOWS TIPS" +#: ../libguestfs-1.11.19/src/guestfs.pod:2453 ../src/guestfs.pod:2453 +msgid "EXTENDING LIBGUESTFS" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2455 ../src/guestfs.pod:2455 +msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:643 +#: ../libguestfs-1.11.19/src/guestfs.pod:2457 ../src/guestfs.pod:2457 msgid "" -"Note that some of these tips modify the guest disk image. The guest I<must> " -"be shut off, else you will get disk corruption." +"Large amounts of boilerplate code in libguestfs (RPC, bindings, " +"documentation) are generated, and this makes it easy to extend the " +"libguestfs API." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2461 ../src/guestfs.pod:2461 +msgid "To add a new API action there are two changes:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2467 ../src/guestfs.pod:2467 +msgid "" +"You need to add a description of the call (name, parameters, return type, " +"tests, documentation) to C<generator/generator_actions.ml>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2470 ../src/guestfs.pod:2470 +msgid "" +"There are two sorts of API action, depending on whether the call goes " +"through to the daemon in the appliance, or is serviced entirely by the " +"library (see L</ARCHITECTURE> above). L</guestfs_sync> is an example of the " +"former, since the sync is done in the appliance. L</guestfs_set_trace> is " +"an example of the latter, since a trace flag is maintained in the handle and " +"all tracing is done on the library side." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2478 ../src/guestfs.pod:2478 +msgid "" +"Most new actions are of the first type, and get added to the " +"C<daemon_functions> list. Each function has a unique procedure number used " +"in the RPC protocol which is assigned to that action when we publish " +"libguestfs and cannot be reused. Take the latest procedure number and " +"increment it." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2484 ../src/guestfs.pod:2484 +msgid "" +"For library-only actions of the second type, add to the " +"C<non_daemon_functions> list. Since these functions are serviced by the " +"library and do not travel over the RPC mechanism to the daemon, these " +"functions do not need a procedure number, and so the procedure number is set " +"to C<-1>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2492 ../src/guestfs.pod:2492 +msgid "Implement the action (in C):" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2494 ../src/guestfs.pod:2494 +msgid "" +"For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " +"C<daemon/> directory." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2497 ../src/guestfs.pod:2497 +msgid "" +"For library actions, implement the function C<guestfs__E<lt>nameE<gt>> " +"(note: double underscore) in the C<src/> directory." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2500 ../src/guestfs.pod:2500 +msgid "In either case, use another function as an example of what to do." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2504 ../src/guestfs.pod:2504 +msgid "After making these changes, use C<make> to compile." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2506 ../src/guestfs.pod:2506 +msgid "" +"Note that you don't need to implement the RPC, language bindings, manual " +"pages or anything else. It's all automatically generated from the OCaml " +"description." msgstr "" #. type: =head2 -#: ../tools/virt-win-reg.pl:646 -msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN" +#: ../libguestfs-1.11.19/src/guestfs.pod:2510 ../src/guestfs.pod:2510 +msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:648 +#: ../libguestfs-1.11.19/src/guestfs.pod:2512 ../src/guestfs.pod:2512 msgid "" -"Prepare a DOS batch script, VBScript or executable. Upload this using " -"L<guestfish(1)>. For this example the script is called C<test.bat> and it " -"is uploaded into C<C:\\>:" +"You can supply zero or as many tests as you want per API call. The tests " +"can either be added as part of the API description " +"(C<generator/generator_actions.ml>), or in some rarer cases you may want to " +"drop a script into C<regressions/>. Note that adding a script to " +"C<regressions/> is slower, so if possible use the first method." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2518 ../src/guestfs.pod:2518 +msgid "" +"The following describes the test environment used when you add an API test " +"in C<generator_actions.ml>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2521 ../src/guestfs.pod:2521 +msgid "The test environment has 4 block devices:" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2525 ../src/guestfs.pod:2525 +msgid "C</dev/sda> 500MB" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2527 ../src/guestfs.pod:2527 +msgid "General block device for testing." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2529 ../src/guestfs.pod:2529 +msgid "C</dev/sdb> 50MB" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2531 ../src/guestfs.pod:2531 +msgid "" +"C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " +"operations." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2534 ../src/guestfs.pod:2534 +msgid "C</dev/sdc> 10MB" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2536 ../src/guestfs.pod:2536 +msgid "Used in a few tests where two block devices are needed." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2538 ../src/guestfs.pod:2538 +msgid "C</dev/sdd>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2540 ../src/guestfs.pod:2540 +msgid "ISO with fixed content (see C<images/test.iso>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2544 ../src/guestfs.pod:2544 +msgid "" +"To be able to run the tests in a reasonable amount of time, the libguestfs " +"appliance and block devices are reused between tests. So don't try testing " +"L</guestfs_kill_subprocess> :-x" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2548 ../src/guestfs.pod:2548 +msgid "" +"Each test starts with an initial scenario, selected using one of the " +"C<Init*> expressions, described in C<generator/generator_types.ml>. These " +"initialize the disks mentioned above in a particular way as documented in " +"C<generator_types.ml>. You should not assume anything about the previous " +"contents of other disks that are not initialized." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2554 ../src/guestfs.pod:2554 +msgid "" +"You can add a prerequisite clause to any individual test. This is a " +"run-time check, which, if it fails, causes the test to be skipped. Useful " +"if testing a command which might not work on all variations of libguestfs " +"builds. A test that has prerequisite of C<Always> means to run " +"unconditionally." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2560 ../src/guestfs.pod:2560 +msgid "" +"In addition, packagers can skip individual tests by setting environment " +"variables before running C<make check>." msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:652 +#: ../libguestfs-1.11.19/src/guestfs.pod:2563 ../src/guestfs.pod:2563 #, no-wrap msgid "" -" guestfish -i -d WindowsGuest upload test.bat /test.bat\n" +" SKIP_TEST_<CMD>_<NUM>=1\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:654 -msgid "Prepare a regedit file containing the registry change:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2565 ../src/guestfs.pod:2565 +msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2567 ../src/guestfs.pod:2567 +msgid "or:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:656 +#: ../libguestfs-1.11.19/src/guestfs.pod:2569 ../src/guestfs.pod:2569 #, no-wrap msgid "" -" cat > test.reg <<'EOF'\n" -" [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n" -" \"Test\"=\"c:\\\\test.bat\"\n" -" EOF\n" +" SKIP_TEST_<CMD>=1\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:661 -msgid "" -"In this example we use the key C<RunOnce> which means that the script will " -"run precisely once when the first user logs in. If you want it to run every " -"time a user logs in, replace C<RunOnce> with C<Run>." +#: ../libguestfs-1.11.19/src/guestfs.pod:2571 ../src/guestfs.pod:2571 +msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:665 -msgid "Now update the registry:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2573 ../src/guestfs.pod:2573 +msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:667 +#: ../libguestfs-1.11.19/src/guestfs.pod:2575 ../src/guestfs.pod:2575 #, no-wrap msgid "" -" virt-win-reg --merge WindowsGuest test.reg\n" +" TEST_ONLY=\"vfs_type zerofree\"\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2577 ../src/guestfs.pod:2577 +msgid "" +"See C<capitests/tests.c> for more details of how these environment variables " +"work." +msgstr "" + #. type: =head2 -#: ../tools/virt-win-reg.pl:669 -msgid "INSTALLING A SERVICE" +#: ../libguestfs-1.11.19/src/guestfs.pod:2580 ../src/guestfs.pod:2580 +msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:671 -msgid "" -"This section assumes you are familiar with Windows services, and you either " -"have a program which handles the Windows Service Control Protocol directly " -"or you want to run any program using a service wrapper like SrvAny or the " -"free RHSrvAny." +#: ../libguestfs-1.11.19/src/guestfs.pod:2582 ../src/guestfs.pod:2582 +msgid "Test new actions work before submitting them." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2584 ../src/guestfs.pod:2584 +msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:676 +#: ../libguestfs-1.11.19/src/guestfs.pod:2586 ../src/guestfs.pod:2586 msgid "" -"First upload the program and optionally the service wrapper. In this case " -"the test program is called C<test.exe> and we are using the RHSrvAny " -"wrapper:" +"Debugging the daemon is a problem because it runs inside a minimal " +"environment. However you can fprintf messages in the daemon to stderr, and " +"they will show up if you use C<guestfish -v>." msgstr "" -#. type: verbatim -#: ../tools/virt-win-reg.pl:680 -#, no-wrap +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2590 ../src/guestfs.pod:2590 +msgid "FORMATTING CODE AND OTHER CONVENTIONS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2592 ../src/guestfs.pod:2592 msgid "" -" guestfish -i -d WindowsGuest <<EOF\n" -" upload rhsrvany.exe /rhsrvany.exe\n" -" upload test.exe /test.exe\n" -" EOF\n" -"\n" +"Our C source code generally adheres to some basic code-formatting " +"conventions. The existing code base is not totally consistent on this " +"front, but we do prefer that contributed code be formatted similarly. In " +"short, use spaces-not-TABs for indentation, use 2 spaces for each " +"indentation level, and other than that, follow the K&R style." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:685 +#: ../libguestfs-1.11.19/src/guestfs.pod:2598 ../src/guestfs.pod:2598 msgid "" -"Prepare a regedit file containing the registry changes. In this example, " -"the first registry change is needed for the service itself or the service " -"wrapper (if used). The second registry change is only needed because I am " -"using the RHSrvAny service wrapper." +"If you use Emacs, add the following to one of one of your start-up files " +"(e.g., ~/.emacs), to help ensure that you get indentation right:" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:690 +#: ../libguestfs-1.11.19/src/guestfs.pod:2601 ../src/guestfs.pod:2601 #, no-wrap msgid "" -" cat > service.reg <<'EOF'\n" -" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n" -" \"Type\"=dword:00000010\n" -" \"Start\"=dword:00000002\n" -" \"ErrorControl\"=dword:00000001\n" -" \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n" -" \"DisplayName\"=\"RHSrvAny\"\n" -" \"ObjectName\"=\"NetworkService\"\n" +" ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" +" ;;; Exceptions: Makefile and ChangeLog modes.\n" +" (add-hook 'find-file-hook\n" +" '(lambda () (if (and buffer-file-name\n" +" (string-match \"/libguestfs\\\\>\"\n" +" (buffer-file-name))\n" +" (not (string-equal mode-name \"Change Log\"))\n" +" (not (string-equal mode-name \"Makefile\")))\n" +" (setq indent-tabs-mode nil))))\n" " \n" msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:699 +#: ../libguestfs-1.11.19/src/guestfs.pod:2611 ../src/guestfs.pod:2611 #, no-wrap msgid "" -" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n" -" \"CommandLine\"=\"c:\\\\test.exe\"\n" -" \"PWD\"=\"c:\\\\Temp\"\n" -" EOF\n" +" ;;; When editing C sources in libguestfs, use this style.\n" +" (defun libguestfs-c-mode ()\n" +" \"C mode with adjusted defaults for use with libguestfs.\"\n" +" (interactive)\n" +" (c-set-style \"K&R\")\n" +" (setq c-indent-level 2)\n" +" (setq c-basic-offset 2))\n" +" (add-hook 'c-mode-hook\n" +" '(lambda () (if (string-match \"/libguestfs\\\\>\"\n" +" (buffer-file-name))\n" +" (libguestfs-c-mode))))\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:710 +#: ../libguestfs-1.11.19/src/guestfs.pod:2623 ../src/guestfs.pod:2623 +msgid "Enable warnings when compiling (and fix any problems this finds):" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2626 ../src/guestfs.pod:2626 +#, no-wrap msgid "" -"For use of C<ControlSet001> see the section above in this manual page. You " -"may need to adjust this according to the control set that is in use by the " -"guest." +" ./configure --enable-gcc-warnings\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:716 +#: ../libguestfs-1.11.19/src/guestfs.pod:2628 ../src/guestfs.pod:2628 +msgid "Useful targets are:" +msgstr "" + +#. type: verbatim +#: ../libguestfs-1.11.19/src/guestfs.pod:2630 ../src/guestfs.pod:2630 +#, no-wrap msgid "" -"C<\"ObjectName\"> controls the privileges that the service will have. An " -"alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most " -"privileged account." +" make syntax-check # checks the syntax of the C code\n" +" make check # runs the test suite\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2633 ../src/guestfs.pod:2633 +msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:722 +#: ../libguestfs-1.11.19/src/guestfs.pod:2635 ../src/guestfs.pod:2635 msgid "" -"For the meaning of the magic numbers, see this Microsoft KB article: " -"L<http://support.microsoft.com/kb/103000>." +"In the daemon code we have created custom printf formatters C<%Q> and C<%R>, " +"which are used to do shell quoting." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2640 ../src/guestfs.pod:2640 +msgid "%Q" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:727 -msgid "Update the registry:" +#: ../libguestfs-1.11.19/src/guestfs.pod:2642 ../src/guestfs.pod:2642 +msgid "" +"Simple shell quoted string. Any spaces or other shell characters are " +"escaped for you." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2645 ../src/guestfs.pod:2645 +msgid "%R" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2647 ../src/guestfs.pod:2647 +msgid "" +"Same as C<%Q> except the string is treated as a path which is prefixed by " +"the sysroot." msgstr "" #. type: verbatim -#: ../tools/virt-win-reg.pl:729 +#: ../libguestfs-1.11.19/src/guestfs.pod:2654 ../src/guestfs.pod:2654 #, no-wrap msgid "" -" virt-win-reg --merge WindowsGuest service.reg\n" +" asprintf (&cmd, \"cat %R\", path);\n" "\n" msgstr "" -#. type: =head1 -#: ../tools/virt-win-reg.pl:731 ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279 ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250 -msgid "SHELL QUOTING" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2656 ../src/guestfs.pod:2656 +msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:733 +#: ../libguestfs-1.11.19/src/guestfs.pod:2658 ../src/guestfs.pod:2658 msgid "" -"Be careful when passing parameters containing C<\\> (backslash) in the " -"shell. Usually you will have to use 'single quotes' or double backslashes " -"(but not both) to protect them from the shell." +"I<Note:> Do I<not> use these when you are passing parameters to the " +"C<command{,r,v,rv}()> functions. These parameters do NOT need to be quoted " +"because they are not passed via the shell (instead, straight to exec). You " +"probably want to use the C<sysroot_path()> function however." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2664 ../src/guestfs.pod:2664 +msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:737 -msgid "Paths and value names are case-insensitive." +#: ../libguestfs-1.11.19/src/guestfs.pod:2666 ../src/guestfs.pod:2666 +msgid "" +"Submit patches to the mailing list: " +"L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " +"L<rjones@redhat.com>." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2670 ../src/guestfs.pod:2670 +msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:739 ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252 +#: ../libguestfs-1.11.19/src/guestfs.pod:2672 ../src/guestfs.pod:2672 +msgid "We support i18n (gettext anyhow) in the library." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2674 ../src/guestfs.pod:2674 msgid "" -"Libvirt guest names can contain arbitrary characters, some of which have " -"meaning to the shell such as C<#> and space. You may need to quote or " -"escape these characters on the command line. See the shell manual page " -"L<sh(1)> for details." +"However many messages come from the daemon, and we don't translate those at " +"the moment. One reason is that the appliance generally has all locale files " +"removed from it, because they take up a lot of space. So we'd have to readd " +"some of those, as well as copying our PO files into the appliance." msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:746 +#: ../libguestfs-1.11.19/src/guestfs.pod:2680 ../src/guestfs.pod:2680 msgid "" -"L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, " -"L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, " -"L<Sys::Guestfs::Lib(3)>, L<Win::Hivex(3)>, L<Win::Hivex::Regedit(3)>, " -"L<Sys::Virt(3)>, L<http://libguestfs.org/>." +"Debugging messages are never translated, since they are intended for the " +"programmers." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2683 ../src/guestfs.pod:2683 +msgid "SOURCE CODE SUBDIRECTORIES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2689 ../src/guestfs.pod:2689 +msgid "The libguestfs appliance, build scripts and so on." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2691 ../src/guestfs.pod:2691 +msgid "C<capitests>" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:761 ../tools/virt-make-fs.pl:555 +#: ../libguestfs-1.11.19/src/guestfs.pod:2693 ../src/guestfs.pod:2693 +msgid "Automated tests of the C API." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2695 ../src/guestfs.pod:2695 +msgid "C<cat>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2697 ../src/guestfs.pod:2697 msgid "" -"When reporting bugs, please enable debugging and capture the I<complete> " -"output:" +"The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " +"documentation." msgstr "" -#. type: verbatim -#: ../tools/virt-win-reg.pl:764 -#, no-wrap +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2700 ../src/guestfs.pod:2700 +msgid "C<caution>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2702 ../src/guestfs.pod:2702 msgid "" -" export LIBGUESTFS_DEBUG=1\n" -" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" -"\n" +"Safety and liveness tests of components that libguestfs depends upon (not of " +"libguestfs itself). Mainly this is for qemu and the kernel." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2705 ../src/guestfs.pod:2705 +msgid "C<contrib>" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:767 +#: ../libguestfs-1.11.19/src/guestfs.pod:2707 ../src/guestfs.pod:2707 +msgid "Outside contributions, experimental parts." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2709 ../src/guestfs.pod:2709 +msgid "C<daemon>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2711 ../src/guestfs.pod:2711 msgid "" -"Attach /tmp/virt-win-reg.log to a new bug report at " -"L<https://bugzilla.redhat.com/>" +"The daemon that runs inside the libguestfs appliance and carries out " +"actions." msgstr "" -#. type: =head1 -#: ../tools/virt-win-reg.pl:770 ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301 ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269 -msgid "AUTHOR" +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2714 ../src/guestfs.pod:2714 +msgid "C<df>" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:772 ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303 ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271 -msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" +#: ../libguestfs-1.11.19/src/guestfs.pod:2716 ../src/guestfs.pod:2716 +msgid "L<virt-df(1)> command and documentation." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2718 ../src/guestfs.pod:2718 +msgid "C<edit>" msgstr "" #. type: textblock -#: ../tools/virt-win-reg.pl:776 ../tools/virt-make-fs.pl:570 -msgid "Copyright (C) 2010 Red Hat Inc." +#: ../libguestfs-1.11.19/src/guestfs.pod:2720 ../src/guestfs.pod:2720 +msgid "L<virt-edit(1)> command and documentation." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2722 ../src/guestfs.pod:2722 +msgid "C<examples>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:32 -msgid "virt-list-filesystems - List filesystems in a virtual machine or disk image" +#: ../libguestfs-1.11.19/src/guestfs.pod:2724 ../src/guestfs.pod:2724 +msgid "C API example code." msgstr "" -#. type: verbatim -#: ../tools/virt-list-filesystems.pl:36 -#, no-wrap -msgid "" -" virt-list-filesystems [--options] domname\n" -"\n" +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2726 ../src/guestfs.pod:2726 +msgid "C<fish>" msgstr "" -#. type: verbatim -#: ../tools/virt-list-filesystems.pl:38 -#, no-wrap +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2728 ../src/guestfs.pod:2728 msgid "" -" virt-list-filesystems [--options] disk.img [disk.img ...]\n" -"\n" +"L<guestfish(1)>, the command-line shell, and various shell scripts built on " +"top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " +"L<virt-tar-out(1)>." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2732 ../src/guestfs.pod:2732 +msgid "C<fuse>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42 -msgid "" -"This tool is obsolete. Use L<virt-filesystems(1)> as a more flexible " -"replacement." +#: ../libguestfs-1.11.19/src/guestfs.pod:2734 ../src/guestfs.pod:2734 +msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2736 ../src/guestfs.pod:2736 +msgid "C<generator>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:45 +#: ../libguestfs-1.11.19/src/guestfs.pod:2738 ../src/guestfs.pod:2738 msgid "" -"C<virt-list-filesystems> is a command line tool to list the filesystems that " -"are contained in a virtual machine or disk image." +"The crucially important generator, used to automatically generate large " +"amounts of boilerplate C code for things like RPC and bindings." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2741 ../src/guestfs.pod:2741 +msgid "C<images>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:49 -msgid "" -"C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> " -"functionality. For more complex cases you should look at the " -"L<guestfish(1)> tool." +#: ../libguestfs-1.11.19/src/guestfs.pod:2743 ../src/guestfs.pod:2743 +msgid "Files used by the test suite." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2745 ../src/guestfs.pod:2745 +msgid "Some \"phony\" guest images which we test against." msgstr "" #. type: =item -#: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115 -msgid "B<-l> | B<--long>" +#: ../libguestfs-1.11.19/src/guestfs.pod:2747 ../src/guestfs.pod:2747 +msgid "C<inspector>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:108 +#: ../libguestfs-1.11.19/src/guestfs.pod:2749 ../src/guestfs.pod:2749 +msgid "L<virt-inspector(1)>, the virtual machine image inspector." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2751 ../src/guestfs.pod:2751 +msgid "C<logo>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2753 ../src/guestfs.pod:2753 +msgid "Logo used on the website. The fish is called Arthur by the way." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2755 ../src/guestfs.pod:2755 +msgid "C<m4>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2757 ../src/guestfs.pod:2757 +msgid "M4 macros used by autoconf." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2759 ../src/guestfs.pod:2759 +msgid "C<po>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2761 ../src/guestfs.pod:2761 +msgid "Translations of simple gettext strings." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2763 ../src/guestfs.pod:2763 +msgid "C<po-docs>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2765 ../src/guestfs.pod:2765 msgid "" -"With this option, C<virt-list-filesystems> displays the type of each " -"filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)" +"The build infrastructure and PO files for translations of manpages and POD " +"files. Eventually this will be combined with the C<po> directory, but that " +"is rather complicated." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2769 ../src/guestfs.pod:2769 +msgid "C<regressions>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2771 ../src/guestfs.pod:2771 +msgid "Regression tests." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2773 ../src/guestfs.pod:2773 +msgid "C<rescue>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2775 ../src/guestfs.pod:2775 +msgid "L<virt-rescue(1)> command and documentation." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2777 ../src/guestfs.pod:2777 +msgid "C<src>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2779 ../src/guestfs.pod:2779 +msgid "Source code to the C library." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2781 ../src/guestfs.pod:2781 +msgid "C<tools>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2783 ../src/guestfs.pod:2783 +msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)." msgstr "" #. type: =item -#: ../tools/virt-list-filesystems.pl:115 -msgid "B<-a> | B<--all>" +#: ../libguestfs-1.11.19/src/guestfs.pod:2785 ../src/guestfs.pod:2785 +msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:117 +#: ../libguestfs-1.11.19/src/guestfs.pod:2787 ../src/guestfs.pod:2787 msgid "" -"Normally we only show mountable filesystems. If this option is given then " -"swap devices are shown too." +"Test tool for end users to test if their qemu/kernel combination will work " +"with libguestfs." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2790 ../src/guestfs.pod:2790 +msgid "C<csharp>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2792 ../src/guestfs.pod:2792 +msgid "C<haskell>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2794 ../src/guestfs.pod:2794 +msgid "C<java>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2796 ../src/guestfs.pod:2796 +msgid "C<ocaml>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2798 ../src/guestfs.pod:2798 +msgid "C<php>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2800 ../src/guestfs.pod:2800 +msgid "C<perl>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2802 ../src/guestfs.pod:2802 +msgid "C<python>" +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/src/guestfs.pod:2804 ../src/guestfs.pod:2804 +msgid "C<ruby>" msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:191 +#: ../libguestfs-1.11.19/src/guestfs.pod:2806 ../src/guestfs.pod:2806 +msgid "Language bindings." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2810 ../src/guestfs.pod:2810 +msgid "MAKING A STABLE RELEASE" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2812 ../src/guestfs.pod:2812 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, " -"L<virt-filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, " -"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." +"When we make a stable release, there are several steps documented here. See " +"L</LIBGUESTFS VERSION NUMBERS> for general information about the stable " +"branch policy." msgstr "" #. type: textblock -#: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307 -msgid "Copyright (C) 2009 Red Hat Inc." +#: ../libguestfs-1.11.19/src/guestfs.pod:2820 ../src/guestfs.pod:2820 +msgid "Finalize RELEASE-NOTES." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:33 -msgid "virt-tar - Extract or upload files to a virtual machine" +#: ../libguestfs-1.11.19/src/guestfs.pod:2824 ../src/guestfs.pod:2824 +msgid "Update ROADMAP." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2828 ../src/guestfs.pod:2828 +msgid "Run C<src/api-support/update-from-tarballs.sh>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2832 ../src/guestfs.pod:2832 +msgid "Push and pull from Transifex." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2834 ../src/guestfs.pod:2834 +msgid "Run:" msgstr "" #. type: verbatim -#: ../tools/virt-tar.pl:37 +#: ../libguestfs-1.11.19/src/guestfs.pod:2836 ../src/guestfs.pod:2836 #, no-wrap msgid "" -" virt-tar [--options] -x domname directory tarball\n" +" tx push -s\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2838 ../src/guestfs.pod:2838 +msgid "to push the latest POT files to Transifex. Then run:" +msgstr "" + #. type: verbatim -#: ../tools/virt-tar.pl:39 +#: ../libguestfs-1.11.19/src/guestfs.pod:2840 ../src/guestfs.pod:2840 #, no-wrap msgid "" -" virt-tar [--options] -u domname tarball directory\n" +" ./tx-pull.sh\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2842 ../src/guestfs.pod:2842 +msgid "which is a wrapper to pull the latest translated C<*.po> files." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2846 ../src/guestfs.pod:2846 +msgid "" +"Create new stable and development directories under " +"L<http://libguestfs.org/download>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2851 ../src/guestfs.pod:2851 +msgid "Create the branch in git:" +msgstr "" + #. type: verbatim -#: ../tools/virt-tar.pl:41 +#: ../libguestfs-1.11.19/src/guestfs.pod:2853 ../src/guestfs.pod:2853 #, no-wrap msgid "" -" virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n" +" git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n" +" git tag -a 1.YY.0 -m \"Version 1.YY.0 (development)\"\n" +" git branch stable-1.XX\n" +" git push origin tag 1.XX.0 1.YY.0 stable-1.XX\n" "\n" msgstr "" +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:2860 ../src/guestfs.pod:2860 +msgid "LIMITS" +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2862 ../src/guestfs.pod:2862 +msgid "PROTOCOL LIMITS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2864 ../src/guestfs.pod:2864 +msgid "" +"Internally libguestfs uses a message-based protocol to pass API calls and " +"their responses to and from a small \"appliance\" (see L</INTERNALS> for " +"plenty more detail about this). The maximum message size used by the " +"protocol is slightly less than 4 MB. For some API calls you may need to be " +"aware of this limit. The API calls which may be affected are individually " +"documented, with a link back to this section of the documentation." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2872 ../src/guestfs.pod:2872 +msgid "" +"A simple call such as L</guestfs_cat> returns its result (the file data) in " +"a simple string. Because this string is at some point internally encoded as " +"a message, the maximum size that it can return is slightly under 4 MB. If " +"the requested file is larger than this then you will get an error." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2878 ../src/guestfs.pod:2878 +msgid "" +"In order to transfer large files into and out of the guest filesystem, you " +"need to use particular calls that support this. The sections L</UPLOADING> " +"and L</DOWNLOADING> document how to do this." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2882 ../src/guestfs.pod:2882 +msgid "" +"You might also consider mounting the disk image using our FUSE filesystem " +"support (L<guestmount(1)>)." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2885 ../src/guestfs.pod:2885 +msgid "MAXIMUM NUMBER OF DISKS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2887 ../src/guestfs.pod:2887 +msgid "When using virtio disks (the default) the current limit is B<25> disks." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2890 ../src/guestfs.pod:2890 +msgid "" +"Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " +"slots. However febootstrap only understands disks with names C</dev/vda> " +"through C</dev/vdz> (26 letters) and it reserves one disk for its own " +"purposes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2895 ../src/guestfs.pod:2895 +msgid "" +"We are working to substantially raise this limit in future versions but it " +"requires complex changes to qemu." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2898 ../src/guestfs.pod:2898 +msgid "" +"In future versions of libguestfs it should also be possible to \"hot plug\" " +"disks (add and remove disks after calling L</guestfs_launch>). This also " +"requires changes to qemu." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2902 ../src/guestfs.pod:2902 +msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2904 ../src/guestfs.pod:2904 +msgid "Virtio limits the maximum number of partitions per disk to B<15>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2906 ../src/guestfs.pod:2906 +msgid "" +"This is because it reserves 4 bits for the minor device number (thus " +"C</dev/vda>, and C</dev/vda1> through C</dev/vda15>)." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2909 ../src/guestfs.pod:2909 +msgid "" +"If you attach a disk with more than 15 partitions, the extra partitions are " +"ignored by libguestfs." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2912 ../src/guestfs.pod:2912 +msgid "MAXIMUM SIZE OF A DISK" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2914 ../src/guestfs.pod:2914 +msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2916 ../src/guestfs.pod:2916 +msgid "" +"We have tested block devices up to 1 exabyte (2**60 or " +"1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host " +"filesystem." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2920 ../src/guestfs.pod:2920 +msgid "" +"Although libguestfs probably does not impose any limit, the underlying host " +"storage will. If you store disk images on a host ext4 filesystem, then the " +"maximum size will be limited by the maximum ext4 file size (currently 16 " +"TB). If you store disk images as host logical volumes then you are limited " +"by the maximum size of an LV." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2926 ../src/guestfs.pod:2926 +msgid "" +"For the hugest disk image files, we recommend using XFS on the host for " +"storage." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2929 ../src/guestfs.pod:2929 +msgid "MAXIMUM SIZE OF A PARTITION" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2931 ../src/guestfs.pod:2931 +msgid "" +"The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector " +"numbers. Assuming a 512 byte sector size, this means that MBR cannot " +"address a partition located beyond 2 TB on the disk." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2935 ../src/guestfs.pod:2935 +msgid "" +"It is recommended that you use GPT partitions on disks which are larger than " +"this size. GPT uses 64 bit sector numbers and so can address partitions " +"which are theoretically larger than the largest disk we could support." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2940 ../src/guestfs.pod:2940 +msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2942 ../src/guestfs.pod:2942 +msgid "" +"This depends on the filesystem type. libguestfs itself does not impose any " +"known limit. Consult Wikipedia or the filesystem documentation to find out " +"what these limits are." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2946 ../src/guestfs.pod:2946 +msgid "MAXIMUM UPLOAD AND DOWNLOAD" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2948 ../src/guestfs.pod:2948 +msgid "" +"The API functions L</guestfs_upload>, L</guestfs_download>, " +"L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized " +"uploads and downloads." +msgstr "" + +#. type: =head2 +#: ../libguestfs-1.11.19/src/guestfs.pod:2952 ../src/guestfs.pod:2952 +msgid "INSPECTION LIMITS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2954 ../src/guestfs.pod:2954 +msgid "" +"The inspection code has several arbitrary limits on things like the size of " +"Windows Registry hive it will read, and the length of product name. These " +"are intended to stop a malicious guest from consuming arbitrary amounts of " +"memory and disk space on the host, and should not be reached in practice. " +"See the source code for more information." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2970 ../src/guestfs.pod:2970 +msgid "" +"Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " +"effect as calling C<guestfs_set_verbose (g, 1)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2982 ../src/guestfs.pod:2982 +msgid "" +"Set the path that libguestfs uses to search for a supermin appliance. See " +"the discussion of paths in section L</PATH> above." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2991 ../src/guestfs.pod:2991 +msgid "See also L</QEMU WRAPPERS> above." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:2995 ../src/guestfs.pod:2995 +msgid "" +"Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same " +"effect as calling C<guestfs_set_trace (g, 1)>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3013 ../src/guestfs.pod:3013 +msgid "" +"L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, " +"L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, " +"L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, " +"L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, " +"L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, " +"L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, " +"L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, L<hivex(3)>, " +"L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3040 ../src/guestfs.pod:3040 +msgid "" +"Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " +"L<lvm(8)>, L<disktype(1)>." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/src/guestfs.pod:3047 ../src/guestfs.pod:3047 ../tools/virt-make-fs.pl:553 ../tools/virt-win-reg.pl:761 +msgid "BUGS" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3049 ../src/guestfs.pod:3049 +msgid "To get a list of bugs against libguestfs use this link:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3051 ../src/guestfs.pod:3051 +msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3053 ../src/guestfs.pod:3053 +msgid "To report a new bug against libguestfs use this link:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3055 ../src/guestfs.pod:3055 +msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3057 ../src/guestfs.pod:3057 +msgid "When reporting a bug, please check:" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3063 ../src/guestfs.pod:3063 +msgid "That the bug hasn't been reported already." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3067 ../src/guestfs.pod:3067 +msgid "That you are testing a recent version." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3071 ../src/guestfs.pod:3071 +msgid "Describe the bug accurately, and give a way to reproduce it." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/src/guestfs.pod:3075 ../src/guestfs.pod:3075 +msgid "" +"Run libguestfs-test-tool and paste the B<complete, unedited> output into the " +"bug report." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:5 ../test-tool/libguestfs-test-tool.pod:5 +msgid "libguestfs-test-tool - End user tests for libguestfs" +msgstr "" + #. type: verbatim -#: ../tools/virt-tar.pl:43 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:9 ../test-tool/libguestfs-test-tool.pod:9 #, no-wrap msgid "" -" virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n" +" libguestfs-test-tool [--options]\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:47 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:13 ../test-tool/libguestfs-test-tool.pod:13 msgid "" -"This tool is obsolete. Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, " -"L<virt-tar-in(1)>, L<virt-tar-out(1)> as replacements." +"libguestfs-test-tool is a test program shipped with libguestfs to end users " +"and developers, to allow them to check basic libguestfs functionality is " +"working. This is needed because libguestfs occasionally breaks for reasons " +"beyond our control: usually because of changes in the underlying qemu or " +"kernel packages, or the host environment." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:52 -msgid "Download C</home> from the VM into a local tarball:" +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:20 ../test-tool/libguestfs-test-tool.pod:20 +msgid "If you suspect a problem in libguestfs, then just run:" msgstr "" #. type: verbatim -#: ../tools/virt-tar.pl:54 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:22 ../test-tool/libguestfs-test-tool.pod:22 #, no-wrap msgid "" -" virt-tar -x domname /home home.tar\n" +" libguestfs-test-tool\n" "\n" msgstr "" +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:24 ../test-tool/libguestfs-test-tool.pod:24 +msgid "It will print lots of diagnostic messages." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:26 ../test-tool/libguestfs-test-tool.pod:26 +msgid "If it runs to completion successfully, you will see this near the end:" +msgstr "" + #. type: verbatim -#: ../tools/virt-tar.pl:56 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:28 ../test-tool/libguestfs-test-tool.pod:28 #, no-wrap msgid "" -" virt-tar -zx domname /home home.tar.gz\n" +" ===== TEST FINISHED OK =====\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:58 -msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:" +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:30 ../test-tool/libguestfs-test-tool.pod:30 +msgid "and the test tool will exit with code 0." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:32 ../test-tool/libguestfs-test-tool.pod:32 +msgid "" +"If it fails (and/or exits with non-zero error code), please paste the " +"B<complete, unedited> output of the test tool into a bug report. More " +"information about reporting bugs can be found on the " +"L<http://libguestfs.org/> website." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:41 ../test-tool/libguestfs-test-tool.pod:41 +msgid "I<--help>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:43 ../test-tool/libguestfs-test-tool.pod:43 +msgid "Display short usage information and exit." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:45 ../test-tool/libguestfs-test-tool.pod:45 +msgid "I<--qemu qemu_binary>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:47 ../test-tool/libguestfs-test-tool.pod:47 +msgid "" +"If you have downloaded another qemu binary, point this option at the full " +"path of the binary to try it." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:50 ../test-tool/libguestfs-test-tool.pod:50 +msgid "I<--qemudir qemu_source_dir>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:52 ../test-tool/libguestfs-test-tool.pod:52 +msgid "" +"If you have compiled qemu from source, point this option at the source " +"directory to try it." +msgstr "" + +#. type: =item +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:55 ../test-tool/libguestfs-test-tool.pod:55 +msgid "I<--timeout N>" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:57 ../test-tool/libguestfs-test-tool.pod:57 +msgid "" +"Set the launch timeout to C<N> seconds. The default is 120 seconds which " +"does not usually need to be adjusted unless your machine is very slow." +msgstr "" + +#. type: =head1 +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:63 ../test-tool/libguestfs-test-tool.pod:63 +msgid "TRYING OUT A DIFFERENT VERSION OF QEMU" +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:65 ../test-tool/libguestfs-test-tool.pod:65 +msgid "" +"If you have compiled another version of qemu from source and would like to " +"try that, then you can use the I<--qemudir> option to point to the qemu " +"source directory." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:69 ../test-tool/libguestfs-test-tool.pod:69 +msgid "" +"If you have downloaded a qemu binary from somewhere, use the I<--qemu> " +"option to point to the binary." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:72 ../test-tool/libguestfs-test-tool.pod:72 +msgid "" +"When using an alternate qemu with libguestfs, usually you would need to " +"write a qemu wrapper script (see section I<QEMU WRAPPERS> in " +"L<guestfs(3)>). libguestfs-test-tool writes a temporary qemu wrapper script " +"when you use either of the I<--qemudir> or I<--qemu> options." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:79 ../test-tool/libguestfs-test-tool.pod:79 +msgid "" +"libguestfs-test-tool returns I<0> if the tests completed without error, or " +"I<1> if there was an error." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:84 ../test-tool/libguestfs-test-tool.pod:84 +msgid "" +"For the full list of environment variables which may affect libguestfs, " +"please see the L<guestfs(3)> manual page." +msgstr "" + +#. type: textblock +#: ../libguestfs-1.11.19/test-tool/libguestfs-test-tool.pod:89 ../test-tool/libguestfs-test-tool.pod:89 +msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>." +msgstr "" + +#. type: textblock +#: ../tools/virt-list-filesystems.pl:32 +msgid "virt-list-filesystems - List filesystems in a virtual machine or disk image" msgstr "" #. type: verbatim -#: ../tools/virt-tar.pl:60 +#: ../tools/virt-list-filesystems.pl:36 #, no-wrap msgid "" -" virt-tar -u domname uploadstuff.tar /tmp\n" +" virt-list-filesystems [--options] domname\n" "\n" msgstr "" #. type: verbatim -#: ../tools/virt-tar.pl:62 +#: ../tools/virt-list-filesystems.pl:38 #, no-wrap msgid "" -" virt-tar -zu domname uploadstuff.tar.gz /tmp\n" +" virt-list-filesystems [--options] disk.img [disk.img ...]\n" "\n" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:66 +#: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42 msgid "" -"You must I<not> use C<virt-tar> with the I<-u> option (upload) on live " -"virtual machines. If you do this, you risk disk corruption in the VM. " -"C<virt-tar> tries to stop you from doing this, but doesn't catch all cases." +"This tool is obsolete. Use L<virt-filesystems(1)> as a more flexible " +"replacement." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:71 +#: ../tools/virt-list-filesystems.pl:45 msgid "" -"You can use I<-x> (extract) on live virtual machines, but you might get " -"inconsistent results or errors if there is filesystem activity inside the " -"VM. If the live VM is synched and quiescent, then C<virt-tar> will usually " -"work, but the only way to guarantee consistent results is if the virtual " -"machine is shut down." +"C<virt-list-filesystems> is a command line tool to list the filesystems that " +"are contained in a virtual machine or disk image." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:79 +#: ../tools/virt-list-filesystems.pl:49 msgid "" -"C<virt-tar> is a general purpose archive tool for downloading and uploading " -"parts of a guest filesystem. There are many possibilities: making backups, " -"uploading data files, snooping on guest activity, fixing or customizing " -"guests, etc." +"C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> " +"functionality. For more complex cases you should look at the " +"L<guestfish(1)> tool." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:84 +#: ../tools/virt-list-filesystems.pl:112 msgid "" -"If you want to just view a single file, use L<virt-cat(1)>. If you just " -"want to edit a single file, use L<virt-edit(1)>. For more complex cases you " -"should look at the L<guestfish(1)> tool." +"With this option, C<virt-list-filesystems> displays the type of each " +"filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)" +msgstr "" + +#. type: =item +#: ../tools/virt-list-filesystems.pl:119 +msgid "B<-a>" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:88 +#: ../tools/virt-list-filesystems.pl:123 msgid "" -"There are two modes of operation: I<-x> (eXtract) downloads a directory and " -"its contents (recursively) from the virtual machine into a local tarball. " -"I<-u> uploads from a local tarball, unpacking it into a directory inside the " -"virtual machine. You cannot use these two options together." +"Normally we only show mountable filesystems. If this option is given then " +"swap devices are shown too." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:94 +#: ../tools/virt-list-filesystems.pl:197 msgid "" -"In addition, you may need to use the I<-z> (gZip) option to enable " -"compression. When uploading, you have to specify I<-z> if the upload file " -"is compressed because virt-tar won't detect this on its own." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, " +"L<virt-filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, " +"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:98 -msgid "" -"C<virt-tar> can only handle tar (optionally gzipped) format tarballs. For " -"example it cannot do PKZip files or bzip2 compression. If you want that " -"then you'll have to rebuild the tarballs yourself. (This is a limitation of " -"the L<libguestfs(3)> API)." +#: ../tools/virt-list-filesystems.pl:214 ../tools/virt-tar.pl:317 +msgid "Copyright (C) 2009 Red Hat Inc." msgstr "" -#. type: =item -#: ../tools/virt-tar.pl:156 -msgid "B<-x> | B<--extract> | B<--download>" +#. type: textblock +#: ../tools/virt-list-partitions.pl:32 +msgid "virt-list-partitions - List partitions in a virtual machine or disk image" msgstr "" -#. type: =item -#: ../tools/virt-tar.pl:158 -msgid "B<-u> | B<--upload>" +#. type: verbatim +#: ../tools/virt-list-partitions.pl:36 +#, no-wrap +msgid "" +" virt-list-partitions [--options] domname\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-list-partitions.pl:38 +#, no-wrap +msgid "" +" virt-list-partitions [--options] disk.img [disk.img ...]\n" +"\n" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:160 +#: ../tools/virt-list-partitions.pl:45 msgid "" -"Use I<-x> to extract (download) a directory from a virtual machine to a " -"local tarball." +"C<virt-list-partitions> is a command line tool to list the partitions that " +"are contained in a virtual machine or disk image. It is mainly useful as a " +"first step to using L<virt-resize(1)>." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:163 +#: ../tools/virt-list-partitions.pl:50 msgid "" -"Use I<-u> to upload and unpack from a local tarball into a virtual machine. " -"Please read the L</WARNING> section above before using this option." +"C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> " +"functionality. For more complex cases you should look at the " +"L<guestfish(1)> tool." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:167 -msgid "You must specify exactly one of these options." +#: ../tools/virt-list-partitions.pl:113 +msgid "Show sizes in human-readable form (eg. \"1G\")." +msgstr "" + +#. type: textblock +#: ../tools/virt-list-partitions.pl:123 +msgid "" +"With this option, C<virt-list-partitions> displays the type and size of each " +"partition too (where \"type\" means C<ext3>, C<pv> etc.)" msgstr "" #. type: =item -#: ../tools/virt-tar.pl:173 -msgid "B<-z> | B<--gzip>" +#: ../tools/virt-list-partitions.pl:130 +msgid "B<-t>" +msgstr "" + +#. type: =item +#: ../tools/virt-list-partitions.pl:132 +msgid "B<--total>" msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:175 -msgid "Specify that the input or output tarball is gzip-compressed." +#: ../tools/virt-list-partitions.pl:134 +msgid "Display the total size of each block device (as a separate row or rows)." msgstr "" #. type: textblock -#: ../tools/virt-tar.pl:288 +#: ../tools/virt-list-partitions.pl:267 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " -"L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " -"L<virt-tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, " -"L<Sys::Virt(3)>, L<http://libguestfs.org/>." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, " +"L<virt-list-filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, " +"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: textblock +#: ../tools/virt-list-partitions.pl:283 +msgid "Copyright (C) 2009-2010 Red Hat Inc." msgstr "" #. type: textblock @@ -30996,6 +36184,13 @@ msgid "" "L<guestfs(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>." msgstr "" +#. type: textblock +#: ../tools/virt-make-fs.pl:555 ../tools/virt-win-reg.pl:763 +msgid "" +"When reporting bugs, please enable debugging and capture the I<complete> " +"output:" +msgstr "" + #. type: verbatim #: ../tools/virt-make-fs.pl:558 #, no-wrap @@ -31013,78 +36208,853 @@ msgid "" msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:32 -msgid "virt-list-partitions - List partitions in a virtual machine or disk image" +#: ../tools/virt-tar.pl:33 +msgid "virt-tar - Extract or upload files to a virtual machine" msgstr "" #. type: verbatim -#: ../tools/virt-list-partitions.pl:36 +#: ../tools/virt-tar.pl:37 #, no-wrap msgid "" -" virt-list-partitions [--options] domname\n" +" virt-tar [--options] -x domname directory tarball\n" "\n" msgstr "" #. type: verbatim -#: ../tools/virt-list-partitions.pl:38 +#: ../tools/virt-tar.pl:39 #, no-wrap msgid "" -" virt-list-partitions [--options] disk.img [disk.img ...]\n" +" virt-tar [--options] -u domname tarball directory\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:41 +#, no-wrap +msgid "" +" virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:43 +#, no-wrap +msgid "" +" virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n" "\n" msgstr "" +#. type: =head2 +#: ../tools/virt-tar.pl:45 ../tools/virt-win-reg.pl:88 +msgid "NOTE" +msgstr "" + #. type: textblock -#: ../tools/virt-list-partitions.pl:45 +#: ../tools/virt-tar.pl:47 msgid "" -"C<virt-list-partitions> is a command line tool to list the partitions that " -"are contained in a virtual machine or disk image. It is mainly useful as a " -"first step to using L<virt-resize(1)>." +"This tool is obsolete. Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, " +"L<virt-tar-in(1)>, L<virt-tar-out(1)> as replacements." msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:50 +#: ../tools/virt-tar.pl:52 +msgid "Download C</home> from the VM into a local tarball:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:54 +#, no-wrap msgid "" -"C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> " -"functionality. For more complex cases you should look at the " -"L<guestfish(1)> tool." +" virt-tar -x domname /home home.tar\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:56 +#, no-wrap +msgid "" +" virt-tar -zx domname /home home.tar.gz\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:58 +msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:60 +#, no-wrap +msgid "" +" virt-tar -u domname uploadstuff.tar /tmp\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-tar.pl:62 +#, no-wrap +msgid "" +" virt-tar -zu domname uploadstuff.tar.gz /tmp\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:66 +msgid "" +"You must I<not> use C<virt-tar> with the I<-u> option (upload) on live " +"virtual machines. If you do this, you risk disk corruption in the VM. " +"C<virt-tar> tries to stop you from doing this, but doesn't catch all cases." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:71 +msgid "" +"You can use I<-x> (extract) on live virtual machines, but you might get " +"inconsistent results or errors if there is filesystem activity inside the " +"VM. If the live VM is synched and quiescent, then C<virt-tar> will usually " +"work, but the only way to guarantee consistent results is if the virtual " +"machine is shut down." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:79 +msgid "" +"C<virt-tar> is a general purpose archive tool for downloading and uploading " +"parts of a guest filesystem. There are many possibilities: making backups, " +"uploading data files, snooping on guest activity, fixing or customizing " +"guests, etc." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:84 +msgid "" +"If you want to just view a single file, use L<virt-cat(1)>. If you just " +"want to edit a single file, use L<virt-edit(1)>. For more complex cases you " +"should look at the L<guestfish(1)> tool." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:88 +msgid "" +"There are two modes of operation: I<-x> (eXtract) downloads a directory and " +"its contents (recursively) from the virtual machine into a local tarball. " +"I<-u> uploads from a local tarball, unpacking it into a directory inside the " +"virtual machine. You cannot use these two options together." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:94 +msgid "" +"In addition, you may need to use the I<-z> (gZip) option to enable " +"compression. When uploading, you have to specify I<-z> if the upload file " +"is compressed because virt-tar won't detect this on its own." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:98 +msgid "" +"C<virt-tar> can only handle tar (optionally gzipped) format tarballs. For " +"example it cannot do PKZip files or bzip2 compression. If you want that " +"then you'll have to rebuild the tarballs yourself. (This is a limitation of " +"the L<libguestfs(3)> API)." msgstr "" #. type: =item -#: ../tools/virt-list-partitions.pl:107 -msgid "B<-h> | B<--human-readable>" +#: ../tools/virt-tar.pl:160 +msgid "B<--extract>" +msgstr "" + +#. type: =item +#: ../tools/virt-tar.pl:162 +msgid "B<--download>" +msgstr "" + +#. type: =item +#: ../tools/virt-tar.pl:164 +msgid "B<-u>" +msgstr "" + +#. type: =item +#: ../tools/virt-tar.pl:166 +msgid "B<--upload>" msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:109 -msgid "Show sizes in human-readable form (eg. \"1G\")." +#: ../tools/virt-tar.pl:168 +msgid "" +"Use I<-x> to extract (download) a directory from a virtual machine to a " +"local tarball." msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:117 +#: ../tools/virt-tar.pl:171 msgid "" -"With this option, C<virt-list-partitions> displays the type and size of each " -"partition too (where \"type\" means C<ext3>, C<pv> etc.)" +"Use I<-u> to upload and unpack from a local tarball into a virtual machine. " +"Please read the L</WARNING> section above before using this option." +msgstr "" + +#. type: textblock +#: ../tools/virt-tar.pl:175 +msgid "You must specify exactly one of these options." +msgstr "" + +#. type: =item +#: ../tools/virt-tar.pl:181 +msgid "B<-z>" msgstr "" #. type: =item -#: ../tools/virt-list-partitions.pl:124 -msgid "B<-t> | B<--total>" +#: ../tools/virt-tar.pl:183 +msgid "B<--gzip>" msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:126 -msgid "Display the total size of each block device (as a separate row or rows)." +#: ../tools/virt-tar.pl:185 +msgid "Specify that the input or output tarball is gzip-compressed." msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:259 +#: ../tools/virt-tar.pl:298 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, " -"L<virt-list-filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, " -"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " +"L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " +"L<virt-tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, " +"L<Sys::Virt(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../tools/virt-list-partitions.pl:275 -msgid "Copyright (C) 2009-2010 Red Hat Inc." +#: ../tools/virt-win-reg.pl:37 +msgid "" +"virt-win-reg - Export and merge Windows Registry entries from a Windows " +"guest" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:41 +#, no-wrap +msgid "" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:43 +#, no-wrap +msgid "" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:45 +#, no-wrap +msgid "" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:47 +#, no-wrap +msgid "" +" virt-win-reg --merge domname [input.reg ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:49 +#, no-wrap +msgid "" +" virt-win-reg [--options] disk.img ... # instead of domname\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:53 +msgid "" +"You must I<not> use C<virt-win-reg> with the I<--merge> option on live " +"virtual machines. If you do this, you I<will> get irreversible disk " +"corruption in the VM. C<virt-win-reg> tries to stop you from doing this, " +"but doesn't catch all cases." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:58 +msgid "" +"Modifying the Windows Registry is an inherently risky operation. The format " +"is deliberately obscure and undocumented, and Registry changes can leave the " +"system unbootable. Therefore when using the I<--merge> option, make sure " +"you have a reliable backup first." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:65 +msgid "" +"This program can export and merge Windows Registry entries from a Windows " +"guest." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:68 +msgid "" +"The first parameter is the libvirt guest name or the raw disk image of a " +"Windows guest." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:71 +msgid "" +"If I<--merge> is I<not> specified, then the chosen registry key is " +"displayed/exported (recursively). For example:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:74 +#, no-wrap +msgid "" +" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:76 +msgid "You can also display single values from within registry keys, for example:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:79 +#, no-wrap +msgid "" +" $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n" +" $ virt-win-reg Windows7 $cvkey ProductName\n" +" Windows 7 Enterprise\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:83 +msgid "" +"With I<--merge>, you can merge a textual regedit file into the Windows " +"Registry:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:86 +#, no-wrap +msgid "" +" $ virt-win-reg --merge Windows7 changes.reg\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:90 +msgid "" +"This program is only meant for simple access to the registry. If you want " +"to do complicated things with the registry, we suggest you download the " +"Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> " +"and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or " +"L<hivexregedit(1)>." +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:159 +msgid "B<--merge>" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:161 +msgid "" +"In merge mode, this merges a textual regedit file into the Windows Registry " +"of the virtual machine. If this flag is I<not> given then virt-win-reg " +"displays or exports Registry entries instead." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:165 +msgid "" +"Note that I<--merge> is I<unsafe> to use on live virtual machines, and will " +"result in disk corruption. However exporting (without this flag) is always " +"safe." +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:173 +msgid "B<--encoding> UTF-16LE|ASCII" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:175 +msgid "" +"When merging (only), you may need to specify the encoding for strings to be " +"used in the hive file. This is explained in detail in " +"L<Win::Hivex::Regedit(3)/ENCODING STRINGS>." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:179 +msgid "" +"The default is to use UTF-16LE, which should work with recent versions of " +"Windows." +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:186 +msgid "B<--unsafe-printable-strings>" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:188 +msgid "" +"When exporting (only), assume strings are UTF-16LE and print them as strings " +"instead of hex sequences. Remove the final zero codepoint from strings if " +"present." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:192 +msgid "" +"This is unsafe and does not preserve the fidelity of strings in the original " +"Registry for various reasons:" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:199 +msgid "" +"Assumes the original encoding is UTF-16LE. ASCII strings and strings in " +"other encodings will be corrupted by this transformation." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:204 +msgid "" +"Assumes that everything which has type 1 or 2 is really a string and that " +"everything else is not a string, but the type field in real Registries is " +"not reliable." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:210 +msgid "" +"Loses information about whether a zero codepoint followed the string in the " +"Registry or not." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:215 +msgid "" +"This all happens because the Registry itself contains no information about " +"how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:219 +msgid "" +"You should only use this option for quick hacking and debugging of the " +"Registry contents, and I<never> use it if the output is going to be passed " +"into another program or stored in another Registry." +msgstr "" + +#. type: =head1 +#: ../tools/virt-win-reg.pl:556 +msgid "SUPPORTED SYSTEMS" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:558 +msgid "" +"The program currently supports Windows NT-derived guests starting with " +"Windows XP through to at least Windows 7." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:561 +msgid "The following Registry keys are supported:" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:565 +msgid "C<HKEY_LOCAL_MACHINE\\SAM>" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:567 +msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:569 +msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:571 +msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:573 +msgid "C<HKEY_USERS\\.DEFAULT>" +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:575 +msgid "C<HKEY_USERS\\I<SID>>" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:577 +msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)." +msgstr "" + +#. type: =item +#: ../tools/virt-win-reg.pl:579 +msgid "C<HKEY_USERS\\I<username>>" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:581 +msgid "where I<username> is a local user name (this is a libguestfs extension)." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:585 +msgid "" +"You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for " +"C<HKEY_USERS>." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:588 +msgid "" +"The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not " +"supported (there is no \"current user\")." +msgstr "" + +#. type: =head1 +#: ../tools/virt-win-reg.pl:591 +msgid "ENCODING" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:593 +msgid "" +"C<virt-win-reg> expects that regedit files have already been reencoded in " +"the local encoding. Usually on Linux hosts, this means UTF-8 with " +"Unix-style line endings. Since Windows regedit files are often in UTF-16LE " +"with Windows-style line endings, you may need to reencode the whole file " +"before or after processing." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:599 +msgid "" +"To reencode a file from Windows format to Linux (before processing it with " +"the I<--merge> option), you would do something like this:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:602 +#, no-wrap +msgid "" +" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:604 +msgid "" +"To go in the opposite direction, after exporting and before sending the file " +"to a Windows user, do something like this:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:607 +#, no-wrap +msgid "" +" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:609 +msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:611 +msgid "" +"If you are unsure about the current encoding, use the L<file(1)> command. " +"Recent versions of Windows regedit.exe produce a UTF-16LE file with " +"Windows-style (CRLF) line endings, like this:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:615 +#, no-wrap +msgid "" +" $ file software.reg\n" +" software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n" +" with CRLF line terminators\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:619 +msgid "This file would need conversion before you could I<--merge> it." +msgstr "" + +#. type: =head1 +#: ../tools/virt-win-reg.pl:621 +msgid "CurrentControlSet etc." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:623 +msgid "" +"Registry keys like C<CurrentControlSet> don't really exist in the Windows " +"Registry at the level of the hive file, and therefore you cannot modify " +"these." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:627 +msgid "" +"C<CurrentControlSet> is usually an alias for C<ControlSet001>. In some " +"circumstances it might refer to another control set. The way to find out is " +"to look at the C<HKLM\\SYSTEM\\Select> key:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:631 +#, no-wrap +msgid "" +" # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n" +" [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n" +" \"Current\"=dword:00000001\n" +" \"Default\"=dword:00000001\n" +" \"Failed\"=dword:00000000\n" +" \"LastKnownGood\"=dword:00000002\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:638 +msgid "\"Current\" is the one which Windows will choose when it boots." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:640 +msgid "Similarly, other C<Current...> keys in the path may need to be replaced." +msgstr "" + +#. type: =head1 +#: ../tools/virt-win-reg.pl:643 +msgid "WINDOWS TIPS" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:645 +msgid "" +"Note that some of these tips modify the guest disk image. The guest I<must> " +"be shut off, else you will get disk corruption." +msgstr "" + +#. type: =head2 +#: ../tools/virt-win-reg.pl:648 +msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:650 +msgid "" +"Prepare a DOS batch script, VBScript or executable. Upload this using " +"L<guestfish(1)>. For this example the script is called C<test.bat> and it " +"is uploaded into C<C:\\>:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:654 +#, no-wrap +msgid "" +" guestfish -i -d WindowsGuest upload test.bat /test.bat\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:656 +msgid "Prepare a regedit file containing the registry change:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:658 +#, no-wrap +msgid "" +" cat > test.reg <<'EOF'\n" +" [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n" +" \"Test\"=\"c:\\\\test.bat\"\n" +" EOF\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:663 +msgid "" +"In this example we use the key C<RunOnce> which means that the script will " +"run precisely once when the first user logs in. If you want it to run every " +"time a user logs in, replace C<RunOnce> with C<Run>." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:667 +msgid "Now update the registry:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:669 +#, no-wrap +msgid "" +" virt-win-reg --merge WindowsGuest test.reg\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../tools/virt-win-reg.pl:671 +msgid "INSTALLING A SERVICE" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:673 +msgid "" +"This section assumes you are familiar with Windows services, and you either " +"have a program which handles the Windows Service Control Protocol directly " +"or you want to run any program using a service wrapper like SrvAny or the " +"free RHSrvAny." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:678 +msgid "" +"First upload the program and optionally the service wrapper. In this case " +"the test program is called C<test.exe> and we are using the RHSrvAny " +"wrapper:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:682 +#, no-wrap +msgid "" +" guestfish -i -d WindowsGuest <<EOF\n" +" upload rhsrvany.exe /rhsrvany.exe\n" +" upload test.exe /test.exe\n" +" EOF\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:687 +msgid "" +"Prepare a regedit file containing the registry changes. In this example, " +"the first registry change is needed for the service itself or the service " +"wrapper (if used). The second registry change is only needed because I am " +"using the RHSrvAny service wrapper." +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:692 +#, no-wrap +msgid "" +" cat > service.reg <<'EOF'\n" +" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n" +" \"Type\"=dword:00000010\n" +" \"Start\"=dword:00000002\n" +" \"ErrorControl\"=dword:00000001\n" +" \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n" +" \"DisplayName\"=\"RHSrvAny\"\n" +" \"ObjectName\"=\"NetworkService\"\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:701 +#, no-wrap +msgid "" +" [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n" +" \"CommandLine\"=\"c:\\\\test.exe\"\n" +" \"PWD\"=\"c:\\\\Temp\"\n" +" EOF\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:712 +msgid "" +"For use of C<ControlSet001> see the section above in this manual page. You " +"may need to adjust this according to the control set that is in use by the " +"guest." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:718 +msgid "" +"C<\"ObjectName\"> controls the privileges that the service will have. An " +"alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most " +"privileged account." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:724 +msgid "" +"For the meaning of the magic numbers, see this Microsoft KB article: " +"L<http://support.microsoft.com/kb/103000>." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:729 +msgid "Update the registry:" +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:731 +#, no-wrap +msgid "" +" virt-win-reg --merge WindowsGuest service.reg\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:735 +msgid "" +"Be careful when passing parameters containing C<\\> (backslash) in the " +"shell. Usually you will have to use 'single quotes' or double backslashes " +"(but not both) to protect them from the shell." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:739 +msgid "Paths and value names are case-insensitive." +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:748 +msgid "" +"L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, " +"L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, " +"L<Sys::Guestfs::Lib(3)>, L<Win::Hivex(3)>, L<Win::Hivex::Regedit(3)>, " +"L<Sys::Virt(3)>, L<http://libguestfs.org/>." +msgstr "" + +#. type: verbatim +#: ../tools/virt-win-reg.pl:766 +#, no-wrap +msgid "" +" export LIBGUESTFS_DEBUG=1\n" +" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" +"\n" +msgstr "" + +#. type: textblock +#: ../tools/virt-win-reg.pl:769 +msgid "" +"Attach /tmp/virt-win-reg.log to a new bug report at " +"L<https://bugzilla.redhat.com/>" msgstr "" |