diff options
| author | Richard W.M. Jones <rjones@redhat.com> | 2010-09-26 22:41:24 +0100 |
|---|---|---|
| committer | Richard W.M. Jones <rjones@redhat.com> | 2010-09-26 22:41:24 +0100 |
| commit | a50cdb512c31efd75fe09ff6646b02a9a23faa02 (patch) | |
| tree | 89cd375b686a3db28bc8b4bce4ac828fa126d81e /po-docs | |
| parent | eeaab2ba84441a96977281a4472b1bccb9ec80a9 (diff) | |
| download | libguestfs-a50cdb512c31efd75fe09ff6646b02a9a23faa02.tar.gz libguestfs-a50cdb512c31efd75fe09ff6646b02a9a23faa02.tar.xz libguestfs-a50cdb512c31efd75fe09ff6646b02a9a23faa02.zip | |
Version 1.5.20.1.5.20
Diffstat (limited to 'po-docs')
| -rw-r--r-- | po-docs/ja.po | 5341 | ||||
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 4958 |
2 files changed, 5298 insertions, 5001 deletions
diff --git a/po-docs/ja.po b/po-docs/ja.po index 52fb7765..c1c42ba3 100644 --- a/po-docs/ja.po +++ b/po-docs/ja.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2010-09-21 22:15+0200\n" +"POT-Creation-Date: 2010-09-26 22:40+0200\n" "PO-Revision-Date: 2010-09-02 14:46+0100\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -19,24 +19,22 @@ msgstr "" # type: =encoding #: ../src/guestfs.pod:1 ../fish/guestfish.pod:1 #: ../test-tool/libguestfs-test-tool.pod:1 ../fuse/guestmount.pod:1 -#: ../inspector/virt-inspector.pl:36 ../tools/virt-cat.pl:30 -#: ../tools/virt-df.pl:32 ../tools/virt-edit.pl:31 -#: ../tools/virt-list-filesystems.pl:28 ../tools/virt-list-partitions.pl:28 -#: ../tools/virt-ls.pl:31 ../tools/virt-make-fs.pl:33 -#: ../tools/virt-rescue.pl:29 ../tools/virt-resize.pl:38 -#: ../tools/virt-tar.pl:30 ../tools/virt-win-reg.pl:34 +#: ../inspector/virt-inspector.pl:36 ../tools/virt-edit.pl:31 +#: ../tools/virt-win-reg.pl:34 ../tools/virt-df.pl:32 ../tools/virt-ls.pl:31 +#: ../tools/virt-resize.pl:38 ../tools/virt-list-filesystems.pl:28 +#: ../tools/virt-cat.pl:30 ../tools/virt-tar.pl:30 ../tools/virt-rescue.pl:29 +#: ../tools/virt-make-fs.pl:33 ../tools/virt-list-partitions.pl:28 msgid "utf8" msgstr "" # type: =head1 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 -#: ../inspector/virt-inspector.pl:38 ../tools/virt-cat.pl:32 -#: ../tools/virt-df.pl:34 ../tools/virt-edit.pl:33 -#: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 -#: ../tools/virt-ls.pl:33 ../tools/virt-make-fs.pl:35 -#: ../tools/virt-rescue.pl:31 ../tools/virt-resize.pl:40 -#: ../tools/virt-tar.pl:32 ../tools/virt-win-reg.pl:36 +#: ../inspector/virt-inspector.pl:38 ../tools/virt-edit.pl:33 +#: ../tools/virt-win-reg.pl:36 ../tools/virt-df.pl:34 ../tools/virt-ls.pl:33 +#: ../tools/virt-resize.pl:40 ../tools/virt-list-filesystems.pl:30 +#: ../tools/virt-cat.pl:32 ../tools/virt-tar.pl:32 ../tools/virt-rescue.pl:31 +#: ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30 msgid "NAME" msgstr "名前" @@ -48,12 +46,11 @@ msgstr "" # type: =head1 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7 -#: ../inspector/virt-inspector.pl:42 ../tools/virt-cat.pl:36 -#: ../tools/virt-df.pl:38 ../tools/virt-edit.pl:37 -#: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34 -#: ../tools/virt-ls.pl:37 ../tools/virt-make-fs.pl:39 -#: ../tools/virt-rescue.pl:35 ../tools/virt-resize.pl:44 -#: ../tools/virt-tar.pl:36 ../tools/virt-win-reg.pl:40 +#: ../inspector/virt-inspector.pl:42 ../tools/virt-edit.pl:37 +#: ../tools/virt-win-reg.pl:40 ../tools/virt-df.pl:38 ../tools/virt-ls.pl:37 +#: ../tools/virt-resize.pl:44 ../tools/virt-list-filesystems.pl:34 +#: ../tools/virt-cat.pl:36 ../tools/virt-tar.pl:36 ../tools/virt-rescue.pl:35 +#: ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34 msgid "SYNOPSIS" msgstr "" @@ -91,14 +88,13 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:24 ../fish/guestfish.pod:115 +#: ../src/guestfs.pod:24 ../fish/guestfish.pod:30 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:16 -#: ../inspector/virt-inspector.pl:48 ../tools/virt-cat.pl:42 -#: ../tools/virt-df.pl:46 ../tools/virt-edit.pl:51 -#: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40 -#: ../tools/virt-ls.pl:43 ../tools/virt-make-fs.pl:47 -#: ../tools/virt-rescue.pl:51 ../tools/virt-resize.pl:50 -#: ../tools/virt-tar.pl:73 ../tools/virt-win-reg.pl:64 +#: ../inspector/virt-inspector.pl:48 ../tools/virt-edit.pl:51 +#: ../tools/virt-win-reg.pl:64 ../tools/virt-df.pl:46 ../tools/virt-ls.pl:43 +#: ../tools/virt-resize.pl:50 ../tools/virt-list-filesystems.pl:40 +#: ../tools/virt-cat.pl:42 ../tools/virt-tar.pl:73 ../tools/virt-rescue.pl:51 +#: ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40 msgid "DESCRIPTION" msgstr "" @@ -748,13 +744,13 @@ msgstr "" # type: =item #: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355 #: ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368 -#: ../src/guestfs.pod:373 ../src/guestfs.pod:1223 ../src/guestfs.pod:1228 -#: ../src/guestfs.pod:1232 ../src/guestfs.pod:1334 ../src/guestfs.pod:1338 -#: ../src/guestfs.pod:1342 ../src/guestfs.pod:1347 ../src/guestfs.pod:1355 -#: ../src/guestfs.pod:1374 ../src/guestfs.pod:1382 ../src/guestfs.pod:1612 -#: ../src/guestfs.pod:1618 ../src/guestfs.pod:1623 ../src/guestfs.pod:1629 -#: ../src/guestfs.pod:1736 ../src/guestfs.pod:1740 ../src/guestfs.pod:1744 -#: ../src/guestfs.pod:1748 ../src/guestfs-actions.pod:14 +#: ../src/guestfs.pod:373 ../src/guestfs.pod:1254 ../src/guestfs.pod:1259 +#: ../src/guestfs.pod:1263 ../src/guestfs.pod:1365 ../src/guestfs.pod:1369 +#: ../src/guestfs.pod:1373 ../src/guestfs.pod:1378 ../src/guestfs.pod:1386 +#: ../src/guestfs.pod:1405 ../src/guestfs.pod:1413 ../src/guestfs.pod:1643 +#: ../src/guestfs.pod:1649 ../src/guestfs.pod:1654 ../src/guestfs.pod:1660 +#: ../src/guestfs.pod:1767 ../src/guestfs.pod:1771 ../src/guestfs.pod:1775 +#: ../src/guestfs.pod:1779 ../src/guestfs-actions.pod:14 #: ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372 #: ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387 #: ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1285 @@ -766,8 +762,8 @@ msgstr "" #: ../src/guestfs-actions.pod:1458 ../src/guestfs-actions.pod:1463 #: ../src/guestfs-actions.pod:1468 ../src/guestfs-actions.pod:1520 #: ../src/guestfs-actions.pod:1524 ../src/guestfs-actions.pod:1529 -#: ../fish/guestfish.pod:316 ../fish/guestfish.pod:320 -#: ../fish/guestfish.pod:324 ../fish/guestfish.pod:328 +#: ../fish/guestfish.pod:338 ../fish/guestfish.pod:342 +#: ../fish/guestfish.pod:346 ../fish/guestfish.pod:350 #: ../fish/guestfish-actions.pod:15 ../fish/guestfish-actions.pod:22 #: ../fish/guestfish-actions.pod:306 ../fish/guestfish-actions.pod:314 #: ../fish/guestfish-actions.pod:321 ../fish/guestfish-actions.pod:328 @@ -998,7 +994,7 @@ msgid "For more information about umask, see L<umask(2)>." msgstr "" # type: =head1 -#: ../src/guestfs.pod:459 ../fish/guestfish.pod:566 +#: ../src/guestfs.pod:459 ../fish/guestfish.pod:589 msgid "ENCRYPTED DISKS" msgstr "" @@ -1568,13 +1564,76 @@ msgid "" "sent back from the daemon." msgstr "" -# type: =head2 +# type: =item +#: ../src/guestfs.pod:750 +msgid "Ambiguity between devices and paths" +msgstr "" + +# type: textblock #: ../src/guestfs.pod:752 +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 +#: ../src/guestfs.pod:757 +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 +#: ../src/guestfs.pod:763 +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 +#: ../src/guestfs.pod:769 +#, no-wrap +msgid "" +" type path = Path of string | Device of int | Partition of int * int\n" +"\n" +msgstr "" + +# type: textblock +#: ../src/guestfs.pod:771 +msgid "which would allow you to pass arguments like:" +msgstr "" + +# type: verbatim +#: ../src/guestfs.pod:773 +#, 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 +#: ../src/guestfs.pod:778 +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:783 msgid "PROTOCOL LIMITS" msgstr "" # type: textblock -#: ../src/guestfs.pod:754 +#: ../src/guestfs.pod:785 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 " @@ -1585,7 +1644,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:762 +#: ../src/guestfs.pod:793 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 " @@ -1594,7 +1653,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:768 +#: ../src/guestfs.pod:799 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> " @@ -1602,26 +1661,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:772 +#: ../src/guestfs.pod:803 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" # type: =head2 -#: ../src/guestfs.pod:775 +#: ../src/guestfs.pod:806 msgid "KEYS AND PASSPHRASES" msgstr "" # type: textblock -#: ../src/guestfs.pod:777 +#: ../src/guestfs.pod:808 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" # type: textblock -#: ../src/guestfs.pod:780 +#: ../src/guestfs.pod:811 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 " @@ -1630,7 +1689,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:785 +#: ../src/guestfs.pod:816 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, " @@ -1638,17 +1697,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:790 +#: ../src/guestfs.pod:821 msgid "CONNECTION MANAGEMENT" msgstr "" # type: =head2 -#: ../src/guestfs.pod:792 +#: ../src/guestfs.pod:823 msgid "guestfs_h *" msgstr "" # type: textblock -#: ../src/guestfs.pod:794 +#: ../src/guestfs.pod:825 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 " @@ -1656,19 +1715,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:798 +#: ../src/guestfs.pod:829 msgid "" "For information on using multiple handles and threads, see the section L</" "MULTIPLE HANDLES AND MULTIPLE THREADS> below." msgstr "" # type: =head2 -#: ../src/guestfs.pod:801 +#: ../src/guestfs.pod:832 msgid "guestfs_create" msgstr "" # type: verbatim -#: ../src/guestfs.pod:803 +#: ../src/guestfs.pod:834 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -1676,41 +1735,41 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:805 +#: ../src/guestfs.pod:836 msgid "Create a connection handle." msgstr "" # type: textblock -#: ../src/guestfs.pod:807 +#: ../src/guestfs.pod:838 msgid "You have to call L</guestfs_add_drive> on the handle at least once." msgstr "" # type: textblock -#: ../src/guestfs.pod:809 +#: ../src/guestfs.pod:840 msgid "" "This function returns a non-NULL pointer to a handle on success or NULL on " "error." msgstr "" # type: textblock -#: ../src/guestfs.pod:812 +#: ../src/guestfs.pod:843 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" # type: textblock -#: ../src/guestfs.pod:814 +#: ../src/guestfs.pod:845 msgid "" "You may also want to configure error handling for the handle. See L</ERROR " "HANDLING> section below." msgstr "" # type: =head2 -#: ../src/guestfs.pod:817 +#: ../src/guestfs.pod:848 msgid "guestfs_close" msgstr "" # type: verbatim -#: ../src/guestfs.pod:819 +#: ../src/guestfs.pod:850 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -1718,17 +1777,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:821 +#: ../src/guestfs.pod:852 msgid "This closes the connection handle and frees up all resources used." msgstr "" # type: =head1 -#: ../src/guestfs.pod:823 +#: ../src/guestfs.pod:854 msgid "ERROR HANDLING" msgstr "" # type: textblock -#: ../src/guestfs.pod:825 +#: ../src/guestfs.pod:856 msgid "" "The convention in all functions that return C<int> is that they return C<-1> " "to indicate an error. You can get additional information on errors by " @@ -1737,12 +1796,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:830 +#: ../src/guestfs.pod:861 msgid "The default error handler prints the information string to C<stderr>." msgstr "" # type: textblock -#: ../src/guestfs.pod:832 +#: ../src/guestfs.pod:863 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</" @@ -1750,12 +1809,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:836 +#: ../src/guestfs.pod:867 msgid "guestfs_last_error" msgstr "" # type: verbatim -#: ../src/guestfs.pod:838 +#: ../src/guestfs.pod:869 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -1763,21 +1822,21 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:840 +#: ../src/guestfs.pod:871 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:844 +#: ../src/guestfs.pod:875 msgid "" "The lifetime of the returned string is until the next error occurs, or L</" "guestfs_close> is called." msgstr "" # type: textblock -#: ../src/guestfs.pod:847 +#: ../src/guestfs.pod:878 msgid "" "The error string is not localized (ie. is always in English), because this " "makes searching for error messages in search engines give the largest number " @@ -1785,12 +1844,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:851 +#: ../src/guestfs.pod:882 msgid "guestfs_set_error_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:853 +#: ../src/guestfs.pod:884 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -1803,7 +1862,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:860 +#: ../src/guestfs.pod:891 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 " @@ -1811,7 +1870,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:864 +#: ../src/guestfs.pod:895 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 " @@ -1819,22 +1878,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:868 +#: ../src/guestfs.pod:899 msgid "The default handler prints messages on C<stderr>." msgstr "" # type: textblock -#: ../src/guestfs.pod:870 +#: ../src/guestfs.pod:901 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" # type: =head2 -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:903 msgid "guestfs_get_error_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:874 +#: ../src/guestfs.pod:905 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -1843,17 +1902,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:877 +#: ../src/guestfs.pod:908 msgid "Returns the current error handler callback." msgstr "" # type: =head2 -#: ../src/guestfs.pod:879 +#: ../src/guestfs.pod:910 msgid "guestfs_set_out_of_memory_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:881 +#: ../src/guestfs.pod:912 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -1863,30 +1922,30 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:885 +#: ../src/guestfs.pod:916 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:888 +#: ../src/guestfs.pod:919 msgid "The default is to call L<abort(3)>." msgstr "" # type: textblock -#: ../src/guestfs.pod:890 +#: ../src/guestfs.pod:921 msgid "" "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" # type: =head2 -#: ../src/guestfs.pod:893 +#: ../src/guestfs.pod:924 msgid "guestfs_get_out_of_memory_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:895 +#: ../src/guestfs.pod:926 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -1894,31 +1953,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:897 +#: ../src/guestfs.pod:928 msgid "This returns the current out of memory handler." msgstr "" # type: =head1 -#: ../src/guestfs.pod:899 +#: ../src/guestfs.pod:930 msgid "PATH" msgstr "" # type: textblock -#: ../src/guestfs.pod:901 +#: ../src/guestfs.pod:932 msgid "" "Libguestfs needs a kernel and initrd.img, which it finds by looking along an " "internal path." msgstr "" # type: textblock -#: ../src/guestfs.pod:904 +#: ../src/guestfs.pod:935 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 -#: ../src/guestfs.pod:907 +#: ../src/guestfs.pod:938 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 " @@ -1929,17 +1988,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:914 +#: ../src/guestfs.pod:945 msgid "HIGH-LEVEL API ACTIONS" msgstr "" # type: =head2 -#: ../src/guestfs.pod:916 +#: ../src/guestfs.pod:947 msgid "ABI GUARANTEE" msgstr "" # type: textblock -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:949 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -1949,32 +2008,32 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:924 ../fish/guestfish.pod:796 +#: ../src/guestfs.pod:955 ../fish/guestfish.pod:819 msgid "@ACTIONS@" msgstr "" # type: =head1 -#: ../src/guestfs.pod:926 +#: ../src/guestfs.pod:957 msgid "STRUCTURES" msgstr "" # type: textblock -#: ../src/guestfs.pod:928 +#: ../src/guestfs.pod:959 msgid "@STRUCTS@" msgstr "" # type: =head1 -#: ../src/guestfs.pod:930 +#: ../src/guestfs.pod:961 msgid "AVAILABILITY" msgstr "" # type: =head2 -#: ../src/guestfs.pod:932 +#: ../src/guestfs.pod:963 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" # type: textblock -#: ../src/guestfs.pod:934 +#: ../src/guestfs.pod:965 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -1982,17 +2041,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:939 +#: ../src/guestfs.pod:970 msgid "@AVAILABILITY@" msgstr "" # type: =head2 -#: ../src/guestfs.pod:941 +#: ../src/guestfs.pod:972 msgid "GUESTFISH supported COMMAND" msgstr "" # type: textblock -#: ../src/guestfs.pod:943 +#: ../src/guestfs.pod:974 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 " @@ -2000,19 +2059,19 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:948 +#: ../src/guestfs.pod:979 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" # type: textblock -#: ../src/guestfs.pod:950 +#: ../src/guestfs.pod:981 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:953 +#: ../src/guestfs.pod:984 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -2020,12 +2079,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:955 +#: ../src/guestfs.pod:986 msgid "if L</guestfs_dd> is available." msgstr "" # type: textblock -#: ../src/guestfs.pod:957 +#: ../src/guestfs.pod:988 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 " @@ -2033,7 +2092,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:962 +#: ../src/guestfs.pod:993 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -2042,19 +2101,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:965 +#: ../src/guestfs.pod:996 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" # type: =head2 -#: ../src/guestfs.pod:968 +#: ../src/guestfs.pod:999 msgid "SINGLE CALLS AT RUN TIME" msgstr "" # type: textblock -#: ../src/guestfs.pod:970 +#: ../src/guestfs.pod:1001 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 " @@ -2064,7 +2123,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:977 +#: ../src/guestfs.pod:1008 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 " @@ -2072,7 +2131,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:981 +#: ../src/guestfs.pod:1012 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -2084,7 +2143,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:987 +#: ../src/guestfs.pod:1018 #, no-wrap msgid "" " main ()\n" @@ -2096,7 +2155,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:993 +#: ../src/guestfs.pod:1024 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -2111,7 +2170,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1002 +#: ../src/guestfs.pod:1033 #, no-wrap msgid "" " if (!has_function)\n" @@ -2130,7 +2189,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1015 +#: ../src/guestfs.pod:1046 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 " @@ -2138,7 +2197,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1020 +#: ../src/guestfs.pod:1051 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -2146,24 +2205,24 @@ msgid "" msgstr "" # type: =end -#: ../src/guestfs.pod:1022 ../src/guestfs.pod:1027 +#: ../src/guestfs.pod:1053 ../src/guestfs.pod:1058 msgid "html" msgstr "" # type: textblock -#: ../src/guestfs.pod:1024 +#: ../src/guestfs.pod:1055 msgid "" "<!-- old anchor for the next section --> <a name=" "\"state_machine_and_low_level_event_api\"/>" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1029 +#: ../src/guestfs.pod:1060 msgid "ARCHITECTURE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1031 +#: ../src/guestfs.pod:1062 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 " @@ -2171,7 +2230,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1035 +#: ../src/guestfs.pod:1066 #, no-wrap msgid "" " ___________________\n" @@ -2197,14 +2256,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1055 +#: ../src/guestfs.pod:1086 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L</guestfs_launch> function." msgstr "" # type: textblock -#: ../src/guestfs.pod:1058 +#: ../src/guestfs.pod:1089 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 " @@ -2216,7 +2275,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1067 +#: ../src/guestfs.pod:1098 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 " @@ -2227,17 +2286,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1074 +#: ../src/guestfs.pod:1105 msgid "STATE MACHINE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1076 +#: ../src/guestfs.pod:1107 msgid "libguestfs uses a state machine to model the child process:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1078 +#: ../src/guestfs.pod:1109 #, no-wrap msgid "" " |\n" @@ -2265,7 +2324,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1100 +#: ../src/guestfs.pod:1131 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), " @@ -2274,7 +2333,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1105 +#: ../src/guestfs.pod:1136 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 " @@ -2282,14 +2341,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1109 +#: ../src/guestfs.pod:1140 msgid "" "Configuration commands for qemu such as L</guestfs_add_drive> can only be " "issued when in the CONFIG state." msgstr "" # type: textblock -#: ../src/guestfs.pod:1112 +#: ../src/guestfs.pod:1143 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 " @@ -2298,7 +2357,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1118 +#: ../src/guestfs.pod:1149 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. " @@ -2308,7 +2367,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1124 +#: ../src/guestfs.pod:1155 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -2316,26 +2375,26 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1128 +#: ../src/guestfs.pod:1159 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1130 +#: ../src/guestfs.pod:1161 msgid "" "The child process generates events in some situations. Current events " "include: receiving a log message, the child process exits." msgstr "" # type: textblock -#: ../src/guestfs.pod:1133 +#: ../src/guestfs.pod:1164 msgid "" "Use the C<guestfs_set_*_callback> functions to set a callback for different " "types of events." msgstr "" # type: textblock -#: ../src/guestfs.pod:1136 +#: ../src/guestfs.pod:1167 msgid "" "Only I<one callback of each type> can be registered for each handle. " "Calling C<guestfs_set_*_callback> again overwrites the previous callback of " @@ -2344,12 +2403,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1141 +#: ../src/guestfs.pod:1172 msgid "guestfs_set_log_message_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1143 +#: ../src/guestfs.pod:1174 #, no-wrap msgid "" " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n" @@ -2361,31 +2420,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1149 +#: ../src/guestfs.pod:1180 msgid "" "The callback function C<cb> will be called whenever qemu or the guest writes " "anything to the console." msgstr "" # type: textblock -#: ../src/guestfs.pod:1152 +#: ../src/guestfs.pod:1183 msgid "Use this function to capture kernel messages and similar." msgstr "" # type: textblock -#: ../src/guestfs.pod:1154 +#: ../src/guestfs.pod:1185 msgid "" "Normally there is no log message handler, and log messages are just " "discarded." msgstr "" # type: =head2 -#: ../src/guestfs.pod:1157 +#: ../src/guestfs.pod:1188 msgid "guestfs_set_subprocess_quit_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1159 +#: ../src/guestfs.pod:1190 #, no-wrap msgid "" " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n" @@ -2396,7 +2455,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1164 +#: ../src/guestfs.pod:1195 msgid "" "The callback function C<cb> will be called when the child process quits, " "either asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -2404,12 +2463,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1169 +#: ../src/guestfs.pod:1200 msgid "guestfs_set_launch_done_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1171 +#: ../src/guestfs.pod:1202 #, no-wrap msgid "" " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n" @@ -2420,7 +2479,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1176 +#: ../src/guestfs.pod:1207 msgid "" "The callback function C<cb> will be called when the child process becomes " "ready first time after it has been launched. (This corresponds to a " @@ -2428,12 +2487,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1180 +#: ../src/guestfs.pod:1211 msgid "guestfs_set_close_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1182 +#: ../src/guestfs.pod:1213 #, no-wrap msgid "" " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n" @@ -2444,14 +2503,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1187 +#: ../src/guestfs.pod:1218 msgid "" "The callback function C<cb> will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" # type: textblock -#: ../src/guestfs.pod:1190 +#: ../src/guestfs.pod:1221 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 " @@ -2462,12 +2521,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1198 +#: ../src/guestfs.pod:1229 msgid "guestfs_set_progress_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1200 +#: ../src/guestfs.pod:1231 #, no-wrap msgid "" " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n" @@ -2480,7 +2539,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1207 +#: ../src/guestfs.pod:1238 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -2490,7 +2549,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1213 +#: ../src/guestfs.pod:1244 msgid "" "The callback receives two numbers: C<position> and C<total>. The units of " "C<total> are not defined, although for some operations C<total> may relate " @@ -2499,31 +2558,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1250 msgid "The only defined and stable parts of the API are:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1225 +#: ../src/guestfs.pod:1256 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:1230 +#: ../src/guestfs.pod:1261 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1234 +#: ../src/guestfs.pod:1265 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C<position> = C<total>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1237 +#: ../src/guestfs.pod:1268 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 " @@ -2531,7 +2590,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1243 +#: ../src/guestfs.pod:1274 msgid "" "The callback also receives the procedure number and serial number of the " "call. These are only useful for debugging protocol issues, and the callback " @@ -2540,12 +2599,12 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1248 +#: ../src/guestfs.pod:1279 msgid "PRIVATE DATA AREA" msgstr "" # type: textblock -#: ../src/guestfs.pod:1250 +#: ../src/guestfs.pod:1281 msgid "" "You can attach named pieces of private data to the libguestfs handle, and " "fetch them by name for the lifetime of the handle. This is called the " @@ -2553,12 +2612,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1254 +#: ../src/guestfs.pod:1285 msgid "To attach a named piece of data, use the following call:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1256 +#: ../src/guestfs.pod:1287 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -2566,7 +2625,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1258 +#: ../src/guestfs.pod:1289 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 name is " @@ -2574,7 +2633,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1262 +#: ../src/guestfs.pod:1293 msgid "" "You can use any C<key> you want, but names beginning with an underscore " "character are reserved for internal libguestfs purposes (for implementing " @@ -2583,12 +2642,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1267 +#: ../src/guestfs.pod:1298 msgid "To retrieve the pointer, use:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1300 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -2596,7 +2655,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1271 +#: ../src/guestfs.pod:1302 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 " @@ -2604,7 +2663,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1275 +#: ../src/guestfs.pod:1306 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 " @@ -2616,19 +2675,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1283 +#: ../src/guestfs.pod:1314 msgid "" "The private data area is implemented using a hash table, and should be " "reasonably efficient for moderate numbers of keys." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1286 +#: ../src/guestfs.pod:1317 msgid "BLOCK DEVICE NAMING" msgstr "" # type: textblock -#: ../src/guestfs.pod:1288 +#: ../src/guestfs.pod:1319 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 " @@ -2642,7 +2701,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1300 +#: ../src/guestfs.pod:1331 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 " @@ -2650,7 +2709,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1304 +#: ../src/guestfs.pod:1335 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 " @@ -2658,7 +2717,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1309 +#: ../src/guestfs.pod:1340 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 " @@ -2667,7 +2726,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1315 +#: ../src/guestfs.pod:1346 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 " @@ -2675,12 +2734,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1320 +#: ../src/guestfs.pod:1351 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" # type: textblock -#: ../src/guestfs.pod:1322 +#: ../src/guestfs.pod:1353 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 " @@ -2689,7 +2748,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1328 +#: ../src/guestfs.pod:1359 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</" @@ -2697,54 +2756,54 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1336 +#: ../src/guestfs.pod:1367 msgid "Is the string a parameter which is a device or partition name?" msgstr "" # type: textblock -#: ../src/guestfs.pod:1340 +#: ../src/guestfs.pod:1371 msgid "Does the string begin with C</dev/sd>?" msgstr "" # type: textblock -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1375 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 -#: ../src/guestfs.pod:1349 +#: ../src/guestfs.pod:1380 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1351 +#: ../src/guestfs.pod:1382 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1353 +#: ../src/guestfs.pod:1384 msgid "If that named device exists, use it. If not, continue." msgstr "" # type: textblock -#: ../src/guestfs.pod:1357 +#: ../src/guestfs.pod:1388 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1359 +#: ../src/guestfs.pod:1390 msgid "If that named device exists, use it. If not, return an error." msgstr "" # type: =head2 -#: ../src/guestfs.pod:1363 +#: ../src/guestfs.pod:1394 msgid "PORTABILITY CONCERNS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:1396 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 " @@ -2752,51 +2811,51 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1369 +#: ../src/guestfs.pod:1400 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1376 +#: ../src/guestfs.pod:1407 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 -#: ../src/guestfs.pod:1379 +#: ../src/guestfs.pod:1410 msgid "" "Since those device names exist by definition, they will never be translated." msgstr "" # type: textblock -#: ../src/guestfs.pod:1384 +#: ../src/guestfs.pod:1415 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1389 +#: ../src/guestfs.pod:1420 msgid "INTERNALS" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1391 +#: ../src/guestfs.pod:1422 msgid "COMMUNICATION PROTOCOL" msgstr "" # type: textblock -#: ../src/guestfs.pod:1393 +#: ../src/guestfs.pod:1424 msgid "" "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 -#: ../src/guestfs.pod:1396 +#: ../src/guestfs.pod:1427 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 " @@ -2804,14 +2863,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1400 +#: ../src/guestfs.pod:1431 msgid "" "The detailed format of structures is in C<src/guestfs_protocol.x> (note: " "this file is automatically generated)." msgstr "" # type: textblock -#: ../src/guestfs.pod:1403 +#: ../src/guestfs.pod:1434 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 " @@ -2821,17 +2880,17 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1410 +#: ../src/guestfs.pod:1441 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" # type: textblock -#: ../src/guestfs.pod:1412 +#: ../src/guestfs.pod:1443 msgid "For ordinary functions, the request message is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1414 +#: ../src/guestfs.pod:1445 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -2842,7 +2901,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1419 +#: ../src/guestfs.pod:1450 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 " @@ -2851,26 +2910,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1425 +#: ../src/guestfs.pod:1456 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: textblock -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1459 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 -#: ../src/guestfs.pod:1432 +#: ../src/guestfs.pod:1463 msgid "The reply message for ordinary functions is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1434 +#: ../src/guestfs.pod:1465 #, no-wrap msgid "" " total length (header + ret,\n" @@ -2881,27 +2940,27 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1439 +#: ../src/guestfs.pod:1470 msgid "" "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" # type: textblock -#: ../src/guestfs.pod:1442 +#: ../src/guestfs.pod:1473 msgid "" "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1445 +#: ../src/guestfs.pod:1476 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:1448 +#: ../src/guestfs.pod:1479 #, no-wrap msgid "" " total length (header + error,\n" @@ -2912,19 +2971,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1453 +#: ../src/guestfs.pod:1484 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" # type: =head3 -#: ../src/guestfs.pod:1456 +#: ../src/guestfs.pod:1487 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1458 +#: ../src/guestfs.pod:1489 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 " @@ -2932,7 +2991,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1462 +#: ../src/guestfs.pod:1493 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -2946,12 +3005,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1470 +#: ../src/guestfs.pod:1501 msgid "The \"sequence of chunks\" is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1503 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -2965,7 +3024,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1480 +#: ../src/guestfs.pod:1511 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 " @@ -2973,7 +3032,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1484 +#: ../src/guestfs.pod:1515 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -2982,7 +3041,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1520 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 " @@ -2991,7 +3050,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1495 +#: ../src/guestfs.pod:1526 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 " @@ -3003,7 +3062,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1504 +#: ../src/guestfs.pod:1535 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 " @@ -3013,19 +3072,19 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1510 +#: ../src/guestfs.pod:1541 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1543 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 -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1546 #, no-wrap msgid "" " total length (header + ret,\n" @@ -3039,12 +3098,12 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1523 +#: ../src/guestfs.pod:1554 msgid "INITIAL MESSAGE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1525 +#: ../src/guestfs.pod:1556 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</" @@ -3052,12 +3111,12 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1529 +#: ../src/guestfs.pod:1560 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" # type: textblock -#: ../src/guestfs.pod:1531 +#: ../src/guestfs.pod:1562 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -3065,7 +3124,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1535 +#: ../src/guestfs.pod:1566 msgid "" "The library turns them into progress callbacks (see " "C<guestfs_set_progress_callback>) if there is a callback registered, or " @@ -3073,7 +3132,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1539 +#: ../src/guestfs.pod:1570 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -3081,19 +3140,19 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1543 +#: ../src/guestfs.pod:1574 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1545 +#: ../src/guestfs.pod:1576 msgid "" "All high-level libguestfs actions are synchronous. If you want to use " "libguestfs asynchronously then you must create a thread." msgstr "" # type: textblock -#: ../src/guestfs.pod:1548 +#: ../src/guestfs.pod:1579 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 " @@ -3101,19 +3160,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1583 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1555 +#: ../src/guestfs.pod:1586 msgid "QEMU WRAPPERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1557 +#: ../src/guestfs.pod:1588 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 " @@ -3121,7 +3180,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1561 +#: ../src/guestfs.pod:1592 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 " @@ -3130,14 +3189,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1566 +#: ../src/guestfs.pod:1597 msgid "" "Here is an example of a wrapper, where I have built my own copy of qemu from " "source:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1569 +#: ../src/guestfs.pod:1600 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -3147,7 +3206,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1573 +#: ../src/guestfs.pod:1604 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 " @@ -3155,7 +3214,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1577 +#: ../src/guestfs.pod:1608 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -3163,19 +3222,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1579 +#: ../src/guestfs.pod:1610 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1582 +#: ../src/guestfs.pod:1613 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1584 +#: ../src/guestfs.pod:1615 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -3183,7 +3242,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1589 +#: ../src/guestfs.pod:1620 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -3200,12 +3259,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1600 +#: ../src/guestfs.pod:1631 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" # type: textblock -#: ../src/guestfs.pod:1602 +#: ../src/guestfs.pod:1633 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 " @@ -3215,26 +3274,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1608 +#: ../src/guestfs.pod:1639 msgid "Our criteria for backporting changes are:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1614 +#: ../src/guestfs.pod:1645 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:1620 +#: ../src/guestfs.pod:1651 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" # type: textblock -#: ../src/guestfs.pod:1625 +#: ../src/guestfs.pod:1656 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 " @@ -3242,7 +3301,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1631 +#: ../src/guestfs.pod:1662 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 " @@ -3250,7 +3309,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1637 +#: ../src/guestfs.pod:1668 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 " @@ -3261,47 +3320,47 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:803 +#: ../src/guestfs.pod:1676 ../fish/guestfish.pod:826 #: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312 #: ../tools/virt-rescue.pl:226 msgid "ENVIRONMENT VARIABLES" msgstr "" # type: =item -#: ../src/guestfs.pod:1649 ../fish/guestfish.pod:829 +#: ../src/guestfs.pod:1680 ../fish/guestfish.pod:852 msgid "LIBGUESTFS_APPEND" msgstr "" # type: textblock -#: ../src/guestfs.pod:1651 ../fish/guestfish.pod:831 +#: ../src/guestfs.pod:1682 ../fish/guestfish.pod:854 msgid "Pass additional options to the guest kernel." msgstr "" # type: =item -#: ../src/guestfs.pod:1653 ../fish/guestfish.pod:833 +#: ../src/guestfs.pod:1684 ../fish/guestfish.pod:856 msgid "LIBGUESTFS_DEBUG" msgstr "" # type: textblock -#: ../src/guestfs.pod:1655 +#: ../src/guestfs.pod:1686 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:1658 ../fish/guestfish.pod:838 +#: ../src/guestfs.pod:1689 ../fish/guestfish.pod:861 msgid "LIBGUESTFS_MEMSIZE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1660 ../fish/guestfish.pod:840 +#: ../src/guestfs.pod:1691 ../fish/guestfish.pod:863 msgid "" "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1663 ../fish/guestfish.pod:843 +#: ../src/guestfs.pod:1694 ../fish/guestfish.pod:866 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -3309,79 +3368,79 @@ msgid "" msgstr "" # type: =item -#: ../src/guestfs.pod:1665 ../fish/guestfish.pod:845 +#: ../src/guestfs.pod:1696 ../fish/guestfish.pod:868 msgid "LIBGUESTFS_PATH" msgstr "" # type: textblock -#: ../src/guestfs.pod:1667 +#: ../src/guestfs.pod:1698 msgid "" "Set the path that libguestfs uses to search for kernel and initrd.img. See " "the discussion of paths in section PATH above." msgstr "" # type: =item -#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:850 +#: ../src/guestfs.pod:1701 ../fish/guestfish.pod:873 msgid "LIBGUESTFS_QEMU" msgstr "" # type: textblock -#: ../src/guestfs.pod:1672 ../fish/guestfish.pod:852 +#: ../src/guestfs.pod:1703 ../fish/guestfish.pod:875 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:1676 +#: ../src/guestfs.pod:1707 msgid "See also L</QEMU WRAPPERS> above." msgstr "" # type: =item -#: ../src/guestfs.pod:1678 ../fish/guestfish.pod:856 +#: ../src/guestfs.pod:1709 ../fish/guestfish.pod:879 msgid "LIBGUESTFS_TRACE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1680 +#: ../src/guestfs.pod:1711 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:1683 ../fish/guestfish.pod:865 +#: ../src/guestfs.pod:1714 ../fish/guestfish.pod:888 msgid "TMPDIR" msgstr "" # type: textblock -#: ../src/guestfs.pod:1685 ../fish/guestfish.pod:867 +#: ../src/guestfs.pod:1716 ../fish/guestfish.pod:890 msgid "Location of temporary directory, defaults to C</tmp>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1687 ../fish/guestfish.pod:869 +#: ../src/guestfs.pod:1718 ../fish/guestfish.pod:892 msgid "" -"If libguestfs was compiled to use the supermin appliance then each handle " -"will require rather a large amount of space in this directory for short " -"periods of time (~ 80 MB). You can use C<$TMPDIR> to configure another " -"directory to use in case C</tmp> is not large enough." +"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</tmp> is not large enough." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1695 ../fish/guestfish.pod:927 +#: ../src/guestfs.pod:1726 ../fish/guestfish.pod:950 #: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178 -#: ../inspector/virt-inspector.pl:846 ../tools/virt-cat.pl:163 -#: ../tools/virt-df.pl:536 ../tools/virt-edit.pl:325 -#: ../tools/virt-list-filesystems.pl:191 ../tools/virt-list-partitions.pl:229 -#: ../tools/virt-ls.pl:210 ../tools/virt-make-fs.pl:527 -#: ../tools/virt-rescue.pl:231 ../tools/virt-resize.pl:1390 -#: ../tools/virt-tar.pl:257 ../tools/virt-win-reg.pl:461 +#: ../inspector/virt-inspector.pl:846 ../tools/virt-edit.pl:325 +#: ../tools/virt-win-reg.pl:461 ../tools/virt-df.pl:536 +#: ../tools/virt-ls.pl:210 ../tools/virt-resize.pl:1390 +#: ../tools/virt-list-filesystems.pl:191 ../tools/virt-cat.pl:163 +#: ../tools/virt-tar.pl:257 ../tools/virt-rescue.pl:231 +#: ../tools/virt-make-fs.pl:527 ../tools/virt-list-partitions.pl:229 msgid "SEE ALSO" msgstr "" # type: textblock -#: ../src/guestfs.pod:1697 +#: ../src/guestfs.pod:1728 msgid "" "L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-edit" "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-" @@ -3391,101 +3450,101 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1715 +#: ../src/guestfs.pod:1746 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm" "(8)>, L<disktype(1)>." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1722 ../tools/virt-make-fs.pl:541 -#: ../tools/virt-win-reg.pl:476 +#: ../src/guestfs.pod:1753 ../tools/virt-win-reg.pl:476 +#: ../tools/virt-make-fs.pl:541 msgid "BUGS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1724 +#: ../src/guestfs.pod:1755 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1726 +#: ../src/guestfs.pod:1757 msgid "" "L<https://bugzilla.redhat.com/buglist.cgi?" "component=libguestfs&product=Virtualization+Tools>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1728 +#: ../src/guestfs.pod:1759 msgid "To report a new bug against libguestfs use this link:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1730 +#: ../src/guestfs.pod:1761 msgid "" "L<https://bugzilla.redhat.com/enter_bug.cgi?" "component=libguestfs&product=Virtualization+Tools>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1732 +#: ../src/guestfs.pod:1763 msgid "When reporting a bug, please check:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1738 +#: ../src/guestfs.pod:1769 msgid "That the bug hasn't been reported already." msgstr "" # type: textblock -#: ../src/guestfs.pod:1742 +#: ../src/guestfs.pod:1773 msgid "That you are testing a recent version." msgstr "" # type: textblock -#: ../src/guestfs.pod:1746 +#: ../src/guestfs.pod:1777 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" # type: textblock -#: ../src/guestfs.pod:1750 +#: ../src/guestfs.pod:1781 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1755 ../fish/guestfish.pod:944 +#: ../src/guestfs.pod:1786 ../fish/guestfish.pod:967 #: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189 #: ../inspector/virt-inspector.pl:855 msgid "AUTHORS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1757 ../fish/guestfish.pod:946 +#: ../src/guestfs.pod:1788 ../fish/guestfish.pod:969 #: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1759 ../fish/guestfish.pod:948 +#: ../src/guestfs.pod:1790 ../fish/guestfish.pod:971 #: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193 -#: ../inspector/virt-inspector.pl:861 ../tools/virt-cat.pl:177 -#: ../tools/virt-df.pl:549 ../tools/virt-edit.pl:341 -#: ../tools/virt-list-filesystems.pl:207 ../tools/virt-list-partitions.pl:244 -#: ../tools/virt-ls.pl:225 ../tools/virt-make-fs.pl:556 -#: ../tools/virt-rescue.pl:245 ../tools/virt-resize.pl:1411 -#: ../tools/virt-tar.pl:272 ../tools/virt-win-reg.pl:491 +#: ../inspector/virt-inspector.pl:861 ../tools/virt-edit.pl:341 +#: ../tools/virt-win-reg.pl:491 ../tools/virt-df.pl:549 +#: ../tools/virt-ls.pl:225 ../tools/virt-resize.pl:1411 +#: ../tools/virt-list-filesystems.pl:207 ../tools/virt-cat.pl:177 +#: ../tools/virt-tar.pl:272 ../tools/virt-rescue.pl:245 +#: ../tools/virt-make-fs.pl:556 ../tools/virt-list-partitions.pl:244 msgid "COPYRIGHT" msgstr "" # type: textblock -#: ../src/guestfs.pod:1761 ../fish/guestfish.pod:950 +#: ../src/guestfs.pod:1792 ../fish/guestfish.pod:973 msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1764 +#: ../src/guestfs.pod:1795 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 " @@ -3494,7 +3553,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1769 +#: ../src/guestfs.pod:1800 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 " @@ -3503,7 +3562,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1774 +#: ../src/guestfs.pod:1805 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, " @@ -3612,38 +3671,38 @@ msgstr "" #: ../src/guestfs-actions.pod:3787 ../src/guestfs-actions.pod:3813 #: ../src/guestfs-actions.pod:3847 ../src/guestfs-actions.pod:3861 #: ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:3882 -#: ../src/guestfs-actions.pod:4114 ../src/guestfs-actions.pod:4130 -#: ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4150 -#: ../src/guestfs-actions.pod:4161 ../src/guestfs-actions.pod:4170 -#: ../src/guestfs-actions.pod:4181 ../src/guestfs-actions.pod:4194 -#: ../src/guestfs-actions.pod:4212 ../src/guestfs-actions.pod:4228 -#: ../src/guestfs-actions.pod:4244 ../src/guestfs-actions.pod:4259 -#: ../src/guestfs-actions.pod:4279 ../src/guestfs-actions.pod:4294 -#: ../src/guestfs-actions.pod:4310 ../src/guestfs-actions.pod:4328 -#: ../src/guestfs-actions.pod:4344 ../src/guestfs-actions.pod:4358 -#: ../src/guestfs-actions.pod:4383 ../src/guestfs-actions.pod:4404 -#: ../src/guestfs-actions.pod:4420 ../src/guestfs-actions.pod:4441 -#: ../src/guestfs-actions.pod:4453 ../src/guestfs-actions.pod:4465 -#: ../src/guestfs-actions.pod:4481 ../src/guestfs-actions.pod:4515 -#: ../src/guestfs-actions.pod:4535 ../src/guestfs-actions.pod:4558 -#: ../src/guestfs-actions.pod:4648 ../src/guestfs-actions.pod:4754 -#: ../src/guestfs-actions.pod:4763 ../src/guestfs-actions.pod:4773 -#: ../src/guestfs-actions.pod:4783 ../src/guestfs-actions.pod:4802 -#: ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4822 -#: ../src/guestfs-actions.pod:4832 ../src/guestfs-actions.pod:4844 -#: ../src/guestfs-actions.pod:4894 ../src/guestfs-actions.pod:4908 -#: ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:4934 -#: ../src/guestfs-actions.pod:4948 ../src/guestfs-actions.pod:4958 -#: ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:5005 -#: ../src/guestfs-actions.pod:5016 ../src/guestfs-actions.pod:5051 -#: ../src/guestfs-actions.pod:5061 ../src/guestfs-actions.pod:5076 -#: ../src/guestfs-actions.pod:5102 ../src/guestfs-actions.pod:5130 -#: ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5249 -#: ../src/guestfs-actions.pod:5260 ../src/guestfs-actions.pod:5306 -#: ../src/guestfs-actions.pod:5316 ../src/guestfs-actions.pod:5353 -#: ../src/guestfs-actions.pod:5380 ../src/guestfs-actions.pod:5422 -#: ../src/guestfs-actions.pod:5445 ../src/guestfs-actions.pod:5502 -#: ../src/guestfs-actions.pod:5518 ../src/guestfs-actions.pod:5544 +#: ../src/guestfs-actions.pod:4137 ../src/guestfs-actions.pod:4153 +#: ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4173 +#: ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4193 +#: ../src/guestfs-actions.pod:4204 ../src/guestfs-actions.pod:4217 +#: ../src/guestfs-actions.pod:4235 ../src/guestfs-actions.pod:4251 +#: ../src/guestfs-actions.pod:4267 ../src/guestfs-actions.pod:4282 +#: ../src/guestfs-actions.pod:4302 ../src/guestfs-actions.pod:4317 +#: ../src/guestfs-actions.pod:4333 ../src/guestfs-actions.pod:4351 +#: ../src/guestfs-actions.pod:4367 ../src/guestfs-actions.pod:4381 +#: ../src/guestfs-actions.pod:4406 ../src/guestfs-actions.pod:4427 +#: ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4464 +#: ../src/guestfs-actions.pod:4476 ../src/guestfs-actions.pod:4488 +#: ../src/guestfs-actions.pod:4504 ../src/guestfs-actions.pod:4538 +#: ../src/guestfs-actions.pod:4558 ../src/guestfs-actions.pod:4581 +#: ../src/guestfs-actions.pod:4671 ../src/guestfs-actions.pod:4777 +#: ../src/guestfs-actions.pod:4786 ../src/guestfs-actions.pod:4796 +#: ../src/guestfs-actions.pod:4806 ../src/guestfs-actions.pod:4825 +#: ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4845 +#: ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4867 +#: ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:4931 +#: ../src/guestfs-actions.pod:4944 ../src/guestfs-actions.pod:4957 +#: ../src/guestfs-actions.pod:4971 ../src/guestfs-actions.pod:4981 +#: ../src/guestfs-actions.pod:4998 ../src/guestfs-actions.pod:5028 +#: ../src/guestfs-actions.pod:5039 ../src/guestfs-actions.pod:5074 +#: ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:5099 +#: ../src/guestfs-actions.pod:5125 ../src/guestfs-actions.pod:5153 +#: ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5272 +#: ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:5329 +#: ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5376 +#: ../src/guestfs-actions.pod:5403 ../src/guestfs-actions.pod:5445 +#: ../src/guestfs-actions.pod:5468 ../src/guestfs-actions.pod:5525 +#: ../src/guestfs-actions.pod:5541 ../src/guestfs-actions.pod:5567 msgid "This function returns 0 on success or -1 on error." msgstr "" @@ -3915,9 +3974,9 @@ msgstr "" #: ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1935 #: ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:2165 #: ../src/guestfs-actions.pod:3503 ../src/guestfs-actions.pod:3610 -#: ../src/guestfs-actions.pod:3941 ../src/guestfs-actions.pod:5040 -#: ../src/guestfs-actions.pod:5390 ../src/guestfs-actions.pod:5400 -#: ../src/guestfs-actions.pod:5410 +#: ../src/guestfs-actions.pod:3941 ../src/guestfs-actions.pod:3964 +#: ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5413 +#: ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5433 msgid "On error this function returns -1." msgstr "" @@ -3957,12 +4016,12 @@ msgstr "" #: ../src/guestfs-actions.pod:2250 ../src/guestfs-actions.pod:2565 #: ../src/guestfs-actions.pod:2986 ../src/guestfs-actions.pod:3082 #: ../src/guestfs-actions.pod:3625 ../src/guestfs-actions.pod:3801 -#: ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:4057 -#: ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4576 -#: ../src/guestfs-actions.pod:4589 ../src/guestfs-actions.pod:4603 -#: ../src/guestfs-actions.pod:4624 ../src/guestfs-actions.pod:5183 -#: ../src/guestfs-actions.pod:5199 ../src/guestfs-actions.pod:5214 -#: ../src/guestfs-actions.pod:5362 ../src/guestfs-actions.pod:5592 +#: ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:4080 +#: ../src/guestfs-actions.pod:4123 ../src/guestfs-actions.pod:4599 +#: ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:4626 +#: ../src/guestfs-actions.pod:4647 ../src/guestfs-actions.pod:5206 +#: ../src/guestfs-actions.pod:5222 ../src/guestfs-actions.pod:5237 +#: ../src/guestfs-actions.pod:5385 ../src/guestfs-actions.pod:5615 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -4168,14 +4227,14 @@ msgstr "" #: ../src/guestfs-actions.pod:2494 ../src/guestfs-actions.pod:2550 #: ../src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2963 #: ../src/guestfs-actions.pod:3470 ../src/guestfs-actions.pod:3896 -#: ../src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:4088 -#: ../src/guestfs-actions.pod:4637 ../src/guestfs-actions.pod:4686 -#: ../src/guestfs-actions.pod:4738 ../src/guestfs-actions.pod:4854 -#: ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:5275 -#: ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:5330 -#: ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5482 -#: ../src/guestfs-actions.pod:5555 ../src/guestfs-actions.pod:5571 -#: ../src/guestfs-actions.pod:5611 ../src/guestfs-actions.pod:5627 +#: ../src/guestfs-actions.pod:4005 ../src/guestfs-actions.pod:4111 +#: ../src/guestfs-actions.pod:4660 ../src/guestfs-actions.pod:4709 +#: ../src/guestfs-actions.pod:4761 ../src/guestfs-actions.pod:4877 +#: ../src/guestfs-actions.pod:4898 ../src/guestfs-actions.pod:5298 +#: ../src/guestfs-actions.pod:5315 ../src/guestfs-actions.pod:5353 +#: ../src/guestfs-actions.pod:5489 ../src/guestfs-actions.pod:5505 +#: ../src/guestfs-actions.pod:5578 ../src/guestfs-actions.pod:5594 +#: ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5650 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 " @@ -4813,8 +4872,8 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:618 ../src/guestfs-actions.pod:3972 -#: ../fish/guestfish-actions.pod:506 ../fish/guestfish-actions.pod:3068 +#: ../src/guestfs-actions.pod:618 ../src/guestfs-actions.pod:3995 +#: ../fish/guestfish-actions.pod:506 ../fish/guestfish-actions.pod:3085 msgid "Return the contents of the file named C<path>." msgstr "" @@ -4836,27 +4895,28 @@ msgstr "" #: ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:1857 #: ../src/guestfs-actions.pod:1871 ../src/guestfs-actions.pod:1897 #: ../src/guestfs-actions.pod:3835 ../src/guestfs-actions.pod:3943 -#: ../src/guestfs-actions.pod:3964 ../src/guestfs-actions.pod:4690 -#: ../src/guestfs-actions.pod:4742 ../src/guestfs-actions.pod:4858 -#: ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:5424 +#: ../src/guestfs-actions.pod:3966 ../src/guestfs-actions.pod:3987 +#: ../src/guestfs-actions.pod:4713 ../src/guestfs-actions.pod:4765 +#: ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:4902 #: ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:5470 -#: ../src/guestfs-actions.pod:5486 ../src/guestfs-actions.pod:5559 -#: ../src/guestfs-actions.pod:5575 ../src/guestfs-actions.pod:5615 -#: ../src/guestfs-actions.pod:5631 ../fish/guestfish-actions.pod:513 -#: ../fish/guestfish-actions.pod:648 ../fish/guestfish-actions.pod:660 -#: ../fish/guestfish-actions.pod:861 ../fish/guestfish-actions.pod:871 -#: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:948 -#: ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1418 -#: ../fish/guestfish-actions.pod:1428 ../fish/guestfish-actions.pod:1456 -#: ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1481 -#: ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:2970 -#: ../fish/guestfish-actions.pod:3046 ../fish/guestfish-actions.pod:3061 -#: ../fish/guestfish-actions.pod:3644 ../fish/guestfish-actions.pod:3690 -#: ../fish/guestfish-actions.pod:3775 ../fish/guestfish-actions.pod:3790 -#: ../fish/guestfish-actions.pod:4200 ../fish/guestfish-actions.pod:4218 -#: ../fish/guestfish-actions.pod:4235 ../fish/guestfish-actions.pod:4245 -#: ../fish/guestfish-actions.pod:4293 ../fish/guestfish-actions.pod:4303 -#: ../fish/guestfish-actions.pod:4332 ../fish/guestfish-actions.pod:4342 +#: ../src/guestfs-actions.pod:5493 ../src/guestfs-actions.pod:5509 +#: ../src/guestfs-actions.pod:5582 ../src/guestfs-actions.pod:5598 +#: ../src/guestfs-actions.pod:5638 ../src/guestfs-actions.pod:5654 +#: ../fish/guestfish-actions.pod:513 ../fish/guestfish-actions.pod:648 +#: ../fish/guestfish-actions.pod:660 ../fish/guestfish-actions.pod:861 +#: ../fish/guestfish-actions.pod:871 ../fish/guestfish-actions.pod:938 +#: ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:1143 +#: ../fish/guestfish-actions.pod:1418 ../fish/guestfish-actions.pod:1428 +#: ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:1471 +#: ../fish/guestfish-actions.pod:1481 ../fish/guestfish-actions.pod:1500 +#: ../fish/guestfish-actions.pod:2970 ../fish/guestfish-actions.pod:3046 +#: ../fish/guestfish-actions.pod:3063 ../fish/guestfish-actions.pod:3078 +#: ../fish/guestfish-actions.pod:3661 ../fish/guestfish-actions.pod:3707 +#: ../fish/guestfish-actions.pod:3792 ../fish/guestfish-actions.pod:3807 +#: ../fish/guestfish-actions.pod:4217 ../fish/guestfish-actions.pod:4235 +#: ../fish/guestfish-actions.pod:4252 ../fish/guestfish-actions.pod:4262 +#: ../fish/guestfish-actions.pod:4310 ../fish/guestfish-actions.pod:4320 +#: ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4359 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -5256,8 +5316,8 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:976 #: ../src/guestfs-actions.pod:1004 ../src/guestfs-actions.pod:1376 -#: ../src/guestfs-actions.pod:1395 ../src/guestfs-actions.pod:5504 -#: ../src/guestfs-actions.pod:5520 +#: ../src/guestfs-actions.pod:1395 ../src/guestfs-actions.pod:5527 +#: ../src/guestfs-actions.pod:5543 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -5498,8 +5558,8 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:5072 -#: ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:3948 +#: ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:5095 +#: ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:3965 msgid "C<filename> can also be a named pipe." msgstr "" @@ -5808,10 +5868,10 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:1148 ../src/guestfs-actions.pod:1583 -#: ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:5453 -#: ../src/guestfs-actions.pod:5598 ../fish/guestfish-actions.pod:907 +#: ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:5476 +#: ../src/guestfs-actions.pod:5621 ../fish/guestfish-actions.pod:907 #: ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1278 -#: ../fish/guestfish-actions.pod:4224 ../fish/guestfish-actions.pod:4321 +#: ../fish/guestfish-actions.pod:4241 ../fish/guestfish-actions.pod:4338 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 " @@ -6592,9 +6652,9 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1679 -#: ../src/guestfs-actions.pod:4325 ../src/guestfs-actions.pod:4417 +#: ../src/guestfs-actions.pod:4348 ../src/guestfs-actions.pod:4440 #: ../fish/guestfish-actions.pod:1293 ../fish/guestfish-actions.pod:1344 -#: ../fish/guestfish-actions.pod:3355 ../fish/guestfish-actions.pod:3442 +#: ../fish/guestfish-actions.pod:3372 ../fish/guestfish-actions.pod:3459 msgid "" "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" @@ -7057,8 +7117,8 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:4873 -#: ../fish/guestfish-actions.pod:1469 ../fish/guestfish-actions.pod:3788 +#: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:4896 +#: ../fish/guestfish-actions.pod:1469 ../fish/guestfish-actions.pod:3805 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" @@ -7130,7 +7190,7 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:3831 -#: ../src/guestfs-actions.pod:3960 +#: ../src/guestfs-actions.pod:3983 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 " @@ -7665,7 +7725,7 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2531 -#: ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:4990 +#: ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:5013 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 " @@ -8473,8 +8533,8 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2657 ../src/guestfs-actions.pod:4655 -#: ../fish/guestfish-actions.pod:2101 ../fish/guestfish-actions.pod:3623 +#: ../src/guestfs-actions.pod:2657 ../src/guestfs-actions.pod:4678 +#: ../fish/guestfish-actions.pod:2101 ../fish/guestfish-actions.pod:3640 msgid "Returns file information for the given C<path>." msgstr "" @@ -8491,7 +8551,7 @@ msgid "This is the same as the C<lstat(2)> system call." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4659 +#: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4682 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>." @@ -8639,13 +8699,13 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:2747 ../src/guestfs-actions.pod:2767 #: ../src/guestfs-actions.pod:2869 ../src/guestfs-actions.pod:3581 -#: ../src/guestfs-actions.pod:4196 ../src/guestfs-actions.pod:4517 -#: ../src/guestfs-actions.pod:4537 ../src/guestfs-actions.pod:4560 -#: ../src/guestfs-actions.pod:5525 ../fish/guestfish-actions.pod:2168 +#: ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:4540 +#: ../src/guestfs-actions.pod:4560 ../src/guestfs-actions.pod:4583 +#: ../src/guestfs-actions.pod:5548 ../fish/guestfish-actions.pod:2168 #: ../fish/guestfish-actions.pod:2181 ../fish/guestfish-actions.pod:2252 -#: ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:3242 -#: ../fish/guestfish-actions.pod:3522 ../fish/guestfish-actions.pod:3538 -#: ../fish/guestfish-actions.pod:3553 ../fish/guestfish-actions.pod:4268 +#: ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:3259 +#: ../fish/guestfish-actions.pod:3539 ../fish/guestfish-actions.pod:3555 +#: ../fish/guestfish-actions.pod:3570 ../fish/guestfish-actions.pod:4285 msgid "" "B<This command is dangerous. Without careful use you can easily destroy all " "your data>." @@ -10635,7 +10695,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3829 +#: ../src/guestfs-actions.pod:3829 ../src/guestfs-actions.pod:3962 msgid "See also C<guestfs_pwrite>." msgstr "" @@ -10847,18 +10907,50 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:3939 -msgid "See also C<guestfs_pread>." +msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" # type: =head2 #: ../src/guestfs-actions.pod:3946 -msgid "guestfs_read_file" +msgid "guestfs_pwrite_device" msgstr "" # type: verbatim #: ../src/guestfs-actions.pod:3948 #, no-wrap msgid "" +" int guestfs_pwrite_device (guestfs_h *g,\n" +"\t\tconst char *device,\n" +"\t\tconst char *content,\n" +"\t\tsize_t content_size,\n" +"\t\tint64_t offset);\n" +"\n" +msgstr "" + +# type: textblock +#: ../src/guestfs-actions.pod:3954 ../fish/guestfish-actions.pod:3053 +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:3957 ../fish/guestfish-actions.pod:3056 +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 " +"devices and partitions are probably impossible with standard Linux kernels)." +msgstr "" + +# type: =head2 +#: ../src/guestfs-actions.pod:3969 +msgid "guestfs_read_file" +msgstr "" + +# type: verbatim +#: ../src/guestfs-actions.pod:3971 +#, no-wrap +msgid "" " char *guestfs_read_file (guestfs_h *g,\n" "\t\tconst char *path,\n" "\t\tsize_t *size_r);\n" @@ -10866,12 +10958,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3952 ../fish/guestfish-actions.pod:3053 +#: ../src/guestfs-actions.pod:3975 ../fish/guestfish-actions.pod:3070 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3955 +#: ../src/guestfs-actions.pod:3978 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -10879,12 +10971,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:3967 +#: ../src/guestfs-actions.pod:3990 msgid "guestfs_read_lines" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:3969 +#: ../src/guestfs-actions.pod:3992 #, no-wrap msgid "" " char **guestfs_read_lines (guestfs_h *g,\n" @@ -10893,14 +10985,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3974 ../fish/guestfish-actions.pod:3070 +#: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:3087 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:3977 +#: ../src/guestfs-actions.pod:4000 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -10909,12 +11001,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:3986 +#: ../src/guestfs-actions.pod:4009 msgid "guestfs_readdir" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:3988 +#: ../src/guestfs-actions.pod:4011 #, no-wrap msgid "" " struct guestfs_dirent_list *guestfs_readdir (guestfs_h *g,\n" @@ -10923,12 +11015,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3991 ../fish/guestfish-actions.pod:3082 +#: ../src/guestfs-actions.pod:4014 ../fish/guestfish-actions.pod:3099 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3993 ../fish/guestfish-actions.pod:3084 +#: ../src/guestfs-actions.pod:4016 ../fish/guestfish-actions.pod:3101 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 " @@ -10936,105 +11028,105 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:3088 +#: ../src/guestfs-actions.pod:4020 ../fish/guestfish-actions.pod:3105 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:4002 ../fish/guestfish-actions.pod:3093 +#: ../src/guestfs-actions.pod:4025 ../fish/guestfish-actions.pod:3110 msgid "'b'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4004 ../fish/guestfish-actions.pod:3095 +#: ../src/guestfs-actions.pod:4027 ../fish/guestfish-actions.pod:3112 msgid "Block special" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4006 ../fish/guestfish-actions.pod:3097 +#: ../src/guestfs-actions.pod:4029 ../fish/guestfish-actions.pod:3114 msgid "'c'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4008 ../fish/guestfish-actions.pod:3099 +#: ../src/guestfs-actions.pod:4031 ../fish/guestfish-actions.pod:3116 msgid "Char special" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4010 ../fish/guestfish-actions.pod:3101 +#: ../src/guestfs-actions.pod:4033 ../fish/guestfish-actions.pod:3118 msgid "'d'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4012 ../fish/guestfish-actions.pod:3103 +#: ../src/guestfs-actions.pod:4035 ../fish/guestfish-actions.pod:3120 msgid "Directory" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4014 ../fish/guestfish-actions.pod:3105 +#: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:3122 msgid "'f'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4016 ../fish/guestfish-actions.pod:3107 +#: ../src/guestfs-actions.pod:4039 ../fish/guestfish-actions.pod:3124 msgid "FIFO (named pipe)" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4018 ../fish/guestfish-actions.pod:3109 +#: ../src/guestfs-actions.pod:4041 ../fish/guestfish-actions.pod:3126 msgid "'l'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4020 ../fish/guestfish-actions.pod:3111 +#: ../src/guestfs-actions.pod:4043 ../fish/guestfish-actions.pod:3128 msgid "Symbolic link" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4022 ../fish/guestfish-actions.pod:3113 +#: ../src/guestfs-actions.pod:4045 ../fish/guestfish-actions.pod:3130 msgid "'r'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4024 ../fish/guestfish-actions.pod:3115 +#: ../src/guestfs-actions.pod:4047 ../fish/guestfish-actions.pod:3132 msgid "Regular file" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4026 ../fish/guestfish-actions.pod:3117 +#: ../src/guestfs-actions.pod:4049 ../fish/guestfish-actions.pod:3134 msgid "'s'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4028 ../fish/guestfish-actions.pod:3119 +#: ../src/guestfs-actions.pod:4051 ../fish/guestfish-actions.pod:3136 msgid "Socket" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4030 ../fish/guestfish-actions.pod:3121 +#: ../src/guestfs-actions.pod:4053 ../fish/guestfish-actions.pod:3138 msgid "'u'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4032 ../fish/guestfish-actions.pod:3123 +#: ../src/guestfs-actions.pod:4055 ../fish/guestfish-actions.pod:3140 msgid "Unknown file type" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4034 ../fish/guestfish-actions.pod:3125 +#: ../src/guestfs-actions.pod:4057 ../fish/guestfish-actions.pod:3142 msgid "'?'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4036 ../fish/guestfish-actions.pod:3127 +#: ../src/guestfs-actions.pod:4059 ../fish/guestfish-actions.pod:3144 msgid "" "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4041 +#: ../src/guestfs-actions.pod:4064 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 " @@ -11042,7 +11134,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4045 +#: ../src/guestfs-actions.pod:4068 msgid "" "This function returns a C<struct guestfs_dirent_list *> (see E<lt>guestfs-" "structs.hE<gt>), or NULL if there was an error. I<The caller must call " @@ -11050,12 +11142,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4050 +#: ../src/guestfs-actions.pod:4073 msgid "guestfs_readlink" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4052 +#: ../src/guestfs-actions.pod:4075 #, no-wrap msgid "" " char *guestfs_readlink (guestfs_h *g,\n" @@ -11064,17 +11156,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4055 ../fish/guestfish-actions.pod:3140 +#: ../src/guestfs-actions.pod:4078 ../fish/guestfish-actions.pod:3157 msgid "This command reads the target of a symbolic link." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4060 +#: ../src/guestfs-actions.pod:4083 msgid "guestfs_readlinklist" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4062 +#: ../src/guestfs-actions.pod:4085 #, no-wrap msgid "" " char **guestfs_readlinklist (guestfs_h *g,\n" @@ -11084,7 +11176,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4066 ../fish/guestfish-actions.pod:3146 +#: ../src/guestfs-actions.pod:4089 ../fish/guestfish-actions.pod:3163 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 " @@ -11092,14 +11184,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4070 ../fish/guestfish-actions.pod:3150 +#: ../src/guestfs-actions.pod:4093 ../fish/guestfish-actions.pod:3167 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:4074 ../fish/guestfish-actions.pod:3154 +#: ../src/guestfs-actions.pod:4097 ../fish/guestfish-actions.pod:3171 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 " @@ -11109,7 +11201,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4081 ../fish/guestfish-actions.pod:3161 +#: ../src/guestfs-actions.pod:4104 ../fish/guestfish-actions.pod:3178 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -11118,12 +11210,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4092 +#: ../src/guestfs-actions.pod:4115 msgid "guestfs_realpath" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4094 +#: ../src/guestfs-actions.pod:4117 #, no-wrap msgid "" " char *guestfs_realpath (guestfs_h *g,\n" @@ -11132,19 +11224,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4097 ../fish/guestfish-actions.pod:3172 +#: ../src/guestfs-actions.pod:4120 ../fish/guestfish-actions.pod:3189 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:4103 +#: ../src/guestfs-actions.pod:4126 msgid "guestfs_removexattr" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4105 +#: ../src/guestfs-actions.pod:4128 #, no-wrap msgid "" " int guestfs_removexattr (guestfs_h *g,\n" @@ -11154,23 +11246,23 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4109 ../fish/guestfish-actions.pod:3179 +#: ../src/guestfs-actions.pod:4132 ../fish/guestfish-actions.pod:3196 msgid "" "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4112 +#: ../src/guestfs-actions.pod:4135 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4116 +#: ../src/guestfs-actions.pod:4139 msgid "guestfs_resize2fs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4118 +#: ../src/guestfs-actions.pod:4141 #, no-wrap msgid "" " int guestfs_resize2fs (guestfs_h *g,\n" @@ -11179,14 +11271,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4121 ../fish/guestfish-actions.pod:3188 +#: ../src/guestfs-actions.pod:4144 ../fish/guestfish-actions.pod:3205 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4124 +#: ../src/guestfs-actions.pod:4147 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> " @@ -11195,12 +11287,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4132 +#: ../src/guestfs-actions.pod:4155 msgid "guestfs_resize2fs_size" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4134 +#: ../src/guestfs-actions.pod:4157 #, no-wrap msgid "" " int guestfs_resize2fs_size (guestfs_h *g,\n" @@ -11210,19 +11302,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4138 +#: ../src/guestfs-actions.pod:4161 msgid "" "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 -#: ../src/guestfs-actions.pod:4143 +#: ../src/guestfs-actions.pod:4166 msgid "guestfs_rm" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4145 +#: ../src/guestfs-actions.pod:4168 #, no-wrap msgid "" " int guestfs_rm (guestfs_h *g,\n" @@ -11231,17 +11323,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4148 ../fish/guestfish-actions.pod:3208 +#: ../src/guestfs-actions.pod:4171 ../fish/guestfish-actions.pod:3225 msgid "Remove the single file C<path>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4152 +#: ../src/guestfs-actions.pod:4175 msgid "guestfs_rm_rf" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4154 +#: ../src/guestfs-actions.pod:4177 #, no-wrap msgid "" " int guestfs_rm_rf (guestfs_h *g,\n" @@ -11250,19 +11342,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4157 ../fish/guestfish-actions.pod:3214 +#: ../src/guestfs-actions.pod:4180 ../fish/guestfish-actions.pod:3231 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:4163 +#: ../src/guestfs-actions.pod:4186 msgid "guestfs_rmdir" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4165 +#: ../src/guestfs-actions.pod:4188 #, no-wrap msgid "" " int guestfs_rmdir (guestfs_h *g,\n" @@ -11271,17 +11363,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4168 ../fish/guestfish-actions.pod:3222 +#: ../src/guestfs-actions.pod:4191 ../fish/guestfish-actions.pod:3239 msgid "Remove the single directory C<path>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4172 +#: ../src/guestfs-actions.pod:4195 msgid "guestfs_rmmountpoint" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4174 +#: ../src/guestfs-actions.pod:4197 #, no-wrap msgid "" " int guestfs_rmmountpoint (guestfs_h *g,\n" @@ -11290,19 +11382,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4177 +#: ../src/guestfs-actions.pod:4200 msgid "" "This calls removes a mountpoint that was previously created with " "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4183 +#: ../src/guestfs-actions.pod:4206 msgid "guestfs_scrub_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4185 +#: ../src/guestfs-actions.pod:4208 #, no-wrap msgid "" " int guestfs_scrub_device (guestfs_h *g,\n" @@ -11311,28 +11403,28 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4188 ../fish/guestfish-actions.pod:3236 +#: ../src/guestfs-actions.pod:4211 ../fish/guestfish-actions.pod:3253 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4191 ../src/guestfs-actions.pod:4209 -#: ../src/guestfs-actions.pod:4225 ../fish/guestfish-actions.pod:3239 -#: ../fish/guestfish-actions.pod:3254 ../fish/guestfish-actions.pod:3267 +#: ../src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:4232 +#: ../src/guestfs-actions.pod:4248 ../fish/guestfish-actions.pod:3256 +#: ../fish/guestfish-actions.pod:3271 ../fish/guestfish-actions.pod:3284 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4199 +#: ../src/guestfs-actions.pod:4222 msgid "guestfs_scrub_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4201 +#: ../src/guestfs-actions.pod:4224 #, no-wrap msgid "" " int guestfs_scrub_file (guestfs_h *g,\n" @@ -11341,24 +11433,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4204 ../fish/guestfish-actions.pod:3249 +#: ../src/guestfs-actions.pod:4227 ../fish/guestfish-actions.pod:3266 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4207 ../fish/guestfish-actions.pod:3252 +#: ../src/guestfs-actions.pod:4230 ../fish/guestfish-actions.pod:3269 msgid "The file is I<removed> after scrubbing." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4214 +#: ../src/guestfs-actions.pod:4237 msgid "guestfs_scrub_freespace" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4216 +#: ../src/guestfs-actions.pod:4239 #, no-wrap msgid "" " int guestfs_scrub_freespace (guestfs_h *g,\n" @@ -11367,7 +11459,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4219 +#: ../src/guestfs-actions.pod:4242 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>, " @@ -11376,12 +11468,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4230 +#: ../src/guestfs-actions.pod:4253 msgid "guestfs_set_append" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4232 +#: ../src/guestfs-actions.pod:4255 #, no-wrap msgid "" " int guestfs_set_append (guestfs_h *g,\n" @@ -11390,33 +11482,33 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4235 ../fish/guestfish-actions.pod:3276 +#: ../src/guestfs-actions.pod:4258 ../fish/guestfish-actions.pod:3293 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4238 ../fish/guestfish-actions.pod:3279 +#: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:3296 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4241 ../fish/guestfish-actions.pod:3282 +#: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:3299 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:4246 +#: ../src/guestfs-actions.pod:4269 msgid "guestfs_set_autosync" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4248 +#: ../src/guestfs-actions.pod:4271 #, no-wrap msgid "" " int guestfs_set_autosync (guestfs_h *g,\n" @@ -11425,7 +11517,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4251 +#: ../src/guestfs-actions.pod:4274 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to run C<guestfs_umount_all> followed by C<guestfs_sync> when " @@ -11433,19 +11525,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4256 ../fish/guestfish-actions.pod:3296 +#: ../src/guestfs-actions.pod:4279 ../fish/guestfish-actions.pod:3313 msgid "" "This is disabled by default (except in guestfish where it is enabled by " "default)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4261 +#: ../src/guestfs-actions.pod:4284 msgid "guestfs_set_direct" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4263 +#: ../src/guestfs-actions.pod:4286 #, no-wrap msgid "" " int guestfs_set_direct (guestfs_h *g,\n" @@ -11454,14 +11546,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4266 ../fish/guestfish-actions.pod:3305 +#: ../src/guestfs-actions.pod:4289 ../fish/guestfish-actions.pod:3322 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:4270 +#: ../src/guestfs-actions.pod:4293 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 " @@ -11469,22 +11561,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4274 ../fish/guestfish-actions.pod:3313 +#: ../src/guestfs-actions.pod:4297 ../fish/guestfish-actions.pod:3330 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4277 ../fish/guestfish-actions.pod:3316 +#: ../src/guestfs-actions.pod:4300 ../fish/guestfish-actions.pod:3333 msgid "The default is disabled." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4281 +#: ../src/guestfs-actions.pod:4304 msgid "guestfs_set_e2label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4283 +#: ../src/guestfs-actions.pod:4306 #, no-wrap msgid "" " int guestfs_set_e2label (guestfs_h *g,\n" @@ -11494,26 +11586,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4287 ../fish/guestfish-actions.pod:3322 +#: ../src/guestfs-actions.pod:4310 ../fish/guestfish-actions.pod:3339 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:4291 +#: ../src/guestfs-actions.pod:4314 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " "the existing label on a filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4296 +#: ../src/guestfs-actions.pod:4319 msgid "guestfs_set_e2uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4298 +#: ../src/guestfs-actions.pod:4321 #, no-wrap msgid "" " int guestfs_set_e2uuid (guestfs_h *g,\n" @@ -11523,7 +11615,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4302 ../fish/guestfish-actions.pod:3333 +#: ../src/guestfs-actions.pod:4325 ../fish/guestfish-actions.pod:3350 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>, " @@ -11531,19 +11623,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4307 +#: ../src/guestfs-actions.pod:4330 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " "the existing UUID of a filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4312 +#: ../src/guestfs-actions.pod:4335 msgid "guestfs_set_memsize" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4314 +#: ../src/guestfs-actions.pod:4337 #, no-wrap msgid "" " int guestfs_set_memsize (guestfs_h *g,\n" @@ -11552,26 +11644,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4317 +#: ../src/guestfs-actions.pod:4340 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before C<guestfs_launch>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4321 ../fish/guestfish-actions.pod:3351 +#: ../src/guestfs-actions.pod:4344 ../fish/guestfish-actions.pod:3368 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:4330 +#: ../src/guestfs-actions.pod:4353 msgid "guestfs_set_network" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4332 +#: ../src/guestfs-actions.pod:4355 #, no-wrap msgid "" " int guestfs_set_network (guestfs_h *g,\n" @@ -11580,33 +11672,33 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4335 ../fish/guestfish-actions.pod:3364 +#: ../src/guestfs-actions.pod:4358 ../fish/guestfish-actions.pod:3381 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:4338 ../fish/guestfish-actions.pod:3367 +#: ../src/guestfs-actions.pod:4361 ../fish/guestfish-actions.pod:3384 msgid "" "This affects whether commands are able to access the network (see L<guestfs" "(3)/RUNNING COMMANDS>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4341 +#: ../src/guestfs-actions.pod:4364 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4346 +#: ../src/guestfs-actions.pod:4369 msgid "guestfs_set_path" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4348 +#: ../src/guestfs-actions.pod:4371 #, no-wrap msgid "" " int guestfs_set_path (guestfs_h *g,\n" @@ -11615,29 +11707,29 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4351 ../fish/guestfish-actions.pod:3379 +#: ../src/guestfs-actions.pod:4374 ../fish/guestfish-actions.pod:3396 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4353 ../fish/guestfish-actions.pod:3381 +#: ../src/guestfs-actions.pod:4376 ../fish/guestfish-actions.pod:3398 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4356 ../fish/guestfish-actions.pod:3384 +#: ../src/guestfs-actions.pod:4379 ../fish/guestfish-actions.pod:3401 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4360 +#: ../src/guestfs-actions.pod:4383 msgid "guestfs_set_qemu" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4362 +#: ../src/guestfs-actions.pod:4385 #, no-wrap msgid "" " int guestfs_set_qemu (guestfs_h *g,\n" @@ -11646,30 +11738,30 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4365 ../fish/guestfish-actions.pod:3392 +#: ../src/guestfs-actions.pod:4388 ../fish/guestfish-actions.pod:3409 msgid "Set the qemu binary that we will use." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4367 ../fish/guestfish-actions.pod:3394 +#: ../src/guestfs-actions.pod:4390 ../fish/guestfish-actions.pod:3411 msgid "" "The default is chosen when the library was compiled by the configure script." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4370 ../fish/guestfish-actions.pod:3397 +#: ../src/guestfs-actions.pod:4393 ../fish/guestfish-actions.pod:3414 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4373 ../fish/guestfish-actions.pod:3400 +#: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:3417 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4375 ../fish/guestfish-actions.pod:3402 +#: ../src/guestfs-actions.pod:4398 ../fish/guestfish-actions.pod:3419 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 " @@ -11680,12 +11772,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4385 +#: ../src/guestfs-actions.pod:4408 msgid "guestfs_set_recovery_proc" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4387 +#: ../src/guestfs-actions.pod:4410 #, no-wrap msgid "" " int guestfs_set_recovery_proc (guestfs_h *g,\n" @@ -11694,7 +11786,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4390 +#: ../src/guestfs-actions.pod:4413 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 " @@ -11703,14 +11795,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4395 +#: ../src/guestfs-actions.pod:4418 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4398 ../fish/guestfish-actions.pod:3424 +#: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:3441 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 " @@ -11719,12 +11811,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4406 +#: ../src/guestfs-actions.pod:4429 msgid "guestfs_set_selinux" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4408 +#: ../src/guestfs-actions.pod:4431 #, no-wrap msgid "" " int guestfs_set_selinux (guestfs_h *g,\n" @@ -11733,26 +11825,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4411 ../fish/guestfish-actions.pod:3436 +#: ../src/guestfs-actions.pod:4434 ../fish/guestfish-actions.pod:3453 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:4414 ../fish/guestfish-actions.pod:3439 +#: ../src/guestfs-actions.pod:4437 ../fish/guestfish-actions.pod:3456 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4422 +#: ../src/guestfs-actions.pod:4445 msgid "guestfs_set_trace" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4424 +#: ../src/guestfs-actions.pod:4447 #, no-wrap msgid "" " int guestfs_set_trace (guestfs_h *g,\n" @@ -11761,7 +11853,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4427 ../fish/guestfish-actions.pod:3451 +#: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:3468 msgid "" "If the command trace flag is set to 1, then commands are printed on stderr " "before they are executed in a format which is very similar to the one used " @@ -11771,26 +11863,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4434 ../fish/guestfish-actions.pod:3458 +#: ../src/guestfs-actions.pod:4457 ../fish/guestfish-actions.pod:3475 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:4438 ../fish/guestfish-actions.pod:3462 +#: ../src/guestfs-actions.pod:4461 ../fish/guestfish-actions.pod:3479 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4443 +#: ../src/guestfs-actions.pod:4466 msgid "guestfs_set_verbose" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4445 +#: ../src/guestfs-actions.pod:4468 #, no-wrap msgid "" " int guestfs_set_verbose (guestfs_h *g,\n" @@ -11799,24 +11891,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4448 ../fish/guestfish-actions.pod:3471 +#: ../src/guestfs-actions.pod:4471 ../fish/guestfish-actions.pod:3488 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:3473 +#: ../src/guestfs-actions.pod:4473 ../fish/guestfish-actions.pod:3490 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4455 +#: ../src/guestfs-actions.pod:4478 msgid "guestfs_setcon" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4457 +#: ../src/guestfs-actions.pod:4480 #, no-wrap msgid "" " int guestfs_setcon (guestfs_h *g,\n" @@ -11825,24 +11917,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3480 +#: ../src/guestfs-actions.pod:4483 ../fish/guestfish-actions.pod:3497 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4463 ../fish/guestfish-actions.pod:3483 +#: ../src/guestfs-actions.pod:4486 ../fish/guestfish-actions.pod:3500 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4467 +#: ../src/guestfs-actions.pod:4490 msgid "guestfs_setxattr" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4469 +#: ../src/guestfs-actions.pod:4492 #, no-wrap msgid "" " int guestfs_setxattr (guestfs_h *g,\n" @@ -11854,24 +11946,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4475 ../fish/guestfish-actions.pod:3489 +#: ../src/guestfs-actions.pod:4498 ../fish/guestfish-actions.pod:3506 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:4479 +#: ../src/guestfs-actions.pod:4502 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4483 +#: ../src/guestfs-actions.pod:4506 msgid "guestfs_sfdisk" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4485 +#: ../src/guestfs-actions.pod:4508 #, no-wrap msgid "" " int guestfs_sfdisk (guestfs_h *g,\n" @@ -11884,19 +11976,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4492 ../fish/guestfish-actions.pod:3499 +#: ../src/guestfs-actions.pod:4515 ../fish/guestfish-actions.pod:3516 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:4495 ../fish/guestfish-actions.pod:3502 +#: ../src/guestfs-actions.pod:4518 ../fish/guestfish-actions.pod:3519 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4497 ../fish/guestfish-actions.pod:3504 +#: ../src/guestfs-actions.pod:4520 ../fish/guestfish-actions.pod:3521 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>, I<-" @@ -11907,14 +11999,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4505 ../fish/guestfish-actions.pod:3512 +#: ../src/guestfs-actions.pod:4528 ../fish/guestfish-actions.pod:3529 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:4508 ../fish/guestfish-actions.pod:3515 +#: ../src/guestfs-actions.pod:4531 ../fish/guestfish-actions.pod:3532 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 " @@ -11922,18 +12014,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4512 +#: ../src/guestfs-actions.pod:4535 msgid "" "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4520 +#: ../src/guestfs-actions.pod:4543 msgid "guestfs_sfdiskM" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4522 +#: ../src/guestfs-actions.pod:4545 #, no-wrap msgid "" " int guestfs_sfdiskM (guestfs_h *g,\n" @@ -11943,7 +12035,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4526 +#: ../src/guestfs-actions.pod:4549 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -11952,19 +12044,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4532 +#: ../src/guestfs-actions.pod:4555 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4540 +#: ../src/guestfs-actions.pod:4563 msgid "guestfs_sfdisk_N" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4542 +#: ../src/guestfs-actions.pod:4565 #, no-wrap msgid "" " int guestfs_sfdisk_N (guestfs_h *g,\n" @@ -11978,31 +12070,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4550 ../fish/guestfish-actions.pod:3545 +#: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3562 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:4553 +#: ../src/guestfs-actions.pod:4576 msgid "" "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4556 +#: ../src/guestfs-actions.pod:4579 msgid "See also: C<guestfs_part_add>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4563 +#: ../src/guestfs-actions.pod:4586 msgid "guestfs_sfdisk_disk_geometry" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4565 +#: ../src/guestfs-actions.pod:4588 #, no-wrap msgid "" " char *guestfs_sfdisk_disk_geometry (guestfs_h *g,\n" @@ -12011,7 +12103,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4568 +#: ../src/guestfs-actions.pod:4591 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, " @@ -12020,18 +12112,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4573 ../src/guestfs-actions.pod:4586 -#: ../fish/guestfish-actions.pod:3565 ../fish/guestfish-actions.pod:3574 +#: ../src/guestfs-actions.pod:4596 ../src/guestfs-actions.pod:4609 +#: ../fish/guestfish-actions.pod:3582 ../fish/guestfish-actions.pod:3591 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4579 +#: ../src/guestfs-actions.pod:4602 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4581 +#: ../src/guestfs-actions.pod:4604 #, no-wrap msgid "" " char *guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n" @@ -12040,17 +12132,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4584 ../fish/guestfish-actions.pod:3572 +#: ../src/guestfs-actions.pod:4607 ../fish/guestfish-actions.pod:3589 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4592 +#: ../src/guestfs-actions.pod:4615 msgid "guestfs_sfdisk_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4594 +#: ../src/guestfs-actions.pod:4617 #, no-wrap msgid "" " char *guestfs_sfdisk_l (guestfs_h *g,\n" @@ -12059,24 +12151,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3581 +#: ../src/guestfs-actions.pod:4620 ../fish/guestfish-actions.pod:3598 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:4601 +#: ../src/guestfs-actions.pod:4624 msgid "See also: C<guestfs_part_list>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4606 +#: ../src/guestfs-actions.pod:4629 msgid "guestfs_sh" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4608 +#: ../src/guestfs-actions.pod:4631 #, no-wrap msgid "" " char *guestfs_sh (guestfs_h *g,\n" @@ -12085,19 +12177,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4611 ../fish/guestfish-actions.pod:3591 +#: ../src/guestfs-actions.pod:4634 ../fish/guestfish-actions.pod:3608 msgid "" "This call runs a command from the guest filesystem via the guest's C</bin/" "sh>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4614 +#: ../src/guestfs-actions.pod:4637 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4616 ../fish/guestfish-actions.pod:3596 +#: ../src/guestfs-actions.pod:4639 ../fish/guestfish-actions.pod:3613 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -12105,24 +12197,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4618 ../fish/guestfish-actions.pod:3598 +#: ../src/guestfs-actions.pod:4641 ../fish/guestfish-actions.pod:3615 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:4622 +#: ../src/guestfs-actions.pod:4645 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4627 +#: ../src/guestfs-actions.pod:4650 msgid "guestfs_sh_lines" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4629 +#: ../src/guestfs-actions.pod:4652 #, no-wrap msgid "" " char **guestfs_sh_lines (guestfs_h *g,\n" @@ -12131,24 +12223,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4632 +#: ../src/guestfs-actions.pod:4655 msgid "" "This is the same as C<guestfs_sh>, but splits the result into a list of " "lines." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4635 +#: ../src/guestfs-actions.pod:4658 msgid "See also: C<guestfs_command_lines>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4641 +#: ../src/guestfs-actions.pod:4664 msgid "guestfs_sleep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4643 +#: ../src/guestfs-actions.pod:4666 #, no-wrap msgid "" " int guestfs_sleep (guestfs_h *g,\n" @@ -12157,17 +12249,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4646 ../fish/guestfish-actions.pod:3617 +#: ../src/guestfs-actions.pod:4669 ../fish/guestfish-actions.pod:3634 msgid "Sleep for C<secs> seconds." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4650 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:4673 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4652 +#: ../src/guestfs-actions.pod:4675 #, no-wrap msgid "" " struct guestfs_stat *guestfs_stat (guestfs_h *g,\n" @@ -12176,17 +12268,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4657 ../fish/guestfish-actions.pod:3625 +#: ../src/guestfs-actions.pod:4680 ../fish/guestfish-actions.pod:3642 msgid "This is the same as the C<stat(2)> system call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4663 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:4686 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4665 +#: ../src/guestfs-actions.pod:4688 #, no-wrap msgid "" " struct guestfs_statvfs *guestfs_statvfs (guestfs_h *g,\n" @@ -12195,7 +12287,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4668 ../fish/guestfish-actions.pod:3631 +#: ../src/guestfs-actions.pod:4691 ../fish/guestfish-actions.pod:3648 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 " @@ -12203,24 +12295,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4672 ../fish/guestfish-actions.pod:3635 +#: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3652 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4674 +#: ../src/guestfs-actions.pod:4697 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:4678 +#: ../src/guestfs-actions.pod:4701 msgid "guestfs_strings" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4680 +#: ../src/guestfs-actions.pod:4703 #, no-wrap msgid "" " char **guestfs_strings (guestfs_h *g,\n" @@ -12229,19 +12321,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4683 ../fish/guestfish-actions.pod:3641 +#: ../src/guestfs-actions.pod:4706 ../fish/guestfish-actions.pod:3658 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:4693 +#: ../src/guestfs-actions.pod:4716 msgid "guestfs_strings_e" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4695 +#: ../src/guestfs-actions.pod:4718 #, no-wrap msgid "" " char **guestfs_strings_e (guestfs_h *g,\n" @@ -12251,93 +12343,93 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4699 +#: ../src/guestfs-actions.pod:4722 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>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4703 ../fish/guestfish-actions.pod:3655 +#: ../src/guestfs-actions.pod:4726 ../fish/guestfish-actions.pod:3672 msgid "Allowed encodings are:" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4707 ../fish/guestfish-actions.pod:3659 +#: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3676 msgid "s" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4709 +#: ../src/guestfs-actions.pod:4732 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4712 ../fish/guestfish-actions.pod:3664 +#: ../src/guestfs-actions.pod:4735 ../fish/guestfish-actions.pod:3681 msgid "S" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4714 ../fish/guestfish-actions.pod:3666 +#: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3683 msgid "Single 8-bit-byte characters." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4716 ../fish/guestfish-actions.pod:3668 +#: ../src/guestfs-actions.pod:4739 ../fish/guestfish-actions.pod:3685 msgid "b" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4718 ../fish/guestfish-actions.pod:3670 +#: ../src/guestfs-actions.pod:4741 ../fish/guestfish-actions.pod:3687 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4721 ../fish/guestfish-actions.pod:3673 +#: ../src/guestfs-actions.pod:4744 ../fish/guestfish-actions.pod:3690 msgid "l (lower case letter L)" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4723 ../fish/guestfish-actions.pod:3675 +#: ../src/guestfs-actions.pod:4746 ../fish/guestfish-actions.pod:3692 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:4726 ../fish/guestfish-actions.pod:3678 +#: ../src/guestfs-actions.pod:4749 ../fish/guestfish-actions.pod:3695 msgid "B" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4728 ../fish/guestfish-actions.pod:3680 +#: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3697 msgid "32-bit big endian such as UCS-4BE." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3682 +#: ../src/guestfs-actions.pod:4753 ../fish/guestfish-actions.pod:3699 msgid "L" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4732 ../fish/guestfish-actions.pod:3684 +#: ../src/guestfs-actions.pod:4755 ../fish/guestfish-actions.pod:3701 msgid "32-bit little endian such as UCS-4LE." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4736 ../fish/guestfish-actions.pod:3688 +#: ../src/guestfs-actions.pod:4759 ../fish/guestfish-actions.pod:3705 msgid "The returned strings are transcoded to UTF-8." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4745 +#: ../src/guestfs-actions.pod:4768 msgid "guestfs_swapoff_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4747 +#: ../src/guestfs-actions.pod:4770 #, no-wrap msgid "" " int guestfs_swapoff_device (guestfs_h *g,\n" @@ -12346,19 +12438,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4750 +#: ../src/guestfs-actions.pod:4773 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See C<guestfs_swapon_device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4756 +#: ../src/guestfs-actions.pod:4779 msgid "guestfs_swapoff_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4758 +#: ../src/guestfs-actions.pod:4781 #, no-wrap msgid "" " int guestfs_swapoff_file (guestfs_h *g,\n" @@ -12367,17 +12459,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4761 ../fish/guestfish-actions.pod:3705 +#: ../src/guestfs-actions.pod:4784 ../fish/guestfish-actions.pod:3722 msgid "This command disables the libguestfs appliance swap on file." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4765 +#: ../src/guestfs-actions.pod:4788 msgid "guestfs_swapoff_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4767 +#: ../src/guestfs-actions.pod:4790 #, no-wrap msgid "" " int guestfs_swapoff_label (guestfs_h *g,\n" @@ -12386,19 +12478,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4770 ../fish/guestfish-actions.pod:3711 +#: ../src/guestfs-actions.pod:4793 ../fish/guestfish-actions.pod:3728 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4775 +#: ../src/guestfs-actions.pod:4798 msgid "guestfs_swapoff_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4777 +#: ../src/guestfs-actions.pod:4800 #, no-wrap msgid "" " int guestfs_swapoff_uuid (guestfs_h *g,\n" @@ -12407,19 +12499,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4780 ../fish/guestfish-actions.pod:3718 +#: ../src/guestfs-actions.pod:4803 ../fish/guestfish-actions.pod:3735 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4785 +#: ../src/guestfs-actions.pod:4808 msgid "guestfs_swapon_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4787 +#: ../src/guestfs-actions.pod:4810 #, no-wrap msgid "" " int guestfs_swapon_device (guestfs_h *g,\n" @@ -12428,7 +12520,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4790 +#: ../src/guestfs-actions.pod:4813 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 " @@ -12436,7 +12528,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4795 ../fish/guestfish-actions.pod:3730 +#: ../src/guestfs-actions.pod:4818 ../fish/guestfish-actions.pod:3747 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 " @@ -12446,12 +12538,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4804 +#: ../src/guestfs-actions.pod:4827 msgid "guestfs_swapon_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4806 +#: ../src/guestfs-actions.pod:4829 #, no-wrap msgid "" " int guestfs_swapon_file (guestfs_h *g,\n" @@ -12460,19 +12552,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4809 +#: ../src/guestfs-actions.pod:4832 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4814 +#: ../src/guestfs-actions.pod:4837 msgid "guestfs_swapon_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4816 +#: ../src/guestfs-actions.pod:4839 #, no-wrap msgid "" " int guestfs_swapon_label (guestfs_h *g,\n" @@ -12481,19 +12573,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4819 +#: ../src/guestfs-actions.pod:4842 msgid "" "This command enables swap to a labeled swap partition. See " "C<guestfs_swapon_device> for other notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4824 +#: ../src/guestfs-actions.pod:4847 msgid "guestfs_swapon_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4826 +#: ../src/guestfs-actions.pod:4849 #, no-wrap msgid "" " int guestfs_swapon_uuid (guestfs_h *g,\n" @@ -12502,19 +12594,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4829 +#: ../src/guestfs-actions.pod:4852 msgid "" "This command enables swap to a swap partition with the given UUID. See " "C<guestfs_swapon_device> for other notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4834 +#: ../src/guestfs-actions.pod:4857 msgid "guestfs_sync" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4836 +#: ../src/guestfs-actions.pod:4859 #, no-wrap msgid "" " int guestfs_sync (guestfs_h *g);\n" @@ -12522,26 +12614,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4838 ../fish/guestfish-actions.pod:3762 +#: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3779 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4841 ../fish/guestfish-actions.pod:3765 +#: ../src/guestfs-actions.pod:4864 ../fish/guestfish-actions.pod:3782 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4846 +#: ../src/guestfs-actions.pod:4869 msgid "guestfs_tail" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4848 +#: ../src/guestfs-actions.pod:4871 #, no-wrap msgid "" " char **guestfs_tail (guestfs_h *g,\n" @@ -12550,18 +12642,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4851 ../fish/guestfish-actions.pod:3772 +#: ../src/guestfs-actions.pod:4874 ../fish/guestfish-actions.pod:3789 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:4861 +#: ../src/guestfs-actions.pod:4884 msgid "guestfs_tail_n" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4863 +#: ../src/guestfs-actions.pod:4886 #, no-wrap msgid "" " char **guestfs_tail_n (guestfs_h *g,\n" @@ -12571,26 +12663,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4867 ../fish/guestfish-actions.pod:3782 +#: ../src/guestfs-actions.pod:4890 ../fish/guestfish-actions.pod:3799 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:4870 ../fish/guestfish-actions.pod:3785 +#: ../src/guestfs-actions.pod:4893 ../fish/guestfish-actions.pod:3802 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:4882 +#: ../src/guestfs-actions.pod:4905 msgid "guestfs_tar_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4884 +#: ../src/guestfs-actions.pod:4907 #, no-wrap msgid "" " int guestfs_tar_in (guestfs_h *g,\n" @@ -12600,25 +12692,25 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3797 +#: ../src/guestfs-actions.pod:4911 ../fish/guestfish-actions.pod:3814 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:4891 +#: ../src/guestfs-actions.pod:4914 msgid "" "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4896 +#: ../src/guestfs-actions.pod:4919 msgid "guestfs_tar_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4898 +#: ../src/guestfs-actions.pod:4921 #, no-wrap msgid "" " int guestfs_tar_out (guestfs_h *g,\n" @@ -12628,26 +12720,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4902 ../fish/guestfish-actions.pod:3809 +#: ../src/guestfs-actions.pod:4925 ../fish/guestfish-actions.pod:3826 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4905 +#: ../src/guestfs-actions.pod:4928 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4910 +#: ../src/guestfs-actions.pod:4933 msgid "guestfs_tgz_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4912 +#: ../src/guestfs-actions.pod:4935 #, no-wrap msgid "" " int guestfs_tgz_in (guestfs_h *g,\n" @@ -12657,24 +12749,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4916 ../fish/guestfish-actions.pod:3821 +#: ../src/guestfs-actions.pod:4939 ../fish/guestfish-actions.pod:3838 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:4919 +#: ../src/guestfs-actions.pod:4942 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4923 +#: ../src/guestfs-actions.pod:4946 msgid "guestfs_tgz_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4925 +#: ../src/guestfs-actions.pod:4948 #, no-wrap msgid "" " int guestfs_tgz_out (guestfs_h *g,\n" @@ -12684,24 +12776,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4929 ../fish/guestfish-actions.pod:3832 +#: ../src/guestfs-actions.pod:4952 ../fish/guestfish-actions.pod:3849 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4932 +#: ../src/guestfs-actions.pod:4955 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4936 +#: ../src/guestfs-actions.pod:4959 msgid "guestfs_touch" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4938 +#: ../src/guestfs-actions.pod:4961 #, no-wrap msgid "" " int guestfs_touch (guestfs_h *g,\n" @@ -12710,7 +12802,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4941 ../fish/guestfish-actions.pod:3843 +#: ../src/guestfs-actions.pod:4964 ../fish/guestfish-actions.pod:3860 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 zero-" @@ -12718,19 +12810,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4945 ../fish/guestfish-actions.pod:3847 +#: ../src/guestfs-actions.pod:4968 ../fish/guestfish-actions.pod:3864 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:4950 +#: ../src/guestfs-actions.pod:4973 msgid "guestfs_truncate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4952 +#: ../src/guestfs-actions.pod:4975 #, no-wrap msgid "" " int guestfs_truncate (guestfs_h *g,\n" @@ -12739,19 +12831,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4955 ../fish/guestfish-actions.pod:3854 +#: ../src/guestfs-actions.pod:4978 ../fish/guestfish-actions.pod:3871 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4960 +#: ../src/guestfs-actions.pod:4983 msgid "guestfs_truncate_size" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4962 +#: ../src/guestfs-actions.pod:4985 #, no-wrap msgid "" " int guestfs_truncate_size (guestfs_h *g,\n" @@ -12761,14 +12853,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4966 ../fish/guestfish-actions.pod:3861 +#: ../src/guestfs-actions.pod:4989 ../fish/guestfish-actions.pod:3878 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4969 +#: ../src/guestfs-actions.pod:4992 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 " @@ -12777,12 +12869,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4977 +#: ../src/guestfs-actions.pod:5000 msgid "guestfs_tune2fs_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4979 +#: ../src/guestfs-actions.pod:5002 #, no-wrap msgid "" " char **guestfs_tune2fs_l (guestfs_h *g,\n" @@ -12791,14 +12883,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4982 ../fish/guestfish-actions.pod:3874 +#: ../src/guestfs-actions.pod:5005 ../fish/guestfish-actions.pod:3891 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4985 ../fish/guestfish-actions.pod:3877 +#: ../src/guestfs-actions.pod:5008 ../fish/guestfish-actions.pod:3894 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 " @@ -12807,12 +12899,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4996 +#: ../src/guestfs-actions.pod:5019 msgid "guestfs_txz_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4998 +#: ../src/guestfs-actions.pod:5021 #, no-wrap msgid "" " int guestfs_txz_in (guestfs_h *g,\n" @@ -12822,19 +12914,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5002 ../fish/guestfish-actions.pod:3886 +#: ../src/guestfs-actions.pod:5025 ../fish/guestfish-actions.pod:3903 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:5007 +#: ../src/guestfs-actions.pod:5030 msgid "guestfs_txz_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5009 +#: ../src/guestfs-actions.pod:5032 #, no-wrap msgid "" " int guestfs_txz_out (guestfs_h *g,\n" @@ -12844,19 +12936,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5013 ../fish/guestfish-actions.pod:3895 +#: ../src/guestfs-actions.pod:5036 ../fish/guestfish-actions.pod:3912 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:5018 +#: ../src/guestfs-actions.pod:5041 msgid "guestfs_umask" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5020 +#: ../src/guestfs-actions.pod:5043 #, no-wrap msgid "" " int guestfs_umask (guestfs_h *g,\n" @@ -12865,14 +12957,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5023 ../fish/guestfish-actions.pod:3904 +#: ../src/guestfs-actions.pod:5046 ../fish/guestfish-actions.pod:3921 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:5026 ../fish/guestfish-actions.pod:3907 +#: ../src/guestfs-actions.pod:5049 ../fish/guestfish-actions.pod:3924 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 " @@ -12880,7 +12972,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5031 ../fish/guestfish-actions.pod:3912 +#: ../src/guestfs-actions.pod:5054 ../fish/guestfish-actions.pod:3929 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 " @@ -12888,24 +12980,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5035 +#: ../src/guestfs-actions.pod:5058 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5038 ../fish/guestfish-actions.pod:3919 +#: ../src/guestfs-actions.pod:5061 ../fish/guestfish-actions.pod:3936 msgid "This call returns the previous umask." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5042 +#: ../src/guestfs-actions.pod:5065 msgid "guestfs_umount" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5044 +#: ../src/guestfs-actions.pod:5067 #, no-wrap msgid "" " int guestfs_umount (guestfs_h *g,\n" @@ -12914,19 +13006,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5047 ../fish/guestfish-actions.pod:3927 +#: ../src/guestfs-actions.pod:5070 ../fish/guestfish-actions.pod:3944 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:5053 +#: ../src/guestfs-actions.pod:5076 msgid "guestfs_umount_all" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5055 +#: ../src/guestfs-actions.pod:5078 #, no-wrap msgid "" " int guestfs_umount_all (guestfs_h *g);\n" @@ -12934,22 +13026,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5057 ../fish/guestfish-actions.pod:3937 +#: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3954 msgid "This unmounts all mounted filesystems." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5059 ../fish/guestfish-actions.pod:3939 +#: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3956 msgid "Some internal mounts are not unmounted by this call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5063 +#: ../src/guestfs-actions.pod:5086 msgid "guestfs_upload" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5065 +#: ../src/guestfs-actions.pod:5088 #, no-wrap msgid "" " int guestfs_upload (guestfs_h *g,\n" @@ -12959,23 +13051,23 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5069 ../src/guestfs-actions.pod:5085 -#: ../fish/guestfish-actions.pod:3945 ../fish/guestfish-actions.pod:3958 +#: ../src/guestfs-actions.pod:5092 ../src/guestfs-actions.pod:5108 +#: ../fish/guestfish-actions.pod:3962 ../fish/guestfish-actions.pod:3975 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5074 +#: ../src/guestfs-actions.pod:5097 msgid "See also C<guestfs_download>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5078 +#: ../src/guestfs-actions.pod:5101 msgid "guestfs_upload_offset" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5080 +#: ../src/guestfs-actions.pod:5103 #, no-wrap msgid "" " int guestfs_upload_offset (guestfs_h *g,\n" @@ -12986,7 +13078,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3961 +#: ../src/guestfs-actions.pod:5111 ../fish/guestfish-actions.pod:3978 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -12996,7 +13088,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5095 +#: ../src/guestfs-actions.pod:5118 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 " @@ -13004,17 +13096,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5100 +#: ../src/guestfs-actions.pod:5123 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5104 +#: ../src/guestfs-actions.pod:5127 msgid "guestfs_utimens" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5106 +#: ../src/guestfs-actions.pod:5129 #, no-wrap msgid "" " int guestfs_utimens (guestfs_h *g,\n" @@ -13027,26 +13119,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5113 ../fish/guestfish-actions.pod:3981 +#: ../src/guestfs-actions.pod:5136 ../fish/guestfish-actions.pod:3998 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5116 ../fish/guestfish-actions.pod:3984 +#: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:4001 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5119 ../fish/guestfish-actions.pod:3987 +#: ../src/guestfs-actions.pod:5142 ../fish/guestfish-actions.pod:4004 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3990 +#: ../src/guestfs-actions.pod:5145 ../fish/guestfish-actions.pod:4007 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 " @@ -13054,7 +13146,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5126 ../fish/guestfish-actions.pod:3994 +#: ../src/guestfs-actions.pod:5149 ../fish/guestfish-actions.pod:4011 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 " @@ -13062,12 +13154,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5132 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:5155 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5134 +#: ../src/guestfs-actions.pod:5157 #, no-wrap msgid "" " struct guestfs_version *guestfs_version (guestfs_h *g);\n" @@ -13075,13 +13167,13 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5136 ../fish/guestfish-actions.pod:4002 +#: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:4019 msgid "" "Return the libguestfs version number that the program is linked against." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:4005 +#: ../src/guestfs-actions.pod:5162 ../fish/guestfish-actions.pod:4022 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 " @@ -13090,7 +13182,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:4010 +#: ../src/guestfs-actions.pod:5167 ../fish/guestfish-actions.pod:4027 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 " @@ -13099,7 +13191,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5150 ../fish/guestfish-actions.pod:4016 +#: ../src/guestfs-actions.pod:5173 ../fish/guestfish-actions.pod:4033 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 " @@ -13108,18 +13200,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5156 ../fish/guestfish-actions.pod:4022 +#: ../src/guestfs-actions.pod:5179 ../fish/guestfish-actions.pod:4039 msgid "" "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:4025 +#: ../src/guestfs-actions.pod:5182 ../fish/guestfish-actions.pod:4042 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5161 +#: ../src/guestfs-actions.pod:5184 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -13128,19 +13220,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5167 +#: ../src/guestfs-actions.pod:5190 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: =head2 -#: ../src/guestfs-actions.pod:5171 +#: ../src/guestfs-actions.pod:5194 msgid "guestfs_vfs_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5173 +#: ../src/guestfs-actions.pod:5196 #, no-wrap msgid "" " char *guestfs_vfs_label (guestfs_h *g,\n" @@ -13149,27 +13241,27 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5176 ../fish/guestfish-actions.pod:4037 +#: ../src/guestfs-actions.pod:5199 ../fish/guestfish-actions.pod:4054 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5179 ../fish/guestfish-actions.pod:4040 +#: ../src/guestfs-actions.pod:5202 ../fish/guestfish-actions.pod:4057 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5181 +#: ../src/guestfs-actions.pod:5204 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5186 +#: ../src/guestfs-actions.pod:5209 msgid "guestfs_vfs_type" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5188 +#: ../src/guestfs-actions.pod:5211 #, no-wrap msgid "" " char *guestfs_vfs_type (guestfs_h *g,\n" @@ -13178,14 +13270,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5191 ../fish/guestfish-actions.pod:4048 +#: ../src/guestfs-actions.pod:5214 ../fish/guestfish-actions.pod:4065 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5194 ../fish/guestfish-actions.pod:4051 +#: ../src/guestfs-actions.pod:5217 ../fish/guestfish-actions.pod:4068 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 " @@ -13193,12 +13285,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5202 +#: ../src/guestfs-actions.pod:5225 msgid "guestfs_vfs_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5204 +#: ../src/guestfs-actions.pod:5227 #, no-wrap msgid "" " char *guestfs_vfs_uuid (guestfs_h *g,\n" @@ -13207,27 +13299,27 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5207 ../fish/guestfish-actions.pod:4060 +#: ../src/guestfs-actions.pod:5230 ../fish/guestfish-actions.pod:4077 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5210 ../fish/guestfish-actions.pod:4063 +#: ../src/guestfs-actions.pod:5233 ../fish/guestfish-actions.pod:4080 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5212 +#: ../src/guestfs-actions.pod:5235 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5217 +#: ../src/guestfs-actions.pod:5240 msgid "guestfs_vg_activate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5219 +#: ../src/guestfs-actions.pod:5242 #, no-wrap msgid "" " int guestfs_vg_activate (guestfs_h *g,\n" @@ -13237,7 +13329,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5223 ../fish/guestfish-actions.pod:4071 +#: ../src/guestfs-actions.pod:5246 ../fish/guestfish-actions.pod:4088 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>. If activated, then they " @@ -13246,24 +13338,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5229 ../fish/guestfish-actions.pod:4077 +#: ../src/guestfs-actions.pod:5252 ../fish/guestfish-actions.pod:4094 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5231 ../fish/guestfish-actions.pod:4079 +#: ../src/guestfs-actions.pod:5254 ../fish/guestfish-actions.pod:4096 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:5236 +#: ../src/guestfs-actions.pod:5259 msgid "guestfs_vg_activate_all" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5238 +#: ../src/guestfs-actions.pod:5261 #, no-wrap msgid "" " int guestfs_vg_activate_all (guestfs_h *g,\n" @@ -13272,7 +13364,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5241 ../fish/guestfish-actions.pod:4086 +#: ../src/guestfs-actions.pod:5264 ../fish/guestfish-actions.pod:4103 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups. If activated, then they are made known to the " @@ -13281,17 +13373,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5247 ../fish/guestfish-actions.pod:4092 +#: ../src/guestfs-actions.pod:5270 ../fish/guestfish-actions.pod:4109 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5251 +#: ../src/guestfs-actions.pod:5274 msgid "guestfs_vgcreate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5253 +#: ../src/guestfs-actions.pod:5276 #, no-wrap msgid "" " int guestfs_vgcreate (guestfs_h *g,\n" @@ -13301,19 +13393,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5257 ../fish/guestfish-actions.pod:4098 +#: ../src/guestfs-actions.pod:5280 ../fish/guestfish-actions.pod:4115 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:5262 +#: ../src/guestfs-actions.pod:5285 msgid "guestfs_vglvuuids" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5287 #, no-wrap msgid "" " char **guestfs_vglvuuids (guestfs_h *g,\n" @@ -13322,31 +13414,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5267 ../fish/guestfish-actions.pod:4105 +#: ../src/guestfs-actions.pod:5290 ../fish/guestfish-actions.pod:4122 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:5270 +#: ../src/guestfs-actions.pod:5293 msgid "" "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " "associate logical volumes and volume groups." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5273 +#: ../src/guestfs-actions.pod:5296 msgid "See also C<guestfs_vgpvuuids>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5279 +#: ../src/guestfs-actions.pod:5302 msgid "guestfs_vgpvuuids" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5281 +#: ../src/guestfs-actions.pod:5304 #, no-wrap msgid "" " char **guestfs_vgpvuuids (guestfs_h *g,\n" @@ -13355,31 +13447,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5284 ../fish/guestfish-actions.pod:4117 +#: ../src/guestfs-actions.pod:5307 ../fish/guestfish-actions.pod:4134 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:5287 +#: ../src/guestfs-actions.pod:5310 msgid "" "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " "associate physical volumes and volume groups." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5290 +#: ../src/guestfs-actions.pod:5313 msgid "See also C<guestfs_vglvuuids>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5296 +#: ../src/guestfs-actions.pod:5319 msgid "guestfs_vgremove" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5298 +#: ../src/guestfs-actions.pod:5321 #, no-wrap msgid "" " int guestfs_vgremove (guestfs_h *g,\n" @@ -13388,23 +13480,23 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5301 ../fish/guestfish-actions.pod:4129 +#: ../src/guestfs-actions.pod:5324 ../fish/guestfish-actions.pod:4146 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5303 ../fish/guestfish-actions.pod:4131 +#: ../src/guestfs-actions.pod:5326 ../fish/guestfish-actions.pod:4148 msgid "" "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5308 +#: ../src/guestfs-actions.pod:5331 msgid "guestfs_vgrename" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5310 +#: ../src/guestfs-actions.pod:5333 #, no-wrap msgid "" " int guestfs_vgrename (guestfs_h *g,\n" @@ -13414,17 +13506,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5314 ../fish/guestfish-actions.pod:4138 +#: ../src/guestfs-actions.pod:5337 ../fish/guestfish-actions.pod:4155 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5318 +#: ../src/guestfs-actions.pod:5341 msgid "guestfs_vgs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5320 +#: ../src/guestfs-actions.pod:5343 #, no-wrap msgid "" " char **guestfs_vgs (guestfs_h *g);\n" @@ -13432,31 +13524,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5322 ../fish/guestfish-actions.pod:4144 +#: ../src/guestfs-actions.pod:5345 ../fish/guestfish-actions.pod:4161 msgid "" "List all the volumes groups detected. This is the equivalent of the L<vgs(8)" "> command." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5325 ../fish/guestfish-actions.pod:4147 +#: ../src/guestfs-actions.pod:5348 ../fish/guestfish-actions.pod:4164 msgid "" "This returns a list of just the volume group names that were detected (eg. " "C<VolGroup00>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5328 +#: ../src/guestfs-actions.pod:5351 msgid "See also C<guestfs_vgs_full>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5334 +#: ../src/guestfs-actions.pod:5357 msgid "guestfs_vgs_full" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5336 +#: ../src/guestfs-actions.pod:5359 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *guestfs_vgs_full (guestfs_h *g);\n" @@ -13464,14 +13556,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5338 ../fish/guestfish-actions.pod:4156 +#: ../src/guestfs-actions.pod:5361 ../fish/guestfish-actions.pod:4173 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:5341 +#: ../src/guestfs-actions.pod:5364 msgid "" "This function returns a C<struct guestfs_lvm_vg_list *> (see E<lt>guestfs-" "structs.hE<gt>), or NULL if there was an error. I<The caller must call " @@ -13479,12 +13571,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5346 +#: ../src/guestfs-actions.pod:5369 msgid "guestfs_vgscan" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5348 +#: ../src/guestfs-actions.pod:5371 #, no-wrap msgid "" " int guestfs_vgscan (guestfs_h *g);\n" @@ -13492,19 +13584,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5350 ../fish/guestfish-actions.pod:4163 +#: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:4180 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:5355 +#: ../src/guestfs-actions.pod:5378 msgid "guestfs_vguuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5357 +#: ../src/guestfs-actions.pod:5380 #, no-wrap msgid "" " char *guestfs_vguuid (guestfs_h *g,\n" @@ -13513,17 +13605,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:4170 +#: ../src/guestfs-actions.pod:5383 ../fish/guestfish-actions.pod:4187 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5365 +#: ../src/guestfs-actions.pod:5388 msgid "guestfs_wait_ready" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5367 +#: ../src/guestfs-actions.pod:5390 #, no-wrap msgid "" " int guestfs_wait_ready (guestfs_h *g);\n" @@ -13531,12 +13623,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5369 +#: ../src/guestfs-actions.pod:5392 msgid "This function is a no op." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5371 +#: ../src/guestfs-actions.pod:5394 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 " @@ -13544,19 +13636,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5376 +#: ../src/guestfs-actions.pod:5399 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: =head2 -#: ../src/guestfs-actions.pod:5382 +#: ../src/guestfs-actions.pod:5405 msgid "guestfs_wc_c" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5384 +#: ../src/guestfs-actions.pod:5407 #, no-wrap msgid "" " int guestfs_wc_c (guestfs_h *g,\n" @@ -13565,19 +13657,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5387 ../fish/guestfish-actions.pod:4176 +#: ../src/guestfs-actions.pod:5410 ../fish/guestfish-actions.pod:4193 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5392 +#: ../src/guestfs-actions.pod:5415 msgid "guestfs_wc_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5394 +#: ../src/guestfs-actions.pod:5417 #, no-wrap msgid "" " int guestfs_wc_l (guestfs_h *g,\n" @@ -13586,18 +13678,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5397 ../fish/guestfish-actions.pod:4183 +#: ../src/guestfs-actions.pod:5420 ../fish/guestfish-actions.pod:4200 msgid "" "This command counts the lines in a file, using the C<wc -l> external command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5402 +#: ../src/guestfs-actions.pod:5425 msgid "guestfs_wc_w" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5404 +#: ../src/guestfs-actions.pod:5427 #, no-wrap msgid "" " int guestfs_wc_w (guestfs_h *g,\n" @@ -13606,18 +13698,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5407 ../fish/guestfish-actions.pod:4190 +#: ../src/guestfs-actions.pod:5430 ../fish/guestfish-actions.pod:4207 msgid "" "This command counts the words in a file, using the C<wc -w> external command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5412 +#: ../src/guestfs-actions.pod:5435 msgid "guestfs_write" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5414 +#: ../src/guestfs-actions.pod:5437 #, no-wrap msgid "" " int guestfs_write (guestfs_h *g,\n" @@ -13628,19 +13720,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5419 ../fish/guestfish-actions.pod:4197 +#: ../src/guestfs-actions.pod:5442 ../fish/guestfish-actions.pod:4214 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: =head2 -#: ../src/guestfs-actions.pod:5427 +#: ../src/guestfs-actions.pod:5450 msgid "guestfs_write_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5429 +#: ../src/guestfs-actions.pod:5452 #, no-wrap msgid "" " int guestfs_write_file (guestfs_h *g,\n" @@ -13651,39 +13743,39 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5434 ../fish/guestfish-actions.pod:4207 +#: ../src/guestfs-actions.pod:5457 ../fish/guestfish-actions.pod:4224 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:5438 ../fish/guestfish-actions.pod:4211 +#: ../src/guestfs-actions.pod:5461 ../fish/guestfish-actions.pod:4228 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:5442 ../fish/guestfish-actions.pod:4215 +#: ../src/guestfs-actions.pod:5465 ../fish/guestfish-actions.pod:4232 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:5450 ../fish/guestfish-actions.pod:4221 +#: ../src/guestfs-actions.pod:5473 ../fish/guestfish-actions.pod:4238 msgid "" "This function is deprecated. In new code, use the C<write> call instead." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5457 +#: ../src/guestfs-actions.pod:5480 msgid "guestfs_zegrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5459 +#: ../src/guestfs-actions.pod:5482 #, no-wrap msgid "" " char **guestfs_zegrep (guestfs_h *g,\n" @@ -13693,18 +13785,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5463 ../fish/guestfish-actions.pod:4232 +#: ../src/guestfs-actions.pod:5486 ../fish/guestfish-actions.pod:4249 msgid "" "This calls the external C<zegrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5473 +#: ../src/guestfs-actions.pod:5496 msgid "guestfs_zegrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5475 +#: ../src/guestfs-actions.pod:5498 #, no-wrap msgid "" " char **guestfs_zegrepi (guestfs_h *g,\n" @@ -13714,18 +13806,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5479 ../fish/guestfish-actions.pod:4242 +#: ../src/guestfs-actions.pod:5502 ../fish/guestfish-actions.pod:4259 msgid "" "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5489 +#: ../src/guestfs-actions.pod:5512 msgid "guestfs_zero" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5491 +#: ../src/guestfs-actions.pod:5514 #, no-wrap msgid "" " int guestfs_zero (guestfs_h *g,\n" @@ -13734,12 +13826,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5494 ../fish/guestfish-actions.pod:4252 +#: ../src/guestfs-actions.pod:5517 ../fish/guestfish-actions.pod:4269 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5496 ../fish/guestfish-actions.pod:4254 +#: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:4271 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 " @@ -13747,17 +13839,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5500 +#: ../src/guestfs-actions.pod:5523 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5509 +#: ../src/guestfs-actions.pod:5532 msgid "guestfs_zero_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5511 +#: ../src/guestfs-actions.pod:5534 #, no-wrap msgid "" " int guestfs_zero_device (guestfs_h *g,\n" @@ -13766,19 +13858,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5514 +#: ../src/guestfs-actions.pod:5537 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: =head2 -#: ../src/guestfs-actions.pod:5528 +#: ../src/guestfs-actions.pod:5551 msgid "guestfs_zerofree" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5530 +#: ../src/guestfs-actions.pod:5553 #, no-wrap msgid "" " int guestfs_zerofree (guestfs_h *g,\n" @@ -13787,7 +13879,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5533 ../fish/guestfish-actions.pod:4275 +#: ../src/guestfs-actions.pod:5556 ../fish/guestfish-actions.pod:4292 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 " @@ -13795,24 +13887,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5538 ../fish/guestfish-actions.pod:4280 +#: ../src/guestfs-actions.pod:5561 ../fish/guestfish-actions.pod:4297 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5541 ../fish/guestfish-actions.pod:4283 +#: ../src/guestfs-actions.pod:5564 ../fish/guestfish-actions.pod:4300 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5546 +#: ../src/guestfs-actions.pod:5569 msgid "guestfs_zfgrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5548 +#: ../src/guestfs-actions.pod:5571 #, no-wrap msgid "" " char **guestfs_zfgrep (guestfs_h *g,\n" @@ -13822,18 +13914,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5552 ../fish/guestfish-actions.pod:4290 +#: ../src/guestfs-actions.pod:5575 ../fish/guestfish-actions.pod:4307 msgid "" "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5562 +#: ../src/guestfs-actions.pod:5585 msgid "guestfs_zfgrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5564 +#: ../src/guestfs-actions.pod:5587 #, no-wrap msgid "" " char **guestfs_zfgrepi (guestfs_h *g,\n" @@ -13843,18 +13935,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5568 ../fish/guestfish-actions.pod:4300 +#: ../src/guestfs-actions.pod:5591 ../fish/guestfish-actions.pod:4317 msgid "" "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5578 +#: ../src/guestfs-actions.pod:5601 msgid "guestfs_zfile" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5580 +#: ../src/guestfs-actions.pod:5603 #, no-wrap msgid "" " char *guestfs_zfile (guestfs_h *g,\n" @@ -13864,36 +13956,36 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5584 ../fish/guestfish-actions.pod:4310 +#: ../src/guestfs-actions.pod:5607 ../fish/guestfish-actions.pod:4327 msgid "" "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5587 ../fish/guestfish-actions.pod:4313 +#: ../src/guestfs-actions.pod:5610 ../fish/guestfish-actions.pod:4330 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5589 +#: ../src/guestfs-actions.pod:5612 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5595 ../fish/guestfish-actions.pod:4318 +#: ../src/guestfs-actions.pod:5618 ../fish/guestfish-actions.pod:4335 msgid "" "This function is deprecated. In new code, use the C<file> call instead." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5602 +#: ../src/guestfs-actions.pod:5625 msgid "guestfs_zgrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5604 +#: ../src/guestfs-actions.pod:5627 #, no-wrap msgid "" " char **guestfs_zgrep (guestfs_h *g,\n" @@ -13903,18 +13995,18 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5608 ../fish/guestfish-actions.pod:4329 +#: ../src/guestfs-actions.pod:5631 ../fish/guestfish-actions.pod:4346 msgid "" "This calls the external C<zgrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5618 +#: ../src/guestfs-actions.pod:5641 msgid "guestfs_zgrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5620 +#: ../src/guestfs-actions.pod:5643 #, no-wrap msgid "" " char **guestfs_zgrepi (guestfs_h *g,\n" @@ -13924,7 +14016,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5624 ../fish/guestfish-actions.pod:4339 +#: ../src/guestfs-actions.pod:5647 ../fish/guestfish-actions.pod:4356 msgid "" "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -14628,8 +14720,8 @@ msgstr "" # type: =head1 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:11 ../tools/virt-edit.pl:45 -#: ../tools/virt-rescue.pl:41 ../tools/virt-tar.pl:60 -#: ../tools/virt-win-reg.pl:52 +#: ../tools/virt-win-reg.pl:52 ../tools/virt-tar.pl:60 +#: ../tools/virt-rescue.pl:41 msgid "WARNING" msgstr "" @@ -14642,20 +14734,37 @@ msgid "" "live." msgstr "" +# type: textblock +#: ../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 " +"functionality of the guestfs API, see L<guestfs(3)>." +msgstr "" + +# type: textblock +#: ../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 " +"broken virtual machine image, you should look at the L<virt-rescue(1)> " +"command." +msgstr "" + # type: =head1 -#: ../fish/guestfish.pod:30 ../fish/guestfish.pod:736 -#: ../fuse/guestmount.pod:35 ../tools/virt-cat.pl:51 ../tools/virt-edit.pl:59 -#: ../tools/virt-resize.pl:66 ../tools/virt-tar.pl:46 +#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:759 +#: ../fuse/guestmount.pod:35 ../tools/virt-edit.pl:59 +#: ../tools/virt-resize.pl:66 ../tools/virt-cat.pl:51 ../tools/virt-tar.pl:46 msgid "EXAMPLES" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:32 +#: ../fish/guestfish.pod:43 msgid "As an interactive shell" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:34 +#: ../fish/guestfish.pod:45 #, no-wrap msgid "" " $ guestfish\n" @@ -14663,7 +14772,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:36 +#: ../fish/guestfish.pod:47 #, no-wrap msgid "" " Welcome to guestfish, the libguestfs filesystem interactive shell for\n" @@ -14672,7 +14781,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:39 +#: ../fish/guestfish.pod:50 #, no-wrap msgid "" " Type: 'help' for a list of commands\n" @@ -14682,25 +14791,36 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:43 +#: ../fish/guestfish.pod:54 #, no-wrap msgid "" -" ><fs> man\n" +" ><fs> add-ro disk.img\n" +" ><fs> run\n" +" ><fs> list-filesystems\n" +" /dev/sda1: ext4\n" +" /dev/vg_guest/lv_root: ext4\n" +" /dev/vg_guest/lv_swap: swap\n" +" ><fs> mount /dev/vg_guest/lv_root /\n" +" ><fs> cat /etc/fstab\n" +" # /etc/fstab\n" +" # Created by anaconda\n" +" [...]\n" +" ><fs> exit\n" "\n" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:45 +#: ../fish/guestfish.pod:67 msgid "From shell scripts" msgstr "" # type: textblock -#: ../fish/guestfish.pod:47 -msgid "Create a new C</etc/motd> file in a guest:" +#: ../fish/guestfish.pod:69 +msgid "Create a new C</etc/motd> file in a guest or disk image:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:49 +#: ../fish/guestfish.pod:71 #, no-wrap msgid "" " guestfish <<_EOF_\n" @@ -14713,12 +14833,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:56 -msgid "List the LVM logical volumes in a guest:" +#: ../fish/guestfish.pod:78 +msgid "List the LVM logical volumes in a disk image:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:58 +#: ../fish/guestfish.pod:80 #, no-wrap msgid "" " guestfish -a disk.img --ro <<_EOF_\n" @@ -14728,18 +14848,34 @@ msgid "" "\n" msgstr "" +# type: textblock +#: ../fish/guestfish.pod:85 +msgid "List all the filesystems in a disk image:" +msgstr "" + +# type: verbatim +#: ../fish/guestfish.pod:87 +#, no-wrap +msgid "" +" guestfish -a disk.img --ro <<_EOF_\n" +" run\n" +" list-filesystems\n" +" _EOF_\n" +"\n" +msgstr "" + # type: =head2 -#: ../fish/guestfish.pod:63 +#: ../fish/guestfish.pod:92 msgid "On one command line" msgstr "" # type: textblock -#: ../fish/guestfish.pod:65 +#: ../fish/guestfish.pod:94 msgid "Update C</etc/resolv.conf> in a guest:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:67 +#: ../fish/guestfish.pod:96 #, no-wrap msgid "" " guestfish \\\n" @@ -14749,12 +14885,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:71 +#: ../fish/guestfish.pod:100 msgid "Edit C</boot/grub/grub.conf> interactively:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:73 +#: ../fish/guestfish.pod:102 #, no-wrap msgid "" " guestfish --add disk.img \\\n" @@ -14765,18 +14901,18 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:78 +#: ../fish/guestfish.pod:107 msgid "Mount disks automatically" msgstr "" # type: textblock -#: ../fish/guestfish.pod:80 +#: ../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:83 +#: ../fish/guestfish.pod:112 #, no-wrap msgid "" " guestfish --ro -a disk.img -i cat /etc/group\n" @@ -14784,25 +14920,38 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:85 +#: ../fish/guestfish.pod:114 #, no-wrap msgid "" " guestfish --ro -d libvirt-domain -i cat /etc/group\n" "\n" msgstr "" +# type: textblock +#: ../fish/guestfish.pod:116 +msgid "Another way to edit C</boot/grub/grub.conf> interactively is:" +msgstr "" + +# type: verbatim +#: ../fish/guestfish.pod:118 +#, no-wrap +msgid "" +" guestfish -a disk.img -i edit /boot/grub/grub.conf\n" +"\n" +msgstr "" + # type: =head2 -#: ../fish/guestfish.pod:87 +#: ../fish/guestfish.pod:120 msgid "As a script interpreter" msgstr "" # type: textblock -#: ../fish/guestfish.pod:89 +#: ../fish/guestfish.pod:122 msgid "Create a 100MB disk containing an ext2-formatted partition:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:91 +#: ../fish/guestfish.pod:124 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" @@ -14814,19 +14963,19 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:97 +#: ../fish/guestfish.pod:130 msgid "Start with a prepared disk" msgstr "" # type: textblock -#: ../fish/guestfish.pod:99 +#: ../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:102 +#: ../fish/guestfish.pod:135 #, no-wrap msgid "" " guestfish -N fs\n" @@ -14834,12 +14983,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:104 +#: ../fish/guestfish.pod:137 msgid "To list what is available do:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:106 ../fish/guestfish.pod:727 +#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:750 #, no-wrap msgid "" " guestfish -N help | less\n" @@ -14847,114 +14996,97 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:108 +#: ../fish/guestfish.pod:141 msgid "Remote control" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:110 +#: ../fish/guestfish.pod:143 #, no-wrap msgid "" -" eval `guestfish --listen --ro`\n" -" guestfish --remote add disk.img\n" +" eval `guestfish --listen`\n" +" guestfish --remote add-ro disk.img\n" " guestfish --remote run\n" " guestfish --remote lvs\n" "\n" msgstr "" -# type: textblock -#: ../fish/guestfish.pod:117 -msgid "" -"Guestfish is a shell and command-line tool for examining and modifying " -"virtual machine filesystems. It uses libguestfs and exposes all of the " -"functionality of the guestfs API, see L<guestfs(3)>." -msgstr "" - -# type: textblock -#: ../fish/guestfish.pod:121 -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 " -"broken virtual machine image, you should look at the L<virt-rescue(1)> " -"command." -msgstr "" - # type: =head1 -#: ../fish/guestfish.pod:126 ../test-tool/libguestfs-test-tool.pod:37 +#: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 #: ../fuse/guestmount.pod:70 ../inspector/virt-inspector.pl:75 -#: ../tools/virt-cat.pl:80 ../tools/virt-df.pl:71 ../tools/virt-edit.pl:73 -#: ../tools/virt-list-filesystems.pl:50 ../tools/virt-list-partitions.pl:51 -#: ../tools/virt-ls.pl:79 ../tools/virt-make-fs.pl:153 -#: ../tools/virt-rescue.pl:103 ../tools/virt-resize.pl:233 -#: ../tools/virt-tar.pl:99 ../tools/virt-win-reg.pl:172 +#: ../tools/virt-edit.pl:73 ../tools/virt-win-reg.pl:172 +#: ../tools/virt-df.pl:71 ../tools/virt-ls.pl:79 ../tools/virt-resize.pl:233 +#: ../tools/virt-list-filesystems.pl:50 ../tools/virt-cat.pl:80 +#: ../tools/virt-tar.pl:99 ../tools/virt-rescue.pl:103 +#: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:51 msgid "OPTIONS" msgstr "" # type: =item -#: ../fish/guestfish.pod:130 ../fuse/guestmount.pod:94 -#: ../inspector/virt-inspector.pl:83 ../tools/virt-cat.pl:88 -#: ../tools/virt-df.pl:79 ../tools/virt-edit.pl:81 -#: ../tools/virt-list-filesystems.pl:58 ../tools/virt-list-partitions.pl:59 -#: ../tools/virt-ls.pl:87 ../tools/virt-make-fs.pl:161 -#: ../tools/virt-rescue.pl:111 ../tools/virt-resize.pl:241 -#: ../tools/virt-tar.pl:107 ../tools/virt-win-reg.pl:180 +#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:94 +#: ../inspector/virt-inspector.pl:83 ../tools/virt-edit.pl:81 +#: ../tools/virt-win-reg.pl:180 ../tools/virt-df.pl:79 ../tools/virt-ls.pl:87 +#: ../tools/virt-resize.pl:241 ../tools/virt-list-filesystems.pl:58 +#: ../tools/virt-cat.pl:88 ../tools/virt-tar.pl:107 +#: ../tools/virt-rescue.pl:111 ../tools/virt-make-fs.pl:161 +#: ../tools/virt-list-partitions.pl:59 msgid "B<--help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:132 +#: ../fish/guestfish.pod:154 msgid "Displays general help on options." msgstr "" # type: =item -#: ../fish/guestfish.pod:134 +#: ../fish/guestfish.pod:156 msgid "B<-h> | B<--cmd-help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:136 +#: ../fish/guestfish.pod:158 msgid "Lists all available guestfish commands." msgstr "" # type: =item -#: ../fish/guestfish.pod:138 +#: ../fish/guestfish.pod:160 msgid "B<-h cmd> | B<--cmd-help cmd>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:140 +#: ../fish/guestfish.pod:162 msgid "Displays detailed help on a single command C<cmd>." msgstr "" # type: =item -#: ../fish/guestfish.pod:142 ../fuse/guestmount.pod:74 +#: ../fish/guestfish.pod:164 ../fuse/guestmount.pod:74 msgid "B<-a image> | B<--add image>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:144 +#: ../fish/guestfish.pod:166 msgid "Add a block device or virtual machine image to the shell." msgstr "" # type: =item -#: ../fish/guestfish.pod:146 +#: ../fish/guestfish.pod:168 msgid "B<-c URI> | B<--connect URI>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:148 +#: ../fish/guestfish.pod:170 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:152 +#: ../fish/guestfish.pod:174 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:154 +#: ../fish/guestfish.pod:176 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 " @@ -14962,12 +15094,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:158 +#: ../fish/guestfish.pod:180 msgid "B<-D> | B<--no-dest-paths>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:160 +#: ../fish/guestfish.pod:182 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 " @@ -14976,12 +15108,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:165 +#: ../fish/guestfish.pod:187 msgid "B<--echo-keys>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:167 +#: ../fish/guestfish.pod:189 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 " @@ -14990,17 +15122,17 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:172 +#: ../fish/guestfish.pod:194 msgid "B<-f file> | B<--file file>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:174 +#: ../fish/guestfish.pod:196 msgid "Read commands from C<file>. To write pure guestfish scripts, use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:177 +#: ../fish/guestfish.pod:199 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" @@ -15008,12 +15140,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:179 +#: ../fish/guestfish.pod:201 msgid "B<-i> | B<--inspector>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:181 +#: ../fish/guestfish.pod:203 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 " @@ -15021,12 +15153,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:185 +#: ../fish/guestfish.pod:207 msgid "Typical usage is either:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:187 +#: ../fish/guestfish.pod:209 #, no-wrap msgid "" " guestfish -d myguest -i\n" @@ -15034,12 +15166,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:189 +#: ../fish/guestfish.pod:211 msgid "(for an inactive libvirt domain called I<myguest>), or:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:191 +#: ../fish/guestfish.pod:213 #, no-wrap msgid "" " guestfish --ro -d myguest -i\n" @@ -15047,12 +15179,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:193 +#: ../fish/guestfish.pod:215 msgid "(for active domains, readonly), or specify the block device directly:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:195 +#: ../fish/guestfish.pod:217 #, no-wrap msgid "" " guestfish -a /dev/Guests/MyGuest -i\n" @@ -15060,14 +15192,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:197 +#: ../fish/guestfish.pod:219 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:200 +#: ../fish/guestfish.pod:222 #, no-wrap msgid "" " guestfish [--ro] -i disk.img\n" @@ -15075,7 +15207,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:202 +#: ../fish/guestfish.pod:224 #, no-wrap msgid "" " guestfish [--ro] -i libvirt-domain\n" @@ -15083,58 +15215,58 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:204 +#: ../fish/guestfish.pod:226 msgid "B<--keys-from-stdin>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:206 +#: ../fish/guestfish.pod:228 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:209 +#: ../fish/guestfish.pod:231 msgid "B<--listen>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:211 +#: ../fish/guestfish.pod:233 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:214 +#: ../fish/guestfish.pod:236 msgid "B<-m dev[:mountpoint]> | B<--mount dev[:mountpoint]>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:216 +#: ../fish/guestfish.pod:238 msgid "Mount the named partition or logical volume on the given mountpoint." msgstr "" # type: textblock -#: ../fish/guestfish.pod:218 +#: ../fish/guestfish.pod:240 msgid "If the mountpoint is omitted, it defaults to C</>." msgstr "" # type: textblock -#: ../fish/guestfish.pod:220 +#: ../fish/guestfish.pod:242 msgid "You have to mount something on C</> before most commands will work." msgstr "" # type: textblock -#: ../fish/guestfish.pod:222 +#: ../fish/guestfish.pod:244 msgid "" "If any I<-m> or I<--mount> options are given, the guest is automatically " "launched." msgstr "" # type: textblock -#: ../fish/guestfish.pod:225 +#: ../fish/guestfish.pod:247 msgid "" "If you don't know what filesystems a disk image contains, you can either run " "guestfish without this option, then list the partitions and LVs available " @@ -15143,24 +15275,24 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:230 ../fuse/guestmount.pod:106 +#: ../fish/guestfish.pod:252 ../fuse/guestmount.pod:106 msgid "B<-n> | B<--no-sync>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:232 +#: ../fish/guestfish.pod:254 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:235 +#: ../fish/guestfish.pod:257 msgid "B<-N type> | B<--new type> | B<-N help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:237 +#: ../fish/guestfish.pod:259 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 " @@ -15169,58 +15301,58 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:242 +#: ../fish/guestfish.pod:264 msgid "B<--progress-bars>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:244 +#: ../fish/guestfish.pod:266 msgid "Enable progress bars, even when guestfish is used non-interactively." msgstr "" # type: textblock -#: ../fish/guestfish.pod:246 +#: ../fish/guestfish.pod:268 msgid "" "Progress bars are enabled by default when guestfish is used as an " "interactive shell." msgstr "" # type: =item -#: ../fish/guestfish.pod:249 +#: ../fish/guestfish.pod:271 msgid "B<--no-progress-bars>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:251 +#: ../fish/guestfish.pod:273 msgid "Disable progress bars." msgstr "" # type: =item -#: ../fish/guestfish.pod:253 +#: ../fish/guestfish.pod:275 msgid "B<--remote[=pid]>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:255 +#: ../fish/guestfish.pod:277 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:258 ../fuse/guestmount.pod:148 +#: ../fish/guestfish.pod:280 ../fuse/guestmount.pod:148 msgid "B<-r> | B<--ro>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:260 +#: ../fish/guestfish.pod:282 msgid "" "This changes the I<-a> and I<-m> options so that disks are added and mounts " "are done read-only (see L<guestfs(3)/guestfs_mount_ro>)." msgstr "" # type: textblock -#: ../fish/guestfish.pod:263 ../tools/virt-rescue.pl:162 +#: ../fish/guestfish.pod:285 ../tools/virt-rescue.pl:162 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 " @@ -15228,74 +15360,74 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:267 +#: ../fish/guestfish.pod:289 msgid "" "Note that prepared disk images created with I<-N> are not affected by the " "I<--ro> option." msgstr "" # type: =item -#: ../fish/guestfish.pod:270 ../fuse/guestmount.pod:158 +#: ../fish/guestfish.pod:292 ../fuse/guestmount.pod:158 #: ../tools/virt-rescue.pl:170 msgid "B<--selinux>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:272 +#: ../fish/guestfish.pod:294 msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>." msgstr "" # type: =item -#: ../fish/guestfish.pod:274 ../fuse/guestmount.pod:168 +#: ../fish/guestfish.pod:296 ../fuse/guestmount.pod:168 msgid "B<-v> | B<--verbose>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:276 +#: ../fish/guestfish.pod:298 msgid "" "Enable very verbose messages. This is particularly useful if you find a bug." msgstr "" # type: =item -#: ../fish/guestfish.pod:279 ../fuse/guestmount.pod:172 +#: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:172 msgid "B<-V> | B<--version>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:281 +#: ../fish/guestfish.pod:303 msgid "Display the guestfish / libguestfs version number and exit." msgstr "" # type: =item -#: ../fish/guestfish.pod:283 +#: ../fish/guestfish.pod:305 msgid "B<-x>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:285 +#: ../fish/guestfish.pod:307 msgid "Echo each command before executing it." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:289 +#: ../fish/guestfish.pod:311 msgid "COMMANDS ON COMMAND LINE" msgstr "" # type: textblock -#: ../fish/guestfish.pod:291 +#: ../fish/guestfish.pod:313 msgid "" "Any additional (non-option) arguments are treated as commands to execute." msgstr "" # type: textblock -#: ../fish/guestfish.pod:294 +#: ../fish/guestfish.pod:316 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:297 +#: ../fish/guestfish.pod:319 #, no-wrap msgid "" " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n" @@ -15303,7 +15435,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:299 +#: ../fish/guestfish.pod:321 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 non-" @@ -15311,7 +15443,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:303 +#: ../fish/guestfish.pod:325 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 " @@ -15319,12 +15451,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:308 +#: ../fish/guestfish.pod:330 msgid "USING launch (OR run)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:310 +#: ../fish/guestfish.pod:332 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 actions/" @@ -15332,54 +15464,54 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:318 +#: ../fish/guestfish.pod:340 msgid "add or -a/--add" msgstr "" # type: textblock -#: ../fish/guestfish.pod:322 +#: ../fish/guestfish.pod:344 msgid "launch (aka run)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:326 +#: ../fish/guestfish.pod:348 msgid "mount or -m/--mount" msgstr "" # type: textblock -#: ../fish/guestfish.pod:330 +#: ../fish/guestfish.pod:352 msgid "any other commands" msgstr "" # type: textblock -#: ../fish/guestfish.pod:334 +#: ../fish/guestfish.pod:356 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:337 +#: ../fish/guestfish.pod:359 msgid "" -"The only exception is that if the I<-m> or I<--mount> option was given, the " -"guest is automatically run for you (simply because guestfish can't mount the " -"disks you asked for without doing this)." +"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 " +"because guestfish can't perform the action you asked for without doing this." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:341 +#: ../fish/guestfish.pod:364 msgid "QUOTING" msgstr "" # type: textblock -#: ../fish/guestfish.pod:343 +#: ../fish/guestfish.pod:366 msgid "" "You can quote ordinary parameters using either single or double quotes. For " "example:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:346 +#: ../fish/guestfish.pod:369 #, no-wrap msgid "" " add \"file with a space.img\"\n" @@ -15387,7 +15519,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:348 +#: ../fish/guestfish.pod:371 #, no-wrap msgid "" " rm '/file name'\n" @@ -15395,7 +15527,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:350 +#: ../fish/guestfish.pod:373 #, no-wrap msgid "" " rm '/\"'\n" @@ -15403,7 +15535,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:352 +#: ../fish/guestfish.pod:375 msgid "" "A few commands require a list of strings to be passed. For these, use a " "whitespace-separated list, enclosed in quotes. Strings containing " @@ -15412,7 +15544,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:357 +#: ../fish/guestfish.pod:380 #, no-wrap msgid "" " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n" @@ -15422,195 +15554,195 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:361 +#: ../fish/guestfish.pod:384 msgid "NUMBERS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:363 +#: ../fish/guestfish.pod:386 msgid "" "This section applies to all commands which can take integers as parameters." msgstr "" # type: =head2 -#: ../fish/guestfish.pod:366 +#: ../fish/guestfish.pod:389 msgid "SIZE SUFFIX" msgstr "" # type: textblock -#: ../fish/guestfish.pod:368 +#: ../fish/guestfish.pod:391 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:374 +#: ../fish/guestfish.pod:397 msgid "B<k> or B<K> or B<KiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:376 +#: ../fish/guestfish.pod:399 msgid "The size in kilobytes (multiplied by 1024)." msgstr "" # type: =item -#: ../fish/guestfish.pod:378 +#: ../fish/guestfish.pod:401 msgid "B<KB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:380 +#: ../fish/guestfish.pod:403 msgid "The size in SI 1000 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:382 +#: ../fish/guestfish.pod:405 msgid "B<M> or B<MiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:384 +#: ../fish/guestfish.pod:407 msgid "The size in megabytes (multiplied by 1048576)." msgstr "" # type: =item -#: ../fish/guestfish.pod:386 +#: ../fish/guestfish.pod:409 msgid "B<MB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:388 +#: ../fish/guestfish.pod:411 msgid "The size in SI 1000000 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:390 +#: ../fish/guestfish.pod:413 msgid "B<G> or B<GiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:392 +#: ../fish/guestfish.pod:415 msgid "The size in gigabytes (multiplied by 2**30)." msgstr "" # type: =item -#: ../fish/guestfish.pod:394 +#: ../fish/guestfish.pod:417 msgid "B<GB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:396 +#: ../fish/guestfish.pod:419 msgid "The size in SI 10**9 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:398 +#: ../fish/guestfish.pod:421 msgid "B<T> or B<TiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:400 +#: ../fish/guestfish.pod:423 msgid "The size in terabytes (multiplied by 2**40)." msgstr "" # type: =item -#: ../fish/guestfish.pod:402 +#: ../fish/guestfish.pod:425 msgid "B<TB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:404 +#: ../fish/guestfish.pod:427 msgid "The size in SI 10**12 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:406 +#: ../fish/guestfish.pod:429 msgid "B<P> or B<PiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:408 +#: ../fish/guestfish.pod:431 msgid "The size in petabytes (multiplied by 2**50)." msgstr "" # type: =item -#: ../fish/guestfish.pod:410 +#: ../fish/guestfish.pod:433 msgid "B<PB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:412 +#: ../fish/guestfish.pod:435 msgid "The size in SI 10**15 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:414 +#: ../fish/guestfish.pod:437 msgid "B<E> or B<EiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:416 +#: ../fish/guestfish.pod:439 msgid "The size in exabytes (multiplied by 2**60)." msgstr "" # type: =item -#: ../fish/guestfish.pod:418 +#: ../fish/guestfish.pod:441 msgid "B<EB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:420 +#: ../fish/guestfish.pod:443 msgid "The size in SI 10**18 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:422 +#: ../fish/guestfish.pod:445 msgid "B<Z> or B<ZiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:424 +#: ../fish/guestfish.pod:447 msgid "The size in zettabytes (multiplied by 2**70)." msgstr "" # type: =item -#: ../fish/guestfish.pod:426 +#: ../fish/guestfish.pod:449 msgid "B<ZB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:428 +#: ../fish/guestfish.pod:451 msgid "The size in SI 10**21 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:430 +#: ../fish/guestfish.pod:453 msgid "B<Y> or B<YiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:432 +#: ../fish/guestfish.pod:455 msgid "The size in yottabytes (multiplied by 2**80)." msgstr "" # type: =item -#: ../fish/guestfish.pod:434 +#: ../fish/guestfish.pod:457 msgid "B<YB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:436 +#: ../fish/guestfish.pod:459 msgid "The size in SI 10**24 byte units." msgstr "" # type: textblock -#: ../fish/guestfish.pod:440 +#: ../fish/guestfish.pod:463 msgid "For example:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:442 +#: ../fish/guestfish.pod:465 #, no-wrap msgid "" " truncate-size /file 1G\n" @@ -15618,12 +15750,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:444 +#: ../fish/guestfish.pod:467 msgid "would truncate the file to 1 gigabyte." msgstr "" # type: textblock -#: ../fish/guestfish.pod:446 +#: ../fish/guestfish.pod:469 msgid "" "Be careful because a few commands take sizes in kilobytes or megabytes (eg. " "the parameter to L</memsize> is specified in megabytes already). Adding a " @@ -15631,19 +15763,19 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:450 +#: ../fish/guestfish.pod:473 msgid "OCTAL AND HEXADECIMAL NUMBERS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:452 +#: ../fish/guestfish.pod:475 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:455 +#: ../fish/guestfish.pod:478 #, no-wrap msgid "" " 1234 decimal number 1234\n" @@ -15653,7 +15785,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:459 +#: ../fish/guestfish.pod:482 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 " @@ -15661,7 +15793,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:463 +#: ../fish/guestfish.pod:486 #, no-wrap msgid "" " chmod 0777 /public # OK\n" @@ -15670,7 +15802,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:466 +#: ../fish/guestfish.pod:489 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 " @@ -15678,12 +15810,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:470 +#: ../fish/guestfish.pod:493 msgid "WILDCARDS AND GLOBBING" msgstr "" # type: textblock -#: ../fish/guestfish.pod:472 +#: ../fish/guestfish.pod:495 msgid "" "Neither guestfish nor the underlying guestfs API performs wildcard expansion " "(globbing) by default. So for example the following will not do what you " @@ -15691,7 +15823,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:476 +#: ../fish/guestfish.pod:499 #, no-wrap msgid "" " rm-rf /home/*\n" @@ -15699,19 +15831,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:478 +#: ../fish/guestfish.pod:501 msgid "" -"Assuming you don't have a directory literally called C</home/*> then the " +"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:481 +#: ../fish/guestfish.pod:504 msgid "To perform wildcard expansion, use the C<glob> command." msgstr "" # type: verbatim -#: ../fish/guestfish.pod:483 +#: ../fish/guestfish.pod:506 #, no-wrap msgid "" " glob rm-rf /home/*\n" @@ -15719,14 +15851,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:485 +#: ../fish/guestfish.pod:508 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:488 +#: ../fish/guestfish.pod:511 #, no-wrap msgid "" " rm-rf /home/jim\n" @@ -15736,24 +15868,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:492 +#: ../fish/guestfish.pod:515 msgid "C<glob> only works on simple guest paths and not on device names." msgstr "" # type: textblock -#: ../fish/guestfish.pod:494 +#: ../fish/guestfish.pod:517 msgid "" "If you have several parameters, each containing a wildcard, then glob will " -"perform a cartesian product." +"perform a Cartesian product." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:497 +#: ../fish/guestfish.pod:520 msgid "COMMENTS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:499 +#: ../fish/guestfish.pod:522 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 " @@ -15761,7 +15893,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:503 +#: ../fish/guestfish.pod:526 #, no-wrap msgid "" " # this is a comment\n" @@ -15771,24 +15903,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:507 +#: ../fish/guestfish.pod:530 msgid "Blank lines are also ignored." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:509 +#: ../fish/guestfish.pod:532 msgid "RUNNING COMMANDS LOCALLY" msgstr "" # type: textblock -#: ../fish/guestfish.pod:511 +#: ../fish/guestfish.pod:534 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:515 +#: ../fish/guestfish.pod:538 #, no-wrap msgid "" " !mkdir local\n" @@ -15797,7 +15929,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:518 +#: ../fish/guestfish.pod:541 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>. " @@ -15805,19 +15937,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:522 +#: ../fish/guestfish.pod:545 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: =head1 -#: ../fish/guestfish.pod:525 +#: ../fish/guestfish.pod:548 msgid "PIPES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:527 +#: ../fish/guestfish.pod:550 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 " @@ -15825,7 +15957,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:531 +#: ../fish/guestfish.pod:554 #, no-wrap msgid "" " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n" @@ -15833,7 +15965,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:533 +#: ../fish/guestfish.pod:556 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 " @@ -15841,7 +15973,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:538 +#: ../fish/guestfish.pod:561 #, no-wrap msgid "" " hexdump /bin/ls | head\n" @@ -15851,7 +15983,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:542 +#: ../fish/guestfish.pod:565 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 " @@ -15860,14 +15992,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:547 +#: ../fish/guestfish.pod:570 msgid "" "To use a literal argument which begins with a pipe symbol, you have to quote " "it, eg:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:550 +#: ../fish/guestfish.pod:573 #, no-wrap msgid "" " echo \"|\"\n" @@ -15875,12 +16007,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:552 +#: ../fish/guestfish.pod:575 msgid "HOME DIRECTORIES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:554 +#: ../fish/guestfish.pod:577 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, " @@ -15888,21 +16020,21 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:558 +#: ../fish/guestfish.pod:581 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:561 +#: ../fish/guestfish.pod:584 msgid "" "To use a literal argument which begins with a tilde, you have to quote it, " "eg:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:564 +#: ../fish/guestfish.pod:587 #, no-wrap msgid "" " echo \"~\"\n" @@ -15910,7 +16042,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:568 +#: ../fish/guestfish.pod:591 msgid "" "Libguestfs has some support for Linux guests encrypted according to the " "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole " @@ -15919,12 +16051,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:573 +#: ../fish/guestfish.pod:596 msgid "Identify encrypted block devices and partitions using L</vfs-type>:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:575 +#: ../fish/guestfish.pod:598 #, no-wrap msgid "" " ><fs> vfs-type /dev/sda2\n" @@ -15933,14 +16065,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:578 +#: ../fish/guestfish.pod:601 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:581 +#: ../fish/guestfish.pod:604 #, no-wrap msgid "" " ><fs> luks-open /dev/sda2 luksdev\n" @@ -15949,28 +16081,28 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:584 +#: ../fish/guestfish.pod:607 msgid "" "Finally you have to tell LVM to scan for volume groups on the newly created " "mapper device:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:587 +#: ../fish/guestfish.pod:610 #, no-wrap msgid "" -" ><fs> vgscan\n" -" ><fs> vg-activate-all true\n" +" vgscan\n" +" vg-activate-all true\n" "\n" msgstr "" # type: textblock -#: ../fish/guestfish.pod:590 +#: ../fish/guestfish.pod:613 msgid "The logical volume(s) can now be mounted in the usual way." msgstr "" # type: textblock -#: ../fish/guestfish.pod:592 +#: ../fish/guestfish.pod:615 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 " @@ -15978,28 +16110,28 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:596 +#: ../fish/guestfish.pod:619 #, no-wrap msgid "" -" ><fs> vg-activate false /dev/VG\n" -" ><fs> luks-close /dev/mapper/luksdev\n" +" vg-activate false /dev/VG\n" +" luks-close /dev/mapper/luksdev\n" "\n" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:599 +#: ../fish/guestfish.pod:622 msgid "WINDOWS PATHS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:601 +#: ../fish/guestfish.pod:624 msgid "" "If a path is prefixed with C<win:> then you can use Windows-style paths " "(with some limitations). The following commands are equivalent:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:604 +#: ../fish/guestfish.pod:627 #, no-wrap msgid "" " file /WINDOWS/system32/config/system.LOG\n" @@ -16007,7 +16139,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:606 +#: ../fish/guestfish.pod:629 #, no-wrap msgid "" " file win:/windows/system32/config/system.log\n" @@ -16015,7 +16147,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:608 +#: ../fish/guestfish.pod:631 #, no-wrap msgid "" " file win:\\windows\\system32\\config\\system.log\n" @@ -16023,7 +16155,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:610 +#: ../fish/guestfish.pod:633 #, no-wrap msgid "" " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n" @@ -16031,7 +16163,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:612 +#: ../fish/guestfish.pod:635 msgid "" "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also " "handles case insensitivity like Windows would. This only works in argument " @@ -16039,12 +16171,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:616 +#: ../fish/guestfish.pod:639 msgid "UPLOADING AND DOWNLOADING FILES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:618 +#: ../fish/guestfish.pod:641 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 " @@ -16052,7 +16184,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:622 +#: ../fish/guestfish.pod:645 #, no-wrap msgid "" " upload - /foo\n" @@ -16060,13 +16192,13 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:624 +#: ../fish/guestfish.pod:647 msgid "" "reads stdin and creates from that a file C</foo> in the disk image, and:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:627 +#: ../fish/guestfish.pod:650 #, no-wrap msgid "" " tar-out /etc - | tar tf -\n" @@ -16074,14 +16206,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:629 +#: ../fish/guestfish.pod:652 msgid "" "writes the tarball to stdout and then pipes that into the external \"tar\" " "command (see L</PIPES>)." msgstr "" # type: textblock -#: ../fish/guestfish.pod:632 +#: ../fish/guestfish.pod:655 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 " @@ -16089,7 +16221,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:636 +#: ../fish/guestfish.pod:659 #, no-wrap msgid "" " upload -<<END /foo\n" @@ -16101,7 +16233,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:642 +#: ../fish/guestfish.pod:665 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 " @@ -16109,19 +16241,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:646 +#: ../fish/guestfish.pod:669 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:649 +#: ../fish/guestfish.pod:672 msgid "EXIT ON ERROR BEHAVIOUR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:651 +#: ../fish/guestfish.pod:674 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 error " @@ -16129,19 +16261,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:656 +#: ../fish/guestfish.pod:679 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:660 +#: ../fish/guestfish.pod:683 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET" msgstr "" # type: textblock -#: ../fish/guestfish.pod:662 +#: ../fish/guestfish.pod:685 msgid "" "Guestfish can be remote-controlled over a socket. This is useful " "particularly in shell scripts where you want to make several different " @@ -16150,12 +16282,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:667 +#: ../fish/guestfish.pod:690 msgid "Start a guestfish server process using:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:669 +#: ../fish/guestfish.pod:692 #, no-wrap msgid "" " eval `guestfish --listen`\n" @@ -16163,12 +16295,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:671 +#: ../fish/guestfish.pod:694 msgid "and then send it commands by doing:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:673 +#: ../fish/guestfish.pod:696 #, no-wrap msgid "" " guestfish --remote cmd [...]\n" @@ -16176,12 +16308,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:675 +#: ../fish/guestfish.pod:698 msgid "To cause the server to exit, send it the exit command:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:677 +#: ../fish/guestfish.pod:700 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -16189,7 +16321,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:679 +#: ../fish/guestfish.pod:702 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 " @@ -16197,12 +16329,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:683 +#: ../fish/guestfish.pod:706 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:685 +#: ../fish/guestfish.pod:708 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 " @@ -16210,7 +16342,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:689 +#: ../fish/guestfish.pod:712 #, no-wrap msgid "" " eval `guestfish --listen`\n" @@ -16224,12 +16356,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:697 +#: ../fish/guestfish.pod:720 msgid "REMOTE CONTROL DETAILS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:699 +#: ../fish/guestfish.pod:722 msgid "" "Remote control happens over a Unix domain socket called C</tmp/.guestfish-" "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, " @@ -16237,17 +16369,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:703 +#: ../fish/guestfish.pod:726 msgid "Guestfish client and server versions must match exactly." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:705 +#: ../fish/guestfish.pod:728 msgid "PREPARED DISK IMAGES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:707 +#: ../fish/guestfish.pod:730 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. " @@ -16257,7 +16389,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:713 +#: ../fish/guestfish.pod:736 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 " @@ -16265,7 +16397,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:717 +#: ../fish/guestfish.pod:740 msgid "" "The type briefly describes how the disk should be sized, partitioned, how " "filesystem(s) should be created, and how content should be added. " @@ -16277,31 +16409,31 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:725 +#: ../fish/guestfish.pod:748 msgid "To list the available types and any extra parameters they take, run:" msgstr "" # type: textblock -#: ../fish/guestfish.pod:729 +#: ../fish/guestfish.pod:752 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:733 +#: ../fish/guestfish.pod:756 msgid "" "If any I<-N> or I<--new> options are given, the guest is automatically " "launched." msgstr "" # type: textblock -#: ../fish/guestfish.pod:738 +#: ../fish/guestfish.pod:761 msgid "Create a 100MB disk with an ext4-formatted partition:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:740 +#: ../fish/guestfish.pod:763 #, no-wrap msgid "" " guestfish -N fs:ext4\n" @@ -16309,12 +16441,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:742 +#: ../fish/guestfish.pod:765 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:744 +#: ../fish/guestfish.pod:767 #, no-wrap msgid "" " guestfish -N fs:vfat:32M -m /dev/sda1\n" @@ -16322,12 +16454,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:746 +#: ../fish/guestfish.pod:769 msgid "Create a blank 200MB disk:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:748 +#: ../fish/guestfish.pod:771 #, no-wrap msgid "" " guestfish -N disk:200M\n" @@ -16335,19 +16467,19 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:750 +#: ../fish/guestfish.pod:773 msgid "PROGRESS BARS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:752 +#: ../fish/guestfish.pod:775 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:756 +#: ../fish/guestfish.pod:779 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 " @@ -16355,7 +16487,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:760 +#: ../fish/guestfish.pod:783 #, no-wrap msgid "" " ><fs> copy-size /large-file /another-file 2048M\n" @@ -16364,7 +16496,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:763 +#: ../fish/guestfish.pod:786 msgid "" "The spinner on the left hand side moves round once for every progress " "notification received from the backend. This is a (reasonably) golden " @@ -16375,7 +16507,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:770 +#: ../fish/guestfish.pod:793 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>, " @@ -16383,24 +16515,24 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:775 +#: ../fish/guestfish.pod:798 msgid "GUESTFISH COMMANDS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:777 +#: ../fish/guestfish.pod:800 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:780 +#: ../fish/guestfish.pod:803 msgid "help" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:782 +#: ../fish/guestfish.pod:805 #, no-wrap msgid "" " help\n" @@ -16409,152 +16541,152 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:785 +#: ../fish/guestfish.pod:808 msgid "" "Without any parameter, this lists all commands. With a C<cmd> parameter, " "this displays detailed help for a command." msgstr "" # type: =head2 -#: ../fish/guestfish.pod:788 +#: ../fish/guestfish.pod:811 msgid "quit | exit" msgstr "" # type: textblock -#: ../fish/guestfish.pod:790 +#: ../fish/guestfish.pod:813 msgid "This exits guestfish. You can also use C<^D> key." msgstr "" # type: textblock -#: ../fish/guestfish.pod:792 +#: ../fish/guestfish.pod:815 msgid "@FISH_COMMANDS@" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:794 +#: ../fish/guestfish.pod:817 msgid "COMMANDS" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:798 ../test-tool/libguestfs-test-tool.pod:83 +#: ../fish/guestfish.pod:821 ../test-tool/libguestfs-test-tool.pod:83 msgid "EXIT CODE" msgstr "" # type: textblock -#: ../fish/guestfish.pod:800 +#: ../fish/guestfish.pod:823 msgid "" "guestfish returns 0 if the commands completed without error, or 1 if there " "was an error." msgstr "" # type: =item -#: ../fish/guestfish.pod:807 +#: ../fish/guestfish.pod:830 msgid "EDITOR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:809 +#: ../fish/guestfish.pod:832 msgid "" "The C<edit> command uses C<$EDITOR> as the editor. If not set, it uses " "C<vi>." msgstr "" # type: =item -#: ../fish/guestfish.pod:812 +#: ../fish/guestfish.pod:835 msgid "GUESTFISH_PID" msgstr "" # type: textblock -#: ../fish/guestfish.pod:814 +#: ../fish/guestfish.pod:837 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:818 +#: ../fish/guestfish.pod:841 msgid "HEXEDITOR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:820 +#: ../fish/guestfish.pod:843 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:824 +#: ../fish/guestfish.pod:847 msgid "HOME" msgstr "" # type: textblock -#: ../fish/guestfish.pod:826 +#: ../fish/guestfish.pod:849 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L</FILES>." msgstr "" # type: textblock -#: ../fish/guestfish.pod:835 +#: ../fish/guestfish.pod:858 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" # type: textblock -#: ../fish/guestfish.pod:847 +#: ../fish/guestfish.pod:870 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: textblock -#: ../fish/guestfish.pod:858 +#: ../fish/guestfish.pod:881 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces." msgstr "" # type: =item -#: ../fish/guestfish.pod:860 +#: ../fish/guestfish.pod:883 msgid "PAGER" msgstr "" # type: textblock -#: ../fish/guestfish.pod:862 +#: ../fish/guestfish.pod:885 msgid "" "The C<more> command uses C<$PAGER> as the pager. If not set, it uses " "C<more>." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:877 ../test-tool/libguestfs-test-tool.pod:88 +#: ../fish/guestfish.pod:900 ../test-tool/libguestfs-test-tool.pod:88 msgid "FILES" msgstr "" # type: =item -#: ../fish/guestfish.pod:881 +#: ../fish/guestfish.pod:904 msgid "$HOME/.guestfish" msgstr "" # type: textblock -#: ../fish/guestfish.pod:883 +#: ../fish/guestfish.pod:906 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" # type: =item -#: ../fish/guestfish.pod:886 +#: ../fish/guestfish.pod:909 msgid "$HOME/.inputrc" msgstr "" # type: =item -#: ../fish/guestfish.pod:888 +#: ../fish/guestfish.pod:911 msgid "/etc/inputrc" msgstr "" # type: textblock -#: ../fish/guestfish.pod:890 +#: ../fish/guestfish.pod:913 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see L<readline(3)/" @@ -16562,12 +16694,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:894 +#: ../fish/guestfish.pod:917 msgid "To write rules which only apply to guestfish, use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:896 +#: ../fish/guestfish.pod:919 #, no-wrap msgid "" " $if guestfish\n" @@ -16577,26 +16709,26 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:900 +#: ../fish/guestfish.pod:923 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" # type: =item -#: ../fish/guestfish.pod:905 +#: ../fish/guestfish.pod:928 msgid "completion-ignore-case (default: on)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:907 +#: ../fish/guestfish.pod:930 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:910 +#: ../fish/guestfish.pod:933 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -16604,22 +16736,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:912 +#: ../fish/guestfish.pod:935 msgid "to make guestfish case sensitive." msgstr "" # type: =item -#: ../fish/guestfish.pod:916 +#: ../fish/guestfish.pod:939 msgid "test1.img" msgstr "" # type: =item -#: ../fish/guestfish.pod:918 +#: ../fish/guestfish.pod:941 msgid "test2.img (etc)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:920 +#: ../fish/guestfish.pod:943 msgid "" "When using the C<-N> or C<--new> option, the prepared disk or filesystem " "will be created in the file C<test1.img> in the current directory. The " @@ -16628,7 +16760,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:929 +#: ../fish/guestfish.pod:952 msgid "" "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-df(1)>, " "L<virt-edit(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, " @@ -16637,13 +16769,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:953 ../test-tool/libguestfs-test-tool.pod:124 +#: ../fish/guestfish.pod:976 ../test-tool/libguestfs-test-tool.pod:124 #: ../fuse/guestmount.pod:198 ../inspector/virt-inspector.pl:865 -#: ../tools/virt-cat.pl:181 ../tools/virt-df.pl:553 ../tools/virt-edit.pl:345 -#: ../tools/virt-list-filesystems.pl:211 ../tools/virt-list-partitions.pl:248 -#: ../tools/virt-ls.pl:229 ../tools/virt-make-fs.pl:560 -#: ../tools/virt-rescue.pl:249 ../tools/virt-resize.pl:1415 -#: ../tools/virt-tar.pl:276 ../tools/virt-win-reg.pl:495 +#: ../tools/virt-edit.pl:345 ../tools/virt-win-reg.pl:495 +#: ../tools/virt-df.pl:553 ../tools/virt-ls.pl:229 +#: ../tools/virt-resize.pl:1415 ../tools/virt-list-filesystems.pl:211 +#: ../tools/virt-cat.pl:181 ../tools/virt-tar.pl:276 +#: ../tools/virt-rescue.pl:249 ../tools/virt-make-fs.pl:560 +#: ../tools/virt-list-partitions.pl:248 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 " @@ -16652,13 +16785,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:958 ../test-tool/libguestfs-test-tool.pod:129 +#: ../fish/guestfish.pod:981 ../test-tool/libguestfs-test-tool.pod:129 #: ../fuse/guestmount.pod:203 ../inspector/virt-inspector.pl:870 -#: ../tools/virt-cat.pl:186 ../tools/virt-df.pl:558 ../tools/virt-edit.pl:350 -#: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:253 -#: ../tools/virt-ls.pl:234 ../tools/virt-make-fs.pl:565 -#: ../tools/virt-rescue.pl:254 ../tools/virt-resize.pl:1420 -#: ../tools/virt-tar.pl:281 ../tools/virt-win-reg.pl:500 +#: ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:500 +#: ../tools/virt-df.pl:558 ../tools/virt-ls.pl:234 +#: ../tools/virt-resize.pl:1420 ../tools/virt-list-filesystems.pl:216 +#: ../tools/virt-cat.pl:186 ../tools/virt-tar.pl:281 +#: ../tools/virt-rescue.pl:254 ../tools/virt-make-fs.pl:565 +#: ../tools/virt-list-partitions.pl:253 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 " @@ -16667,13 +16801,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:963 ../test-tool/libguestfs-test-tool.pod:134 +#: ../fish/guestfish.pod:986 ../test-tool/libguestfs-test-tool.pod:134 #: ../fuse/guestmount.pod:208 ../inspector/virt-inspector.pl:875 -#: ../tools/virt-cat.pl:191 ../tools/virt-df.pl:563 ../tools/virt-edit.pl:355 -#: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:258 -#: ../tools/virt-ls.pl:239 ../tools/virt-make-fs.pl:570 -#: ../tools/virt-rescue.pl:259 ../tools/virt-resize.pl:1425 -#: ../tools/virt-tar.pl:286 ../tools/virt-win-reg.pl:505 +#: ../tools/virt-edit.pl:355 ../tools/virt-win-reg.pl:505 +#: ../tools/virt-df.pl:563 ../tools/virt-ls.pl:239 +#: ../tools/virt-resize.pl:1425 ../tools/virt-list-filesystems.pl:221 +#: ../tools/virt-cat.pl:191 ../tools/virt-tar.pl:286 +#: ../tools/virt-rescue.pl:259 ../tools/virt-make-fs.pl:570 +#: ../tools/virt-list-partitions.pl:258 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 " @@ -17121,11 +17256,11 @@ msgstr "" #: ../fish/guestfish-actions.pod:356 ../fish/guestfish-actions.pod:365 #: ../fish/guestfish-actions.pod:589 ../fish/guestfish-actions.pod:736 #: ../fish/guestfish-actions.pod:783 ../fish/guestfish-actions.pod:802 -#: ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:3803 -#: ../fish/guestfish-actions.pod:3815 ../fish/guestfish-actions.pod:3826 -#: ../fish/guestfish-actions.pod:3837 ../fish/guestfish-actions.pod:3889 -#: ../fish/guestfish-actions.pod:3898 ../fish/guestfish-actions.pod:3952 -#: ../fish/guestfish-actions.pod:3975 +#: ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:3820 +#: ../fish/guestfish-actions.pod:3832 ../fish/guestfish-actions.pod:3843 +#: ../fish/guestfish-actions.pod:3854 ../fish/guestfish-actions.pod:3906 +#: ../fish/guestfish-actions.pod:3915 ../fish/guestfish-actions.pod:3969 +#: ../fish/guestfish-actions.pod:3992 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -20346,7 +20481,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:2968 +#: ../fish/guestfish-actions.pod:2968 ../fish/guestfish-actions.pod:3061 msgid "See also L</pwrite>." msgstr "" @@ -20468,24 +20603,37 @@ msgstr "" # type: textblock #: ../fish/guestfish-actions.pod:3044 -msgid "See also L</pread>." +msgid "See also L</pread>, L</pwrite-device>." msgstr "" # type: =head2 #: ../fish/guestfish-actions.pod:3049 -msgid "read-file" +msgid "pwrite-device" msgstr "" # type: verbatim #: ../fish/guestfish-actions.pod:3051 #, no-wrap msgid "" +" pwrite-device device content offset\n" +"\n" +msgstr "" + +# type: =head2 +#: ../fish/guestfish-actions.pod:3066 +msgid "read-file" +msgstr "" + +# type: verbatim +#: ../fish/guestfish-actions.pod:3068 +#, no-wrap +msgid "" " read-file path\n" "\n" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3056 +#: ../fish/guestfish-actions.pod:3073 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -20493,12 +20641,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3064 +#: ../fish/guestfish-actions.pod:3081 msgid "read-lines" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3066 +#: ../fish/guestfish-actions.pod:3083 #, no-wrap msgid "" " read-lines path\n" @@ -20506,7 +20654,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3073 +#: ../fish/guestfish-actions.pod:3090 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -20515,12 +20663,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3078 +#: ../fish/guestfish-actions.pod:3095 msgid "readdir" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3080 +#: ../fish/guestfish-actions.pod:3097 #, no-wrap msgid "" " readdir dir\n" @@ -20528,7 +20676,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3132 +#: ../fish/guestfish-actions.pod:3149 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 " @@ -20536,12 +20684,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3136 +#: ../fish/guestfish-actions.pod:3153 msgid "readlink" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3138 +#: ../fish/guestfish-actions.pod:3155 #, no-wrap msgid "" " readlink path\n" @@ -20549,12 +20697,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3142 +#: ../fish/guestfish-actions.pod:3159 msgid "readlinklist" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3161 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -20562,12 +20710,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3168 +#: ../fish/guestfish-actions.pod:3185 msgid "realpath" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3170 +#: ../fish/guestfish-actions.pod:3187 #, no-wrap msgid "" " realpath path\n" @@ -20575,12 +20723,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3175 +#: ../fish/guestfish-actions.pod:3192 msgid "removexattr" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3177 +#: ../fish/guestfish-actions.pod:3194 #, no-wrap msgid "" " removexattr xattr path\n" @@ -20588,17 +20736,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3182 +#: ../fish/guestfish-actions.pod:3199 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3184 +#: ../fish/guestfish-actions.pod:3201 msgid "resize2fs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3186 +#: ../fish/guestfish-actions.pod:3203 #, no-wrap msgid "" " resize2fs device\n" @@ -20606,7 +20754,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3191 +#: ../fish/guestfish-actions.pod:3208 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 " @@ -20615,12 +20763,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3197 +#: ../fish/guestfish-actions.pod:3214 msgid "resize2fs-size" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3199 +#: ../fish/guestfish-actions.pod:3216 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -20628,19 +20776,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3201 +#: ../fish/guestfish-actions.pod:3218 msgid "" "This command is the same as L</resize2fs> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3204 +#: ../fish/guestfish-actions.pod:3221 msgid "rm" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3206 +#: ../fish/guestfish-actions.pod:3223 #, no-wrap msgid "" " rm path\n" @@ -20648,12 +20796,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3210 +#: ../fish/guestfish-actions.pod:3227 msgid "rm-rf" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3212 +#: ../fish/guestfish-actions.pod:3229 #, no-wrap msgid "" " rm-rf path\n" @@ -20661,12 +20809,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3218 +#: ../fish/guestfish-actions.pod:3235 msgid "rmdir" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3220 +#: ../fish/guestfish-actions.pod:3237 #, no-wrap msgid "" " rmdir path\n" @@ -20674,12 +20822,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3224 +#: ../fish/guestfish-actions.pod:3241 msgid "rmmountpoint" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3226 +#: ../fish/guestfish-actions.pod:3243 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -20687,19 +20835,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3228 +#: ../fish/guestfish-actions.pod:3245 msgid "" "This calls removes a mountpoint that was previously created with L</" "mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3232 +#: ../fish/guestfish-actions.pod:3249 msgid "scrub-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3234 +#: ../fish/guestfish-actions.pod:3251 #, no-wrap msgid "" " scrub-device device\n" @@ -20707,12 +20855,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3245 +#: ../fish/guestfish-actions.pod:3262 msgid "scrub-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3247 +#: ../fish/guestfish-actions.pod:3264 #, no-wrap msgid "" " scrub-file file\n" @@ -20720,12 +20868,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3257 +#: ../fish/guestfish-actions.pod:3274 msgid "scrub-freespace" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3259 +#: ../fish/guestfish-actions.pod:3276 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -20733,7 +20881,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3261 +#: ../fish/guestfish-actions.pod:3278 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 " @@ -20742,17 +20890,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3270 +#: ../fish/guestfish-actions.pod:3287 msgid "set-append" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3272 +#: ../fish/guestfish-actions.pod:3289 msgid "append" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3274 +#: ../fish/guestfish-actions.pod:3291 #, no-wrap msgid "" " set-append append\n" @@ -20760,17 +20908,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3285 +#: ../fish/guestfish-actions.pod:3302 msgid "set-autosync" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3287 +#: ../fish/guestfish-actions.pod:3304 msgid "autosync" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3289 +#: ../fish/guestfish-actions.pod:3306 #, no-wrap msgid "" " set-autosync true|false\n" @@ -20778,7 +20926,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3291 +#: ../fish/guestfish-actions.pod:3308 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to run L</umount-all> followed by L</sync> when the handle is " @@ -20786,17 +20934,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3299 +#: ../fish/guestfish-actions.pod:3316 msgid "set-direct" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3301 +#: ../fish/guestfish-actions.pod:3318 msgid "direct" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3303 +#: ../fish/guestfish-actions.pod:3320 #, no-wrap msgid "" " set-direct true|false\n" @@ -20804,19 +20952,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3309 +#: ../fish/guestfish-actions.pod:3326 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." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3318 +#: ../fish/guestfish-actions.pod:3335 msgid "set-e2label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3320 +#: ../fish/guestfish-actions.pod:3337 #, no-wrap msgid "" " set-e2label device label\n" @@ -20824,19 +20972,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3326 +#: ../fish/guestfish-actions.pod:3343 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3329 +#: ../fish/guestfish-actions.pod:3346 msgid "set-e2uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3331 +#: ../fish/guestfish-actions.pod:3348 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -20844,24 +20992,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3338 +#: ../fish/guestfish-actions.pod:3355 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:3341 +#: ../fish/guestfish-actions.pod:3358 msgid "set-memsize" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3343 +#: ../fish/guestfish-actions.pod:3360 msgid "memsize" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3345 +#: ../fish/guestfish-actions.pod:3362 #, no-wrap msgid "" " set-memsize memsize\n" @@ -20869,24 +21017,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3347 +#: ../fish/guestfish-actions.pod:3364 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:3358 +#: ../fish/guestfish-actions.pod:3375 msgid "set-network" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3360 +#: ../fish/guestfish-actions.pod:3377 msgid "network" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3362 +#: ../fish/guestfish-actions.pod:3379 #, no-wrap msgid "" " set-network true|false\n" @@ -20894,23 +21042,23 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3370 +#: ../fish/guestfish-actions.pod:3387 msgid "" "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3373 +#: ../fish/guestfish-actions.pod:3390 msgid "set-path" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3375 +#: ../fish/guestfish-actions.pod:3392 msgid "path" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3377 +#: ../fish/guestfish-actions.pod:3394 #, no-wrap msgid "" " set-path searchpath\n" @@ -20918,17 +21066,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3386 +#: ../fish/guestfish-actions.pod:3403 msgid "set-qemu" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3388 +#: ../fish/guestfish-actions.pod:3405 msgid "qemu" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3390 +#: ../fish/guestfish-actions.pod:3407 #, no-wrap msgid "" " set-qemu qemu\n" @@ -20936,17 +21084,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3410 +#: ../fish/guestfish-actions.pod:3427 msgid "set-recovery-proc" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3412 +#: ../fish/guestfish-actions.pod:3429 msgid "recovery-proc" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3431 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -20954,7 +21102,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3416 +#: ../fish/guestfish-actions.pod:3433 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 " @@ -20962,24 +21110,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3421 +#: ../fish/guestfish-actions.pod:3438 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3430 +#: ../fish/guestfish-actions.pod:3447 msgid "set-selinux" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3432 +#: ../fish/guestfish-actions.pod:3449 msgid "selinux" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3434 +#: ../fish/guestfish-actions.pod:3451 #, no-wrap msgid "" " set-selinux true|false\n" @@ -20987,17 +21135,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3445 +#: ../fish/guestfish-actions.pod:3462 msgid "set-trace" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3447 +#: ../fish/guestfish-actions.pod:3464 msgid "trace" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3449 +#: ../fish/guestfish-actions.pod:3466 #, no-wrap msgid "" " set-trace true|false\n" @@ -21005,17 +21153,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3465 +#: ../fish/guestfish-actions.pod:3482 msgid "set-verbose" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3467 +#: ../fish/guestfish-actions.pod:3484 msgid "verbose" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3469 +#: ../fish/guestfish-actions.pod:3486 #, no-wrap msgid "" " set-verbose true|false\n" @@ -21023,12 +21171,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3476 +#: ../fish/guestfish-actions.pod:3493 msgid "setcon" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3478 +#: ../fish/guestfish-actions.pod:3495 #, no-wrap msgid "" " setcon context\n" @@ -21036,12 +21184,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3485 +#: ../fish/guestfish-actions.pod:3502 msgid "setxattr" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3487 +#: ../fish/guestfish-actions.pod:3504 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -21049,17 +21197,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3493 +#: ../fish/guestfish-actions.pod:3510 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3495 +#: ../fish/guestfish-actions.pod:3512 msgid "sfdisk" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3497 +#: ../fish/guestfish-actions.pod:3514 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -21067,17 +21215,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3519 +#: ../fish/guestfish-actions.pod:3536 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3525 +#: ../fish/guestfish-actions.pod:3542 msgid "sfdiskM" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3527 +#: ../fish/guestfish-actions.pod:3544 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -21085,7 +21233,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3529 +#: ../fish/guestfish-actions.pod:3546 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 " @@ -21094,17 +21242,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3535 +#: ../fish/guestfish-actions.pod:3552 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3541 +#: ../fish/guestfish-actions.pod:3558 msgid "sfdisk-N" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3543 +#: ../fish/guestfish-actions.pod:3560 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -21112,24 +21260,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3548 +#: ../fish/guestfish-actions.pod:3565 msgid "" "For other parameters, see L</sfdisk>. You should usually pass C<0> for the " "cyls/heads/sectors parameters." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3551 +#: ../fish/guestfish-actions.pod:3568 msgid "See also: L</part-add>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3556 +#: ../fish/guestfish-actions.pod:3573 msgid "sfdisk-disk-geometry" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3558 +#: ../fish/guestfish-actions.pod:3575 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -21137,7 +21285,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3560 +#: ../fish/guestfish-actions.pod:3577 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, " @@ -21146,12 +21294,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3568 +#: ../fish/guestfish-actions.pod:3585 msgid "sfdisk-kernel-geometry" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3570 +#: ../fish/guestfish-actions.pod:3587 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -21159,12 +21307,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3577 +#: ../fish/guestfish-actions.pod:3594 msgid "sfdisk-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3579 +#: ../fish/guestfish-actions.pod:3596 #, no-wrap msgid "" " sfdisk-l device\n" @@ -21172,17 +21320,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3585 +#: ../fish/guestfish-actions.pod:3602 msgid "See also: L</part-list>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3587 +#: ../fish/guestfish-actions.pod:3604 msgid "sh" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3589 +#: ../fish/guestfish-actions.pod:3606 #, no-wrap msgid "" " sh command\n" @@ -21190,22 +21338,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3594 +#: ../fish/guestfish-actions.pod:3611 msgid "This is like L</command>, but passes the command to:" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3602 +#: ../fish/guestfish-actions.pod:3619 msgid "All the provisos about L</command> apply to this call." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3604 +#: ../fish/guestfish-actions.pod:3621 msgid "sh-lines" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3606 +#: ../fish/guestfish-actions.pod:3623 #, no-wrap msgid "" " sh-lines command\n" @@ -21213,22 +21361,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3608 +#: ../fish/guestfish-actions.pod:3625 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3611 +#: ../fish/guestfish-actions.pod:3628 msgid "See also: L</command-lines>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3613 +#: ../fish/guestfish-actions.pod:3630 msgid "sleep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3615 +#: ../fish/guestfish-actions.pod:3632 #, no-wrap msgid "" " sleep secs\n" @@ -21236,12 +21384,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3619 +#: ../fish/guestfish-actions.pod:3636 msgid "stat" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3621 +#: ../fish/guestfish-actions.pod:3638 #, no-wrap msgid "" " stat path\n" @@ -21249,12 +21397,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3627 +#: ../fish/guestfish-actions.pod:3644 msgid "statvfs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3629 +#: ../fish/guestfish-actions.pod:3646 #, no-wrap msgid "" " statvfs path\n" @@ -21262,12 +21410,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3637 +#: ../fish/guestfish-actions.pod:3654 msgid "strings" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3639 +#: ../fish/guestfish-actions.pod:3656 #, no-wrap msgid "" " strings path\n" @@ -21275,12 +21423,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3647 +#: ../fish/guestfish-actions.pod:3664 msgid "strings-e" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3649 +#: ../fish/guestfish-actions.pod:3666 #, no-wrap msgid "" " strings-e encoding path\n" @@ -21288,26 +21436,26 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3651 +#: ../fish/guestfish-actions.pod:3668 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>." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3661 +#: ../fish/guestfish-actions.pod:3678 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what L</strings> uses)." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3693 +#: ../fish/guestfish-actions.pod:3710 msgid "swapoff-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3695 +#: ../fish/guestfish-actions.pod:3712 #, no-wrap msgid "" " swapoff-device device\n" @@ -21315,19 +21463,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3697 +#: ../fish/guestfish-actions.pod:3714 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See L</swapon-device>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3701 +#: ../fish/guestfish-actions.pod:3718 msgid "swapoff-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3720 #, no-wrap msgid "" " swapoff-file file\n" @@ -21335,12 +21483,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3707 +#: ../fish/guestfish-actions.pod:3724 msgid "swapoff-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3709 +#: ../fish/guestfish-actions.pod:3726 #, no-wrap msgid "" " swapoff-label label\n" @@ -21348,12 +21496,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3714 +#: ../fish/guestfish-actions.pod:3731 msgid "swapoff-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3716 +#: ../fish/guestfish-actions.pod:3733 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -21361,12 +21509,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3721 +#: ../fish/guestfish-actions.pod:3738 msgid "swapon-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3723 +#: ../fish/guestfish-actions.pod:3740 #, no-wrap msgid "" " swapon-device device\n" @@ -21374,7 +21522,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3725 +#: ../fish/guestfish-actions.pod:3742 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 " @@ -21382,12 +21530,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3737 +#: ../fish/guestfish-actions.pod:3754 msgid "swapon-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3739 +#: ../fish/guestfish-actions.pod:3756 #, no-wrap msgid "" " swapon-file file\n" @@ -21395,18 +21543,18 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3741 +#: ../fish/guestfish-actions.pod:3758 msgid "" "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3744 +#: ../fish/guestfish-actions.pod:3761 msgid "swapon-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3746 +#: ../fish/guestfish-actions.pod:3763 #, no-wrap msgid "" " swapon-label label\n" @@ -21414,19 +21562,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3748 +#: ../fish/guestfish-actions.pod:3765 msgid "" "This command enables swap to a labeled swap partition. See L</swapon-" "device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3751 +#: ../fish/guestfish-actions.pod:3768 msgid "swapon-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3753 +#: ../fish/guestfish-actions.pod:3770 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -21434,19 +21582,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3755 +#: ../fish/guestfish-actions.pod:3772 msgid "" "This command enables swap to a swap partition with the given UUID. See L</" "swapon-device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3758 +#: ../fish/guestfish-actions.pod:3775 msgid "sync" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3760 +#: ../fish/guestfish-actions.pod:3777 #, no-wrap msgid "" " sync\n" @@ -21454,12 +21602,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3785 msgid "tail" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3770 +#: ../fish/guestfish-actions.pod:3787 #, no-wrap msgid "" " tail path\n" @@ -21467,12 +21615,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3778 +#: ../fish/guestfish-actions.pod:3795 msgid "tail-n" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3780 +#: ../fish/guestfish-actions.pod:3797 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -21480,12 +21628,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3793 +#: ../fish/guestfish-actions.pod:3810 msgid "tar-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3795 +#: ../fish/guestfish-actions.pod:3812 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -21493,17 +21641,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3800 +#: ../fish/guestfish-actions.pod:3817 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3805 +#: ../fish/guestfish-actions.pod:3822 msgid "tar-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3807 +#: ../fish/guestfish-actions.pod:3824 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -21511,17 +21659,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3812 +#: ../fish/guestfish-actions.pod:3829 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3817 +#: ../fish/guestfish-actions.pod:3834 msgid "tgz-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3819 +#: ../fish/guestfish-actions.pod:3836 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -21529,17 +21677,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3824 +#: ../fish/guestfish-actions.pod:3841 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3828 +#: ../fish/guestfish-actions.pod:3845 msgid "tgz-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3830 +#: ../fish/guestfish-actions.pod:3847 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -21547,17 +21695,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3835 +#: ../fish/guestfish-actions.pod:3852 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3839 +#: ../fish/guestfish-actions.pod:3856 msgid "touch" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3841 +#: ../fish/guestfish-actions.pod:3858 #, no-wrap msgid "" " touch path\n" @@ -21565,12 +21713,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3850 +#: ../fish/guestfish-actions.pod:3867 msgid "truncate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3852 +#: ../fish/guestfish-actions.pod:3869 #, no-wrap msgid "" " truncate path\n" @@ -21578,12 +21726,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3857 +#: ../fish/guestfish-actions.pod:3874 msgid "truncate-size" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3876 #, no-wrap msgid "" " truncate-size path size\n" @@ -21591,7 +21739,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3864 +#: ../fish/guestfish-actions.pod:3881 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 " @@ -21600,12 +21748,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3870 +#: ../fish/guestfish-actions.pod:3887 msgid "tune2fs-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3872 +#: ../fish/guestfish-actions.pod:3889 #, no-wrap msgid "" " tune2fs-l device\n" @@ -21613,12 +21761,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3882 +#: ../fish/guestfish-actions.pod:3899 msgid "txz-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3884 +#: ../fish/guestfish-actions.pod:3901 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -21626,12 +21774,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3891 +#: ../fish/guestfish-actions.pod:3908 msgid "txz-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3893 +#: ../fish/guestfish-actions.pod:3910 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -21639,12 +21787,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3900 +#: ../fish/guestfish-actions.pod:3917 msgid "umask" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3902 +#: ../fish/guestfish-actions.pod:3919 #, no-wrap msgid "" " umask mask\n" @@ -21652,22 +21800,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3916 +#: ../fish/guestfish-actions.pod:3933 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3921 +#: ../fish/guestfish-actions.pod:3938 msgid "umount" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3923 +#: ../fish/guestfish-actions.pod:3940 msgid "unmount" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3925 +#: ../fish/guestfish-actions.pod:3942 #, no-wrap msgid "" " umount pathordevice\n" @@ -21675,17 +21823,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3931 +#: ../fish/guestfish-actions.pod:3948 msgid "umount-all" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3933 +#: ../fish/guestfish-actions.pod:3950 msgid "unmount-all" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3935 +#: ../fish/guestfish-actions.pod:3952 #, no-wrap msgid "" " umount-all\n" @@ -21693,12 +21841,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3941 +#: ../fish/guestfish-actions.pod:3958 msgid "upload" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3943 +#: ../fish/guestfish-actions.pod:3960 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -21706,17 +21854,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3950 +#: ../fish/guestfish-actions.pod:3967 msgid "See also L</download>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3954 +#: ../fish/guestfish-actions.pod:3971 msgid "upload-offset" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3956 +#: ../fish/guestfish-actions.pod:3973 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -21724,7 +21872,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3968 +#: ../fish/guestfish-actions.pod:3985 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 " @@ -21732,17 +21880,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3973 +#: ../fish/guestfish-actions.pod:3990 msgid "See also L</upload>, L</pwrite>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3977 +#: ../fish/guestfish-actions.pod:3994 msgid "utimens" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3979 +#: ../fish/guestfish-actions.pod:3996 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -21750,12 +21898,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3998 +#: ../fish/guestfish-actions.pod:4015 msgid "version" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4000 +#: ../fish/guestfish-actions.pod:4017 #, no-wrap msgid "" " version\n" @@ -21763,7 +21911,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4027 +#: ../fish/guestfish-actions.pod:4044 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -21772,12 +21920,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4033 +#: ../fish/guestfish-actions.pod:4050 msgid "vfs-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4035 +#: ../fish/guestfish-actions.pod:4052 #, no-wrap msgid "" " vfs-label device\n" @@ -21785,17 +21933,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:4059 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4044 +#: ../fish/guestfish-actions.pod:4061 msgid "vfs-type" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4046 +#: ../fish/guestfish-actions.pod:4063 #, no-wrap msgid "" " vfs-type device\n" @@ -21803,12 +21951,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4056 +#: ../fish/guestfish-actions.pod:4073 msgid "vfs-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4058 +#: ../fish/guestfish-actions.pod:4075 #, no-wrap msgid "" " vfs-uuid device\n" @@ -21816,17 +21964,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4065 +#: ../fish/guestfish-actions.pod:4082 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4067 +#: ../fish/guestfish-actions.pod:4084 msgid "vg-activate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4069 +#: ../fish/guestfish-actions.pod:4086 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -21834,12 +21982,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4082 +#: ../fish/guestfish-actions.pod:4099 msgid "vg-activate-all" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4084 +#: ../fish/guestfish-actions.pod:4101 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -21847,12 +21995,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4094 +#: ../fish/guestfish-actions.pod:4111 msgid "vgcreate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4096 +#: ../fish/guestfish-actions.pod:4113 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -21860,12 +22008,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4101 +#: ../fish/guestfish-actions.pod:4118 msgid "vglvuuids" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4103 +#: ../fish/guestfish-actions.pod:4120 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -21873,24 +22021,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4108 +#: ../fish/guestfish-actions.pod:4125 msgid "" "You can use this along with L</lvs> and L</lvuuid> calls to associate " "logical volumes and volume groups." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4111 +#: ../fish/guestfish-actions.pod:4128 msgid "See also L</vgpvuuids>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4113 +#: ../fish/guestfish-actions.pod:4130 msgid "vgpvuuids" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4115 +#: ../fish/guestfish-actions.pod:4132 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -21898,24 +22046,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4120 +#: ../fish/guestfish-actions.pod:4137 msgid "" "You can use this along with L</pvs> and L</pvuuid> calls to associate " "physical volumes and volume groups." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4123 +#: ../fish/guestfish-actions.pod:4140 msgid "See also L</vglvuuids>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4125 +#: ../fish/guestfish-actions.pod:4142 msgid "vgremove" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4127 +#: ../fish/guestfish-actions.pod:4144 #, no-wrap msgid "" " vgremove vgname\n" @@ -21923,12 +22071,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4134 +#: ../fish/guestfish-actions.pod:4151 msgid "vgrename" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4153 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -21936,12 +22084,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4140 +#: ../fish/guestfish-actions.pod:4157 msgid "vgs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4142 +#: ../fish/guestfish-actions.pod:4159 #, no-wrap msgid "" " vgs\n" @@ -21949,17 +22097,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4150 +#: ../fish/guestfish-actions.pod:4167 msgid "See also L</vgs-full>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4152 +#: ../fish/guestfish-actions.pod:4169 msgid "vgs-full" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4154 +#: ../fish/guestfish-actions.pod:4171 #, no-wrap msgid "" " vgs-full\n" @@ -21967,12 +22115,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4159 +#: ../fish/guestfish-actions.pod:4176 msgid "vgscan" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4161 +#: ../fish/guestfish-actions.pod:4178 #, no-wrap msgid "" " vgscan\n" @@ -21980,12 +22128,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4166 +#: ../fish/guestfish-actions.pod:4183 msgid "vguuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4168 +#: ../fish/guestfish-actions.pod:4185 #, no-wrap msgid "" " vguuid vgname\n" @@ -21993,12 +22141,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4172 +#: ../fish/guestfish-actions.pod:4189 msgid "wc-c" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4174 +#: ../fish/guestfish-actions.pod:4191 #, no-wrap msgid "" " wc-c path\n" @@ -22006,12 +22154,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4179 +#: ../fish/guestfish-actions.pod:4196 msgid "wc-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4181 +#: ../fish/guestfish-actions.pod:4198 #, no-wrap msgid "" " wc-l path\n" @@ -22019,12 +22167,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4186 +#: ../fish/guestfish-actions.pod:4203 msgid "wc-w" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4188 +#: ../fish/guestfish-actions.pod:4205 #, no-wrap msgid "" " wc-w path\n" @@ -22032,12 +22180,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4193 +#: ../fish/guestfish-actions.pod:4210 msgid "write" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4195 +#: ../fish/guestfish-actions.pod:4212 #, no-wrap msgid "" " write path content\n" @@ -22045,12 +22193,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4203 +#: ../fish/guestfish-actions.pod:4220 msgid "write-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4205 +#: ../fish/guestfish-actions.pod:4222 #, no-wrap msgid "" " write-file path content size\n" @@ -22058,12 +22206,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4228 +#: ../fish/guestfish-actions.pod:4245 msgid "zegrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4230 +#: ../fish/guestfish-actions.pod:4247 #, no-wrap msgid "" " zegrep regex path\n" @@ -22071,12 +22219,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4238 +#: ../fish/guestfish-actions.pod:4255 msgid "zegrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4240 +#: ../fish/guestfish-actions.pod:4257 #, no-wrap msgid "" " zegrepi regex path\n" @@ -22084,12 +22232,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4248 +#: ../fish/guestfish-actions.pod:4265 msgid "zero" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4250 +#: ../fish/guestfish-actions.pod:4267 #, no-wrap msgid "" " zero device\n" @@ -22097,17 +22245,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4258 +#: ../fish/guestfish-actions.pod:4275 msgid "See also: L</zero-device>, L</scrub-device>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4260 +#: ../fish/guestfish-actions.pod:4277 msgid "zero-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4262 +#: ../fish/guestfish-actions.pod:4279 #, no-wrap msgid "" " zero-device device\n" @@ -22115,19 +22263,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4264 +#: ../fish/guestfish-actions.pod:4281 msgid "" "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 -#: ../fish/guestfish-actions.pod:4271 +#: ../fish/guestfish-actions.pod:4288 msgid "zerofree" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4273 +#: ../fish/guestfish-actions.pod:4290 #, no-wrap msgid "" " zerofree device\n" @@ -22135,12 +22283,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4286 +#: ../fish/guestfish-actions.pod:4303 msgid "zfgrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4288 +#: ../fish/guestfish-actions.pod:4305 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -22148,12 +22296,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4296 +#: ../fish/guestfish-actions.pod:4313 msgid "zfgrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4298 +#: ../fish/guestfish-actions.pod:4315 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -22161,12 +22309,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4306 +#: ../fish/guestfish-actions.pod:4323 msgid "zfile" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4308 +#: ../fish/guestfish-actions.pod:4325 #, no-wrap msgid "" " zfile meth path\n" @@ -22174,18 +22322,18 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4315 +#: ../fish/guestfish-actions.pod:4332 msgid "" "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4325 +#: ../fish/guestfish-actions.pod:4342 msgid "zgrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4327 +#: ../fish/guestfish-actions.pod:4344 #, no-wrap msgid "" " zgrep regex path\n" @@ -22193,12 +22341,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4335 +#: ../fish/guestfish-actions.pod:4352 msgid "zgrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4337 +#: ../fish/guestfish-actions.pod:4354 #, no-wrap msgid "" " zgrepi regex path\n" @@ -23291,50 +23439,49 @@ msgid "" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:85 ../tools/virt-cat.pl:90 -#: ../tools/virt-df.pl:81 ../tools/virt-edit.pl:83 -#: ../tools/virt-list-filesystems.pl:60 ../tools/virt-list-partitions.pl:61 -#: ../tools/virt-ls.pl:89 ../tools/virt-make-fs.pl:163 -#: ../tools/virt-rescue.pl:113 ../tools/virt-tar.pl:109 -#: ../tools/virt-win-reg.pl:182 +#: ../inspector/virt-inspector.pl:85 ../tools/virt-edit.pl:83 +#: ../tools/virt-win-reg.pl:182 ../tools/virt-df.pl:81 ../tools/virt-ls.pl:89 +#: ../tools/virt-list-filesystems.pl:60 ../tools/virt-cat.pl:90 +#: ../tools/virt-tar.pl:109 ../tools/virt-rescue.pl:113 +#: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:61 msgid "Display brief help." msgstr "" # type: =item -#: ../inspector/virt-inspector.pl:91 ../tools/virt-cat.pl:96 -#: ../tools/virt-df.pl:87 ../tools/virt-edit.pl:89 -#: ../tools/virt-list-filesystems.pl:66 ../tools/virt-list-partitions.pl:67 -#: ../tools/virt-ls.pl:95 ../tools/virt-make-fs.pl:169 -#: ../tools/virt-rescue.pl:119 ../tools/virt-resize.pl:249 -#: ../tools/virt-tar.pl:115 ../tools/virt-win-reg.pl:188 +#: ../inspector/virt-inspector.pl:91 ../tools/virt-edit.pl:89 +#: ../tools/virt-win-reg.pl:188 ../tools/virt-df.pl:87 ../tools/virt-ls.pl:95 +#: ../tools/virt-resize.pl:249 ../tools/virt-list-filesystems.pl:66 +#: ../tools/virt-cat.pl:96 ../tools/virt-tar.pl:115 +#: ../tools/virt-rescue.pl:119 ../tools/virt-make-fs.pl:169 +#: ../tools/virt-list-partitions.pl:67 msgid "B<--version>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:93 ../tools/virt-cat.pl:98 -#: ../tools/virt-df.pl:89 ../tools/virt-edit.pl:91 -#: ../tools/virt-list-filesystems.pl:68 ../tools/virt-list-partitions.pl:69 -#: ../tools/virt-ls.pl:97 ../tools/virt-make-fs.pl:171 -#: ../tools/virt-rescue.pl:121 ../tools/virt-resize.pl:251 -#: ../tools/virt-tar.pl:117 ../tools/virt-win-reg.pl:190 +#: ../inspector/virt-inspector.pl:93 ../tools/virt-edit.pl:91 +#: ../tools/virt-win-reg.pl:190 ../tools/virt-df.pl:89 ../tools/virt-ls.pl:97 +#: ../tools/virt-resize.pl:251 ../tools/virt-list-filesystems.pl:68 +#: ../tools/virt-cat.pl:98 ../tools/virt-tar.pl:117 +#: ../tools/virt-rescue.pl:121 ../tools/virt-make-fs.pl:171 +#: ../tools/virt-list-partitions.pl:69 msgid "Display version number and exit." msgstr "" # type: =item -#: ../inspector/virt-inspector.pl:99 ../tools/virt-cat.pl:104 -#: ../tools/virt-df.pl:95 ../tools/virt-edit.pl:113 -#: ../tools/virt-list-filesystems.pl:74 ../tools/virt-list-partitions.pl:75 -#: ../tools/virt-ls.pl:103 ../tools/virt-rescue.pl:135 -#: ../tools/virt-tar.pl:123 ../tools/virt-win-reg.pl:204 +#: ../inspector/virt-inspector.pl:99 ../tools/virt-edit.pl:113 +#: ../tools/virt-win-reg.pl:204 ../tools/virt-df.pl:95 ../tools/virt-ls.pl:103 +#: ../tools/virt-list-filesystems.pl:74 ../tools/virt-cat.pl:104 +#: ../tools/virt-tar.pl:123 ../tools/virt-rescue.pl:135 +#: ../tools/virt-list-partitions.pl:75 msgid "B<--connect URI> | B<-c URI>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:101 ../tools/virt-cat.pl:106 -#: ../tools/virt-df.pl:97 ../tools/virt-edit.pl:115 -#: ../tools/virt-list-filesystems.pl:76 ../tools/virt-list-partitions.pl:77 -#: ../tools/virt-ls.pl:105 ../tools/virt-rescue.pl:137 -#: ../tools/virt-tar.pl:125 ../tools/virt-win-reg.pl:206 +#: ../inspector/virt-inspector.pl:101 ../tools/virt-edit.pl:115 +#: ../tools/virt-win-reg.pl:206 ../tools/virt-df.pl:97 ../tools/virt-ls.pl:105 +#: ../tools/virt-list-filesystems.pl:76 ../tools/virt-cat.pl:106 +#: ../tools/virt-tar.pl:125 ../tools/virt-rescue.pl:137 +#: ../tools/virt-list-partitions.pl:77 msgid "" "If using libvirt, connect to the given I<URI>. If omitted, then we connect " "to the default libvirt hypervisor." @@ -23727,12 +23874,12 @@ msgid "" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:857 ../tools/virt-cat.pl:175 -#: ../tools/virt-df.pl:547 ../tools/virt-edit.pl:339 -#: ../tools/virt-list-filesystems.pl:205 ../tools/virt-list-partitions.pl:242 -#: ../tools/virt-ls.pl:223 ../tools/virt-make-fs.pl:554 -#: ../tools/virt-rescue.pl:243 ../tools/virt-resize.pl:1409 -#: ../tools/virt-tar.pl:270 ../tools/virt-win-reg.pl:489 +#: ../inspector/virt-inspector.pl:857 ../tools/virt-edit.pl:339 +#: ../tools/virt-win-reg.pl:489 ../tools/virt-df.pl:547 +#: ../tools/virt-ls.pl:223 ../tools/virt-resize.pl:1409 +#: ../tools/virt-list-filesystems.pl:205 ../tools/virt-cat.pl:175 +#: ../tools/virt-tar.pl:270 ../tools/virt-rescue.pl:243 +#: ../tools/virt-make-fs.pl:554 ../tools/virt-list-partitions.pl:242 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" @@ -23742,365 +23889,13 @@ msgid "Matthew Booth L<mbooth@redhat.com>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:863 ../tools/virt-cat.pl:179 -#: ../tools/virt-list-filesystems.pl:209 ../tools/virt-ls.pl:227 +#: ../inspector/virt-inspector.pl:863 ../tools/virt-ls.pl:227 +#: ../tools/virt-list-filesystems.pl:209 ../tools/virt-cat.pl:179 #: ../tools/virt-tar.pl:274 msgid "Copyright (C) 2009 Red Hat Inc." msgstr "" # type: textblock -#: ../tools/virt-cat.pl:34 -msgid "virt-cat - Display a file in a virtual machine" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:38 -#, no-wrap -msgid "" -" virt-cat [--options] domname file\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:40 -#, no-wrap -msgid "" -" virt-cat [--options] disk.img [disk.img ...] file\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:44 -msgid "" -"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 -#: ../tools/virt-cat.pl:47 -msgid "" -"C<virt-cat> can be used to quickly view a single file. To edit a file, use " -"C<virt-edit>. For more complex cases you should look at the L<guestfish(1)> " -"tool." -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:53 -msgid "" -"Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:56 -#, no-wrap -msgid "" -" virt-cat mydomain /etc/fstab\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:58 -msgid "List syslog messages from a VM:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:60 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/messages | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:62 -msgid "Find out what DHCP IP address a VM acquired:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:64 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/messages | grep 'dhclient: bound to' | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:66 -msgid "Find out what packages were recently installed:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:68 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/yum.log | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:70 -msgid "Find out who is logged on inside a virtual machine:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:72 -#, no-wrap -msgid "" -" virt-cat mydomain /var/run/utmp > /tmp/utmp\n" -" who /tmp/utmp\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:75 -msgid "or who was logged on:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:77 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/wtmp > /tmp/wtmp\n" -" last -f /tmp/wtmp\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:109 ../tools/virt-df.pl:100 ../tools/virt-edit.pl:118 -#: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 -#: ../tools/virt-ls.pl:108 ../tools/virt-rescue.pl:140 -#: ../tools/virt-tar.pl:128 ../tools/virt-win-reg.pl:209 -msgid "" -"If you specify guest block devices directly, then libvirt is not used at all." -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:165 -msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-edit(1)>, L<Sys::Guestfs(3)>, L<Sys::" -"Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." -msgstr "" - -# type: =head1 -#: ../tools/virt-cat.pl:173 ../tools/virt-df.pl:545 ../tools/virt-edit.pl:337 -#: ../tools/virt-list-filesystems.pl:203 ../tools/virt-list-partitions.pl:240 -#: ../tools/virt-ls.pl:221 ../tools/virt-make-fs.pl:552 -#: ../tools/virt-rescue.pl:241 ../tools/virt-resize.pl:1407 -#: ../tools/virt-tar.pl:268 ../tools/virt-win-reg.pl:487 -msgid "AUTHOR" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:36 -msgid "virt-df - Display free space on virtual filesystems" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:40 -#, no-wrap -msgid "" -" virt-df [--options]\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:42 -#, no-wrap -msgid "" -" virt-df [--options] domname\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:44 -#, no-wrap -msgid "" -" virt-df [--options] disk.img [disk.img ...]\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:48 -msgid "" -"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 amount of " -"space allocated to a virtual machine, but can look inside the virtual " -"machine to see how much space is really being used." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:53 -msgid "" -"It is like the L<df(1)> command, but for virtual machines, except that it " -"also works for Windows virtual machines." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:56 -msgid "" -"If used without any 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 -#: ../tools/virt-df.pl:60 -msgid "" -"If used with any argument(s), 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 -#: ../tools/virt-df.pl:67 -msgid "" -"Use the C<--csv> option to get a format which can be easily parsed by other " -"programs. Other options are mostly similar to standard C<df> options. See " -"below for the complete list." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:107 -msgid "B<--csv>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:109 -msgid "" -"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: =item -#: ../tools/virt-df.pl:117 -msgid "B<--human-readable> | B<-h>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:119 -msgid "Print sizes in human-readable format." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:121 -msgid "You are not allowed to use I<-h> and I<--csv> at the same time." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:127 -msgid "B<--inodes> | B<-i>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:129 -msgid "Print inodes instead of blocks." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:135 -msgid "B<--one-per-guest>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:137 -msgid "" -"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 -#: ../tools/virt-df.pl:140 -msgid "You might use this option in the following circumstances:" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:146 -msgid "" -"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 -#: ../tools/virt-df.pl:152 -msgid "" -"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: =head1 -#: ../tools/virt-df.pl:512 -msgid "NOTE ABOUT CSV FORMAT" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:514 -msgid "" -"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 -#: ../tools/virt-df.pl:517 -msgid "" -"Myth: Just split fields at commas. Reality: This does I<not> work " -"reliably. This example has two columns:" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:520 -#, no-wrap -msgid "" -" \"foo,bar\",baz\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:522 -msgid "" -"Myth: Read the file one line at a time. Reality: This does I<not> work " -"reliably. This example has one row:" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:525 -#, no-wrap -msgid "" -" \"foo\n" -" bar\",baz\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:528 -msgid "" -"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " -"packaged in major Linux distributions)." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:531 -msgid "" -"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " -"or Python's built-in csv library)." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:534 -msgid "Most spreadsheets and databases can import CSV directly." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:551 ../tools/virt-edit.pl:343 -#: ../tools/virt-list-partitions.pl:246 ../tools/virt-rescue.pl:247 -msgid "Copyright (C) 2009-2010 Red Hat Inc." -msgstr "" - -# type: textblock #: ../tools/virt-edit.pl:35 msgid "virt-edit - Edit a file in a virtual machine" msgstr "" @@ -24219,6 +24014,16 @@ msgstr "" msgid "By default, no backup file is made." msgstr "" +# type: textblock +#: ../tools/virt-edit.pl:118 ../tools/virt-win-reg.pl:209 +#: ../tools/virt-df.pl:100 ../tools/virt-ls.pl:108 +#: ../tools/virt-list-filesystems.pl:79 ../tools/virt-cat.pl:109 +#: ../tools/virt-tar.pl:128 ../tools/virt-rescue.pl:140 +#: ../tools/virt-list-partitions.pl:80 +msgid "" +"If you specify guest block devices directly, then libvirt is not used at all." +msgstr "" + # type: =item #: ../tools/virt-edit.pl:125 msgid "B<--expr EXPR> | B<-e EXPR>" @@ -24404,929 +24209,762 @@ msgid "" "L<perlre(1)>." msgstr "" +# type: =head1 +#: ../tools/virt-edit.pl:337 ../tools/virt-win-reg.pl:487 +#: ../tools/virt-df.pl:545 ../tools/virt-ls.pl:221 +#: ../tools/virt-resize.pl:1407 ../tools/virt-list-filesystems.pl:203 +#: ../tools/virt-cat.pl:173 ../tools/virt-tar.pl:268 +#: ../tools/virt-rescue.pl:241 ../tools/virt-make-fs.pl:552 +#: ../tools/virt-list-partitions.pl:240 +msgid "AUTHOR" +msgstr "" + # type: textblock -#: ../tools/virt-list-filesystems.pl:32 +#: ../tools/virt-edit.pl:343 ../tools/virt-df.pl:551 +#: ../tools/virt-rescue.pl:247 ../tools/virt-list-partitions.pl:246 +msgid "Copyright (C) 2009-2010 Red Hat Inc." +msgstr "" + +# type: textblock +#: ../tools/virt-win-reg.pl:38 msgid "" -"virt-list-filesystems - List filesystems in a virtual machine or disk image" +"virt-win-reg - Export and merge Windows Registry entries from a Windows guest" msgstr "" # type: verbatim -#: ../tools/virt-list-filesystems.pl:36 +#: ../tools/virt-win-reg.pl:42 #, no-wrap msgid "" -" virt-list-filesystems [--options] domname\n" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-list-filesystems.pl:38 +#: ../tools/virt-win-reg.pl:44 #, no-wrap msgid "" -" virt-list-filesystems [--options] disk.img [disk.img ...]\n" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-list-filesystems.pl:42 -msgid "" -"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-list-filesystems.pl:46 -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." -msgstr "" - -# type: =item -#: ../tools/virt-list-filesystems.pl:86 ../tools/virt-list-partitions.pl:95 -#: ../tools/virt-ls.pl:115 -msgid "B<-l> | B<--long>" -msgstr "" - -# type: textblock -#: ../tools/virt-list-filesystems.pl:88 -msgid "" -"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:95 -msgid "B<-a> | B<--all>" -msgstr "" - -# type: textblock -#: ../tools/virt-list-filesystems.pl:97 -msgid "" -"Normally we only show mountable filesystems. If this option is given then " -"swap devices are shown too." -msgstr "" - -# type: textblock -#: ../tools/virt-list-filesystems.pl:193 -msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(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-list-partitions.pl:32 -msgid "" -"virt-list-partitions - List partitions in a virtual machine or disk image" -msgstr "" - # type: verbatim -#: ../tools/virt-list-partitions.pl:36 +#: ../tools/virt-win-reg.pl:46 #, no-wrap msgid "" -" virt-list-partitions [--options] domname\n" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-list-partitions.pl:38 +#: ../tools/virt-win-reg.pl:48 #, no-wrap msgid "" -" virt-list-partitions [--options] disk.img [disk.img ...]\n" +" virt-win-reg --merge domname [input.reg ...]\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-list-partitions.pl:42 +# type: verbatim +#: ../tools/virt-win-reg.pl:50 +#, no-wrap 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)>." +" virt-win-reg [--options] disk.img ... # instead of domname\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:47 +#: ../tools/virt-win-reg.pl:54 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." -msgstr "" - -# type: =item -#: ../tools/virt-list-partitions.pl:87 -msgid "B<-h> | B<--human-readable>" -msgstr "" - -# type: textblock -#: ../tools/virt-list-partitions.pl:89 -msgid "Show sizes in human-readable form (eg. \"1G\")." +"You must I<not> use C<virt-win-reg> with the C<--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-list-partitions.pl:97 +#: ../tools/virt-win-reg.pl:59 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-list-partitions.pl:104 -msgid "B<-t> | B<--total>" +"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 C<--merge> option, make sure " +"you have a reliable backup first." msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:106 +#: ../tools/virt-win-reg.pl:66 msgid "" -"Display the total size of each block device (as a separate row or rows)." +"This program can export and merge Windows Registry entries from a Windows " +"guest." msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:231 +#: ../tools/virt-win-reg.pl:69 msgid "" -"L<guestfs(3)>, L<guestfish(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/>." +"The first parameter is the libvirt guest name or the raw disk image of a " +"Windows guest." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:35 -msgid "virt-ls - List files in a virtual machine" -msgstr "" - -# type: verbatim -#: ../tools/virt-ls.pl:39 -#, no-wrap +#: ../tools/virt-win-reg.pl:72 msgid "" -" virt-ls [--options] domname directory\n" -"\n" +"If C<--merge> is I<not> specified, then the chosen registry key is displayed/" +"exported (recursively). For example:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:41 +#: ../tools/virt-win-reg.pl:75 #, no-wrap msgid "" -" virt-ls [--options] disk.img [disk.img ...] directory\n" +" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:45 -msgid "" -"C<virt-ls> is a command line tool to list the names of files in a directory " -"inside a virtual machine or disk image." -msgstr "" - -# type: textblock -#: ../tools/virt-ls.pl:48 -msgid "" -"C<virt-ls> 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-ls.pl:52 +#: ../tools/virt-win-reg.pl:77 msgid "" -"C<virt-ls> can be used in one of three modes: simple, long and recursive. A " -"simple listing is like the ordinary L<ls(1)> command:" +"You can also display single values from within registry keys, for example:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:55 +#: ../tools/virt-win-reg.pl:80 #, no-wrap msgid "" -" $ virt-ls myguest /\n" -" bin\n" -" boot\n" -" [etc.]\n" +" $ 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-ls.pl:60 -msgid "With the C<-l> (C<--long>) option, C<virt-ls> shows more detail:" +#: ../tools/virt-win-reg.pl:84 +msgid "" +"With C<--merge>, you can merge a textual regedit file into the Windows " +"Registry:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:62 +#: ../tools/virt-win-reg.pl:87 #, no-wrap msgid "" -" $ virt-ls -l myguest /\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" +" $ virt-win-reg --merge Windows7 changes.reg\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-ls.pl:68 -msgid "" -"With the C<-R> (C<--recursive>) option, C<virt-ls> lists the names of files " -"and directories recursively:" +# type: =head2 +#: ../tools/virt-win-reg.pl:89 +msgid "SUPPORTED SYSTEMS" msgstr "" -# type: verbatim -#: ../tools/virt-ls.pl:71 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:91 msgid "" -" $ virt-ls -R myguest /tmp\n" -" foo\n" -" foo/bar\n" -" [etc.]\n" -"\n" +"The program currently supports Windows NT-derived guests starting with " +"Windows XP through to at least Windows 7." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:76 +#: ../tools/virt-win-reg.pl:94 msgid "" -"You I<cannot> combine these options. To do more complicated things, use " -"L<guestfish(1)>." -msgstr "" - -# type: =item -#: ../tools/virt-ls.pl:117 -msgid "B<-R> | B<--recursive>" +"Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE" +"\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> " +"and C<HKEY_USERS\\.DEFAULT>." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:119 +#: ../tools/virt-win-reg.pl:98 msgid "" -"Select the mode. With neither of these options, C<virt-ls> produces a " -"simple, flat list of the files in the named directory." +"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-ls.pl:122 +#: ../tools/virt-win-reg.pl:101 msgid "" -"C<virt-ls -l> produces a \"long listing\", which shows more detail (just " -"like the plain C<ls -l> command)." +"C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this " +"time." +msgstr "" + +# type: =head2 +#: ../tools/virt-win-reg.pl:104 +msgid "NOTE" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:125 +#: ../tools/virt-win-reg.pl:106 msgid "" -"C<virt-ls -R> produces a recursive list of files starting at the named " -"directory. See the documentation for the C<guestfs_find> command L<guestfs" -"(3)> for precise details." +"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: textblock -#: ../tools/virt-ls.pl:129 -msgid "You cannot combine these options." +# type: =head2 +#: ../tools/virt-win-reg.pl:112 +msgid "ENCODING" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:212 +#: ../tools/virt-win-reg.pl:114 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<Sys::" -"Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs." -"org/>." +"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-make-fs.pl:37 -msgid "virt-make-fs - Make a filesystem from a tar archive or files" +#: ../tools/virt-win-reg.pl:120 +msgid "" +"To reencode a file from Windows format to Linux (before processing it with " +"the C<--merge> option), you would do something like this:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:41 +#: ../tools/virt-win-reg.pl:123 #, no-wrap msgid "" -" virt-make-fs [--options] input.tar output.img\n" +" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" "\n" msgstr "" -# type: verbatim -#: ../tools/virt-make-fs.pl:43 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:125 msgid "" -" virt-make-fs [--options] input.tar.gz output.img\n" -"\n" +"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-make-fs.pl:45 +#: ../tools/virt-win-reg.pl:128 #, no-wrap msgid "" -" virt-make-fs [--options] directory output.img\n" +" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:49 -msgid "" -"Virt-make-fs is a command line tool for creating a filesystem from a tar " -"archive or some files in a directory. It is similar to tools like L<mkisofs" -"(1)>, L<genisoimage(1)> and L<mksquashfs(1)>. Unlike those tools, it can " -"create common filesystem types like ext2/3 or NTFS, which can be useful if " -"you want to attach these filesystems to existing virtual machines (eg. to " -"import large amounts of read-only data to a VM)." +#: ../tools/virt-win-reg.pl:130 +msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:57 -msgid "Basic usage is:" +#: ../tools/virt-win-reg.pl:132 +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-make-fs.pl:59 +#: ../tools/virt-win-reg.pl:136 #, no-wrap msgid "" -" virt-make-fs input output\n" +" $ 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-make-fs.pl:61 -msgid "" -"where C<input> is either a directory containing files that you want to add, " -"or a tar archive (either uncompressed tar or gzip-compressed tar); and " -"C<output> is a disk image. The input type is detected automatically. The " -"output disk image defaults to a raw ext2 image unless you specify extra " -"flags (see L</OPTIONS> below)." +#: ../tools/virt-win-reg.pl:140 +msgid "This file would need conversion before you could C<--merge> it." msgstr "" # type: =head2 -#: ../tools/virt-make-fs.pl:67 -msgid "EXTRA SPACE" +#: ../tools/virt-win-reg.pl:142 +msgid "SHELL QUOTING" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:69 +#: ../tools/virt-win-reg.pl:144 msgid "" -"Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" " -"the files that it contains, but might have extra space. Depending on how " -"you are going to use the output, you might think this extra space is wasted " -"and want to minimize it, or you might want to leave space so that more files " -"can be added later. Virt-make-fs defaults to minimizing the extra space, " -"but you can use the C<--size> flag to leave space in the filesystem if you " -"want it." +"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-make-fs.pl:77 -msgid "" -"An alternative way to leave extra space but not make the output image any " -"bigger is to use an alternative disk image format (instead of the default " -"\"raw\" format). Using C<--format=qcow2> will use the native QEmu/KVM qcow2 " -"image format (check your hypervisor supports this before using it). This " -"allows you to choose a large C<--size> but the extra space won't actually be " -"allocated in the image until you try to store something in it." +#: ../tools/virt-win-reg.pl:148 +msgid "Paths and value names are case-insensitive." +msgstr "" + +# type: =head2 +#: ../tools/virt-win-reg.pl:150 +msgid "CurrentControlSet etc." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:85 +#: ../tools/virt-win-reg.pl:152 msgid "" -"Don't forget that you can also use local commands including L<resize2fs(8)> " -"and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-" -"resize to build another image from scratch." +"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: =head3 -#: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 -#: ../tools/virt-make-fs.pl:142 -msgid "EXAMPLE" +# type: textblock +#: ../tools/virt-win-reg.pl:156 +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-make-fs.pl:91 +#: ../tools/virt-win-reg.pl:160 #, no-wrap msgid "" -" virt-make-fs --format=qcow2 --size=+200M input output.img\n" +" # 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: =head2 -#: ../tools/virt-make-fs.pl:93 -msgid "FILESYSTEM TYPE" +# type: textblock +#: ../tools/virt-win-reg.pl:167 +msgid "\"Default\" is the one which Windows will choose when it boots." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:95 +#: ../tools/virt-win-reg.pl:169 msgid "" -"The default filesystem type is C<ext2>. Just about any filesystem type that " -"libguestfs supports can be used (but I<not> read-only formats like " -"ISO9660). Here are some of the more common choices:" +"Similarly, other C<Current...> keys in the path may need to be replaced." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:101 -msgid "I<ext3>" +#: ../tools/virt-win-reg.pl:196 ../tools/virt-make-fs.pl:177 +msgid "B<--debug>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:103 -msgid "" -"Note that ext3 filesystems contain a journal, typically 1-32 MB in size. If " -"you are not going to use the filesystem in a way that requires the journal, " -"then this is just wasted overhead." +#: ../tools/virt-win-reg.pl:198 ../tools/virt-resize.pl:477 +msgid "Enable debugging messages." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:107 -msgid "I<ntfs> or I<vfat>" +#: ../tools/virt-win-reg.pl:216 +msgid "B<--merge>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:109 -msgid "Useful if exporting data to a Windows guest." +#: ../tools/virt-win-reg.pl:218 +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-make-fs.pl:111 +#: ../tools/virt-win-reg.pl:222 msgid "" -"I<Note for vfat>: The tar archive or local directory must only contain files " -"which are owned by root (ie. UID:GID = 0:0). The reason is that the tar " -"program running within libguestfs is unable to change the ownership of non-" -"root files, since vfat itself does not support this." +"Note that C<--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-make-fs.pl:116 -msgid "I<minix>" +#: ../tools/virt-win-reg.pl:230 +msgid "B<--encoding> UTF-16LE|ASCII" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:118 +#: ../tools/virt-win-reg.pl:232 msgid "" -"Lower overhead than C<ext2>, but certain limitations on filename length and " -"total filesystem size." +"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: verbatim -#: ../tools/virt-make-fs.pl:125 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:236 msgid "" -" virt-make-fs --type=minix input minixfs.img\n" -"\n" +"The default is to use UTF-16LE, which should work with recent versions of " +"Windows." msgstr "" -# type: =head2 -#: ../tools/virt-make-fs.pl:127 -msgid "TO PARTITION OR NOT TO PARTITION" +# type: textblock +#: ../tools/virt-win-reg.pl:463 +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: textblock -#: ../tools/virt-make-fs.pl:129 -msgid "Optionally virt-make-fs can add a partition table to the output disk." +#: ../tools/virt-win-reg.pl:478 ../tools/virt-make-fs.pl:543 +msgid "" +"When reporting bugs, please enable debugging and capture the I<complete> " +"output:" msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:131 +# type: verbatim +#: ../tools/virt-win-reg.pl:481 +#, no-wrap msgid "" -"Adding a partition can make the disk image more compatible with certain " -"virtualized operating systems which don't expect to see a filesystem " -"directly located on a block device (Linux doesn't care and will happily " -"handle both types)." +" export LIBGUESTFS_DEBUG=1\n" +" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:136 +#: ../tools/virt-win-reg.pl:484 msgid "" -"On the other hand, if you have a partition table then the output image is no " -"longer a straight filesystem. For example you cannot run L<fsck(8)> " -"directly on a partitioned disk image. (However libguestfs tools such as " -"L<guestfish(1)> and L<virt-resize(1)> can still be used)." +"Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla." +"redhat.com/>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:144 -msgid "Add an MBR partition:" +#: ../tools/virt-win-reg.pl:493 ../tools/virt-resize.pl:1413 +#: ../tools/virt-make-fs.pl:558 +msgid "Copyright (C) 2010 Red Hat Inc." +msgstr "" + +# type: textblock +#: ../tools/virt-df.pl:36 +msgid "virt-df - Display free space on virtual filesystems" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:146 +#: ../tools/virt-df.pl:40 #, no-wrap msgid "" -" virt-make-fs --partition -- input disk.img\n" +" virt-df [--options]\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:148 +# type: verbatim +#: ../tools/virt-df.pl:42 +#, no-wrap msgid "" -"If the output disk image could be terabyte-sized or larger, it's better to " -"use an EFI/GPT-compatible partition table:" +" virt-df [--options] domname\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:151 +#: ../tools/virt-df.pl:44 #, no-wrap msgid "" -" virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n" +" virt-df [--options] disk.img [disk.img ...]\n" "\n" msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:177 ../tools/virt-win-reg.pl:196 -msgid "B<--debug>" -msgstr "" - -# type: textblock -#: ../tools/virt-make-fs.pl:179 -msgid "Enable debugging information." -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:185 -msgid "B<--size=E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:187 -msgid "B<--size=+E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:189 -msgid "B<-s E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:191 -msgid "B<-s +E<lt>NE<gt>>" -msgstr "" - # type: textblock -#: ../tools/virt-make-fs.pl:193 +#: ../tools/virt-df.pl:48 msgid "" -"Use the C<--size> (or C<-s>) option to choose the size of the output image." +"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 amount of " +"space allocated to a virtual machine, but can look inside the virtual " +"machine to see how much space is really being used." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:196 +#: ../tools/virt-df.pl:53 msgid "" -"If this option is I<not> given, then the output image will be just large " -"enough to contain all the files, with not much wasted space." +"It is like the L<df(1)> command, but for virtual machines, except that it " +"also works for Windows virtual machines." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:199 +#: ../tools/virt-df.pl:56 msgid "" -"To choose a fixed size output disk, specify an absolute number followed by b/" -"K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " -"Petabytes or Exabytes. This must be large enough to contain all the input " -"files, else you will get an error." +"If used without any 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 -#: ../tools/virt-make-fs.pl:204 +#: ../tools/virt-df.pl:60 msgid "" -"To leave extra space, specify C<+> (plus sign) and a number followed by b/K/" -"M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " -"Petabytes or Exabytes. For example: C<--size=+200M> means enough space for " -"the input files, and (approximately) an extra 200 MB free space." +"If used with any argument(s), 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 -#: ../tools/virt-make-fs.pl:210 +#: ../tools/virt-df.pl:67 msgid "" -"Note that virt-make-fs estimates free space, and therefore will not produce " -"filesystems containing precisely the free space requested. (It is much more " -"expensive and time-consuming to produce a filesystem which has precisely the " -"desired free space)." -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:219 -msgid "B<--format=E<lt>fmtE<gt>>" +"Use the C<--csv> option to get a format which can be easily parsed by other " +"programs. Other options are mostly similar to standard C<df> options. See " +"below for the complete list." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:221 -msgid "B<-F E<lt>fmtE<gt>>" +#: ../tools/virt-df.pl:107 +msgid "B<--csv>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:223 -msgid "Choose the output disk image format." +#: ../tools/virt-df.pl:109 +msgid "" +"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 -#: ../tools/virt-make-fs.pl:225 -msgid "The default is C<raw> (raw disk image)." +# type: =item +#: ../tools/virt-df.pl:117 +msgid "B<--human-readable> | B<-h>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:227 -msgid "" -"For other choices, see the L<qemu-img(1)> manpage. The only other choice " -"that would really make sense here is C<qcow2>." +#: ../tools/virt-df.pl:119 +msgid "Print sizes in human-readable format." msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:234 -msgid "B<--type=E<lt>fsE<gt>>" +# type: textblock +#: ../tools/virt-df.pl:121 +msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:236 -msgid "B<-t E<lt>fsE<gt>>" +#: ../tools/virt-df.pl:127 +msgid "B<--inodes> | B<-i>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:238 -msgid "Choose the output filesystem type." +#: ../tools/virt-df.pl:129 +msgid "Print inodes instead of blocks." msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:240 -msgid "The default is C<ext2>." +# type: =item +#: ../tools/virt-df.pl:135 +msgid "B<--one-per-guest>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:242 +#: ../tools/virt-df.pl:137 msgid "" -"Any filesystem which is supported read-write by libguestfs can be used here." +"Run one libguestfs appliance per guest. Normally C<virt-df> will add the " +"disks from several guests to a single libguestfs appliance." msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:249 -msgid "B<--partition>" +# type: textblock +#: ../tools/virt-df.pl:140 +msgid "You might use this option in the following circumstances:" msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:251 -msgid "B<--partition=E<lt>parttypeE<gt>>" +# type: textblock +#: ../tools/virt-df.pl:146 +msgid "" +"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 -#: ../tools/virt-make-fs.pl:253 +#: ../tools/virt-df.pl:152 msgid "" -"If specified, this flag adds an MBR partition table to the output disk image." +"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: =head1 +#: ../tools/virt-df.pl:512 +msgid "NOTE ABOUT CSV FORMAT" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:256 +#: ../tools/virt-df.pl:514 msgid "" -"You can change the partition table type, eg. C<--partition=gpt> for large " -"disks." +"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 -#: ../tools/virt-make-fs.pl:259 +#: ../tools/virt-df.pl:517 msgid "" -"Note that if you just use a lonesome C<--partition>, the Perl option parser " -"might consider the next parameter to be the partition type. For example:" +"Myth: Just split fields at commas. Reality: This does I<not> work " +"reliably. This example has two columns:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:263 +#: ../tools/virt-df.pl:520 #, no-wrap msgid "" -" virt-make-fs --partition input.tar ...\n" +" \"foo,bar\",baz\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:265 +#: ../tools/virt-df.pl:522 msgid "" -"would cause virt-make-fs to think you wanted to use a partition type of " -"C<input.tar> which is completely wrong. To avoid this, use C<--> (a double " -"dash) between options and the input file argument:" +"Myth: Read the file one line at a time. Reality: This does I<not> work " +"reliably. This example has one row:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:269 +#: ../tools/virt-df.pl:525 #, no-wrap msgid "" -" virt-make-fs --partition -- input.tar ...\n" +" \"foo\n" +" bar\",baz\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:529 -msgid "" -"L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, " -"L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs" -"(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>." -msgstr "" - -# type: textblock -#: ../tools/virt-make-fs.pl:543 ../tools/virt-win-reg.pl:478 -msgid "" -"When reporting bugs, please enable debugging and capture the I<complete> " -"output:" -msgstr "" - -# type: verbatim -#: ../tools/virt-make-fs.pl:546 -#, no-wrap +#: ../tools/virt-df.pl:528 msgid "" -" export LIBGUESTFS_DEBUG=1\n" -" virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n" -"\n" +"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " +"packaged in major Linux distributions)." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:549 +#: ../tools/virt-df.pl:531 msgid "" -"Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla." -"redhat.com/>" +"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " +"or Python's built-in csv library)." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:558 ../tools/virt-resize.pl:1413 -#: ../tools/virt-win-reg.pl:493 -msgid "Copyright (C) 2010 Red Hat Inc." +#: ../tools/virt-df.pl:534 +msgid "Most spreadsheets and databases can import CSV directly." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:33 -msgid "virt-rescue - Run a rescue shell on a virtual machine" +#: ../tools/virt-ls.pl:35 +msgid "virt-ls - List files in a virtual machine" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:37 +#: ../tools/virt-ls.pl:39 #, no-wrap msgid "" -" virt-rescue [--options] domname\n" +" virt-ls [--options] domname directory\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:39 +#: ../tools/virt-ls.pl:41 #, no-wrap msgid "" -" virt-rescue [--options] disk.img [disk.img ...]\n" +" virt-ls [--options] disk.img [disk.img ...] directory\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:43 -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 -#: ../tools/virt-rescue.pl:47 +#: ../tools/virt-ls.pl:45 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." +"C<virt-ls> is a command line tool to list the names of files in a directory " +"inside a virtual machine or disk image." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:53 +#: ../tools/virt-ls.pl:48 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." +"C<virt-ls> 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-rescue.pl:58 +#: ../tools/virt-ls.pl:52 msgid "" -"You can run virt-rescue on any virtual machine known to libvirt, or directly " -"on disk image(s):" +"C<virt-ls> can be used in one of three modes: simple, long and recursive. A " +"simple listing is like the ordinary L<ls(1)> command:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:61 +#: ../tools/virt-ls.pl:55 #, no-wrap msgid "" -" virt-rescue GuestName\n" +" $ virt-ls myguest /\n" +" bin\n" +" boot\n" +" [etc.]\n" "\n" msgstr "" -# type: verbatim -#: ../tools/virt-rescue.pl:63 -#, no-wrap -msgid "" -" virt-rescue --ro /path/to/disk.img\n" -"\n" +# type: textblock +#: ../tools/virt-ls.pl:60 +msgid "With the C<-l> (C<--long>) option, C<virt-ls> shows more detail:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:65 +#: ../tools/virt-ls.pl:62 #, no-wrap msgid "" -" virt-rescue /dev/sdc\n" +" $ virt-ls -l myguest /\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 -#: ../tools/virt-rescue.pl:67 -msgid "For live VMs you I<must> use the --ro option." -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:69 -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 -#: ../tools/virt-rescue.pl:76 +#: ../tools/virt-ls.pl:68 msgid "" -"In the example below, we list logical volumes, then choose one to mount " -"under C</sysroot>:" +"With the C<-R> (C<--recursive>) option, C<virt-ls> lists the names of files " +"and directories recursively:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:79 +#: ../tools/virt-ls.pl:71 #, 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" +" $ virt-ls -R myguest /tmp\n" +" foo\n" +" foo/bar\n" +" [etc.]\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:86 -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: =head1 -#: ../tools/virt-rescue.pl:90 ../tools/virt-resize.pl:1350 -msgid "NOTES" -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:92 -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 -#: ../tools/virt-rescue.pl:98 +#: ../tools/virt-ls.pl:76 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)>." +"You I<cannot> combine these options. To do more complicated things, use " +"L<guestfish(1)>." msgstr "" # type: =item -#: ../tools/virt-rescue.pl:127 -msgid "B<--append kernelopts>" -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:129 -msgid "Pass additional options to the rescue kernel." +#: ../tools/virt-ls.pl:115 ../tools/virt-list-filesystems.pl:86 +#: ../tools/virt-list-partitions.pl:95 +msgid "B<-l> | B<--long>" msgstr "" # type: =item -#: ../tools/virt-rescue.pl:147 -msgid "B<--memsize MB> | B<-m MB>" +#: ../tools/virt-ls.pl:117 +msgid "B<-R> | B<--recursive>" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:149 +#: ../tools/virt-ls.pl:119 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 -#: ../tools/virt-rescue.pl:158 -msgid "B<--ro> | B<-r>" +"Select the mode. With neither of these options, C<virt-ls> produces a " +"simple, flat list of the files in the named directory." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:160 -msgid "Open the image read-only." +#: ../tools/virt-ls.pl:122 +msgid "" +"C<virt-ls -l> produces a \"long listing\", which shows more detail (just " +"like the plain C<ls -l> command)." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:172 +#: ../tools/virt-ls.pl:125 msgid "" -"Enable SELinux in the rescue appliance. You should read L<guestfs(3)/" -"SELINUX> before using this option." +"C<virt-ls -R> produces a recursive list of files starting at the named " +"directory. See the documentation for the C<guestfs_find> command L<guestfs" +"(3)> for precise details." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:228 -msgid "" -"Several environment variables affect virt-rescue. See L<guestfs(3)/" -"ENVIRONMENT VARIABLES> for the complete list." +#: ../tools/virt-ls.pl:129 +msgid "You cannot combine these options." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:233 +#: ../tools/virt-ls.pl:212 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(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-tar(1)>, L<Sys::" +"Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs." +"org/>." msgstr "" # type: textblock @@ -26106,11 +25744,6 @@ msgstr "" msgid "B<-d> | B<--debug>" msgstr "" -# type: textblock -#: ../tools/virt-resize.pl:477 ../tools/virt-win-reg.pl:198 -msgid "Enable debugging messages." -msgstr "" - # type: =item #: ../tools/virt-resize.pl:483 msgid "B<-n> | B<--dryrun>" @@ -26131,6 +25764,11 @@ msgstr "" msgid "Don't print the summary." msgstr "" +# type: =head1 +#: ../tools/virt-resize.pl:1350 ../tools/virt-rescue.pl:90 +msgid "NOTES" +msgstr "" + # type: =head2 #: ../tools/virt-resize.pl:1352 msgid "\"Partition 1 does not end on cylinder boundary.\"" @@ -26210,6 +25848,194 @@ msgid "" 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-list-filesystems.pl:36 +#, no-wrap +msgid "" +" virt-list-filesystems [--options] domname\n" +"\n" +msgstr "" + +# type: verbatim +#: ../tools/virt-list-filesystems.pl:38 +#, no-wrap +msgid "" +" virt-list-filesystems [--options] disk.img [disk.img ...]\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:42 +msgid "" +"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-list-filesystems.pl:46 +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." +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:88 +msgid "" +"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:95 +msgid "B<-a> | B<--all>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:97 +msgid "" +"Normally we only show mountable filesystems. If this option is given then " +"swap devices are shown too." +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:193 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(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-cat.pl:34 +msgid "virt-cat - Display a file in a virtual machine" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:38 +#, no-wrap +msgid "" +" virt-cat [--options] domname file\n" +"\n" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:40 +#, no-wrap +msgid "" +" virt-cat [--options] disk.img [disk.img ...] file\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:44 +msgid "" +"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 +#: ../tools/virt-cat.pl:47 +msgid "" +"C<virt-cat> can be used to quickly view a single file. To edit a file, use " +"C<virt-edit>. For more complex cases you should look at the L<guestfish(1)> " +"tool." +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:53 +msgid "" +"Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:56 +#, no-wrap +msgid "" +" virt-cat mydomain /etc/fstab\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:58 +msgid "List syslog messages from a VM:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:60 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/messages | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:62 +msgid "Find out what DHCP IP address a VM acquired:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:64 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/messages | grep 'dhclient: bound to' | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:66 +msgid "Find out what packages were recently installed:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:68 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/yum.log | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:70 +msgid "Find out who is logged on inside a virtual machine:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:72 +#, no-wrap +msgid "" +" virt-cat mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:75 +msgid "or who was logged on:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:77 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:165 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-edit(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:34 msgid "virt-tar - Extract or upload files to a virtual machine" msgstr "" @@ -26397,375 +26223,698 @@ msgid "" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:38 +#: ../tools/virt-rescue.pl:33 +msgid "virt-rescue - Run a rescue shell on a virtual machine" +msgstr "" + +# type: verbatim +#: ../tools/virt-rescue.pl:37 +#, no-wrap msgid "" -"virt-win-reg - Export and merge Windows Registry entries from a Windows guest" +" virt-rescue [--options] domname\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:42 +#: ../tools/virt-rescue.pl:39 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" +" virt-rescue [--options] disk.img [disk.img ...]\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-rescue.pl:43 +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 +#: ../tools/virt-rescue.pl:47 +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 +#: ../tools/virt-rescue.pl:53 +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 +#: ../tools/virt-rescue.pl:58 +msgid "" +"You can run virt-rescue on any virtual machine known to libvirt, or directly " +"on disk image(s):" +msgstr "" + # type: verbatim -#: ../tools/virt-win-reg.pl:44 +#: ../tools/virt-rescue.pl:61 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" +" virt-rescue GuestName\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:46 +#: ../tools/virt-rescue.pl:63 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" +" virt-rescue --ro /path/to/disk.img\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:48 +#: ../tools/virt-rescue.pl:65 #, no-wrap msgid "" -" virt-win-reg --merge domname [input.reg ...]\n" +" virt-rescue /dev/sdc\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-rescue.pl:67 +msgid "For live VMs you I<must> use the --ro option." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:69 +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 +#: ../tools/virt-rescue.pl:76 +msgid "" +"In the example below, we list logical volumes, then choose one to mount " +"under C</sysroot>:" +msgstr "" + # type: verbatim -#: ../tools/virt-win-reg.pl:50 +#: ../tools/virt-rescue.pl:79 #, no-wrap msgid "" -" virt-win-reg [--options] disk.img ... # instead of domname\n" +" ><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 -#: ../tools/virt-win-reg.pl:54 +#: ../tools/virt-rescue.pl:86 msgid "" -"You must I<not> use C<virt-win-reg> with the C<--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." +"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 -#: ../tools/virt-win-reg.pl:59 +#: ../tools/virt-rescue.pl:92 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 C<--merge> option, make sure " -"you have a reliable backup first." +"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 -#: ../tools/virt-win-reg.pl:66 +#: ../tools/virt-rescue.pl:98 msgid "" -"This program can export and merge Windows Registry entries from a Windows " -"guest." +"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 +#: ../tools/virt-rescue.pl:127 +msgid "B<--append kernelopts>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:69 +#: ../tools/virt-rescue.pl:129 +msgid "Pass additional options to the rescue kernel." +msgstr "" + +# type: =item +#: ../tools/virt-rescue.pl:147 +msgid "B<--memsize MB> | B<-m MB>" +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:149 msgid "" -"The first parameter is the libvirt guest name or the raw disk image of a " -"Windows guest." +"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 +#: ../tools/virt-rescue.pl:158 +msgid "B<--ro> | B<-r>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:72 +#: ../tools/virt-rescue.pl:160 +msgid "Open the image read-only." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:172 msgid "" -"If C<--merge> is I<not> specified, then the chosen registry key is displayed/" -"exported (recursively). For example:" +"Enable SELinux in the rescue appliance. You should read L<guestfs(3)/" +"SELINUX> before using this option." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:228 +msgid "" +"Several environment variables affect virt-rescue. See L<guestfs(3)/" +"ENVIRONMENT VARIABLES> for the complete list." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:233 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::" +"Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:37 +msgid "virt-make-fs - Make a filesystem from a tar archive or files" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:75 +#: ../tools/virt-make-fs.pl:41 #, no-wrap msgid "" -" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" +" virt-make-fs [--options] input.tar output.img\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-win-reg.pl:77 +# type: verbatim +#: ../tools/virt-make-fs.pl:43 +#, no-wrap msgid "" -"You can also display single values from within registry keys, for example:" +" virt-make-fs [--options] input.tar.gz output.img\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:80 +#: ../tools/virt-make-fs.pl:45 #, no-wrap msgid "" -" $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n" -" $ virt-win-reg Windows7 $cvkey ProductName\n" -" Windows 7 Enterprise\n" +" virt-make-fs [--options] directory output.img\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:84 +#: ../tools/virt-make-fs.pl:49 msgid "" -"With C<--merge>, you can merge a textual regedit file into the Windows " -"Registry:" +"Virt-make-fs is a command line tool for creating a filesystem from a tar " +"archive or some files in a directory. It is similar to tools like L<mkisofs" +"(1)>, L<genisoimage(1)> and L<mksquashfs(1)>. Unlike those tools, it can " +"create common filesystem types like ext2/3 or NTFS, which can be useful if " +"you want to attach these filesystems to existing virtual machines (eg. to " +"import large amounts of read-only data to a VM)." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:57 +msgid "Basic usage is:" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:87 +#: ../tools/virt-make-fs.pl:59 #, no-wrap msgid "" -" $ virt-win-reg --merge Windows7 changes.reg\n" +" virt-make-fs input output\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-make-fs.pl:61 +msgid "" +"where C<input> is either a directory containing files that you want to add, " +"or a tar archive (either uncompressed tar or gzip-compressed tar); and " +"C<output> is a disk image. The input type is detected automatically. The " +"output disk image defaults to a raw ext2 image unless you specify extra " +"flags (see L</OPTIONS> below)." +msgstr "" + # type: =head2 -#: ../tools/virt-win-reg.pl:89 -msgid "SUPPORTED SYSTEMS" +#: ../tools/virt-make-fs.pl:67 +msgid "EXTRA SPACE" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:91 +#: ../tools/virt-make-fs.pl:69 msgid "" -"The program currently supports Windows NT-derived guests starting with " -"Windows XP through to at least Windows 7." +"Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" " +"the files that it contains, but might have extra space. Depending on how " +"you are going to use the output, you might think this extra space is wasted " +"and want to minimize it, or you might want to leave space so that more files " +"can be added later. Virt-make-fs defaults to minimizing the extra space, " +"but you can use the C<--size> flag to leave space in the filesystem if you " +"want it." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:94 +#: ../tools/virt-make-fs.pl:77 msgid "" -"Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE" -"\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> " -"and C<HKEY_USERS\\.DEFAULT>." +"An alternative way to leave extra space but not make the output image any " +"bigger is to use an alternative disk image format (instead of the default " +"\"raw\" format). Using C<--format=qcow2> will use the native QEmu/KVM qcow2 " +"image format (check your hypervisor supports this before using it). This " +"allows you to choose a large C<--size> but the extra space won't actually be " +"allocated in the image until you try to store something in it." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:98 +#: ../tools/virt-make-fs.pl:85 msgid "" -"You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for " -"C<HKEY_USERS>." +"Don't forget that you can also use local commands including L<resize2fs(8)> " +"and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-" +"resize to build another image from scratch." msgstr "" -# type: textblock -#: ../tools/virt-win-reg.pl:101 +# type: =head3 +#: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 +#: ../tools/virt-make-fs.pl:142 +msgid "EXAMPLE" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:91 +#, no-wrap msgid "" -"C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this " -"time." +" virt-make-fs --format=qcow2 --size=+200M input output.img\n" +"\n" msgstr "" # type: =head2 -#: ../tools/virt-win-reg.pl:104 -msgid "NOTE" +#: ../tools/virt-make-fs.pl:93 +msgid "FILESYSTEM TYPE" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:106 +#: ../tools/virt-make-fs.pl:95 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)>." +"The default filesystem type is C<ext2>. Just about any filesystem type that " +"libguestfs supports can be used (but I<not> read-only formats like " +"ISO9660). Here are some of the more common choices:" msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:112 -msgid "ENCODING" +# type: =item +#: ../tools/virt-make-fs.pl:101 +msgid "I<ext3>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:114 +#: ../tools/virt-make-fs.pl:103 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." +"Note that ext3 filesystems contain a journal, typically 1-32 MB in size. If " +"you are not going to use the filesystem in a way that requires the journal, " +"then this is just wasted overhead." +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:107 +msgid "I<ntfs> or I<vfat>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:120 +#: ../tools/virt-make-fs.pl:109 +msgid "Useful if exporting data to a Windows guest." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:111 msgid "" -"To reencode a file from Windows format to Linux (before processing it with " -"the C<--merge> option), you would do something like this:" +"I<Note for vfat>: The tar archive or local directory must only contain files " +"which are owned by root (ie. UID:GID = 0:0). The reason is that the tar " +"program running within libguestfs is unable to change the ownership of non-" +"root files, since vfat itself does not support this." +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:116 +msgid "I<minix>" +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:118 +msgid "" +"Lower overhead than C<ext2>, but certain limitations on filename length and " +"total filesystem size." msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:123 +#: ../tools/virt-make-fs.pl:125 #, no-wrap msgid "" -" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" +" virt-make-fs --type=minix input minixfs.img\n" "\n" msgstr "" +# type: =head2 +#: ../tools/virt-make-fs.pl:127 +msgid "TO PARTITION OR NOT TO PARTITION" +msgstr "" + # type: textblock -#: ../tools/virt-win-reg.pl:125 +#: ../tools/virt-make-fs.pl:129 +msgid "Optionally virt-make-fs can add a partition table to the output disk." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:131 msgid "" -"To go in the opposite direction, after exporting and before sending the file " -"to a Windows user, do something like this:" +"Adding a partition can make the disk image more compatible with certain " +"virtualized operating systems which don't expect to see a filesystem " +"directly located on a block device (Linux doesn't care and will happily " +"handle both types)." msgstr "" -# type: verbatim -#: ../tools/virt-win-reg.pl:128 -#, no-wrap +# type: textblock +#: ../tools/virt-make-fs.pl:136 msgid "" -" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" -"\n" +"On the other hand, if you have a partition table then the output image is no " +"longer a straight filesystem. For example you cannot run L<fsck(8)> " +"directly on a partitioned disk image. (However libguestfs tools such as " +"L<guestfish(1)> and L<virt-resize(1)> can still be used)." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:130 -msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." +#: ../tools/virt-make-fs.pl:144 +msgid "Add an MBR partition:" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:146 +#, no-wrap +msgid "" +" virt-make-fs --partition -- input disk.img\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:132 +#: ../tools/virt-make-fs.pl:148 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:" +"If the output disk image could be terabyte-sized or larger, it's better to " +"use an EFI/GPT-compatible partition table:" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:136 +#: ../tools/virt-make-fs.pl:151 #, 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" +" virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:140 -msgid "This file would need conversion before you could C<--merge> it." +#: ../tools/virt-make-fs.pl:179 +msgid "Enable debugging information." msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:142 -msgid "SHELL QUOTING" +# type: =item +#: ../tools/virt-make-fs.pl:185 +msgid "B<--size=E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:187 +msgid "B<--size=+E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:189 +msgid "B<-s E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:191 +msgid "B<-s +E<lt>NE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:144 +#: ../tools/virt-make-fs.pl:193 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." +"Use the C<--size> (or C<-s>) option to choose the size of the output image." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:148 -msgid "Paths and value names are case-insensitive." +#: ../tools/virt-make-fs.pl:196 +msgid "" +"If this option is I<not> given, then the output image will be just large " +"enough to contain all the files, with not much wasted space." msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:150 -msgid "CurrentControlSet etc." +# type: textblock +#: ../tools/virt-make-fs.pl:199 +msgid "" +"To choose a fixed size output disk, specify an absolute number followed by b/" +"K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " +"Petabytes or Exabytes. This must be large enough to contain all the input " +"files, else you will get an error." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:152 +#: ../tools/virt-make-fs.pl:204 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." +"To leave extra space, specify C<+> (plus sign) and a number followed by b/K/" +"M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " +"Petabytes or Exabytes. For example: C<--size=+200M> means enough space for " +"the input files, and (approximately) an extra 200 MB free space." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:156 +#: ../tools/virt-make-fs.pl:210 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:" +"Note that virt-make-fs estimates free space, and therefore will not produce " +"filesystems containing precisely the free space requested. (It is much more " +"expensive and time-consuming to produce a filesystem which has precisely the " +"desired free space)." msgstr "" -# type: verbatim -#: ../tools/virt-win-reg.pl:160 -#, 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" +# type: =item +#: ../tools/virt-make-fs.pl:219 +msgid "B<--format=E<lt>fmtE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:221 +msgid "B<-F E<lt>fmtE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:167 -msgid "\"Default\" is the one which Windows will choose when it boots." +#: ../tools/virt-make-fs.pl:223 +msgid "Choose the output disk image format." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:169 +#: ../tools/virt-make-fs.pl:225 +msgid "The default is C<raw> (raw disk image)." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:227 msgid "" -"Similarly, other C<Current...> keys in the path may need to be replaced." +"For other choices, see the L<qemu-img(1)> manpage. The only other choice " +"that would really make sense here is C<qcow2>." msgstr "" # type: =item -#: ../tools/virt-win-reg.pl:216 -msgid "B<--merge>" +#: ../tools/virt-make-fs.pl:234 +msgid "B<--type=E<lt>fsE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:236 +msgid "B<-t E<lt>fsE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:218 -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." +#: ../tools/virt-make-fs.pl:238 +msgid "Choose the output filesystem type." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:222 +#: ../tools/virt-make-fs.pl:240 +msgid "The default is C<ext2>." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:242 msgid "" -"Note that C<--merge> is I<unsafe> to use on live virtual machines, and will " -"result in disk corruption. However exporting (without this flag) is always " -"safe." +"Any filesystem which is supported read-write by libguestfs can be used here." msgstr "" # type: =item -#: ../tools/virt-win-reg.pl:230 -msgid "B<--encoding> UTF-16LE|ASCII" +#: ../tools/virt-make-fs.pl:249 +msgid "B<--partition>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:251 +msgid "B<--partition=E<lt>parttypeE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:232 +#: ../tools/virt-make-fs.pl:253 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>." +"If specified, this flag adds an MBR partition table to the output disk image." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:236 +#: ../tools/virt-make-fs.pl:256 msgid "" -"The default is to use UTF-16LE, which should work with recent versions of " -"Windows." +"You can change the partition table type, eg. C<--partition=gpt> for large " +"disks." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:463 +#: ../tools/virt-make-fs.pl:259 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/>." +"Note that if you just use a lonesome C<--partition>, the Perl option parser " +"might consider the next parameter to be the partition type. For example:" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:481 +#: ../tools/virt-make-fs.pl:263 +#, no-wrap +msgid "" +" virt-make-fs --partition input.tar ...\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:265 +msgid "" +"would cause virt-make-fs to think you wanted to use a partition type of " +"C<input.tar> which is completely wrong. To avoid this, use C<--> (a double " +"dash) between options and the input file argument:" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:269 +#, no-wrap +msgid "" +" virt-make-fs --partition -- input.tar ...\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:529 +msgid "" +"L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, " +"L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs" +"(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>." +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:546 #, no-wrap msgid "" " export LIBGUESTFS_DEBUG=1\n" -" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" +" virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:484 +#: ../tools/virt-make-fs.pl:549 msgid "" -"Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla." +"Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla." "redhat.com/>" msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:32 +msgid "" +"virt-list-partitions - List partitions in a virtual machine or disk image" +msgstr "" + +# 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-list-partitions.pl:42 +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)>." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:47 +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." +msgstr "" + +# type: =item +#: ../tools/virt-list-partitions.pl:87 +msgid "B<-h> | B<--human-readable>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:89 +msgid "Show sizes in human-readable form (eg. \"1G\")." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:97 +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-list-partitions.pl:104 +msgid "B<-t> | B<--total>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:106 +msgid "" +"Display the total size of each block device (as a separate row or rows)." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:231 +msgid "" +"L<guestfs(3)>, L<guestfish(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 "" diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index f3c56feb..054e33ea 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.5.19\n" +"Project-Id-Version: libguestfs 1.5.20\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2010-09-22 21:43+0200\n" +"POT-Creation-Date: 2010-09-26 22:40+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" @@ -17,12 +17,12 @@ msgstr "" "Content-Transfer-Encoding: ENCODING" # type: =encoding -#: ../src/guestfs.pod:1 ../fish/guestfish.pod:1 ../test-tool/libguestfs-test-tool.pod:1 ../fuse/guestmount.pod:1 ../inspector/virt-inspector.pl:36 ../tools/virt-cat.pl:30 ../tools/virt-df.pl:32 ../tools/virt-edit.pl:31 ../tools/virt-list-filesystems.pl:28 ../tools/virt-list-partitions.pl:28 ../tools/virt-ls.pl:31 ../tools/virt-make-fs.pl:33 ../tools/virt-rescue.pl:29 ../tools/virt-resize.pl:38 ../tools/virt-tar.pl:30 ../tools/virt-win-reg.pl:34 +#: ../src/guestfs.pod:1 ../fish/guestfish.pod:1 ../test-tool/libguestfs-test-tool.pod:1 ../fuse/guestmount.pod:1 ../inspector/virt-inspector.pl:36 ../tools/virt-edit.pl:31 ../tools/virt-win-reg.pl:34 ../tools/virt-df.pl:32 ../tools/virt-ls.pl:31 ../tools/virt-resize.pl:38 ../tools/virt-list-filesystems.pl:28 ../tools/virt-cat.pl:30 ../tools/virt-tar.pl:30 ../tools/virt-rescue.pl:29 ../tools/virt-make-fs.pl:33 ../tools/virt-list-partitions.pl:28 msgid "utf8" msgstr "" # type: =head1 -#: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pl:38 ../tools/virt-cat.pl:32 ../tools/virt-df.pl:34 ../tools/virt-edit.pl:33 ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 ../tools/virt-ls.pl:33 ../tools/virt-make-fs.pl:35 ../tools/virt-rescue.pl:31 ../tools/virt-resize.pl:40 ../tools/virt-tar.pl:32 ../tools/virt-win-reg.pl:36 +#: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pl:38 ../tools/virt-edit.pl:33 ../tools/virt-win-reg.pl:36 ../tools/virt-df.pl:34 ../tools/virt-ls.pl:33 ../tools/virt-resize.pl:40 ../tools/virt-list-filesystems.pl:30 ../tools/virt-cat.pl:32 ../tools/virt-tar.pl:32 ../tools/virt-rescue.pl:31 ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30 msgid "NAME" msgstr "" @@ -32,7 +32,7 @@ msgid "guestfs - Library for accessing and modifying virtual machine images" msgstr "" # type: =head1 -#: ../src/guestfs.pod:7 ../fish/guestfish.pod:7 ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pl:42 ../tools/virt-cat.pl:36 ../tools/virt-df.pl:38 ../tools/virt-edit.pl:37 ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34 ../tools/virt-ls.pl:37 ../tools/virt-make-fs.pl:39 ../tools/virt-rescue.pl:35 ../tools/virt-resize.pl:44 ../tools/virt-tar.pl:36 ../tools/virt-win-reg.pl:40 +#: ../src/guestfs.pod:7 ../fish/guestfish.pod:7 ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pl:42 ../tools/virt-edit.pl:37 ../tools/virt-win-reg.pl:40 ../tools/virt-df.pl:38 ../tools/virt-ls.pl:37 ../tools/virt-resize.pl:44 ../tools/virt-list-filesystems.pl:34 ../tools/virt-cat.pl:36 ../tools/virt-tar.pl:36 ../tools/virt-rescue.pl:35 ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34 msgid "SYNOPSIS" msgstr "" @@ -70,7 +70,7 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:24 ../fish/guestfish.pod:115 ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:16 ../inspector/virt-inspector.pl:48 ../tools/virt-cat.pl:42 ../tools/virt-df.pl:46 ../tools/virt-edit.pl:51 ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40 ../tools/virt-ls.pl:43 ../tools/virt-make-fs.pl:47 ../tools/virt-rescue.pl:51 ../tools/virt-resize.pl:50 ../tools/virt-tar.pl:73 ../tools/virt-win-reg.pl:64 +#: ../src/guestfs.pod:24 ../fish/guestfish.pod:30 ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:16 ../inspector/virt-inspector.pl:48 ../tools/virt-edit.pl:51 ../tools/virt-win-reg.pl:64 ../tools/virt-df.pl:46 ../tools/virt-ls.pl:43 ../tools/virt-resize.pl:50 ../tools/virt-list-filesystems.pl:40 ../tools/virt-cat.pl:42 ../tools/virt-tar.pl:73 ../tools/virt-rescue.pl:51 ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40 msgid "DESCRIPTION" msgstr "" @@ -719,7 +719,7 @@ msgid "There are many limitations to this:" msgstr "" # type: =item -#: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355 ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368 ../src/guestfs.pod:373 ../src/guestfs.pod:1223 ../src/guestfs.pod:1228 ../src/guestfs.pod:1232 ../src/guestfs.pod:1334 ../src/guestfs.pod:1338 ../src/guestfs.pod:1342 ../src/guestfs.pod:1347 ../src/guestfs.pod:1355 ../src/guestfs.pod:1374 ../src/guestfs.pod:1382 ../src/guestfs.pod:1612 ../src/guestfs.pod:1618 ../src/guestfs.pod:1623 ../src/guestfs.pod:1629 ../src/guestfs.pod:1736 ../src/guestfs.pod:1740 ../src/guestfs.pod:1744 ../src/guestfs.pod:1748 ../src/guestfs-actions.pod:14 ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1289 ../src/guestfs-actions.pod:1293 ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1305 ../src/guestfs-actions.pod:1309 ../src/guestfs-actions.pod:1313 ../src/guestfs-actions.pod:1323 ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:1331 ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1458 ../src/guestfs-actions.pod:1463 ../src/guestfs-actions.pod:1468 ../src/guestfs-actions.pod:1520 ../src/guestfs-actions.pod:1524 ../src/guestfs-actions.pod:1529 ../fish/guestfish.pod:316 ../fish/guestfish.pod:320 ../fish/guestfish.pod:324 ../fish/guestfish.pod:328 ../fish/guestfish-actions.pod:15 ../fish/guestfish-actions.pod:22 ../fish/guestfish-actions.pod:306 ../fish/guestfish-actions.pod:314 ../fish/guestfish-actions.pod:321 ../fish/guestfish-actions.pod:328 ../fish/guestfish-actions.pod:1023 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1031 ../fish/guestfish-actions.pod:1035 ../fish/guestfish-actions.pod:1043 ../fish/guestfish-actions.pod:1047 ../fish/guestfish-actions.pod:1051 ../fish/guestfish-actions.pod:1061 ../fish/guestfish-actions.pod:1065 ../fish/guestfish-actions.pod:1069 ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163 ../fish/guestfish-actions.pod:1168 ../fish/guestfish-actions.pod:1173 ../fish/guestfish-actions.pod:1215 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224 ../tools/virt-df.pl:144 ../tools/virt-df.pl:150 ../tools/virt-resize.pl:324 ../tools/virt-resize.pl:329 ../tools/virt-resize.pl:339 +#: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355 ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368 ../src/guestfs.pod:373 ../src/guestfs.pod:1254 ../src/guestfs.pod:1259 ../src/guestfs.pod:1263 ../src/guestfs.pod:1365 ../src/guestfs.pod:1369 ../src/guestfs.pod:1373 ../src/guestfs.pod:1378 ../src/guestfs.pod:1386 ../src/guestfs.pod:1405 ../src/guestfs.pod:1413 ../src/guestfs.pod:1643 ../src/guestfs.pod:1649 ../src/guestfs.pod:1654 ../src/guestfs.pod:1660 ../src/guestfs.pod:1767 ../src/guestfs.pod:1771 ../src/guestfs.pod:1775 ../src/guestfs.pod:1779 ../src/guestfs-actions.pod:14 ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1289 ../src/guestfs-actions.pod:1293 ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1305 ../src/guestfs-actions.pod:1309 ../src/guestfs-actions.pod:1313 ../src/guestfs-actions.pod:1323 ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:1331 ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1458 ../src/guestfs-actions.pod:1463 ../src/guestfs-actions.pod:1468 ../src/guestfs-actions.pod:1520 ../src/guestfs-actions.pod:1524 ../src/guestfs-actions.pod:1529 ../fish/guestfish.pod:338 ../fish/guestfish.pod:342 ../fish/guestfish.pod:346 ../fish/guestfish.pod:350 ../fish/guestfish-actions.pod:15 ../fish/guestfish-actions.pod:22 ../fish/guestfish-actions.pod:306 ../fish/guestfish-actions.pod:314 ../fish/guestfish-actions.pod:321 ../fish/guestfish-actions.pod:328 ../fish/guestfish-actions.pod:1023 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1031 ../fish/guestfish-actions.pod:1035 ../fish/guestfish-actions.pod:1043 ../fish/guestfish-actions.pod:1047 ../fish/guestfish-actions.pod:1051 ../fish/guestfish-actions.pod:1061 ../fish/guestfish-actions.pod:1065 ../fish/guestfish-actions.pod:1069 ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163 ../fish/guestfish-actions.pod:1168 ../fish/guestfish-actions.pod:1173 ../fish/guestfish-actions.pod:1215 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224 ../tools/virt-df.pl:144 ../tools/virt-df.pl:150 ../tools/virt-resize.pl:324 ../tools/virt-resize.pl:329 ../tools/virt-resize.pl:339 msgid "*" msgstr "" @@ -935,7 +935,7 @@ msgid "For more information about umask, see L<umask(2)>." msgstr "" # type: =head1 -#: ../src/guestfs.pod:459 ../fish/guestfish.pod:566 +#: ../src/guestfs.pod:459 ../fish/guestfish.pod:589 msgid "ENCRYPTED DISKS" msgstr "" @@ -1507,13 +1507,76 @@ msgid "" "sent back from the daemon." msgstr "" -# type: =head2 +# type: =item +#: ../src/guestfs.pod:750 +msgid "Ambiguity between devices and paths" +msgstr "" + +# type: textblock #: ../src/guestfs.pod:752 +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 +#: ../src/guestfs.pod:757 +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 +#: ../src/guestfs.pod:763 +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 +#: ../src/guestfs.pod:769 +#, no-wrap +msgid "" +" type path = Path of string | Device of int | Partition of int * int\n" +"\n" +msgstr "" + +# type: textblock +#: ../src/guestfs.pod:771 +msgid "which would allow you to pass arguments like:" +msgstr "" + +# type: verbatim +#: ../src/guestfs.pod:773 +#, 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 +#: ../src/guestfs.pod:778 +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:783 msgid "PROTOCOL LIMITS" msgstr "" # type: textblock -#: ../src/guestfs.pod:754 +#: ../src/guestfs.pod:785 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 " @@ -1524,7 +1587,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:762 +#: ../src/guestfs.pod:793 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 " @@ -1533,7 +1596,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:768 +#: ../src/guestfs.pod:799 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> " @@ -1541,26 +1604,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:772 +#: ../src/guestfs.pod:803 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L<guestmount(1)>)." msgstr "" # type: =head2 -#: ../src/guestfs.pod:775 +#: ../src/guestfs.pod:806 msgid "KEYS AND PASSPHRASES" msgstr "" # type: textblock -#: ../src/guestfs.pod:777 +#: ../src/guestfs.pod:808 msgid "" "Certain libguestfs calls take a parameter that contains sensitive key " "material, passed in as a C string." msgstr "" # type: textblock -#: ../src/guestfs.pod:780 +#: ../src/guestfs.pod:811 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 " @@ -1569,7 +1632,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:785 +#: ../src/guestfs.pod:816 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, " @@ -1577,17 +1640,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:790 +#: ../src/guestfs.pod:821 msgid "CONNECTION MANAGEMENT" msgstr "" # type: =head2 -#: ../src/guestfs.pod:792 +#: ../src/guestfs.pod:823 msgid "guestfs_h *" msgstr "" # type: textblock -#: ../src/guestfs.pod:794 +#: ../src/guestfs.pod:825 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 " @@ -1595,19 +1658,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:798 +#: ../src/guestfs.pod:829 msgid "" "For information on using multiple handles and threads, see the section " "L</MULTIPLE HANDLES AND MULTIPLE THREADS> below." msgstr "" # type: =head2 -#: ../src/guestfs.pod:801 +#: ../src/guestfs.pod:832 msgid "guestfs_create" msgstr "" # type: verbatim -#: ../src/guestfs.pod:803 +#: ../src/guestfs.pod:834 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -1615,41 +1678,41 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:805 +#: ../src/guestfs.pod:836 msgid "Create a connection handle." msgstr "" # type: textblock -#: ../src/guestfs.pod:807 +#: ../src/guestfs.pod:838 msgid "You have to call L</guestfs_add_drive> on the handle at least once." msgstr "" # type: textblock -#: ../src/guestfs.pod:809 +#: ../src/guestfs.pod:840 msgid "" "This function returns a non-NULL pointer to a handle on success or NULL on " "error." msgstr "" # type: textblock -#: ../src/guestfs.pod:812 +#: ../src/guestfs.pod:843 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" # type: textblock -#: ../src/guestfs.pod:814 +#: ../src/guestfs.pod:845 msgid "" "You may also want to configure error handling for the handle. See L</ERROR " "HANDLING> section below." msgstr "" # type: =head2 -#: ../src/guestfs.pod:817 +#: ../src/guestfs.pod:848 msgid "guestfs_close" msgstr "" # type: verbatim -#: ../src/guestfs.pod:819 +#: ../src/guestfs.pod:850 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -1657,17 +1720,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:821 +#: ../src/guestfs.pod:852 msgid "This closes the connection handle and frees up all resources used." msgstr "" # type: =head1 -#: ../src/guestfs.pod:823 +#: ../src/guestfs.pod:854 msgid "ERROR HANDLING" msgstr "" # type: textblock -#: ../src/guestfs.pod:825 +#: ../src/guestfs.pod:856 msgid "" "The convention in all functions that return C<int> is that they return C<-1> " "to indicate an error. You can get additional information on errors by " @@ -1676,12 +1739,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:830 +#: ../src/guestfs.pod:861 msgid "The default error handler prints the information string to C<stderr>." msgstr "" # type: textblock -#: ../src/guestfs.pod:832 +#: ../src/guestfs.pod:863 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 " @@ -1689,12 +1752,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:836 +#: ../src/guestfs.pod:867 msgid "guestfs_last_error" msgstr "" # type: verbatim -#: ../src/guestfs.pod:838 +#: ../src/guestfs.pod:869 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -1702,21 +1765,21 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:840 +#: ../src/guestfs.pod:871 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:844 +#: ../src/guestfs.pod:875 msgid "" "The lifetime of the returned string is until the next error occurs, or " "L</guestfs_close> is called." msgstr "" # type: textblock -#: ../src/guestfs.pod:847 +#: ../src/guestfs.pod:878 msgid "" "The error string is not localized (ie. is always in English), because this " "makes searching for error messages in search engines give the largest number " @@ -1724,12 +1787,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:851 +#: ../src/guestfs.pod:882 msgid "guestfs_set_error_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:853 +#: ../src/guestfs.pod:884 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -1742,7 +1805,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:860 +#: ../src/guestfs.pod:891 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 " @@ -1750,7 +1813,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:864 +#: ../src/guestfs.pod:895 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 " @@ -1758,22 +1821,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:868 +#: ../src/guestfs.pod:899 msgid "The default handler prints messages on C<stderr>." msgstr "" # type: textblock -#: ../src/guestfs.pod:870 +#: ../src/guestfs.pod:901 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" # type: =head2 -#: ../src/guestfs.pod:872 +#: ../src/guestfs.pod:903 msgid "guestfs_get_error_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:874 +#: ../src/guestfs.pod:905 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -1782,17 +1845,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:877 +#: ../src/guestfs.pod:908 msgid "Returns the current error handler callback." msgstr "" # type: =head2 -#: ../src/guestfs.pod:879 +#: ../src/guestfs.pod:910 msgid "guestfs_set_out_of_memory_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:881 +#: ../src/guestfs.pod:912 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -1802,29 +1865,29 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:885 +#: ../src/guestfs.pod:916 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:888 +#: ../src/guestfs.pod:919 msgid "The default is to call L<abort(3)>." msgstr "" # type: textblock -#: ../src/guestfs.pod:890 +#: ../src/guestfs.pod:921 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" # type: =head2 -#: ../src/guestfs.pod:893 +#: ../src/guestfs.pod:924 msgid "guestfs_get_out_of_memory_handler" msgstr "" # type: verbatim -#: ../src/guestfs.pod:895 +#: ../src/guestfs.pod:926 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -1832,31 +1895,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:897 +#: ../src/guestfs.pod:928 msgid "This returns the current out of memory handler." msgstr "" # type: =head1 -#: ../src/guestfs.pod:899 +#: ../src/guestfs.pod:930 msgid "PATH" msgstr "" # type: textblock -#: ../src/guestfs.pod:901 +#: ../src/guestfs.pod:932 msgid "" "Libguestfs needs a kernel and initrd.img, which it finds by looking along an " "internal path." msgstr "" # type: textblock -#: ../src/guestfs.pod:904 +#: ../src/guestfs.pod:935 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 -#: ../src/guestfs.pod:907 +#: ../src/guestfs.pod:938 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 " @@ -1867,17 +1930,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:914 +#: ../src/guestfs.pod:945 msgid "HIGH-LEVEL API ACTIONS" msgstr "" # type: =head2 -#: ../src/guestfs.pod:916 +#: ../src/guestfs.pod:947 msgid "ABI GUARANTEE" msgstr "" # type: textblock -#: ../src/guestfs.pod:918 +#: ../src/guestfs.pod:949 msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " @@ -1887,32 +1950,32 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:924 ../fish/guestfish.pod:796 +#: ../src/guestfs.pod:955 ../fish/guestfish.pod:819 msgid "@ACTIONS@" msgstr "" # type: =head1 -#: ../src/guestfs.pod:926 +#: ../src/guestfs.pod:957 msgid "STRUCTURES" msgstr "" # type: textblock -#: ../src/guestfs.pod:928 +#: ../src/guestfs.pod:959 msgid "@STRUCTS@" msgstr "" # type: =head1 -#: ../src/guestfs.pod:930 +#: ../src/guestfs.pod:961 msgid "AVAILABILITY" msgstr "" # type: =head2 -#: ../src/guestfs.pod:932 +#: ../src/guestfs.pod:963 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" # type: textblock -#: ../src/guestfs.pod:934 +#: ../src/guestfs.pod:965 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -1920,17 +1983,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:939 +#: ../src/guestfs.pod:970 msgid "@AVAILABILITY@" msgstr "" # type: =head2 -#: ../src/guestfs.pod:941 +#: ../src/guestfs.pod:972 msgid "GUESTFISH supported COMMAND" msgstr "" # type: textblock -#: ../src/guestfs.pod:943 +#: ../src/guestfs.pod:974 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 " @@ -1938,19 +2001,19 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:948 +#: ../src/guestfs.pod:979 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" # type: textblock -#: ../src/guestfs.pod:950 +#: ../src/guestfs.pod:981 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:953 +#: ../src/guestfs.pod:984 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -1958,12 +2021,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:955 +#: ../src/guestfs.pod:986 msgid "if L</guestfs_dd> is available." msgstr "" # type: textblock -#: ../src/guestfs.pod:957 +#: ../src/guestfs.pod:988 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 " @@ -1971,7 +2034,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:962 +#: ../src/guestfs.pod:993 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -1980,19 +2043,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:965 +#: ../src/guestfs.pod:996 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" # type: =head2 -#: ../src/guestfs.pod:968 +#: ../src/guestfs.pod:999 msgid "SINGLE CALLS AT RUN TIME" msgstr "" # type: textblock -#: ../src/guestfs.pod:970 +#: ../src/guestfs.pod:1001 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 " @@ -2002,7 +2065,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:977 +#: ../src/guestfs.pod:1008 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 " @@ -2010,7 +2073,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:981 +#: ../src/guestfs.pod:1012 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -2022,7 +2085,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:987 +#: ../src/guestfs.pod:1018 #, no-wrap msgid "" " main ()\n" @@ -2034,7 +2097,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:993 +#: ../src/guestfs.pod:1024 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -2049,7 +2112,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1002 +#: ../src/guestfs.pod:1033 #, no-wrap msgid "" " if (!has_function)\n" @@ -2068,7 +2131,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1015 +#: ../src/guestfs.pod:1046 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 " @@ -2076,7 +2139,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1020 +#: ../src/guestfs.pod:1051 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -2084,24 +2147,24 @@ msgid "" msgstr "" # type: =end -#: ../src/guestfs.pod:1022 ../src/guestfs.pod:1027 +#: ../src/guestfs.pod:1053 ../src/guestfs.pod:1058 msgid "html" msgstr "" # type: textblock -#: ../src/guestfs.pod:1024 +#: ../src/guestfs.pod:1055 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1029 +#: ../src/guestfs.pod:1060 msgid "ARCHITECTURE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1031 +#: ../src/guestfs.pod:1062 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 " @@ -2109,7 +2172,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1035 +#: ../src/guestfs.pod:1066 #, no-wrap msgid "" " ___________________\n" @@ -2135,14 +2198,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1055 +#: ../src/guestfs.pod:1086 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L</guestfs_launch> function." msgstr "" # type: textblock -#: ../src/guestfs.pod:1058 +#: ../src/guestfs.pod:1089 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 " @@ -2154,7 +2217,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1067 +#: ../src/guestfs.pod:1098 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 " @@ -2165,17 +2228,17 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1074 +#: ../src/guestfs.pod:1105 msgid "STATE MACHINE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1076 +#: ../src/guestfs.pod:1107 msgid "libguestfs uses a state machine to model the child process:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1078 +#: ../src/guestfs.pod:1109 #, no-wrap msgid "" " |\n" @@ -2203,7 +2266,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1100 +#: ../src/guestfs.pod:1131 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), " @@ -2212,7 +2275,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1105 +#: ../src/guestfs.pod:1136 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 " @@ -2220,14 +2283,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1109 +#: ../src/guestfs.pod:1140 msgid "" "Configuration commands for qemu such as L</guestfs_add_drive> can only be " "issued when in the CONFIG state." msgstr "" # type: textblock -#: ../src/guestfs.pod:1112 +#: ../src/guestfs.pod:1143 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 " @@ -2236,7 +2299,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1118 +#: ../src/guestfs.pod:1149 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 " @@ -2246,7 +2309,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1124 +#: ../src/guestfs.pod:1155 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -2254,26 +2317,26 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1128 +#: ../src/guestfs.pod:1159 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1130 +#: ../src/guestfs.pod:1161 msgid "" "The child process generates events in some situations. Current events " "include: receiving a log message, the child process exits." msgstr "" # type: textblock -#: ../src/guestfs.pod:1133 +#: ../src/guestfs.pod:1164 msgid "" "Use the C<guestfs_set_*_callback> functions to set a callback for different " "types of events." msgstr "" # type: textblock -#: ../src/guestfs.pod:1136 +#: ../src/guestfs.pod:1167 msgid "" "Only I<one callback of each type> can be registered for each handle. " "Calling C<guestfs_set_*_callback> again overwrites the previous callback of " @@ -2282,12 +2345,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1141 +#: ../src/guestfs.pod:1172 msgid "guestfs_set_log_message_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1143 +#: ../src/guestfs.pod:1174 #, no-wrap msgid "" " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n" @@ -2299,31 +2362,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1149 +#: ../src/guestfs.pod:1180 msgid "" "The callback function C<cb> will be called whenever qemu or the guest writes " "anything to the console." msgstr "" # type: textblock -#: ../src/guestfs.pod:1152 +#: ../src/guestfs.pod:1183 msgid "Use this function to capture kernel messages and similar." msgstr "" # type: textblock -#: ../src/guestfs.pod:1154 +#: ../src/guestfs.pod:1185 msgid "" "Normally there is no log message handler, and log messages are just " "discarded." msgstr "" # type: =head2 -#: ../src/guestfs.pod:1157 +#: ../src/guestfs.pod:1188 msgid "guestfs_set_subprocess_quit_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1159 +#: ../src/guestfs.pod:1190 #, no-wrap msgid "" " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n" @@ -2334,7 +2397,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1164 +#: ../src/guestfs.pod:1195 msgid "" "The callback function C<cb> will be called when the child process quits, " "either asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -2342,12 +2405,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1169 +#: ../src/guestfs.pod:1200 msgid "guestfs_set_launch_done_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1171 +#: ../src/guestfs.pod:1202 #, no-wrap msgid "" " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n" @@ -2358,7 +2421,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1176 +#: ../src/guestfs.pod:1207 msgid "" "The callback function C<cb> will be called when the child process becomes " "ready first time after it has been launched. (This corresponds to a " @@ -2366,12 +2429,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1180 +#: ../src/guestfs.pod:1211 msgid "guestfs_set_close_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1182 +#: ../src/guestfs.pod:1213 #, no-wrap msgid "" " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n" @@ -2382,14 +2445,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1187 +#: ../src/guestfs.pod:1218 msgid "" "The callback function C<cb> will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" # type: textblock -#: ../src/guestfs.pod:1190 +#: ../src/guestfs.pod:1221 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 " @@ -2400,12 +2463,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1198 +#: ../src/guestfs.pod:1229 msgid "guestfs_set_progress_callback" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1200 +#: ../src/guestfs.pod:1231 #, no-wrap msgid "" " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n" @@ -2418,7 +2481,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1207 +#: ../src/guestfs.pod:1238 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -2428,7 +2491,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1213 +#: ../src/guestfs.pod:1244 msgid "" "The callback receives two numbers: C<position> and C<total>. The units of " "C<total> are not defined, although for some operations C<total> may relate " @@ -2437,31 +2500,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1250 msgid "The only defined and stable parts of the API are:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1225 +#: ../src/guestfs.pod:1256 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:1230 +#: ../src/guestfs.pod:1261 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1234 +#: ../src/guestfs.pod:1265 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C<position> = C<total>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1237 +#: ../src/guestfs.pod:1268 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 " @@ -2469,7 +2532,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1243 +#: ../src/guestfs.pod:1274 msgid "" "The callback also receives the procedure number and serial number of the " "call. These are only useful for debugging protocol issues, and the callback " @@ -2478,12 +2541,12 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1248 +#: ../src/guestfs.pod:1279 msgid "PRIVATE DATA AREA" msgstr "" # type: textblock -#: ../src/guestfs.pod:1250 +#: ../src/guestfs.pod:1281 msgid "" "You can attach named pieces of private data to the libguestfs handle, and " "fetch them by name for the lifetime of the handle. This is called the " @@ -2491,12 +2554,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1254 +#: ../src/guestfs.pod:1285 msgid "To attach a named piece of data, use the following call:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1256 +#: ../src/guestfs.pod:1287 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -2504,7 +2567,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1258 +#: ../src/guestfs.pod:1289 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 name is " @@ -2512,7 +2575,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1262 +#: ../src/guestfs.pod:1293 msgid "" "You can use any C<key> you want, but names beginning with an underscore " "character are reserved for internal libguestfs purposes (for implementing " @@ -2521,12 +2584,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1267 +#: ../src/guestfs.pod:1298 msgid "To retrieve the pointer, use:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1300 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -2534,7 +2597,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1271 +#: ../src/guestfs.pod:1302 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 " @@ -2542,7 +2605,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1275 +#: ../src/guestfs.pod:1306 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 " @@ -2554,19 +2617,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1283 +#: ../src/guestfs.pod:1314 msgid "" "The private data area is implemented using a hash table, and should be " "reasonably efficient for moderate numbers of keys." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1286 +#: ../src/guestfs.pod:1317 msgid "BLOCK DEVICE NAMING" msgstr "" # type: textblock -#: ../src/guestfs.pod:1288 +#: ../src/guestfs.pod:1319 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 " @@ -2581,7 +2644,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1300 +#: ../src/guestfs.pod:1331 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 " @@ -2589,7 +2652,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1304 +#: ../src/guestfs.pod:1335 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 " @@ -2597,7 +2660,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1309 +#: ../src/guestfs.pod:1340 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 " @@ -2606,7 +2669,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1315 +#: ../src/guestfs.pod:1346 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 " @@ -2614,12 +2677,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1320 +#: ../src/guestfs.pod:1351 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" # type: textblock -#: ../src/guestfs.pod:1322 +#: ../src/guestfs.pod:1353 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 " @@ -2629,7 +2692,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1328 +#: ../src/guestfs.pod:1359 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 " @@ -2637,54 +2700,54 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1336 +#: ../src/guestfs.pod:1367 msgid "Is the string a parameter which is a device or partition name?" msgstr "" # type: textblock -#: ../src/guestfs.pod:1340 +#: ../src/guestfs.pod:1371 msgid "Does the string begin with C</dev/sd>?" msgstr "" # type: textblock -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1375 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 -#: ../src/guestfs.pod:1349 +#: ../src/guestfs.pod:1380 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1351 +#: ../src/guestfs.pod:1382 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1353 +#: ../src/guestfs.pod:1384 msgid "If that named device exists, use it. If not, continue." msgstr "" # type: textblock -#: ../src/guestfs.pod:1357 +#: ../src/guestfs.pod:1388 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1359 +#: ../src/guestfs.pod:1390 msgid "If that named device exists, use it. If not, return an error." msgstr "" # type: =head2 -#: ../src/guestfs.pod:1363 +#: ../src/guestfs.pod:1394 msgid "PORTABILITY CONCERNS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:1396 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 " @@ -2692,50 +2755,50 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1369 +#: ../src/guestfs.pod:1400 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1376 +#: ../src/guestfs.pod:1407 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 -#: ../src/guestfs.pod:1379 +#: ../src/guestfs.pod:1410 msgid "Since those device names exist by definition, they will never be translated." msgstr "" # type: textblock -#: ../src/guestfs.pod:1384 +#: ../src/guestfs.pod:1415 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1389 +#: ../src/guestfs.pod:1420 msgid "INTERNALS" msgstr "" # type: =head2 -#: ../src/guestfs.pod:1391 +#: ../src/guestfs.pod:1422 msgid "COMMUNICATION PROTOCOL" msgstr "" # type: textblock -#: ../src/guestfs.pod:1393 +#: ../src/guestfs.pod:1424 msgid "" "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 -#: ../src/guestfs.pod:1396 +#: ../src/guestfs.pod:1427 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 " @@ -2743,14 +2806,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1400 +#: ../src/guestfs.pod:1431 msgid "" "The detailed format of structures is in C<src/guestfs_protocol.x> (note: " "this file is automatically generated)." msgstr "" # type: textblock -#: ../src/guestfs.pod:1403 +#: ../src/guestfs.pod:1434 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 " @@ -2760,17 +2823,17 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1410 +#: ../src/guestfs.pod:1441 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" # type: textblock -#: ../src/guestfs.pod:1412 +#: ../src/guestfs.pod:1443 msgid "For ordinary functions, the request message is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1414 +#: ../src/guestfs.pod:1445 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -2781,7 +2844,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1419 +#: ../src/guestfs.pod:1450 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 " @@ -2790,26 +2853,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1425 +#: ../src/guestfs.pod:1456 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: textblock -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1459 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 -#: ../src/guestfs.pod:1432 +#: ../src/guestfs.pod:1463 msgid "The reply message for ordinary functions is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1434 +#: ../src/guestfs.pod:1465 #, no-wrap msgid "" " total length (header + ret,\n" @@ -2820,26 +2883,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1439 +#: ../src/guestfs.pod:1470 msgid "" "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" # type: textblock -#: ../src/guestfs.pod:1442 +#: ../src/guestfs.pod:1473 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1445 +#: ../src/guestfs.pod:1476 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:1448 +#: ../src/guestfs.pod:1479 #, no-wrap msgid "" " total length (header + error,\n" @@ -2850,19 +2913,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1453 +#: ../src/guestfs.pod:1484 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" # type: =head3 -#: ../src/guestfs.pod:1456 +#: ../src/guestfs.pod:1487 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1458 +#: ../src/guestfs.pod:1489 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 " @@ -2870,7 +2933,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1462 +#: ../src/guestfs.pod:1493 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -2884,12 +2947,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1470 +#: ../src/guestfs.pod:1501 msgid "The \"sequence of chunks\" is:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1503 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -2903,7 +2966,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1480 +#: ../src/guestfs.pod:1511 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 " @@ -2911,7 +2974,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1484 +#: ../src/guestfs.pod:1515 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -2920,7 +2983,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1489 +#: ../src/guestfs.pod:1520 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 " @@ -2929,7 +2992,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1495 +#: ../src/guestfs.pod:1526 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 " @@ -2941,7 +3004,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1504 +#: ../src/guestfs.pod:1535 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 " @@ -2951,19 +3014,19 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1510 +#: ../src/guestfs.pod:1541 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1543 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 -#: ../src/guestfs.pod:1515 +#: ../src/guestfs.pod:1546 #, no-wrap msgid "" " total length (header + ret,\n" @@ -2977,12 +3040,12 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1523 +#: ../src/guestfs.pod:1554 msgid "INITIAL MESSAGE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1525 +#: ../src/guestfs.pod:1556 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 " @@ -2990,12 +3053,12 @@ msgid "" msgstr "" # type: =head3 -#: ../src/guestfs.pod:1529 +#: ../src/guestfs.pod:1560 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" # type: textblock -#: ../src/guestfs.pod:1531 +#: ../src/guestfs.pod:1562 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -3003,7 +3066,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1535 +#: ../src/guestfs.pod:1566 msgid "" "The library turns them into progress callbacks (see " "C<guestfs_set_progress_callback>) if there is a callback registered, or " @@ -3011,7 +3074,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1539 +#: ../src/guestfs.pod:1570 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -3019,19 +3082,19 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1543 +#: ../src/guestfs.pod:1574 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1545 +#: ../src/guestfs.pod:1576 msgid "" "All high-level libguestfs actions are synchronous. If you want to use " "libguestfs asynchronously then you must create a thread." msgstr "" # type: textblock -#: ../src/guestfs.pod:1548 +#: ../src/guestfs.pod:1579 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 " @@ -3039,19 +3102,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1583 msgid "" "See the graphical program guestfs-browser for one possible architecture for " "multithreaded programs using libvirt and libguestfs." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1555 +#: ../src/guestfs.pod:1586 msgid "QEMU WRAPPERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1557 +#: ../src/guestfs.pod:1588 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 " @@ -3059,7 +3122,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1561 +#: ../src/guestfs.pod:1592 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 " @@ -3068,14 +3131,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1566 +#: ../src/guestfs.pod:1597 msgid "" "Here is an example of a wrapper, where I have built my own copy of qemu from " "source:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1569 +#: ../src/guestfs.pod:1600 #, no-wrap msgid "" " #!/bin/sh -\n" @@ -3086,7 +3149,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1573 +#: ../src/guestfs.pod:1604 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 " @@ -3094,7 +3157,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1577 +#: ../src/guestfs.pod:1608 #, no-wrap msgid "" " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n" @@ -3102,19 +3165,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1579 +#: ../src/guestfs.pod:1610 msgid "" "Note that libguestfs also calls qemu with the -help and -version options in " "order to determine features." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1582 +#: ../src/guestfs.pod:1613 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1584 +#: ../src/guestfs.pod:1615 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -3122,7 +3185,7 @@ msgid "" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1589 +#: ../src/guestfs.pod:1620 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -3139,12 +3202,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1600 +#: ../src/guestfs.pod:1631 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" # type: textblock -#: ../src/guestfs.pod:1602 +#: ../src/guestfs.pod:1633 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 " @@ -3154,26 +3217,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1608 +#: ../src/guestfs.pod:1639 msgid "Our criteria for backporting changes are:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1614 +#: ../src/guestfs.pod:1645 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:1620 +#: ../src/guestfs.pod:1651 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" # type: textblock -#: ../src/guestfs.pod:1625 +#: ../src/guestfs.pod:1656 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 " @@ -3181,7 +3244,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1631 +#: ../src/guestfs.pod:1662 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 " @@ -3189,7 +3252,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1637 +#: ../src/guestfs.pod:1668 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 " @@ -3200,44 +3263,44 @@ msgid "" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:803 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312 ../tools/virt-rescue.pl:226 +#: ../src/guestfs.pod:1676 ../fish/guestfish.pod:826 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312 ../tools/virt-rescue.pl:226 msgid "ENVIRONMENT VARIABLES" msgstr "" # type: =item -#: ../src/guestfs.pod:1649 ../fish/guestfish.pod:829 +#: ../src/guestfs.pod:1680 ../fish/guestfish.pod:852 msgid "LIBGUESTFS_APPEND" msgstr "" # type: textblock -#: ../src/guestfs.pod:1651 ../fish/guestfish.pod:831 +#: ../src/guestfs.pod:1682 ../fish/guestfish.pod:854 msgid "Pass additional options to the guest kernel." msgstr "" # type: =item -#: ../src/guestfs.pod:1653 ../fish/guestfish.pod:833 +#: ../src/guestfs.pod:1684 ../fish/guestfish.pod:856 msgid "LIBGUESTFS_DEBUG" msgstr "" # type: textblock -#: ../src/guestfs.pod:1655 +#: ../src/guestfs.pod:1686 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:1658 ../fish/guestfish.pod:838 +#: ../src/guestfs.pod:1689 ../fish/guestfish.pod:861 msgid "LIBGUESTFS_MEMSIZE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1660 ../fish/guestfish.pod:840 +#: ../src/guestfs.pod:1691 ../fish/guestfish.pod:863 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" # type: verbatim -#: ../src/guestfs.pod:1663 ../fish/guestfish.pod:843 +#: ../src/guestfs.pod:1694 ../fish/guestfish.pod:866 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -3245,72 +3308,72 @@ msgid "" msgstr "" # type: =item -#: ../src/guestfs.pod:1665 ../fish/guestfish.pod:845 +#: ../src/guestfs.pod:1696 ../fish/guestfish.pod:868 msgid "LIBGUESTFS_PATH" msgstr "" # type: textblock -#: ../src/guestfs.pod:1667 +#: ../src/guestfs.pod:1698 msgid "" "Set the path that libguestfs uses to search for kernel and initrd.img. See " "the discussion of paths in section PATH above." msgstr "" # type: =item -#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:850 +#: ../src/guestfs.pod:1701 ../fish/guestfish.pod:873 msgid "LIBGUESTFS_QEMU" msgstr "" # type: textblock -#: ../src/guestfs.pod:1672 ../fish/guestfish.pod:852 +#: ../src/guestfs.pod:1703 ../fish/guestfish.pod:875 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:1676 +#: ../src/guestfs.pod:1707 msgid "See also L</QEMU WRAPPERS> above." msgstr "" # type: =item -#: ../src/guestfs.pod:1678 ../fish/guestfish.pod:856 +#: ../src/guestfs.pod:1709 ../fish/guestfish.pod:879 msgid "LIBGUESTFS_TRACE" msgstr "" # type: textblock -#: ../src/guestfs.pod:1680 +#: ../src/guestfs.pod:1711 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:1683 ../fish/guestfish.pod:865 +#: ../src/guestfs.pod:1714 ../fish/guestfish.pod:888 msgid "TMPDIR" msgstr "" # type: textblock -#: ../src/guestfs.pod:1685 ../fish/guestfish.pod:867 +#: ../src/guestfs.pod:1716 ../fish/guestfish.pod:890 msgid "Location of temporary directory, defaults to C</tmp>." msgstr "" # type: textblock -#: ../src/guestfs.pod:1687 ../fish/guestfish.pod:869 +#: ../src/guestfs.pod:1718 ../fish/guestfish.pod:892 msgid "" -"If libguestfs was compiled to use the supermin appliance then each handle " -"will require rather a large amount of space in this directory for short " -"periods of time (~ 80 MB). You can use C<$TMPDIR> to configure another " -"directory to use in case C</tmp> is not large enough." +"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</tmp> is not large enough." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1695 ../fish/guestfish.pod:927 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178 ../inspector/virt-inspector.pl:846 ../tools/virt-cat.pl:163 ../tools/virt-df.pl:536 ../tools/virt-edit.pl:325 ../tools/virt-list-filesystems.pl:191 ../tools/virt-list-partitions.pl:229 ../tools/virt-ls.pl:210 ../tools/virt-make-fs.pl:527 ../tools/virt-rescue.pl:231 ../tools/virt-resize.pl:1390 ../tools/virt-tar.pl:257 ../tools/virt-win-reg.pl:461 +#: ../src/guestfs.pod:1726 ../fish/guestfish.pod:950 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178 ../inspector/virt-inspector.pl:846 ../tools/virt-edit.pl:325 ../tools/virt-win-reg.pl:461 ../tools/virt-df.pl:536 ../tools/virt-ls.pl:210 ../tools/virt-resize.pl:1390 ../tools/virt-list-filesystems.pl:191 ../tools/virt-cat.pl:163 ../tools/virt-tar.pl:257 ../tools/virt-rescue.pl:231 ../tools/virt-make-fs.pl:527 ../tools/virt-list-partitions.pl:229 msgid "SEE ALSO" msgstr "" # type: textblock -#: ../src/guestfs.pod:1697 +#: ../src/guestfs.pod:1728 msgid "" "L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, " "L<virt-edit(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, " @@ -3320,86 +3383,86 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1715 +#: ../src/guestfs.pod:1746 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1722 ../tools/virt-make-fs.pl:541 ../tools/virt-win-reg.pl:476 +#: ../src/guestfs.pod:1753 ../tools/virt-win-reg.pl:476 ../tools/virt-make-fs.pl:541 msgid "BUGS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1724 +#: ../src/guestfs.pod:1755 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1726 +#: ../src/guestfs.pod:1757 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1728 +#: ../src/guestfs.pod:1759 msgid "To report a new bug against libguestfs use this link:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1730 +#: ../src/guestfs.pod:1761 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1732 +#: ../src/guestfs.pod:1763 msgid "When reporting a bug, please check:" msgstr "" # type: textblock -#: ../src/guestfs.pod:1738 +#: ../src/guestfs.pod:1769 msgid "That the bug hasn't been reported already." msgstr "" # type: textblock -#: ../src/guestfs.pod:1742 +#: ../src/guestfs.pod:1773 msgid "That you are testing a recent version." msgstr "" # type: textblock -#: ../src/guestfs.pod:1746 +#: ../src/guestfs.pod:1777 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" # type: textblock -#: ../src/guestfs.pod:1750 +#: ../src/guestfs.pod:1781 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." msgstr "" # type: =head1 -#: ../src/guestfs.pod:1755 ../fish/guestfish.pod:944 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189 ../inspector/virt-inspector.pl:855 +#: ../src/guestfs.pod:1786 ../fish/guestfish.pod:967 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189 ../inspector/virt-inspector.pl:855 msgid "AUTHORS" msgstr "" # type: textblock -#: ../src/guestfs.pod:1757 ../fish/guestfish.pod:946 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191 +#: ../src/guestfs.pod:1788 ../fish/guestfish.pod:969 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" # type: =head1 -#: ../src/guestfs.pod:1759 ../fish/guestfish.pod:948 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193 ../inspector/virt-inspector.pl:861 ../tools/virt-cat.pl:177 ../tools/virt-df.pl:549 ../tools/virt-edit.pl:341 ../tools/virt-list-filesystems.pl:207 ../tools/virt-list-partitions.pl:244 ../tools/virt-ls.pl:225 ../tools/virt-make-fs.pl:556 ../tools/virt-rescue.pl:245 ../tools/virt-resize.pl:1411 ../tools/virt-tar.pl:272 ../tools/virt-win-reg.pl:491 +#: ../src/guestfs.pod:1790 ../fish/guestfish.pod:971 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193 ../inspector/virt-inspector.pl:861 ../tools/virt-edit.pl:341 ../tools/virt-win-reg.pl:491 ../tools/virt-df.pl:549 ../tools/virt-ls.pl:225 ../tools/virt-resize.pl:1411 ../tools/virt-list-filesystems.pl:207 ../tools/virt-cat.pl:177 ../tools/virt-tar.pl:272 ../tools/virt-rescue.pl:245 ../tools/virt-make-fs.pl:556 ../tools/virt-list-partitions.pl:244 msgid "COPYRIGHT" msgstr "" # type: textblock -#: ../src/guestfs.pod:1761 ../fish/guestfish.pod:950 +#: ../src/guestfs.pod:1792 ../fish/guestfish.pod:973 msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" # type: textblock -#: ../src/guestfs.pod:1764 +#: ../src/guestfs.pod:1795 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 " @@ -3408,7 +3471,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1769 +#: ../src/guestfs.pod:1800 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 " @@ -3417,7 +3480,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs.pod:1774 +#: ../src/guestfs.pod:1805 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, " @@ -3471,7 +3534,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:63 ../src/guestfs-actions.pod:92 ../src/guestfs-actions.pod:103 ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:124 ../src/guestfs-actions.pod:135 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:266 ../src/guestfs-actions.pod:302 ../src/guestfs-actions.pod:324 ../src/guestfs-actions.pod:339 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:430 ../src/guestfs-actions.pod:441 ../src/guestfs-actions.pod:453 ../src/guestfs-actions.pod:534 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:560 ../src/guestfs-actions.pod:571 ../src/guestfs-actions.pod:717 ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:749 ../src/guestfs-actions.pod:824 ../src/guestfs-actions.pod:839 ../src/guestfs-actions.pod:855 ../src/guestfs-actions.pod:866 ../src/guestfs-actions.pod:883 ../src/guestfs-actions.pod:916 ../src/guestfs-actions.pod:974 ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:1024 ../src/guestfs-actions.pod:1055 ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1393 ../src/guestfs-actions.pod:1474 ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1945 ../src/guestfs-actions.pod:2000 ../src/guestfs-actions.pod:2030 ../src/guestfs-actions.pod:2439 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2576 ../src/guestfs-actions.pod:2587 ../src/guestfs-actions.pod:2597 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2620 ../src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2731 ../src/guestfs-actions.pod:2745 ../src/guestfs-actions.pod:2765 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2814 ../src/guestfs-actions.pod:2830 ../src/guestfs-actions.pod:2846 ../src/guestfs-actions.pod:2858 ../src/guestfs-actions.pod:2867 ../src/guestfs-actions.pod:2900 ../src/guestfs-actions.pod:2913 ../src/guestfs-actions.pod:2923 ../src/guestfs-actions.pod:2935 ../src/guestfs-actions.pod:2949 ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:3046 ../src/guestfs-actions.pod:3056 ../src/guestfs-actions.pod:3101 ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3131 ../src/guestfs-actions.pod:3144 ../src/guestfs-actions.pod:3155 ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:3192 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3284 ../src/guestfs-actions.pod:3300 ../src/guestfs-actions.pod:3309 ../src/guestfs-actions.pod:3323 ../src/guestfs-actions.pod:3333 ../src/guestfs-actions.pod:3345 ../src/guestfs-actions.pod:3357 ../src/guestfs-actions.pod:3389 ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3443 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:3514 ../src/guestfs-actions.pod:3525 ../src/guestfs-actions.pod:3550 ../src/guestfs-actions.pod:3564 ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3701 ../src/guestfs-actions.pod:3753 ../src/guestfs-actions.pod:3772 ../src/guestfs-actions.pod:3787 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3847 ../src/guestfs-actions.pod:3861 ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:4114 ../src/guestfs-actions.pod:4130 ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4150 ../src/guestfs-actions.pod:4161 ../src/guestfs-actions.pod:4170 ../src/guestfs-actions.pod:4181 ../src/guestfs-actions.pod:4194 ../src/guestfs-actions.pod:4212 ../src/guestfs-actions.pod:4228 ../src/guestfs-actions.pod:4244 ../src/guestfs-actions.pod:4259 ../src/guestfs-actions.pod:4279 ../src/guestfs-actions.pod:4294 ../src/guestfs-actions.pod:4310 ../src/guestfs-actions.pod:4328 ../src/guestfs-actions.pod:4344 ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:4383 ../src/guestfs-actions.pod:4404 ../src/guestfs-actions.pod:4420 ../src/guestfs-actions.pod:4441 ../src/guestfs-actions.pod:4453 ../src/guestfs-actions.pod:4465 ../src/guestfs-actions.pod:4481 ../src/guestfs-actions.pod:4515 ../src/guestfs-actions.pod:4535 ../src/guestfs-actions.pod:4558 ../src/guestfs-actions.pod:4648 ../src/guestfs-actions.pod:4754 ../src/guestfs-actions.pod:4763 ../src/guestfs-actions.pod:4773 ../src/guestfs-actions.pod:4783 ../src/guestfs-actions.pod:4802 ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4822 ../src/guestfs-actions.pod:4832 ../src/guestfs-actions.pod:4844 ../src/guestfs-actions.pod:4894 ../src/guestfs-actions.pod:4908 ../src/guestfs-actions.pod:4921 ../src/guestfs-actions.pod:4934 ../src/guestfs-actions.pod:4948 ../src/guestfs-actions.pod:4958 ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:5005 ../src/guestfs-actions.pod:5016 ../src/guestfs-actions.pod:5051 ../src/guestfs-actions.pod:5061 ../src/guestfs-actions.pod:5076 ../src/guestfs-actions.pod:5102 ../src/guestfs-actions.pod:5130 ../src/guestfs-actions.pod:5234 ../src/guestfs-actions.pod:5249 ../src/guestfs-actions.pod:5260 ../src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:5316 ../src/guestfs-actions.pod:5353 ../src/guestfs-actions.pod:5380 ../src/guestfs-actions.pod:5422 ../src/guestfs-actions.pod:5445 ../src/guestfs-actions.pod:5502 ../src/guestfs-actions.pod:5518 ../src/guestfs-actions.pod:5544 +#: ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:63 ../src/guestfs-actions.pod:92 ../src/guestfs-actions.pod:103 ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:124 ../src/guestfs-actions.pod:135 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:266 ../src/guestfs-actions.pod:302 ../src/guestfs-actions.pod:324 ../src/guestfs-actions.pod:339 ../src/guestfs-actions.pod:403 ../src/guestfs-actions.pod:430 ../src/guestfs-actions.pod:441 ../src/guestfs-actions.pod:453 ../src/guestfs-actions.pod:534 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:560 ../src/guestfs-actions.pod:571 ../src/guestfs-actions.pod:717 ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:749 ../src/guestfs-actions.pod:824 ../src/guestfs-actions.pod:839 ../src/guestfs-actions.pod:855 ../src/guestfs-actions.pod:866 ../src/guestfs-actions.pod:883 ../src/guestfs-actions.pod:916 ../src/guestfs-actions.pod:974 ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:1024 ../src/guestfs-actions.pod:1055 ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1393 ../src/guestfs-actions.pod:1474 ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1945 ../src/guestfs-actions.pod:2000 ../src/guestfs-actions.pod:2030 ../src/guestfs-actions.pod:2439 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2576 ../src/guestfs-actions.pod:2587 ../src/guestfs-actions.pod:2597 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2620 ../src/guestfs-actions.pod:2650 ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2731 ../src/guestfs-actions.pod:2745 ../src/guestfs-actions.pod:2765 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2814 ../src/guestfs-actions.pod:2830 ../src/guestfs-actions.pod:2846 ../src/guestfs-actions.pod:2858 ../src/guestfs-actions.pod:2867 ../src/guestfs-actions.pod:2900 ../src/guestfs-actions.pod:2913 ../src/guestfs-actions.pod:2923 ../src/guestfs-actions.pod:2935 ../src/guestfs-actions.pod:2949 ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:3046 ../src/guestfs-actions.pod:3056 ../src/guestfs-actions.pod:3101 ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3131 ../src/guestfs-actions.pod:3144 ../src/guestfs-actions.pod:3155 ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:3192 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3284 ../src/guestfs-actions.pod:3300 ../src/guestfs-actions.pod:3309 ../src/guestfs-actions.pod:3323 ../src/guestfs-actions.pod:3333 ../src/guestfs-actions.pod:3345 ../src/guestfs-actions.pod:3357 ../src/guestfs-actions.pod:3389 ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3443 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:3514 ../src/guestfs-actions.pod:3525 ../src/guestfs-actions.pod:3550 ../src/guestfs-actions.pod:3564 ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3701 ../src/guestfs-actions.pod:3753 ../src/guestfs-actions.pod:3772 ../src/guestfs-actions.pod:3787 ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3847 ../src/guestfs-actions.pod:3861 ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:4137 ../src/guestfs-actions.pod:4153 ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4173 ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4193 ../src/guestfs-actions.pod:4204 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:4235 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4267 ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:4302 ../src/guestfs-actions.pod:4317 ../src/guestfs-actions.pod:4333 ../src/guestfs-actions.pod:4351 ../src/guestfs-actions.pod:4367 ../src/guestfs-actions.pod:4381 ../src/guestfs-actions.pod:4406 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4464 ../src/guestfs-actions.pod:4476 ../src/guestfs-actions.pod:4488 ../src/guestfs-actions.pod:4504 ../src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:4558 ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4671 ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:4786 ../src/guestfs-actions.pod:4796 ../src/guestfs-actions.pod:4806 ../src/guestfs-actions.pod:4825 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4845 ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4867 ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:4931 ../src/guestfs-actions.pod:4944 ../src/guestfs-actions.pod:4957 ../src/guestfs-actions.pod:4971 ../src/guestfs-actions.pod:4981 ../src/guestfs-actions.pod:4998 ../src/guestfs-actions.pod:5028 ../src/guestfs-actions.pod:5039 ../src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:5099 ../src/guestfs-actions.pod:5125 ../src/guestfs-actions.pod:5153 ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5272 ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5376 ../src/guestfs-actions.pod:5403 ../src/guestfs-actions.pod:5445 ../src/guestfs-actions.pod:5468 ../src/guestfs-actions.pod:5525 ../src/guestfs-actions.pod:5541 ../src/guestfs-actions.pod:5567 msgid "This function returns 0 on success or -1 on error." msgstr "" @@ -3733,7 +3796,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:172 ../src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:492 ../src/guestfs-actions.pod:507 ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1693 ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1935 ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:2165 ../src/guestfs-actions.pod:3503 ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3941 ../src/guestfs-actions.pod:5040 ../src/guestfs-actions.pod:5390 ../src/guestfs-actions.pod:5400 ../src/guestfs-actions.pod:5410 +#: ../src/guestfs-actions.pod:172 ../src/guestfs-actions.pod:313 ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:492 ../src/guestfs-actions.pod:507 ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1538 ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1650 ../src/guestfs-actions.pod:1693 ../src/guestfs-actions.pod:1710 ../src/guestfs-actions.pod:1935 ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:2165 ../src/guestfs-actions.pod:3503 ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3941 ../src/guestfs-actions.pod:3964 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5413 ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5433 msgid "On error this function returns -1." msgstr "" @@ -3759,7 +3822,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:182 ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:695 ../src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:899 ../src/guestfs-actions.pod:928 ../src/guestfs-actions.pod:942 ../src/guestfs-actions.pod:958 ../src/guestfs-actions.pod:1069 ../src/guestfs-actions.pod:1233 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1487 ../src/guestfs-actions.pod:1501 ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1729 ../src/guestfs-actions.pod:1868 ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2215 ../src/guestfs-actions.pod:2250 ../src/guestfs-actions.pod:2565 ../src/guestfs-actions.pod:2986 ../src/guestfs-actions.pod:3082 ../src/guestfs-actions.pod:3625 ../src/guestfs-actions.pod:3801 ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:4057 ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4576 ../src/guestfs-actions.pod:4589 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:4624 ../src/guestfs-actions.pod:5183 ../src/guestfs-actions.pod:5199 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5362 ../src/guestfs-actions.pod:5592 +#: ../src/guestfs-actions.pod:182 ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:695 ../src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:899 ../src/guestfs-actions.pod:928 ../src/guestfs-actions.pod:942 ../src/guestfs-actions.pod:958 ../src/guestfs-actions.pod:1069 ../src/guestfs-actions.pod:1233 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1487 ../src/guestfs-actions.pod:1501 ../src/guestfs-actions.pod:1577 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1729 ../src/guestfs-actions.pod:1868 ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2215 ../src/guestfs-actions.pod:2250 ../src/guestfs-actions.pod:2565 ../src/guestfs-actions.pod:2986 ../src/guestfs-actions.pod:3082 ../src/guestfs-actions.pod:3625 ../src/guestfs-actions.pod:3801 ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4123 ../src/guestfs-actions.pod:4599 ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:4626 ../src/guestfs-actions.pod:4647 ../src/guestfs-actions.pod:5206 ../src/guestfs-actions.pod:5222 ../src/guestfs-actions.pod:5237 ../src/guestfs-actions.pod:5385 ../src/guestfs-actions.pod:5615 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." @@ -3952,7 +4015,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:276 ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:417 ../src/guestfs-actions.pod:802 ../src/guestfs-actions.pod:1081 ../src/guestfs-actions.pod:1097 ../src/guestfs-actions.pod:1185 ../src/guestfs-actions.pod:1201 ../src/guestfs-actions.pod:1432 ../src/guestfs-actions.pod:1766 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1795 ../src/guestfs-actions.pod:1832 ../src/guestfs-actions.pod:1853 ../src/guestfs-actions.pod:1915 ../src/guestfs-actions.pod:1955 ../src/guestfs-actions.pod:2121 ../src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2494 ../src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2963 ../src/guestfs-actions.pod:3470 ../src/guestfs-actions.pod:3896 ../src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:4088 ../src/guestfs-actions.pod:4637 ../src/guestfs-actions.pod:4686 ../src/guestfs-actions.pod:4738 ../src/guestfs-actions.pod:4854 ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:5275 ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:5330 ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5482 ../src/guestfs-actions.pod:5555 ../src/guestfs-actions.pod:5571 ../src/guestfs-actions.pod:5611 ../src/guestfs-actions.pod:5627 +#: ../src/guestfs-actions.pod:276 ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:417 ../src/guestfs-actions.pod:802 ../src/guestfs-actions.pod:1081 ../src/guestfs-actions.pod:1097 ../src/guestfs-actions.pod:1185 ../src/guestfs-actions.pod:1201 ../src/guestfs-actions.pod:1432 ../src/guestfs-actions.pod:1766 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1795 ../src/guestfs-actions.pod:1832 ../src/guestfs-actions.pod:1853 ../src/guestfs-actions.pod:1915 ../src/guestfs-actions.pod:1955 ../src/guestfs-actions.pod:2121 ../src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2494 ../src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2963 ../src/guestfs-actions.pod:3470 ../src/guestfs-actions.pod:3896 ../src/guestfs-actions.pod:4005 ../src/guestfs-actions.pod:4111 ../src/guestfs-actions.pod:4660 ../src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:4761 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4898 ../src/guestfs-actions.pod:5298 ../src/guestfs-actions.pod:5315 ../src/guestfs-actions.pod:5353 ../src/guestfs-actions.pod:5489 ../src/guestfs-actions.pod:5505 ../src/guestfs-actions.pod:5578 ../src/guestfs-actions.pod:5594 ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5650 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 " @@ -4567,7 +4630,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:618 ../src/guestfs-actions.pod:3972 ../fish/guestfish-actions.pod:506 ../fish/guestfish-actions.pod:3068 +#: ../src/guestfs-actions.pod:618 ../src/guestfs-actions.pod:3995 ../fish/guestfish-actions.pod:506 ../fish/guestfish-actions.pod:3085 msgid "Return the contents of the file named C<path>." msgstr "" @@ -4581,7 +4644,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:628 ../src/guestfs-actions.pod:789 ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:1085 ../src/guestfs-actions.pod:1101 ../src/guestfs-actions.pod:1189 ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:1436 ../src/guestfs-actions.pod:1783 ../src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:1871 ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:3835 ../src/guestfs-actions.pod:3943 ../src/guestfs-actions.pod:3964 ../src/guestfs-actions.pod:4690 ../src/guestfs-actions.pod:4742 ../src/guestfs-actions.pod:4858 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:5424 ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5486 ../src/guestfs-actions.pod:5559 ../src/guestfs-actions.pod:5575 ../src/guestfs-actions.pod:5615 ../src/guestfs-actions.pod:5631 ../fish/guestfish-actions.pod:513 ../fish/guestfish-actions.pod:648 ../fish/guestfish-actions.pod:660 ../fish/guestfish-actions.pod:861 ../fish/guestfish-actions.pod:871 ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1418 ../fish/guestfish-actions.pod:1428 ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1481 ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:2970 ../fish/guestfish-actions.pod:3046 ../fish/guestfish-actions.pod:3061 ../fish/guestfish-actions.pod:3644 ../fish/guestfish-actions.pod:3690 ../fish/guestfish-actions.pod:3775 ../fish/guestfish-actions.pod:3790 ../fish/guestfish-actions.pod:4200 ../fish/guestfish-actions.pod:4218 ../fish/guestfish-actions.pod:4235 ../fish/guestfish-actions.pod:4245 ../fish/guestfish-actions.pod:4293 ../fish/guestfish-actions.pod:4303 ../fish/guestfish-actions.pod:4332 ../fish/guestfish-actions.pod:4342 +#: ../src/guestfs-actions.pod:628 ../src/guestfs-actions.pod:789 ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:1085 ../src/guestfs-actions.pod:1101 ../src/guestfs-actions.pod:1189 ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:1436 ../src/guestfs-actions.pod:1783 ../src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:1836 ../src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:1871 ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:3835 ../src/guestfs-actions.pod:3943 ../src/guestfs-actions.pod:3966 ../src/guestfs-actions.pod:3987 ../src/guestfs-actions.pod:4713 ../src/guestfs-actions.pod:4765 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:4902 ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5493 ../src/guestfs-actions.pod:5509 ../src/guestfs-actions.pod:5582 ../src/guestfs-actions.pod:5598 ../src/guestfs-actions.pod:5638 ../src/guestfs-actions.pod:5654 ../fish/guestfish-actions.pod:513 ../fish/guestfish-actions.pod:648 ../fish/guestfish-actions.pod:660 ../fish/guestfish-actions.pod:861 ../fish/guestfish-actions.pod:871 ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:948 ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1418 ../fish/guestfish-actions.pod:1428 ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:1471 ../fish/guestfish-actions.pod:1481 ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:2970 ../fish/guestfish-actions.pod:3046 ../fish/guestfish-actions.pod:3063 ../fish/guestfish-actions.pod:3078 ../fish/guestfish-actions.pod:3661 ../fish/guestfish-actions.pod:3707 ../fish/guestfish-actions.pod:3792 ../fish/guestfish-actions.pod:3807 ../fish/guestfish-actions.pod:4217 ../fish/guestfish-actions.pod:4235 ../fish/guestfish-actions.pod:4252 ../fish/guestfish-actions.pod:4262 ../fish/guestfish-actions.pod:4310 ../fish/guestfish-actions.pod:4320 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4359 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." @@ -4973,7 +5036,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:1004 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:1395 ../src/guestfs-actions.pod:5504 ../src/guestfs-actions.pod:5520 +#: ../src/guestfs-actions.pod:841 ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:1004 ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:1395 ../src/guestfs-actions.pod:5527 ../src/guestfs-actions.pod:5543 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -5212,7 +5275,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:5072 ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:3948 +#: ../src/guestfs-actions.pod:970 ../src/guestfs-actions.pod:5095 ../fish/guestfish-actions.pod:779 ../fish/guestfish-actions.pod:3965 msgid "C<filename> can also be a named pipe." msgstr "" @@ -5516,7 +5579,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:1148 ../src/guestfs-actions.pod:1583 ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:5453 ../src/guestfs-actions.pod:5598 ../fish/guestfish-actions.pod:907 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1278 ../fish/guestfish-actions.pod:4224 ../fish/guestfish-actions.pod:4321 +#: ../src/guestfs-actions.pod:1148 ../src/guestfs-actions.pod:1583 ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:5476 ../src/guestfs-actions.pod:5621 ../fish/guestfish-actions.pod:907 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1278 ../fish/guestfish-actions.pod:4241 ../fish/guestfish-actions.pod:4338 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 " @@ -6289,7 +6352,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1679 ../src/guestfs-actions.pod:4325 ../src/guestfs-actions.pod:4417 ../fish/guestfish-actions.pod:1293 ../fish/guestfish-actions.pod:1344 ../fish/guestfish-actions.pod:3355 ../fish/guestfish-actions.pod:3442 +#: ../src/guestfs-actions.pod:1616 ../src/guestfs-actions.pod:1679 ../src/guestfs-actions.pod:4348 ../src/guestfs-actions.pod:4440 ../fish/guestfish-actions.pod:1293 ../fish/guestfish-actions.pod:1344 ../fish/guestfish-actions.pod:3372 ../fish/guestfish-actions.pod:3459 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" @@ -6743,7 +6806,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:4873 ../fish/guestfish-actions.pod:1469 ../fish/guestfish-actions.pod:3788 +#: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:4896 ../fish/guestfish-actions.pod:1469 ../fish/guestfish-actions.pod:3805 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" @@ -6814,7 +6877,7 @@ msgid "See also C<guestfs_initrd_list>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:3960 +#: ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:3983 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 " @@ -7333,7 +7396,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:4990 +#: ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:3453 ../src/guestfs-actions.pod:5013 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 " @@ -8140,7 +8203,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2657 ../src/guestfs-actions.pod:4655 ../fish/guestfish-actions.pod:2101 ../fish/guestfish-actions.pod:3623 +#: ../src/guestfs-actions.pod:2657 ../src/guestfs-actions.pod:4678 ../fish/guestfish-actions.pod:2101 ../fish/guestfish-actions.pod:3640 msgid "Returns file information for the given C<path>." msgstr "" @@ -8157,7 +8220,7 @@ msgid "This is the same as the C<lstat(2)> system call." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4659 +#: ../src/guestfs-actions.pod:2665 ../src/guestfs-actions.pod:4682 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>." @@ -8301,7 +8364,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:2747 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2869 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:4196 ../src/guestfs-actions.pod:4517 ../src/guestfs-actions.pod:4537 ../src/guestfs-actions.pod:4560 ../src/guestfs-actions.pod:5525 ../fish/guestfish-actions.pod:2168 ../fish/guestfish-actions.pod:2181 ../fish/guestfish-actions.pod:2252 ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:3242 ../fish/guestfish-actions.pod:3522 ../fish/guestfish-actions.pod:3538 ../fish/guestfish-actions.pod:3553 ../fish/guestfish-actions.pod:4268 +#: ../src/guestfs-actions.pod:2747 ../src/guestfs-actions.pod:2767 ../src/guestfs-actions.pod:2869 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:4540 ../src/guestfs-actions.pod:4560 ../src/guestfs-actions.pod:4583 ../src/guestfs-actions.pod:5548 ../fish/guestfish-actions.pod:2168 ../fish/guestfish-actions.pod:2181 ../fish/guestfish-actions.pod:2252 ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:3259 ../fish/guestfish-actions.pod:3539 ../fish/guestfish-actions.pod:3555 ../fish/guestfish-actions.pod:3570 ../fish/guestfish-actions.pod:4285 msgid "" "B<This command is dangerous. Without careful use you can easily destroy all " "your data>." @@ -10290,7 +10353,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3829 +#: ../src/guestfs-actions.pod:3829 ../src/guestfs-actions.pod:3962 msgid "See also C<guestfs_pwrite>." msgstr "" @@ -10502,18 +10565,50 @@ msgstr "" # type: textblock #: ../src/guestfs-actions.pod:3939 -msgid "See also C<guestfs_pread>." +msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" # type: =head2 #: ../src/guestfs-actions.pod:3946 -msgid "guestfs_read_file" +msgid "guestfs_pwrite_device" msgstr "" # type: verbatim #: ../src/guestfs-actions.pod:3948 #, no-wrap msgid "" +" int guestfs_pwrite_device (guestfs_h *g,\n" +"\t\tconst char *device,\n" +"\t\tconst char *content,\n" +"\t\tsize_t content_size,\n" +"\t\tint64_t offset);\n" +"\n" +msgstr "" + +# type: textblock +#: ../src/guestfs-actions.pod:3954 ../fish/guestfish-actions.pod:3053 +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:3957 ../fish/guestfish-actions.pod:3056 +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 " +"devices and partitions are probably impossible with standard Linux kernels)." +msgstr "" + +# type: =head2 +#: ../src/guestfs-actions.pod:3969 +msgid "guestfs_read_file" +msgstr "" + +# type: verbatim +#: ../src/guestfs-actions.pod:3971 +#, no-wrap +msgid "" " char *guestfs_read_file (guestfs_h *g,\n" "\t\tconst char *path,\n" "\t\tsize_t *size_r);\n" @@ -10521,12 +10616,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3952 ../fish/guestfish-actions.pod:3053 +#: ../src/guestfs-actions.pod:3975 ../fish/guestfish-actions.pod:3070 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3955 +#: ../src/guestfs-actions.pod:3978 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -10534,12 +10629,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:3967 +#: ../src/guestfs-actions.pod:3990 msgid "guestfs_read_lines" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:3969 +#: ../src/guestfs-actions.pod:3992 #, no-wrap msgid "" " char **guestfs_read_lines (guestfs_h *g,\n" @@ -10548,14 +10643,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3974 ../fish/guestfish-actions.pod:3070 +#: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:3087 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:3977 +#: ../src/guestfs-actions.pod:4000 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -10564,12 +10659,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:3986 +#: ../src/guestfs-actions.pod:4009 msgid "guestfs_readdir" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:3988 +#: ../src/guestfs-actions.pod:4011 #, no-wrap msgid "" " struct guestfs_dirent_list *guestfs_readdir (guestfs_h *g,\n" @@ -10578,12 +10673,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3991 ../fish/guestfish-actions.pod:3082 +#: ../src/guestfs-actions.pod:4014 ../fish/guestfish-actions.pod:3099 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3993 ../fish/guestfish-actions.pod:3084 +#: ../src/guestfs-actions.pod:4016 ../fish/guestfish-actions.pod:3101 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 " @@ -10591,104 +10686,104 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:3088 +#: ../src/guestfs-actions.pod:4020 ../fish/guestfish-actions.pod:3105 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:4002 ../fish/guestfish-actions.pod:3093 +#: ../src/guestfs-actions.pod:4025 ../fish/guestfish-actions.pod:3110 msgid "'b'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4004 ../fish/guestfish-actions.pod:3095 +#: ../src/guestfs-actions.pod:4027 ../fish/guestfish-actions.pod:3112 msgid "Block special" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4006 ../fish/guestfish-actions.pod:3097 +#: ../src/guestfs-actions.pod:4029 ../fish/guestfish-actions.pod:3114 msgid "'c'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4008 ../fish/guestfish-actions.pod:3099 +#: ../src/guestfs-actions.pod:4031 ../fish/guestfish-actions.pod:3116 msgid "Char special" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4010 ../fish/guestfish-actions.pod:3101 +#: ../src/guestfs-actions.pod:4033 ../fish/guestfish-actions.pod:3118 msgid "'d'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4012 ../fish/guestfish-actions.pod:3103 +#: ../src/guestfs-actions.pod:4035 ../fish/guestfish-actions.pod:3120 msgid "Directory" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4014 ../fish/guestfish-actions.pod:3105 +#: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:3122 msgid "'f'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4016 ../fish/guestfish-actions.pod:3107 +#: ../src/guestfs-actions.pod:4039 ../fish/guestfish-actions.pod:3124 msgid "FIFO (named pipe)" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4018 ../fish/guestfish-actions.pod:3109 +#: ../src/guestfs-actions.pod:4041 ../fish/guestfish-actions.pod:3126 msgid "'l'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4020 ../fish/guestfish-actions.pod:3111 +#: ../src/guestfs-actions.pod:4043 ../fish/guestfish-actions.pod:3128 msgid "Symbolic link" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4022 ../fish/guestfish-actions.pod:3113 +#: ../src/guestfs-actions.pod:4045 ../fish/guestfish-actions.pod:3130 msgid "'r'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4024 ../fish/guestfish-actions.pod:3115 +#: ../src/guestfs-actions.pod:4047 ../fish/guestfish-actions.pod:3132 msgid "Regular file" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4026 ../fish/guestfish-actions.pod:3117 +#: ../src/guestfs-actions.pod:4049 ../fish/guestfish-actions.pod:3134 msgid "'s'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4028 ../fish/guestfish-actions.pod:3119 +#: ../src/guestfs-actions.pod:4051 ../fish/guestfish-actions.pod:3136 msgid "Socket" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4030 ../fish/guestfish-actions.pod:3121 +#: ../src/guestfs-actions.pod:4053 ../fish/guestfish-actions.pod:3138 msgid "'u'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4032 ../fish/guestfish-actions.pod:3123 +#: ../src/guestfs-actions.pod:4055 ../fish/guestfish-actions.pod:3140 msgid "Unknown file type" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4034 ../fish/guestfish-actions.pod:3125 +#: ../src/guestfs-actions.pod:4057 ../fish/guestfish-actions.pod:3142 msgid "'?'" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4036 ../fish/guestfish-actions.pod:3127 +#: ../src/guestfs-actions.pod:4059 ../fish/guestfish-actions.pod:3144 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4041 +#: ../src/guestfs-actions.pod:4064 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 " @@ -10696,7 +10791,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4045 +#: ../src/guestfs-actions.pod:4068 msgid "" "This function returns a C<struct guestfs_dirent_list *> (see " "E<lt>guestfs-structs.hE<gt>), or NULL if there was an error. I<The caller " @@ -10704,12 +10799,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4050 +#: ../src/guestfs-actions.pod:4073 msgid "guestfs_readlink" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4052 +#: ../src/guestfs-actions.pod:4075 #, no-wrap msgid "" " char *guestfs_readlink (guestfs_h *g,\n" @@ -10718,17 +10813,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4055 ../fish/guestfish-actions.pod:3140 +#: ../src/guestfs-actions.pod:4078 ../fish/guestfish-actions.pod:3157 msgid "This command reads the target of a symbolic link." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4060 +#: ../src/guestfs-actions.pod:4083 msgid "guestfs_readlinklist" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4062 +#: ../src/guestfs-actions.pod:4085 #, no-wrap msgid "" " char **guestfs_readlinklist (guestfs_h *g,\n" @@ -10738,7 +10833,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4066 ../fish/guestfish-actions.pod:3146 +#: ../src/guestfs-actions.pod:4089 ../fish/guestfish-actions.pod:3163 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 " @@ -10746,14 +10841,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4070 ../fish/guestfish-actions.pod:3150 +#: ../src/guestfs-actions.pod:4093 ../fish/guestfish-actions.pod:3167 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:4074 ../fish/guestfish-actions.pod:3154 +#: ../src/guestfs-actions.pod:4097 ../fish/guestfish-actions.pod:3171 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 " @@ -10763,7 +10858,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4081 ../fish/guestfish-actions.pod:3161 +#: ../src/guestfs-actions.pod:4104 ../fish/guestfish-actions.pod:3178 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -10772,12 +10867,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4092 +#: ../src/guestfs-actions.pod:4115 msgid "guestfs_realpath" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4094 +#: ../src/guestfs-actions.pod:4117 #, no-wrap msgid "" " char *guestfs_realpath (guestfs_h *g,\n" @@ -10786,19 +10881,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4097 ../fish/guestfish-actions.pod:3172 +#: ../src/guestfs-actions.pod:4120 ../fish/guestfish-actions.pod:3189 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:4103 +#: ../src/guestfs-actions.pod:4126 msgid "guestfs_removexattr" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4105 +#: ../src/guestfs-actions.pod:4128 #, no-wrap msgid "" " int guestfs_removexattr (guestfs_h *g,\n" @@ -10808,22 +10903,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4109 ../fish/guestfish-actions.pod:3179 +#: ../src/guestfs-actions.pod:4132 ../fish/guestfish-actions.pod:3196 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4112 +#: ../src/guestfs-actions.pod:4135 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4116 +#: ../src/guestfs-actions.pod:4139 msgid "guestfs_resize2fs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4118 +#: ../src/guestfs-actions.pod:4141 #, no-wrap msgid "" " int guestfs_resize2fs (guestfs_h *g,\n" @@ -10832,14 +10927,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4121 ../fish/guestfish-actions.pod:3188 +#: ../src/guestfs-actions.pod:4144 ../fish/guestfish-actions.pod:3205 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4124 +#: ../src/guestfs-actions.pod:4147 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> " @@ -10848,12 +10943,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4132 +#: ../src/guestfs-actions.pod:4155 msgid "guestfs_resize2fs_size" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4134 +#: ../src/guestfs-actions.pod:4157 #, no-wrap msgid "" " int guestfs_resize2fs_size (guestfs_h *g,\n" @@ -10863,19 +10958,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4138 +#: ../src/guestfs-actions.pod:4161 msgid "" "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 -#: ../src/guestfs-actions.pod:4143 +#: ../src/guestfs-actions.pod:4166 msgid "guestfs_rm" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4145 +#: ../src/guestfs-actions.pod:4168 #, no-wrap msgid "" " int guestfs_rm (guestfs_h *g,\n" @@ -10884,17 +10979,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4148 ../fish/guestfish-actions.pod:3208 +#: ../src/guestfs-actions.pod:4171 ../fish/guestfish-actions.pod:3225 msgid "Remove the single file C<path>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4152 +#: ../src/guestfs-actions.pod:4175 msgid "guestfs_rm_rf" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4154 +#: ../src/guestfs-actions.pod:4177 #, no-wrap msgid "" " int guestfs_rm_rf (guestfs_h *g,\n" @@ -10903,19 +10998,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4157 ../fish/guestfish-actions.pod:3214 +#: ../src/guestfs-actions.pod:4180 ../fish/guestfish-actions.pod:3231 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:4163 +#: ../src/guestfs-actions.pod:4186 msgid "guestfs_rmdir" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4165 +#: ../src/guestfs-actions.pod:4188 #, no-wrap msgid "" " int guestfs_rmdir (guestfs_h *g,\n" @@ -10924,17 +11019,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4168 ../fish/guestfish-actions.pod:3222 +#: ../src/guestfs-actions.pod:4191 ../fish/guestfish-actions.pod:3239 msgid "Remove the single directory C<path>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4172 +#: ../src/guestfs-actions.pod:4195 msgid "guestfs_rmmountpoint" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4174 +#: ../src/guestfs-actions.pod:4197 #, no-wrap msgid "" " int guestfs_rmmountpoint (guestfs_h *g,\n" @@ -10943,19 +11038,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4177 +#: ../src/guestfs-actions.pod:4200 msgid "" "This calls removes a mountpoint that was previously created with " "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4183 +#: ../src/guestfs-actions.pod:4206 msgid "guestfs_scrub_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4185 +#: ../src/guestfs-actions.pod:4208 #, no-wrap msgid "" " int guestfs_scrub_device (guestfs_h *g,\n" @@ -10964,26 +11059,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4188 ../fish/guestfish-actions.pod:3236 +#: ../src/guestfs-actions.pod:4211 ../fish/guestfish-actions.pod:3253 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4191 ../src/guestfs-actions.pod:4209 ../src/guestfs-actions.pod:4225 ../fish/guestfish-actions.pod:3239 ../fish/guestfish-actions.pod:3254 ../fish/guestfish-actions.pod:3267 +#: ../src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:4248 ../fish/guestfish-actions.pod:3256 ../fish/guestfish-actions.pod:3271 ../fish/guestfish-actions.pod:3284 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4199 +#: ../src/guestfs-actions.pod:4222 msgid "guestfs_scrub_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4201 +#: ../src/guestfs-actions.pod:4224 #, no-wrap msgid "" " int guestfs_scrub_file (guestfs_h *g,\n" @@ -10992,24 +11087,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4204 ../fish/guestfish-actions.pod:3249 +#: ../src/guestfs-actions.pod:4227 ../fish/guestfish-actions.pod:3266 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4207 ../fish/guestfish-actions.pod:3252 +#: ../src/guestfs-actions.pod:4230 ../fish/guestfish-actions.pod:3269 msgid "The file is I<removed> after scrubbing." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4214 +#: ../src/guestfs-actions.pod:4237 msgid "guestfs_scrub_freespace" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4216 +#: ../src/guestfs-actions.pod:4239 #, no-wrap msgid "" " int guestfs_scrub_freespace (guestfs_h *g,\n" @@ -11018,7 +11113,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4219 +#: ../src/guestfs-actions.pod:4242 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>, " @@ -11027,12 +11122,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4230 +#: ../src/guestfs-actions.pod:4253 msgid "guestfs_set_append" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4232 +#: ../src/guestfs-actions.pod:4255 #, no-wrap msgid "" " int guestfs_set_append (guestfs_h *g,\n" @@ -11041,33 +11136,33 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4235 ../fish/guestfish-actions.pod:3276 +#: ../src/guestfs-actions.pod:4258 ../fish/guestfish-actions.pod:3293 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4238 ../fish/guestfish-actions.pod:3279 +#: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:3296 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4241 ../fish/guestfish-actions.pod:3282 +#: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:3299 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:4246 +#: ../src/guestfs-actions.pod:4269 msgid "guestfs_set_autosync" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4248 +#: ../src/guestfs-actions.pod:4271 #, no-wrap msgid "" " int guestfs_set_autosync (guestfs_h *g,\n" @@ -11076,7 +11171,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4251 +#: ../src/guestfs-actions.pod:4274 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to run C<guestfs_umount_all> followed by C<guestfs_sync> when " @@ -11084,19 +11179,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4256 ../fish/guestfish-actions.pod:3296 +#: ../src/guestfs-actions.pod:4279 ../fish/guestfish-actions.pod:3313 msgid "" "This is disabled by default (except in guestfish where it is enabled by " "default)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4261 +#: ../src/guestfs-actions.pod:4284 msgid "guestfs_set_direct" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4263 +#: ../src/guestfs-actions.pod:4286 #, no-wrap msgid "" " int guestfs_set_direct (guestfs_h *g,\n" @@ -11105,14 +11200,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4266 ../fish/guestfish-actions.pod:3305 +#: ../src/guestfs-actions.pod:4289 ../fish/guestfish-actions.pod:3322 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:4270 +#: ../src/guestfs-actions.pod:4293 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 " @@ -11120,22 +11215,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4274 ../fish/guestfish-actions.pod:3313 +#: ../src/guestfs-actions.pod:4297 ../fish/guestfish-actions.pod:3330 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4277 ../fish/guestfish-actions.pod:3316 +#: ../src/guestfs-actions.pod:4300 ../fish/guestfish-actions.pod:3333 msgid "The default is disabled." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4281 +#: ../src/guestfs-actions.pod:4304 msgid "guestfs_set_e2label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4283 +#: ../src/guestfs-actions.pod:4306 #, no-wrap msgid "" " int guestfs_set_e2label (guestfs_h *g,\n" @@ -11145,26 +11240,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4287 ../fish/guestfish-actions.pod:3322 +#: ../src/guestfs-actions.pod:4310 ../fish/guestfish-actions.pod:3339 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:4291 +#: ../src/guestfs-actions.pod:4314 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " "the existing label on a filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4296 +#: ../src/guestfs-actions.pod:4319 msgid "guestfs_set_e2uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4298 +#: ../src/guestfs-actions.pod:4321 #, no-wrap msgid "" " int guestfs_set_e2uuid (guestfs_h *g,\n" @@ -11174,7 +11269,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4302 ../fish/guestfish-actions.pod:3333 +#: ../src/guestfs-actions.pod:4325 ../fish/guestfish-actions.pod:3350 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>, " @@ -11182,19 +11277,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4307 +#: ../src/guestfs-actions.pod:4330 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " "the existing UUID of a filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4312 +#: ../src/guestfs-actions.pod:4335 msgid "guestfs_set_memsize" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4314 +#: ../src/guestfs-actions.pod:4337 #, no-wrap msgid "" " int guestfs_set_memsize (guestfs_h *g,\n" @@ -11203,26 +11298,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4317 +#: ../src/guestfs-actions.pod:4340 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before C<guestfs_launch>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4321 ../fish/guestfish-actions.pod:3351 +#: ../src/guestfs-actions.pod:4344 ../fish/guestfish-actions.pod:3368 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:4330 +#: ../src/guestfs-actions.pod:4353 msgid "guestfs_set_network" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4332 +#: ../src/guestfs-actions.pod:4355 #, no-wrap msgid "" " int guestfs_set_network (guestfs_h *g,\n" @@ -11231,33 +11326,33 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4335 ../fish/guestfish-actions.pod:3364 +#: ../src/guestfs-actions.pod:4358 ../fish/guestfish-actions.pod:3381 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:4338 ../fish/guestfish-actions.pod:3367 +#: ../src/guestfs-actions.pod:4361 ../fish/guestfish-actions.pod:3384 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4341 +#: ../src/guestfs-actions.pod:4364 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4346 +#: ../src/guestfs-actions.pod:4369 msgid "guestfs_set_path" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4348 +#: ../src/guestfs-actions.pod:4371 #, no-wrap msgid "" " int guestfs_set_path (guestfs_h *g,\n" @@ -11266,29 +11361,29 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4351 ../fish/guestfish-actions.pod:3379 +#: ../src/guestfs-actions.pod:4374 ../fish/guestfish-actions.pod:3396 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4353 ../fish/guestfish-actions.pod:3381 +#: ../src/guestfs-actions.pod:4376 ../fish/guestfish-actions.pod:3398 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4356 ../fish/guestfish-actions.pod:3384 +#: ../src/guestfs-actions.pod:4379 ../fish/guestfish-actions.pod:3401 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4360 +#: ../src/guestfs-actions.pod:4383 msgid "guestfs_set_qemu" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4362 +#: ../src/guestfs-actions.pod:4385 #, no-wrap msgid "" " int guestfs_set_qemu (guestfs_h *g,\n" @@ -11297,29 +11392,29 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4365 ../fish/guestfish-actions.pod:3392 +#: ../src/guestfs-actions.pod:4388 ../fish/guestfish-actions.pod:3409 msgid "Set the qemu binary that we will use." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4367 ../fish/guestfish-actions.pod:3394 +#: ../src/guestfs-actions.pod:4390 ../fish/guestfish-actions.pod:3411 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4370 ../fish/guestfish-actions.pod:3397 +#: ../src/guestfs-actions.pod:4393 ../fish/guestfish-actions.pod:3414 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4373 ../fish/guestfish-actions.pod:3400 +#: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:3417 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4375 ../fish/guestfish-actions.pod:3402 +#: ../src/guestfs-actions.pod:4398 ../fish/guestfish-actions.pod:3419 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 " @@ -11330,12 +11425,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4385 +#: ../src/guestfs-actions.pod:4408 msgid "guestfs_set_recovery_proc" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4387 +#: ../src/guestfs-actions.pod:4410 #, no-wrap msgid "" " int guestfs_set_recovery_proc (guestfs_h *g,\n" @@ -11344,7 +11439,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4390 +#: ../src/guestfs-actions.pod:4413 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 " @@ -11353,14 +11448,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4395 +#: ../src/guestfs-actions.pod:4418 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4398 ../fish/guestfish-actions.pod:3424 +#: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:3441 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 " @@ -11369,12 +11464,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4406 +#: ../src/guestfs-actions.pod:4429 msgid "guestfs_set_selinux" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4408 +#: ../src/guestfs-actions.pod:4431 #, no-wrap msgid "" " int guestfs_set_selinux (guestfs_h *g,\n" @@ -11383,26 +11478,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4411 ../fish/guestfish-actions.pod:3436 +#: ../src/guestfs-actions.pod:4434 ../fish/guestfish-actions.pod:3453 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:4414 ../fish/guestfish-actions.pod:3439 +#: ../src/guestfs-actions.pod:4437 ../fish/guestfish-actions.pod:3456 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4422 +#: ../src/guestfs-actions.pod:4445 msgid "guestfs_set_trace" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4424 +#: ../src/guestfs-actions.pod:4447 #, no-wrap msgid "" " int guestfs_set_trace (guestfs_h *g,\n" @@ -11411,7 +11506,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4427 ../fish/guestfish-actions.pod:3451 +#: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:3468 msgid "" "If the command trace flag is set to 1, then commands are printed on stderr " "before they are executed in a format which is very similar to the one used " @@ -11421,26 +11516,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4434 ../fish/guestfish-actions.pod:3458 +#: ../src/guestfs-actions.pod:4457 ../fish/guestfish-actions.pod:3475 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:4438 ../fish/guestfish-actions.pod:3462 +#: ../src/guestfs-actions.pod:4461 ../fish/guestfish-actions.pod:3479 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4443 +#: ../src/guestfs-actions.pod:4466 msgid "guestfs_set_verbose" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4445 +#: ../src/guestfs-actions.pod:4468 #, no-wrap msgid "" " int guestfs_set_verbose (guestfs_h *g,\n" @@ -11449,24 +11544,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4448 ../fish/guestfish-actions.pod:3471 +#: ../src/guestfs-actions.pod:4471 ../fish/guestfish-actions.pod:3488 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:3473 +#: ../src/guestfs-actions.pod:4473 ../fish/guestfish-actions.pod:3490 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4455 +#: ../src/guestfs-actions.pod:4478 msgid "guestfs_setcon" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4457 +#: ../src/guestfs-actions.pod:4480 #, no-wrap msgid "" " int guestfs_setcon (guestfs_h *g,\n" @@ -11475,24 +11570,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3480 +#: ../src/guestfs-actions.pod:4483 ../fish/guestfish-actions.pod:3497 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4463 ../fish/guestfish-actions.pod:3483 +#: ../src/guestfs-actions.pod:4486 ../fish/guestfish-actions.pod:3500 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4467 +#: ../src/guestfs-actions.pod:4490 msgid "guestfs_setxattr" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4469 +#: ../src/guestfs-actions.pod:4492 #, no-wrap msgid "" " int guestfs_setxattr (guestfs_h *g,\n" @@ -11504,24 +11599,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4475 ../fish/guestfish-actions.pod:3489 +#: ../src/guestfs-actions.pod:4498 ../fish/guestfish-actions.pod:3506 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:4479 +#: ../src/guestfs-actions.pod:4502 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4483 +#: ../src/guestfs-actions.pod:4506 msgid "guestfs_sfdisk" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4485 +#: ../src/guestfs-actions.pod:4508 #, no-wrap msgid "" " int guestfs_sfdisk (guestfs_h *g,\n" @@ -11534,19 +11629,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4492 ../fish/guestfish-actions.pod:3499 +#: ../src/guestfs-actions.pod:4515 ../fish/guestfish-actions.pod:3516 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:4495 ../fish/guestfish-actions.pod:3502 +#: ../src/guestfs-actions.pod:4518 ../fish/guestfish-actions.pod:3519 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4497 ../fish/guestfish-actions.pod:3504 +#: ../src/guestfs-actions.pod:4520 ../fish/guestfish-actions.pod:3521 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>, " @@ -11557,14 +11652,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4505 ../fish/guestfish-actions.pod:3512 +#: ../src/guestfs-actions.pod:4528 ../fish/guestfish-actions.pod:3529 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:4508 ../fish/guestfish-actions.pod:3515 +#: ../src/guestfs-actions.pod:4531 ../fish/guestfish-actions.pod:3532 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 " @@ -11572,17 +11667,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4512 +#: ../src/guestfs-actions.pod:4535 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4520 +#: ../src/guestfs-actions.pod:4543 msgid "guestfs_sfdiskM" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4522 +#: ../src/guestfs-actions.pod:4545 #, no-wrap msgid "" " int guestfs_sfdiskM (guestfs_h *g,\n" @@ -11592,7 +11687,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4526 +#: ../src/guestfs-actions.pod:4549 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -11601,19 +11696,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4532 +#: ../src/guestfs-actions.pod:4555 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4540 +#: ../src/guestfs-actions.pod:4563 msgid "guestfs_sfdisk_N" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4542 +#: ../src/guestfs-actions.pod:4565 #, no-wrap msgid "" " int guestfs_sfdisk_N (guestfs_h *g,\n" @@ -11627,31 +11722,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4550 ../fish/guestfish-actions.pod:3545 +#: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3562 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:4553 +#: ../src/guestfs-actions.pod:4576 msgid "" "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4556 +#: ../src/guestfs-actions.pod:4579 msgid "See also: C<guestfs_part_add>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4563 +#: ../src/guestfs-actions.pod:4586 msgid "guestfs_sfdisk_disk_geometry" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4565 +#: ../src/guestfs-actions.pod:4588 #, no-wrap msgid "" " char *guestfs_sfdisk_disk_geometry (guestfs_h *g,\n" @@ -11660,7 +11755,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4568 +#: ../src/guestfs-actions.pod:4591 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, " @@ -11669,17 +11764,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4573 ../src/guestfs-actions.pod:4586 ../fish/guestfish-actions.pod:3565 ../fish/guestfish-actions.pod:3574 +#: ../src/guestfs-actions.pod:4596 ../src/guestfs-actions.pod:4609 ../fish/guestfish-actions.pod:3582 ../fish/guestfish-actions.pod:3591 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4579 +#: ../src/guestfs-actions.pod:4602 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4581 +#: ../src/guestfs-actions.pod:4604 #, no-wrap msgid "" " char *guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n" @@ -11688,17 +11783,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4584 ../fish/guestfish-actions.pod:3572 +#: ../src/guestfs-actions.pod:4607 ../fish/guestfish-actions.pod:3589 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4592 +#: ../src/guestfs-actions.pod:4615 msgid "guestfs_sfdisk_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4594 +#: ../src/guestfs-actions.pod:4617 #, no-wrap msgid "" " char *guestfs_sfdisk_l (guestfs_h *g,\n" @@ -11707,24 +11802,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3581 +#: ../src/guestfs-actions.pod:4620 ../fish/guestfish-actions.pod:3598 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:4601 +#: ../src/guestfs-actions.pod:4624 msgid "See also: C<guestfs_part_list>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4606 +#: ../src/guestfs-actions.pod:4629 msgid "guestfs_sh" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4608 +#: ../src/guestfs-actions.pod:4631 #, no-wrap msgid "" " char *guestfs_sh (guestfs_h *g,\n" @@ -11733,19 +11828,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4611 ../fish/guestfish-actions.pod:3591 +#: ../src/guestfs-actions.pod:4634 ../fish/guestfish-actions.pod:3608 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4614 +#: ../src/guestfs-actions.pod:4637 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4616 ../fish/guestfish-actions.pod:3596 +#: ../src/guestfs-actions.pod:4639 ../fish/guestfish-actions.pod:3613 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -11753,24 +11848,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4618 ../fish/guestfish-actions.pod:3598 +#: ../src/guestfs-actions.pod:4641 ../fish/guestfish-actions.pod:3615 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:4622 +#: ../src/guestfs-actions.pod:4645 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4627 +#: ../src/guestfs-actions.pod:4650 msgid "guestfs_sh_lines" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4629 +#: ../src/guestfs-actions.pod:4652 #, no-wrap msgid "" " char **guestfs_sh_lines (guestfs_h *g,\n" @@ -11779,24 +11874,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4632 +#: ../src/guestfs-actions.pod:4655 msgid "" "This is the same as C<guestfs_sh>, but splits the result into a list of " "lines." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4635 +#: ../src/guestfs-actions.pod:4658 msgid "See also: C<guestfs_command_lines>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4641 +#: ../src/guestfs-actions.pod:4664 msgid "guestfs_sleep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4643 +#: ../src/guestfs-actions.pod:4666 #, no-wrap msgid "" " int guestfs_sleep (guestfs_h *g,\n" @@ -11805,17 +11900,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4646 ../fish/guestfish-actions.pod:3617 +#: ../src/guestfs-actions.pod:4669 ../fish/guestfish-actions.pod:3634 msgid "Sleep for C<secs> seconds." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4650 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:4673 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4652 +#: ../src/guestfs-actions.pod:4675 #, no-wrap msgid "" " struct guestfs_stat *guestfs_stat (guestfs_h *g,\n" @@ -11824,17 +11919,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4657 ../fish/guestfish-actions.pod:3625 +#: ../src/guestfs-actions.pod:4680 ../fish/guestfish-actions.pod:3642 msgid "This is the same as the C<stat(2)> system call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4663 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:4686 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4665 +#: ../src/guestfs-actions.pod:4688 #, no-wrap msgid "" " struct guestfs_statvfs *guestfs_statvfs (guestfs_h *g,\n" @@ -11843,7 +11938,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4668 ../fish/guestfish-actions.pod:3631 +#: ../src/guestfs-actions.pod:4691 ../fish/guestfish-actions.pod:3648 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 " @@ -11851,24 +11946,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4672 ../fish/guestfish-actions.pod:3635 +#: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3652 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4674 +#: ../src/guestfs-actions.pod:4697 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:4678 +#: ../src/guestfs-actions.pod:4701 msgid "guestfs_strings" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4680 +#: ../src/guestfs-actions.pod:4703 #, no-wrap msgid "" " char **guestfs_strings (guestfs_h *g,\n" @@ -11877,19 +11972,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4683 ../fish/guestfish-actions.pod:3641 +#: ../src/guestfs-actions.pod:4706 ../fish/guestfish-actions.pod:3658 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:4693 +#: ../src/guestfs-actions.pod:4716 msgid "guestfs_strings_e" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4695 +#: ../src/guestfs-actions.pod:4718 #, no-wrap msgid "" " char **guestfs_strings_e (guestfs_h *g,\n" @@ -11899,93 +11994,93 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4699 +#: ../src/guestfs-actions.pod:4722 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>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4703 ../fish/guestfish-actions.pod:3655 +#: ../src/guestfs-actions.pod:4726 ../fish/guestfish-actions.pod:3672 msgid "Allowed encodings are:" msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4707 ../fish/guestfish-actions.pod:3659 +#: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3676 msgid "s" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4709 +#: ../src/guestfs-actions.pod:4732 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4712 ../fish/guestfish-actions.pod:3664 +#: ../src/guestfs-actions.pod:4735 ../fish/guestfish-actions.pod:3681 msgid "S" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4714 ../fish/guestfish-actions.pod:3666 +#: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3683 msgid "Single 8-bit-byte characters." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4716 ../fish/guestfish-actions.pod:3668 +#: ../src/guestfs-actions.pod:4739 ../fish/guestfish-actions.pod:3685 msgid "b" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4718 ../fish/guestfish-actions.pod:3670 +#: ../src/guestfs-actions.pod:4741 ../fish/guestfish-actions.pod:3687 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4721 ../fish/guestfish-actions.pod:3673 +#: ../src/guestfs-actions.pod:4744 ../fish/guestfish-actions.pod:3690 msgid "l (lower case letter L)" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4723 ../fish/guestfish-actions.pod:3675 +#: ../src/guestfs-actions.pod:4746 ../fish/guestfish-actions.pod:3692 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:4726 ../fish/guestfish-actions.pod:3678 +#: ../src/guestfs-actions.pod:4749 ../fish/guestfish-actions.pod:3695 msgid "B" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4728 ../fish/guestfish-actions.pod:3680 +#: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3697 msgid "32-bit big endian such as UCS-4BE." msgstr "" # type: =item -#: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3682 +#: ../src/guestfs-actions.pod:4753 ../fish/guestfish-actions.pod:3699 msgid "L" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4732 ../fish/guestfish-actions.pod:3684 +#: ../src/guestfs-actions.pod:4755 ../fish/guestfish-actions.pod:3701 msgid "32-bit little endian such as UCS-4LE." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4736 ../fish/guestfish-actions.pod:3688 +#: ../src/guestfs-actions.pod:4759 ../fish/guestfish-actions.pod:3705 msgid "The returned strings are transcoded to UTF-8." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4745 +#: ../src/guestfs-actions.pod:4768 msgid "guestfs_swapoff_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4747 +#: ../src/guestfs-actions.pod:4770 #, no-wrap msgid "" " int guestfs_swapoff_device (guestfs_h *g,\n" @@ -11994,19 +12089,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4750 +#: ../src/guestfs-actions.pod:4773 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See C<guestfs_swapon_device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4756 +#: ../src/guestfs-actions.pod:4779 msgid "guestfs_swapoff_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4758 +#: ../src/guestfs-actions.pod:4781 #, no-wrap msgid "" " int guestfs_swapoff_file (guestfs_h *g,\n" @@ -12015,17 +12110,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4761 ../fish/guestfish-actions.pod:3705 +#: ../src/guestfs-actions.pod:4784 ../fish/guestfish-actions.pod:3722 msgid "This command disables the libguestfs appliance swap on file." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4765 +#: ../src/guestfs-actions.pod:4788 msgid "guestfs_swapoff_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4767 +#: ../src/guestfs-actions.pod:4790 #, no-wrap msgid "" " int guestfs_swapoff_label (guestfs_h *g,\n" @@ -12034,19 +12129,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4770 ../fish/guestfish-actions.pod:3711 +#: ../src/guestfs-actions.pod:4793 ../fish/guestfish-actions.pod:3728 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4775 +#: ../src/guestfs-actions.pod:4798 msgid "guestfs_swapoff_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4777 +#: ../src/guestfs-actions.pod:4800 #, no-wrap msgid "" " int guestfs_swapoff_uuid (guestfs_h *g,\n" @@ -12055,19 +12150,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4780 ../fish/guestfish-actions.pod:3718 +#: ../src/guestfs-actions.pod:4803 ../fish/guestfish-actions.pod:3735 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4785 +#: ../src/guestfs-actions.pod:4808 msgid "guestfs_swapon_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4787 +#: ../src/guestfs-actions.pod:4810 #, no-wrap msgid "" " int guestfs_swapon_device (guestfs_h *g,\n" @@ -12076,7 +12171,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4790 +#: ../src/guestfs-actions.pod:4813 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 " @@ -12084,7 +12179,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4795 ../fish/guestfish-actions.pod:3730 +#: ../src/guestfs-actions.pod:4818 ../fish/guestfish-actions.pod:3747 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 " @@ -12094,12 +12189,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4804 +#: ../src/guestfs-actions.pod:4827 msgid "guestfs_swapon_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4806 +#: ../src/guestfs-actions.pod:4829 #, no-wrap msgid "" " int guestfs_swapon_file (guestfs_h *g,\n" @@ -12108,19 +12203,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4809 +#: ../src/guestfs-actions.pod:4832 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4814 +#: ../src/guestfs-actions.pod:4837 msgid "guestfs_swapon_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4816 +#: ../src/guestfs-actions.pod:4839 #, no-wrap msgid "" " int guestfs_swapon_label (guestfs_h *g,\n" @@ -12129,19 +12224,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4819 +#: ../src/guestfs-actions.pod:4842 msgid "" "This command enables swap to a labeled swap partition. See " "C<guestfs_swapon_device> for other notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4824 +#: ../src/guestfs-actions.pod:4847 msgid "guestfs_swapon_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4826 +#: ../src/guestfs-actions.pod:4849 #, no-wrap msgid "" " int guestfs_swapon_uuid (guestfs_h *g,\n" @@ -12150,19 +12245,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4829 +#: ../src/guestfs-actions.pod:4852 msgid "" "This command enables swap to a swap partition with the given UUID. See " "C<guestfs_swapon_device> for other notes." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4834 +#: ../src/guestfs-actions.pod:4857 msgid "guestfs_sync" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4836 +#: ../src/guestfs-actions.pod:4859 #, no-wrap msgid "" " int guestfs_sync (guestfs_h *g);\n" @@ -12170,26 +12265,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4838 ../fish/guestfish-actions.pod:3762 +#: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3779 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4841 ../fish/guestfish-actions.pod:3765 +#: ../src/guestfs-actions.pod:4864 ../fish/guestfish-actions.pod:3782 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4846 +#: ../src/guestfs-actions.pod:4869 msgid "guestfs_tail" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4848 +#: ../src/guestfs-actions.pod:4871 #, no-wrap msgid "" " char **guestfs_tail (guestfs_h *g,\n" @@ -12198,17 +12293,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4851 ../fish/guestfish-actions.pod:3772 +#: ../src/guestfs-actions.pod:4874 ../fish/guestfish-actions.pod:3789 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:4861 +#: ../src/guestfs-actions.pod:4884 msgid "guestfs_tail_n" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4863 +#: ../src/guestfs-actions.pod:4886 #, no-wrap msgid "" " char **guestfs_tail_n (guestfs_h *g,\n" @@ -12218,26 +12313,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4867 ../fish/guestfish-actions.pod:3782 +#: ../src/guestfs-actions.pod:4890 ../fish/guestfish-actions.pod:3799 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:4870 ../fish/guestfish-actions.pod:3785 +#: ../src/guestfs-actions.pod:4893 ../fish/guestfish-actions.pod:3802 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:4882 +#: ../src/guestfs-actions.pod:4905 msgid "guestfs_tar_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4884 +#: ../src/guestfs-actions.pod:4907 #, no-wrap msgid "" " int guestfs_tar_in (guestfs_h *g,\n" @@ -12247,24 +12342,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3797 +#: ../src/guestfs-actions.pod:4911 ../fish/guestfish-actions.pod:3814 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:4891 +#: ../src/guestfs-actions.pod:4914 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4896 +#: ../src/guestfs-actions.pod:4919 msgid "guestfs_tar_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4898 +#: ../src/guestfs-actions.pod:4921 #, no-wrap msgid "" " int guestfs_tar_out (guestfs_h *g,\n" @@ -12274,26 +12369,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4902 ../fish/guestfish-actions.pod:3809 +#: ../src/guestfs-actions.pod:4925 ../fish/guestfish-actions.pod:3826 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4905 +#: ../src/guestfs-actions.pod:4928 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4910 +#: ../src/guestfs-actions.pod:4933 msgid "guestfs_tgz_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4912 +#: ../src/guestfs-actions.pod:4935 #, no-wrap msgid "" " int guestfs_tgz_in (guestfs_h *g,\n" @@ -12303,24 +12398,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4916 ../fish/guestfish-actions.pod:3821 +#: ../src/guestfs-actions.pod:4939 ../fish/guestfish-actions.pod:3838 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:4919 +#: ../src/guestfs-actions.pod:4942 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4923 +#: ../src/guestfs-actions.pod:4946 msgid "guestfs_tgz_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4925 +#: ../src/guestfs-actions.pod:4948 #, no-wrap msgid "" " int guestfs_tgz_out (guestfs_h *g,\n" @@ -12330,24 +12425,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4929 ../fish/guestfish-actions.pod:3832 +#: ../src/guestfs-actions.pod:4952 ../fish/guestfish-actions.pod:3849 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4932 +#: ../src/guestfs-actions.pod:4955 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4936 +#: ../src/guestfs-actions.pod:4959 msgid "guestfs_touch" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4938 +#: ../src/guestfs-actions.pod:4961 #, no-wrap msgid "" " int guestfs_touch (guestfs_h *g,\n" @@ -12356,7 +12451,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4941 ../fish/guestfish-actions.pod:3843 +#: ../src/guestfs-actions.pod:4964 ../fish/guestfish-actions.pod:3860 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 " @@ -12364,19 +12459,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4945 ../fish/guestfish-actions.pod:3847 +#: ../src/guestfs-actions.pod:4968 ../fish/guestfish-actions.pod:3864 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:4950 +#: ../src/guestfs-actions.pod:4973 msgid "guestfs_truncate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4952 +#: ../src/guestfs-actions.pod:4975 #, no-wrap msgid "" " int guestfs_truncate (guestfs_h *g,\n" @@ -12385,19 +12480,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4955 ../fish/guestfish-actions.pod:3854 +#: ../src/guestfs-actions.pod:4978 ../fish/guestfish-actions.pod:3871 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4960 +#: ../src/guestfs-actions.pod:4983 msgid "guestfs_truncate_size" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4962 +#: ../src/guestfs-actions.pod:4985 #, no-wrap msgid "" " int guestfs_truncate_size (guestfs_h *g,\n" @@ -12407,14 +12502,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4966 ../fish/guestfish-actions.pod:3861 +#: ../src/guestfs-actions.pod:4989 ../fish/guestfish-actions.pod:3878 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4969 +#: ../src/guestfs-actions.pod:4992 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 " @@ -12423,12 +12518,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4977 +#: ../src/guestfs-actions.pod:5000 msgid "guestfs_tune2fs_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4979 +#: ../src/guestfs-actions.pod:5002 #, no-wrap msgid "" " char **guestfs_tune2fs_l (guestfs_h *g,\n" @@ -12437,14 +12532,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4982 ../fish/guestfish-actions.pod:3874 +#: ../src/guestfs-actions.pod:5005 ../fish/guestfish-actions.pod:3891 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:4985 ../fish/guestfish-actions.pod:3877 +#: ../src/guestfs-actions.pod:5008 ../fish/guestfish-actions.pod:3894 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 " @@ -12453,12 +12548,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:4996 +#: ../src/guestfs-actions.pod:5019 msgid "guestfs_txz_in" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:4998 +#: ../src/guestfs-actions.pod:5021 #, no-wrap msgid "" " int guestfs_txz_in (guestfs_h *g,\n" @@ -12468,19 +12563,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5002 ../fish/guestfish-actions.pod:3886 +#: ../src/guestfs-actions.pod:5025 ../fish/guestfish-actions.pod:3903 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:5007 +#: ../src/guestfs-actions.pod:5030 msgid "guestfs_txz_out" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5009 +#: ../src/guestfs-actions.pod:5032 #, no-wrap msgid "" " int guestfs_txz_out (guestfs_h *g,\n" @@ -12490,19 +12585,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5013 ../fish/guestfish-actions.pod:3895 +#: ../src/guestfs-actions.pod:5036 ../fish/guestfish-actions.pod:3912 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:5018 +#: ../src/guestfs-actions.pod:5041 msgid "guestfs_umask" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5020 +#: ../src/guestfs-actions.pod:5043 #, no-wrap msgid "" " int guestfs_umask (guestfs_h *g,\n" @@ -12511,14 +12606,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5023 ../fish/guestfish-actions.pod:3904 +#: ../src/guestfs-actions.pod:5046 ../fish/guestfish-actions.pod:3921 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:5026 ../fish/guestfish-actions.pod:3907 +#: ../src/guestfs-actions.pod:5049 ../fish/guestfish-actions.pod:3924 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 " @@ -12526,7 +12621,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5031 ../fish/guestfish-actions.pod:3912 +#: ../src/guestfs-actions.pod:5054 ../fish/guestfish-actions.pod:3929 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 " @@ -12534,24 +12629,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5035 +#: ../src/guestfs-actions.pod:5058 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5038 ../fish/guestfish-actions.pod:3919 +#: ../src/guestfs-actions.pod:5061 ../fish/guestfish-actions.pod:3936 msgid "This call returns the previous umask." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5042 +#: ../src/guestfs-actions.pod:5065 msgid "guestfs_umount" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5044 +#: ../src/guestfs-actions.pod:5067 #, no-wrap msgid "" " int guestfs_umount (guestfs_h *g,\n" @@ -12560,19 +12655,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5047 ../fish/guestfish-actions.pod:3927 +#: ../src/guestfs-actions.pod:5070 ../fish/guestfish-actions.pod:3944 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:5053 +#: ../src/guestfs-actions.pod:5076 msgid "guestfs_umount_all" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5055 +#: ../src/guestfs-actions.pod:5078 #, no-wrap msgid "" " int guestfs_umount_all (guestfs_h *g);\n" @@ -12580,22 +12675,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5057 ../fish/guestfish-actions.pod:3937 +#: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3954 msgid "This unmounts all mounted filesystems." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5059 ../fish/guestfish-actions.pod:3939 +#: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3956 msgid "Some internal mounts are not unmounted by this call." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5063 +#: ../src/guestfs-actions.pod:5086 msgid "guestfs_upload" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5065 +#: ../src/guestfs-actions.pod:5088 #, no-wrap msgid "" " int guestfs_upload (guestfs_h *g,\n" @@ -12605,22 +12700,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5069 ../src/guestfs-actions.pod:5085 ../fish/guestfish-actions.pod:3945 ../fish/guestfish-actions.pod:3958 +#: ../src/guestfs-actions.pod:5092 ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3962 ../fish/guestfish-actions.pod:3975 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5074 +#: ../src/guestfs-actions.pod:5097 msgid "See also C<guestfs_download>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5078 +#: ../src/guestfs-actions.pod:5101 msgid "guestfs_upload_offset" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5080 +#: ../src/guestfs-actions.pod:5103 #, no-wrap msgid "" " int guestfs_upload_offset (guestfs_h *g,\n" @@ -12631,7 +12726,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3961 +#: ../src/guestfs-actions.pod:5111 ../fish/guestfish-actions.pod:3978 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -12641,7 +12736,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5095 +#: ../src/guestfs-actions.pod:5118 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 " @@ -12649,17 +12744,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5100 +#: ../src/guestfs-actions.pod:5123 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5104 +#: ../src/guestfs-actions.pod:5127 msgid "guestfs_utimens" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5106 +#: ../src/guestfs-actions.pod:5129 #, no-wrap msgid "" " int guestfs_utimens (guestfs_h *g,\n" @@ -12672,26 +12767,26 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5113 ../fish/guestfish-actions.pod:3981 +#: ../src/guestfs-actions.pod:5136 ../fish/guestfish-actions.pod:3998 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5116 ../fish/guestfish-actions.pod:3984 +#: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:4001 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5119 ../fish/guestfish-actions.pod:3987 +#: ../src/guestfs-actions.pod:5142 ../fish/guestfish-actions.pod:4004 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3990 +#: ../src/guestfs-actions.pod:5145 ../fish/guestfish-actions.pod:4007 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 " @@ -12699,7 +12794,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5126 ../fish/guestfish-actions.pod:3994 +#: ../src/guestfs-actions.pod:5149 ../fish/guestfish-actions.pod:4011 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 " @@ -12707,12 +12802,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5132 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:5155 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5134 +#: ../src/guestfs-actions.pod:5157 #, no-wrap msgid "" " struct guestfs_version *guestfs_version (guestfs_h *g);\n" @@ -12720,12 +12815,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5136 ../fish/guestfish-actions.pod:4002 +#: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:4019 msgid "Return the libguestfs version number that the program is linked against." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:4005 +#: ../src/guestfs-actions.pod:5162 ../fish/guestfish-actions.pod:4022 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 " @@ -12734,7 +12829,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:4010 +#: ../src/guestfs-actions.pod:5167 ../fish/guestfish-actions.pod:4027 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 " @@ -12743,7 +12838,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5150 ../fish/guestfish-actions.pod:4016 +#: ../src/guestfs-actions.pod:5173 ../fish/guestfish-actions.pod:4033 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 " @@ -12752,17 +12847,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5156 ../fish/guestfish-actions.pod:4022 +#: ../src/guestfs-actions.pod:5179 ../fish/guestfish-actions.pod:4039 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:4025 +#: ../src/guestfs-actions.pod:5182 ../fish/guestfish-actions.pod:4042 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5161 +#: ../src/guestfs-actions.pod:5184 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -12771,19 +12866,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5167 +#: ../src/guestfs-actions.pod:5190 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: =head2 -#: ../src/guestfs-actions.pod:5171 +#: ../src/guestfs-actions.pod:5194 msgid "guestfs_vfs_label" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5173 +#: ../src/guestfs-actions.pod:5196 #, no-wrap msgid "" " char *guestfs_vfs_label (guestfs_h *g,\n" @@ -12792,27 +12887,27 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5176 ../fish/guestfish-actions.pod:4037 +#: ../src/guestfs-actions.pod:5199 ../fish/guestfish-actions.pod:4054 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5179 ../fish/guestfish-actions.pod:4040 +#: ../src/guestfs-actions.pod:5202 ../fish/guestfish-actions.pod:4057 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5181 +#: ../src/guestfs-actions.pod:5204 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5186 +#: ../src/guestfs-actions.pod:5209 msgid "guestfs_vfs_type" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5188 +#: ../src/guestfs-actions.pod:5211 #, no-wrap msgid "" " char *guestfs_vfs_type (guestfs_h *g,\n" @@ -12821,14 +12916,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5191 ../fish/guestfish-actions.pod:4048 +#: ../src/guestfs-actions.pod:5214 ../fish/guestfish-actions.pod:4065 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5194 ../fish/guestfish-actions.pod:4051 +#: ../src/guestfs-actions.pod:5217 ../fish/guestfish-actions.pod:4068 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 " @@ -12836,12 +12931,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5202 +#: ../src/guestfs-actions.pod:5225 msgid "guestfs_vfs_uuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5204 +#: ../src/guestfs-actions.pod:5227 #, no-wrap msgid "" " char *guestfs_vfs_uuid (guestfs_h *g,\n" @@ -12850,27 +12945,27 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5207 ../fish/guestfish-actions.pod:4060 +#: ../src/guestfs-actions.pod:5230 ../fish/guestfish-actions.pod:4077 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5210 ../fish/guestfish-actions.pod:4063 +#: ../src/guestfs-actions.pod:5233 ../fish/guestfish-actions.pod:4080 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5212 +#: ../src/guestfs-actions.pod:5235 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5217 +#: ../src/guestfs-actions.pod:5240 msgid "guestfs_vg_activate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5219 +#: ../src/guestfs-actions.pod:5242 #, no-wrap msgid "" " int guestfs_vg_activate (guestfs_h *g,\n" @@ -12880,7 +12975,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5223 ../fish/guestfish-actions.pod:4071 +#: ../src/guestfs-actions.pod:5246 ../fish/guestfish-actions.pod:4088 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>. If activated, then they " @@ -12889,24 +12984,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5229 ../fish/guestfish-actions.pod:4077 +#: ../src/guestfs-actions.pod:5252 ../fish/guestfish-actions.pod:4094 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5231 ../fish/guestfish-actions.pod:4079 +#: ../src/guestfs-actions.pod:5254 ../fish/guestfish-actions.pod:4096 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:5236 +#: ../src/guestfs-actions.pod:5259 msgid "guestfs_vg_activate_all" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5238 +#: ../src/guestfs-actions.pod:5261 #, no-wrap msgid "" " int guestfs_vg_activate_all (guestfs_h *g,\n" @@ -12915,7 +13010,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5241 ../fish/guestfish-actions.pod:4086 +#: ../src/guestfs-actions.pod:5264 ../fish/guestfish-actions.pod:4103 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups. If activated, then they are made known to the " @@ -12924,17 +13019,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5247 ../fish/guestfish-actions.pod:4092 +#: ../src/guestfs-actions.pod:5270 ../fish/guestfish-actions.pod:4109 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5251 +#: ../src/guestfs-actions.pod:5274 msgid "guestfs_vgcreate" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5253 +#: ../src/guestfs-actions.pod:5276 #, no-wrap msgid "" " int guestfs_vgcreate (guestfs_h *g,\n" @@ -12944,19 +13039,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5257 ../fish/guestfish-actions.pod:4098 +#: ../src/guestfs-actions.pod:5280 ../fish/guestfish-actions.pod:4115 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:5262 +#: ../src/guestfs-actions.pod:5285 msgid "guestfs_vglvuuids" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5287 #, no-wrap msgid "" " char **guestfs_vglvuuids (guestfs_h *g,\n" @@ -12965,31 +13060,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5267 ../fish/guestfish-actions.pod:4105 +#: ../src/guestfs-actions.pod:5290 ../fish/guestfish-actions.pod:4122 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:5270 +#: ../src/guestfs-actions.pod:5293 msgid "" "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " "associate logical volumes and volume groups." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5273 +#: ../src/guestfs-actions.pod:5296 msgid "See also C<guestfs_vgpvuuids>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5279 +#: ../src/guestfs-actions.pod:5302 msgid "guestfs_vgpvuuids" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5281 +#: ../src/guestfs-actions.pod:5304 #, no-wrap msgid "" " char **guestfs_vgpvuuids (guestfs_h *g,\n" @@ -12998,31 +13093,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5284 ../fish/guestfish-actions.pod:4117 +#: ../src/guestfs-actions.pod:5307 ../fish/guestfish-actions.pod:4134 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:5287 +#: ../src/guestfs-actions.pod:5310 msgid "" "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " "associate physical volumes and volume groups." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5290 +#: ../src/guestfs-actions.pod:5313 msgid "See also C<guestfs_vglvuuids>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5296 +#: ../src/guestfs-actions.pod:5319 msgid "guestfs_vgremove" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5298 +#: ../src/guestfs-actions.pod:5321 #, no-wrap msgid "" " int guestfs_vgremove (guestfs_h *g,\n" @@ -13031,22 +13126,22 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5301 ../fish/guestfish-actions.pod:4129 +#: ../src/guestfs-actions.pod:5324 ../fish/guestfish-actions.pod:4146 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5303 ../fish/guestfish-actions.pod:4131 +#: ../src/guestfs-actions.pod:5326 ../fish/guestfish-actions.pod:4148 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5308 +#: ../src/guestfs-actions.pod:5331 msgid "guestfs_vgrename" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5310 +#: ../src/guestfs-actions.pod:5333 #, no-wrap msgid "" " int guestfs_vgrename (guestfs_h *g,\n" @@ -13056,17 +13151,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5314 ../fish/guestfish-actions.pod:4138 +#: ../src/guestfs-actions.pod:5337 ../fish/guestfish-actions.pod:4155 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5318 +#: ../src/guestfs-actions.pod:5341 msgid "guestfs_vgs" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5320 +#: ../src/guestfs-actions.pod:5343 #, no-wrap msgid "" " char **guestfs_vgs (guestfs_h *g);\n" @@ -13074,31 +13169,31 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5322 ../fish/guestfish-actions.pod:4144 +#: ../src/guestfs-actions.pod:5345 ../fish/guestfish-actions.pod:4161 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5325 ../fish/guestfish-actions.pod:4147 +#: ../src/guestfs-actions.pod:5348 ../fish/guestfish-actions.pod:4164 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5328 +#: ../src/guestfs-actions.pod:5351 msgid "See also C<guestfs_vgs_full>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5334 +#: ../src/guestfs-actions.pod:5357 msgid "guestfs_vgs_full" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5336 +#: ../src/guestfs-actions.pod:5359 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *guestfs_vgs_full (guestfs_h *g);\n" @@ -13106,14 +13201,14 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5338 ../fish/guestfish-actions.pod:4156 +#: ../src/guestfs-actions.pod:5361 ../fish/guestfish-actions.pod:4173 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:5341 +#: ../src/guestfs-actions.pod:5364 msgid "" "This function returns a C<struct guestfs_lvm_vg_list *> (see " "E<lt>guestfs-structs.hE<gt>), or NULL if there was an error. I<The caller " @@ -13121,12 +13216,12 @@ msgid "" msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5346 +#: ../src/guestfs-actions.pod:5369 msgid "guestfs_vgscan" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5348 +#: ../src/guestfs-actions.pod:5371 #, no-wrap msgid "" " int guestfs_vgscan (guestfs_h *g);\n" @@ -13134,19 +13229,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5350 ../fish/guestfish-actions.pod:4163 +#: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:4180 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:5355 +#: ../src/guestfs-actions.pod:5378 msgid "guestfs_vguuid" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5357 +#: ../src/guestfs-actions.pod:5380 #, no-wrap msgid "" " char *guestfs_vguuid (guestfs_h *g,\n" @@ -13155,17 +13250,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:4170 +#: ../src/guestfs-actions.pod:5383 ../fish/guestfish-actions.pod:4187 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5365 +#: ../src/guestfs-actions.pod:5388 msgid "guestfs_wait_ready" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5367 +#: ../src/guestfs-actions.pod:5390 #, no-wrap msgid "" " int guestfs_wait_ready (guestfs_h *g);\n" @@ -13173,12 +13268,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5369 +#: ../src/guestfs-actions.pod:5392 msgid "This function is a no op." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5371 +#: ../src/guestfs-actions.pod:5394 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 " @@ -13186,19 +13281,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5376 +#: ../src/guestfs-actions.pod:5399 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: =head2 -#: ../src/guestfs-actions.pod:5382 +#: ../src/guestfs-actions.pod:5405 msgid "guestfs_wc_c" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5384 +#: ../src/guestfs-actions.pod:5407 #, no-wrap msgid "" " int guestfs_wc_c (guestfs_h *g,\n" @@ -13207,19 +13302,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5387 ../fish/guestfish-actions.pod:4176 +#: ../src/guestfs-actions.pod:5410 ../fish/guestfish-actions.pod:4193 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5392 +#: ../src/guestfs-actions.pod:5415 msgid "guestfs_wc_l" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5394 +#: ../src/guestfs-actions.pod:5417 #, no-wrap msgid "" " int guestfs_wc_l (guestfs_h *g,\n" @@ -13228,19 +13323,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5397 ../fish/guestfish-actions.pod:4183 +#: ../src/guestfs-actions.pod:5420 ../fish/guestfish-actions.pod:4200 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5402 +#: ../src/guestfs-actions.pod:5425 msgid "guestfs_wc_w" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5404 +#: ../src/guestfs-actions.pod:5427 #, no-wrap msgid "" " int guestfs_wc_w (guestfs_h *g,\n" @@ -13249,19 +13344,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5407 ../fish/guestfish-actions.pod:4190 +#: ../src/guestfs-actions.pod:5430 ../fish/guestfish-actions.pod:4207 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5412 +#: ../src/guestfs-actions.pod:5435 msgid "guestfs_write" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5414 +#: ../src/guestfs-actions.pod:5437 #, no-wrap msgid "" " int guestfs_write (guestfs_h *g,\n" @@ -13272,19 +13367,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5419 ../fish/guestfish-actions.pod:4197 +#: ../src/guestfs-actions.pod:5442 ../fish/guestfish-actions.pod:4214 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: =head2 -#: ../src/guestfs-actions.pod:5427 +#: ../src/guestfs-actions.pod:5450 msgid "guestfs_write_file" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5429 +#: ../src/guestfs-actions.pod:5452 #, no-wrap msgid "" " int guestfs_write_file (guestfs_h *g,\n" @@ -13295,38 +13390,38 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5434 ../fish/guestfish-actions.pod:4207 +#: ../src/guestfs-actions.pod:5457 ../fish/guestfish-actions.pod:4224 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:5438 ../fish/guestfish-actions.pod:4211 +#: ../src/guestfs-actions.pod:5461 ../fish/guestfish-actions.pod:4228 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:5442 ../fish/guestfish-actions.pod:4215 +#: ../src/guestfs-actions.pod:5465 ../fish/guestfish-actions.pod:4232 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:5450 ../fish/guestfish-actions.pod:4221 +#: ../src/guestfs-actions.pod:5473 ../fish/guestfish-actions.pod:4238 msgid "This function is deprecated. In new code, use the C<write> call instead." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5457 +#: ../src/guestfs-actions.pod:5480 msgid "guestfs_zegrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5459 +#: ../src/guestfs-actions.pod:5482 #, no-wrap msgid "" " char **guestfs_zegrep (guestfs_h *g,\n" @@ -13336,17 +13431,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5463 ../fish/guestfish-actions.pod:4232 +#: ../src/guestfs-actions.pod:5486 ../fish/guestfish-actions.pod:4249 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5473 +#: ../src/guestfs-actions.pod:5496 msgid "guestfs_zegrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5475 +#: ../src/guestfs-actions.pod:5498 #, no-wrap msgid "" " char **guestfs_zegrepi (guestfs_h *g,\n" @@ -13356,17 +13451,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5479 ../fish/guestfish-actions.pod:4242 +#: ../src/guestfs-actions.pod:5502 ../fish/guestfish-actions.pod:4259 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5489 +#: ../src/guestfs-actions.pod:5512 msgid "guestfs_zero" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5491 +#: ../src/guestfs-actions.pod:5514 #, no-wrap msgid "" " int guestfs_zero (guestfs_h *g,\n" @@ -13375,12 +13470,12 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5494 ../fish/guestfish-actions.pod:4252 +#: ../src/guestfs-actions.pod:5517 ../fish/guestfish-actions.pod:4269 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5496 ../fish/guestfish-actions.pod:4254 +#: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:4271 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 " @@ -13388,17 +13483,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5500 +#: ../src/guestfs-actions.pod:5523 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5509 +#: ../src/guestfs-actions.pod:5532 msgid "guestfs_zero_device" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5511 +#: ../src/guestfs-actions.pod:5534 #, no-wrap msgid "" " int guestfs_zero_device (guestfs_h *g,\n" @@ -13407,19 +13502,19 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5514 +#: ../src/guestfs-actions.pod:5537 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: =head2 -#: ../src/guestfs-actions.pod:5528 +#: ../src/guestfs-actions.pod:5551 msgid "guestfs_zerofree" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5530 +#: ../src/guestfs-actions.pod:5553 #, no-wrap msgid "" " int guestfs_zerofree (guestfs_h *g,\n" @@ -13428,7 +13523,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5533 ../fish/guestfish-actions.pod:4275 +#: ../src/guestfs-actions.pod:5556 ../fish/guestfish-actions.pod:4292 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 " @@ -13436,24 +13531,24 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5538 ../fish/guestfish-actions.pod:4280 +#: ../src/guestfs-actions.pod:5561 ../fish/guestfish-actions.pod:4297 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5541 ../fish/guestfish-actions.pod:4283 +#: ../src/guestfs-actions.pod:5564 ../fish/guestfish-actions.pod:4300 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5546 +#: ../src/guestfs-actions.pod:5569 msgid "guestfs_zfgrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5548 +#: ../src/guestfs-actions.pod:5571 #, no-wrap msgid "" " char **guestfs_zfgrep (guestfs_h *g,\n" @@ -13463,17 +13558,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5552 ../fish/guestfish-actions.pod:4290 +#: ../src/guestfs-actions.pod:5575 ../fish/guestfish-actions.pod:4307 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5562 +#: ../src/guestfs-actions.pod:5585 msgid "guestfs_zfgrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5564 +#: ../src/guestfs-actions.pod:5587 #, no-wrap msgid "" " char **guestfs_zfgrepi (guestfs_h *g,\n" @@ -13483,17 +13578,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5568 ../fish/guestfish-actions.pod:4300 +#: ../src/guestfs-actions.pod:5591 ../fish/guestfish-actions.pod:4317 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5578 +#: ../src/guestfs-actions.pod:5601 msgid "guestfs_zfile" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5580 +#: ../src/guestfs-actions.pod:5603 #, no-wrap msgid "" " char *guestfs_zfile (guestfs_h *g,\n" @@ -13503,34 +13598,34 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5584 ../fish/guestfish-actions.pod:4310 +#: ../src/guestfs-actions.pod:5607 ../fish/guestfish-actions.pod:4327 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5587 ../fish/guestfish-actions.pod:4313 +#: ../src/guestfs-actions.pod:5610 ../fish/guestfish-actions.pod:4330 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5589 +#: ../src/guestfs-actions.pod:5612 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5595 ../fish/guestfish-actions.pod:4318 +#: ../src/guestfs-actions.pod:5618 ../fish/guestfish-actions.pod:4335 msgid "This function is deprecated. In new code, use the C<file> call instead." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5602 +#: ../src/guestfs-actions.pod:5625 msgid "guestfs_zgrep" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5604 +#: ../src/guestfs-actions.pod:5627 #, no-wrap msgid "" " char **guestfs_zgrep (guestfs_h *g,\n" @@ -13540,17 +13635,17 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5608 ../fish/guestfish-actions.pod:4329 +#: ../src/guestfs-actions.pod:5631 ../fish/guestfish-actions.pod:4346 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" # type: =head2 -#: ../src/guestfs-actions.pod:5618 +#: ../src/guestfs-actions.pod:5641 msgid "guestfs_zgrepi" msgstr "" # type: verbatim -#: ../src/guestfs-actions.pod:5620 +#: ../src/guestfs-actions.pod:5643 #, no-wrap msgid "" " char **guestfs_zgrepi (guestfs_h *g,\n" @@ -13560,7 +13655,7 @@ msgid "" msgstr "" # type: textblock -#: ../src/guestfs-actions.pod:5624 ../fish/guestfish-actions.pod:4339 +#: ../src/guestfs-actions.pod:5647 ../fish/guestfish-actions.pod:4356 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -14266,7 +14361,7 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:11 ../tools/virt-edit.pl:45 ../tools/virt-rescue.pl:41 ../tools/virt-tar.pl:60 ../tools/virt-win-reg.pl:52 +#: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:11 ../tools/virt-edit.pl:45 ../tools/virt-win-reg.pl:52 ../tools/virt-tar.pl:60 ../tools/virt-rescue.pl:41 msgid "WARNING" msgstr "" @@ -14279,18 +14374,35 @@ msgid "" "live." msgstr "" +# type: textblock +#: ../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 " +"functionality of the guestfs API, see L<guestfs(3)>." +msgstr "" + +# type: textblock +#: ../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 " +"broken virtual machine image, you should look at the L<virt-rescue(1)> " +"command." +msgstr "" + # type: =head1 -#: ../fish/guestfish.pod:30 ../fish/guestfish.pod:736 ../fuse/guestmount.pod:35 ../tools/virt-cat.pl:51 ../tools/virt-edit.pl:59 ../tools/virt-resize.pl:66 ../tools/virt-tar.pl:46 +#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:759 ../fuse/guestmount.pod:35 ../tools/virt-edit.pl:59 ../tools/virt-resize.pl:66 ../tools/virt-cat.pl:51 ../tools/virt-tar.pl:46 msgid "EXAMPLES" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:32 +#: ../fish/guestfish.pod:43 msgid "As an interactive shell" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:34 +#: ../fish/guestfish.pod:45 #, no-wrap msgid "" " $ guestfish\n" @@ -14298,7 +14410,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:36 +#: ../fish/guestfish.pod:47 #, no-wrap msgid "" " Welcome to guestfish, the libguestfs filesystem interactive shell for\n" @@ -14307,7 +14419,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:39 +#: ../fish/guestfish.pod:50 #, no-wrap msgid "" " Type: 'help' for a list of commands\n" @@ -14317,25 +14429,36 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:43 +#: ../fish/guestfish.pod:54 #, no-wrap msgid "" -" ><fs> man\n" +" ><fs> add-ro disk.img\n" +" ><fs> run\n" +" ><fs> list-filesystems\n" +" /dev/sda1: ext4\n" +" /dev/vg_guest/lv_root: ext4\n" +" /dev/vg_guest/lv_swap: swap\n" +" ><fs> mount /dev/vg_guest/lv_root /\n" +" ><fs> cat /etc/fstab\n" +" # /etc/fstab\n" +" # Created by anaconda\n" +" [...]\n" +" ><fs> exit\n" "\n" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:45 +#: ../fish/guestfish.pod:67 msgid "From shell scripts" msgstr "" # type: textblock -#: ../fish/guestfish.pod:47 -msgid "Create a new C</etc/motd> file in a guest:" +#: ../fish/guestfish.pod:69 +msgid "Create a new C</etc/motd> file in a guest or disk image:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:49 +#: ../fish/guestfish.pod:71 #, no-wrap msgid "" " guestfish <<_EOF_\n" @@ -14348,12 +14471,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:56 -msgid "List the LVM logical volumes in a guest:" +#: ../fish/guestfish.pod:78 +msgid "List the LVM logical volumes in a disk image:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:58 +#: ../fish/guestfish.pod:80 #, no-wrap msgid "" " guestfish -a disk.img --ro <<_EOF_\n" @@ -14363,18 +14486,34 @@ msgid "" "\n" msgstr "" +# type: textblock +#: ../fish/guestfish.pod:85 +msgid "List all the filesystems in a disk image:" +msgstr "" + +# type: verbatim +#: ../fish/guestfish.pod:87 +#, no-wrap +msgid "" +" guestfish -a disk.img --ro <<_EOF_\n" +" run\n" +" list-filesystems\n" +" _EOF_\n" +"\n" +msgstr "" + # type: =head2 -#: ../fish/guestfish.pod:63 +#: ../fish/guestfish.pod:92 msgid "On one command line" msgstr "" # type: textblock -#: ../fish/guestfish.pod:65 +#: ../fish/guestfish.pod:94 msgid "Update C</etc/resolv.conf> in a guest:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:67 +#: ../fish/guestfish.pod:96 #, no-wrap msgid "" " guestfish \\\n" @@ -14384,12 +14523,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:71 +#: ../fish/guestfish.pod:100 msgid "Edit C</boot/grub/grub.conf> interactively:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:73 +#: ../fish/guestfish.pod:102 #, no-wrap msgid "" " guestfish --add disk.img \\\n" @@ -14400,19 +14539,19 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:78 +#: ../fish/guestfish.pod:107 msgid "Mount disks automatically" msgstr "" # type: textblock -#: ../fish/guestfish.pod:80 +#: ../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:83 +#: ../fish/guestfish.pod:112 #, no-wrap msgid "" " guestfish --ro -a disk.img -i cat /etc/group\n" @@ -14420,25 +14559,38 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:85 +#: ../fish/guestfish.pod:114 #, no-wrap msgid "" " guestfish --ro -d libvirt-domain -i cat /etc/group\n" "\n" msgstr "" +# type: textblock +#: ../fish/guestfish.pod:116 +msgid "Another way to edit C</boot/grub/grub.conf> interactively is:" +msgstr "" + +# type: verbatim +#: ../fish/guestfish.pod:118 +#, no-wrap +msgid "" +" guestfish -a disk.img -i edit /boot/grub/grub.conf\n" +"\n" +msgstr "" + # type: =head2 -#: ../fish/guestfish.pod:87 +#: ../fish/guestfish.pod:120 msgid "As a script interpreter" msgstr "" # type: textblock -#: ../fish/guestfish.pod:89 +#: ../fish/guestfish.pod:122 msgid "Create a 100MB disk containing an ext2-formatted partition:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:91 +#: ../fish/guestfish.pod:124 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" @@ -14450,19 +14602,19 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:97 +#: ../fish/guestfish.pod:130 msgid "Start with a prepared disk" msgstr "" # type: textblock -#: ../fish/guestfish.pod:99 +#: ../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:102 +#: ../fish/guestfish.pod:135 #, no-wrap msgid "" " guestfish -N fs\n" @@ -14470,12 +14622,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:104 +#: ../fish/guestfish.pod:137 msgid "To list what is available do:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:106 ../fish/guestfish.pod:727 +#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:750 #, no-wrap msgid "" " guestfish -N help | less\n" @@ -14483,102 +14635,85 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:108 +#: ../fish/guestfish.pod:141 msgid "Remote control" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:110 +#: ../fish/guestfish.pod:143 #, no-wrap msgid "" -" eval `guestfish --listen --ro`\n" -" guestfish --remote add disk.img\n" +" eval `guestfish --listen`\n" +" guestfish --remote add-ro disk.img\n" " guestfish --remote run\n" " guestfish --remote lvs\n" "\n" msgstr "" -# type: textblock -#: ../fish/guestfish.pod:117 -msgid "" -"Guestfish is a shell and command-line tool for examining and modifying " -"virtual machine filesystems. It uses libguestfs and exposes all of the " -"functionality of the guestfs API, see L<guestfs(3)>." -msgstr "" - -# type: textblock -#: ../fish/guestfish.pod:121 -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 " -"broken virtual machine image, you should look at the L<virt-rescue(1)> " -"command." -msgstr "" - # type: =head1 -#: ../fish/guestfish.pod:126 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:70 ../inspector/virt-inspector.pl:75 ../tools/virt-cat.pl:80 ../tools/virt-df.pl:71 ../tools/virt-edit.pl:73 ../tools/virt-list-filesystems.pl:50 ../tools/virt-list-partitions.pl:51 ../tools/virt-ls.pl:79 ../tools/virt-make-fs.pl:153 ../tools/virt-rescue.pl:103 ../tools/virt-resize.pl:233 ../tools/virt-tar.pl:99 ../tools/virt-win-reg.pl:172 +#: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:70 ../inspector/virt-inspector.pl:75 ../tools/virt-edit.pl:73 ../tools/virt-win-reg.pl:172 ../tools/virt-df.pl:71 ../tools/virt-ls.pl:79 ../tools/virt-resize.pl:233 ../tools/virt-list-filesystems.pl:50 ../tools/virt-cat.pl:80 ../tools/virt-tar.pl:99 ../tools/virt-rescue.pl:103 ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:51 msgid "OPTIONS" msgstr "" # type: =item -#: ../fish/guestfish.pod:130 ../fuse/guestmount.pod:94 ../inspector/virt-inspector.pl:83 ../tools/virt-cat.pl:88 ../tools/virt-df.pl:79 ../tools/virt-edit.pl:81 ../tools/virt-list-filesystems.pl:58 ../tools/virt-list-partitions.pl:59 ../tools/virt-ls.pl:87 ../tools/virt-make-fs.pl:161 ../tools/virt-rescue.pl:111 ../tools/virt-resize.pl:241 ../tools/virt-tar.pl:107 ../tools/virt-win-reg.pl:180 +#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:94 ../inspector/virt-inspector.pl:83 ../tools/virt-edit.pl:81 ../tools/virt-win-reg.pl:180 ../tools/virt-df.pl:79 ../tools/virt-ls.pl:87 ../tools/virt-resize.pl:241 ../tools/virt-list-filesystems.pl:58 ../tools/virt-cat.pl:88 ../tools/virt-tar.pl:107 ../tools/virt-rescue.pl:111 ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:59 msgid "B<--help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:132 +#: ../fish/guestfish.pod:154 msgid "Displays general help on options." msgstr "" # type: =item -#: ../fish/guestfish.pod:134 +#: ../fish/guestfish.pod:156 msgid "B<-h> | B<--cmd-help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:136 +#: ../fish/guestfish.pod:158 msgid "Lists all available guestfish commands." msgstr "" # type: =item -#: ../fish/guestfish.pod:138 +#: ../fish/guestfish.pod:160 msgid "B<-h cmd> | B<--cmd-help cmd>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:140 +#: ../fish/guestfish.pod:162 msgid "Displays detailed help on a single command C<cmd>." msgstr "" # type: =item -#: ../fish/guestfish.pod:142 ../fuse/guestmount.pod:74 +#: ../fish/guestfish.pod:164 ../fuse/guestmount.pod:74 msgid "B<-a image> | B<--add image>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:144 +#: ../fish/guestfish.pod:166 msgid "Add a block device or virtual machine image to the shell." msgstr "" # type: =item -#: ../fish/guestfish.pod:146 +#: ../fish/guestfish.pod:168 msgid "B<-c URI> | B<--connect URI>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:148 +#: ../fish/guestfish.pod:170 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:152 +#: ../fish/guestfish.pod:174 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:154 +#: ../fish/guestfish.pod:176 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 " @@ -14586,12 +14721,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:158 +#: ../fish/guestfish.pod:180 msgid "B<-D> | B<--no-dest-paths>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:160 +#: ../fish/guestfish.pod:182 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 " @@ -14600,12 +14735,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:165 +#: ../fish/guestfish.pod:187 msgid "B<--echo-keys>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:167 +#: ../fish/guestfish.pod:189 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 " @@ -14614,17 +14749,17 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:172 +#: ../fish/guestfish.pod:194 msgid "B<-f file> | B<--file file>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:174 +#: ../fish/guestfish.pod:196 msgid "Read commands from C<file>. To write pure guestfish scripts, use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:177 +#: ../fish/guestfish.pod:199 #, no-wrap msgid "" " #!/usr/bin/guestfish -f\n" @@ -14632,12 +14767,12 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:179 +#: ../fish/guestfish.pod:201 msgid "B<-i> | B<--inspector>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:181 +#: ../fish/guestfish.pod:203 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 " @@ -14645,12 +14780,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:185 +#: ../fish/guestfish.pod:207 msgid "Typical usage is either:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:187 +#: ../fish/guestfish.pod:209 #, no-wrap msgid "" " guestfish -d myguest -i\n" @@ -14658,12 +14793,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:189 +#: ../fish/guestfish.pod:211 msgid "(for an inactive libvirt domain called I<myguest>), or:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:191 +#: ../fish/guestfish.pod:213 #, no-wrap msgid "" " guestfish --ro -d myguest -i\n" @@ -14671,12 +14806,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:193 +#: ../fish/guestfish.pod:215 msgid "(for active domains, readonly), or specify the block device directly:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:195 +#: ../fish/guestfish.pod:217 #, no-wrap msgid "" " guestfish -a /dev/Guests/MyGuest -i\n" @@ -14684,14 +14819,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:197 +#: ../fish/guestfish.pod:219 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:200 +#: ../fish/guestfish.pod:222 #, no-wrap msgid "" " guestfish [--ro] -i disk.img\n" @@ -14699,7 +14834,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:202 +#: ../fish/guestfish.pod:224 #, no-wrap msgid "" " guestfish [--ro] -i libvirt-domain\n" @@ -14707,58 +14842,58 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:204 +#: ../fish/guestfish.pod:226 msgid "B<--keys-from-stdin>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:206 +#: ../fish/guestfish.pod:228 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:209 +#: ../fish/guestfish.pod:231 msgid "B<--listen>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:211 +#: ../fish/guestfish.pod:233 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:214 +#: ../fish/guestfish.pod:236 msgid "B<-m dev[:mountpoint]> | B<--mount dev[:mountpoint]>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:216 +#: ../fish/guestfish.pod:238 msgid "Mount the named partition or logical volume on the given mountpoint." msgstr "" # type: textblock -#: ../fish/guestfish.pod:218 +#: ../fish/guestfish.pod:240 msgid "If the mountpoint is omitted, it defaults to C</>." msgstr "" # type: textblock -#: ../fish/guestfish.pod:220 +#: ../fish/guestfish.pod:242 msgid "You have to mount something on C</> before most commands will work." msgstr "" # type: textblock -#: ../fish/guestfish.pod:222 +#: ../fish/guestfish.pod:244 msgid "" "If any I<-m> or I<--mount> options are given, the guest is automatically " "launched." msgstr "" # type: textblock -#: ../fish/guestfish.pod:225 +#: ../fish/guestfish.pod:247 msgid "" "If you don't know what filesystems a disk image contains, you can either run " "guestfish without this option, then list the partitions and LVs available " @@ -14767,24 +14902,24 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:230 ../fuse/guestmount.pod:106 +#: ../fish/guestfish.pod:252 ../fuse/guestmount.pod:106 msgid "B<-n> | B<--no-sync>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:232 +#: ../fish/guestfish.pod:254 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:235 +#: ../fish/guestfish.pod:257 msgid "B<-N type> | B<--new type> | B<-N help>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:237 +#: ../fish/guestfish.pod:259 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 " @@ -14793,58 +14928,58 @@ msgid "" msgstr "" # type: =item -#: ../fish/guestfish.pod:242 +#: ../fish/guestfish.pod:264 msgid "B<--progress-bars>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:244 +#: ../fish/guestfish.pod:266 msgid "Enable progress bars, even when guestfish is used non-interactively." msgstr "" # type: textblock -#: ../fish/guestfish.pod:246 +#: ../fish/guestfish.pod:268 msgid "" "Progress bars are enabled by default when guestfish is used as an " "interactive shell." msgstr "" # type: =item -#: ../fish/guestfish.pod:249 +#: ../fish/guestfish.pod:271 msgid "B<--no-progress-bars>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:251 +#: ../fish/guestfish.pod:273 msgid "Disable progress bars." msgstr "" # type: =item -#: ../fish/guestfish.pod:253 +#: ../fish/guestfish.pod:275 msgid "B<--remote[=pid]>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:255 +#: ../fish/guestfish.pod:277 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:258 ../fuse/guestmount.pod:148 +#: ../fish/guestfish.pod:280 ../fuse/guestmount.pod:148 msgid "B<-r> | B<--ro>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:260 +#: ../fish/guestfish.pod:282 msgid "" "This changes the I<-a> and I<-m> options so that disks are added and mounts " "are done read-only (see L<guestfs(3)/guestfs_mount_ro>)." msgstr "" # type: textblock -#: ../fish/guestfish.pod:263 ../tools/virt-rescue.pl:162 +#: ../fish/guestfish.pod:285 ../tools/virt-rescue.pl:162 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 " @@ -14852,73 +14987,73 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:267 +#: ../fish/guestfish.pod:289 msgid "" "Note that prepared disk images created with I<-N> are not affected by the " "I<--ro> option." msgstr "" # type: =item -#: ../fish/guestfish.pod:270 ../fuse/guestmount.pod:158 ../tools/virt-rescue.pl:170 +#: ../fish/guestfish.pod:292 ../fuse/guestmount.pod:158 ../tools/virt-rescue.pl:170 msgid "B<--selinux>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:272 +#: ../fish/guestfish.pod:294 msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>." msgstr "" # type: =item -#: ../fish/guestfish.pod:274 ../fuse/guestmount.pod:168 +#: ../fish/guestfish.pod:296 ../fuse/guestmount.pod:168 msgid "B<-v> | B<--verbose>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:276 +#: ../fish/guestfish.pod:298 msgid "" "Enable very verbose messages. This is particularly useful if you find a " "bug." msgstr "" # type: =item -#: ../fish/guestfish.pod:279 ../fuse/guestmount.pod:172 +#: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:172 msgid "B<-V> | B<--version>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:281 +#: ../fish/guestfish.pod:303 msgid "Display the guestfish / libguestfs version number and exit." msgstr "" # type: =item -#: ../fish/guestfish.pod:283 +#: ../fish/guestfish.pod:305 msgid "B<-x>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:285 +#: ../fish/guestfish.pod:307 msgid "Echo each command before executing it." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:289 +#: ../fish/guestfish.pod:311 msgid "COMMANDS ON COMMAND LINE" msgstr "" # type: textblock -#: ../fish/guestfish.pod:291 +#: ../fish/guestfish.pod:313 msgid "Any additional (non-option) arguments are treated as commands to execute." msgstr "" # type: textblock -#: ../fish/guestfish.pod:294 +#: ../fish/guestfish.pod:316 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:297 +#: ../fish/guestfish.pod:319 #, no-wrap msgid "" " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n" @@ -14926,7 +15061,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:299 +#: ../fish/guestfish.pod:321 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 " @@ -14934,7 +15069,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:303 +#: ../fish/guestfish.pod:325 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 " @@ -14942,12 +15077,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:308 +#: ../fish/guestfish.pod:330 msgid "USING launch (OR run)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:310 +#: ../fish/guestfish.pod:332 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 " @@ -14955,54 +15090,54 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:318 +#: ../fish/guestfish.pod:340 msgid "add or -a/--add" msgstr "" # type: textblock -#: ../fish/guestfish.pod:322 +#: ../fish/guestfish.pod:344 msgid "launch (aka run)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:326 +#: ../fish/guestfish.pod:348 msgid "mount or -m/--mount" msgstr "" # type: textblock -#: ../fish/guestfish.pod:330 +#: ../fish/guestfish.pod:352 msgid "any other commands" msgstr "" # type: textblock -#: ../fish/guestfish.pod:334 +#: ../fish/guestfish.pod:356 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:337 +#: ../fish/guestfish.pod:359 msgid "" -"The only exception is that if the I<-m> or I<--mount> option was given, the " -"guest is automatically run for you (simply because guestfish can't mount the " -"disks you asked for without doing this)." +"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 " +"because guestfish can't perform the action you asked for without doing this." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:341 +#: ../fish/guestfish.pod:364 msgid "QUOTING" msgstr "" # type: textblock -#: ../fish/guestfish.pod:343 +#: ../fish/guestfish.pod:366 msgid "" "You can quote ordinary parameters using either single or double quotes. For " "example:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:346 +#: ../fish/guestfish.pod:369 #, no-wrap msgid "" " add \"file with a space.img\"\n" @@ -15010,7 +15145,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:348 +#: ../fish/guestfish.pod:371 #, no-wrap msgid "" " rm '/file name'\n" @@ -15018,7 +15153,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:350 +#: ../fish/guestfish.pod:373 #, no-wrap msgid "" " rm '/\"'\n" @@ -15026,7 +15161,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:352 +#: ../fish/guestfish.pod:375 msgid "" "A few commands require a list of strings to be passed. For these, use a " "whitespace-separated list, enclosed in quotes. Strings containing " @@ -15035,7 +15170,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:357 +#: ../fish/guestfish.pod:380 #, no-wrap msgid "" " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n" @@ -15045,194 +15180,194 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:361 +#: ../fish/guestfish.pod:384 msgid "NUMBERS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:363 +#: ../fish/guestfish.pod:386 msgid "This section applies to all commands which can take integers as parameters." msgstr "" # type: =head2 -#: ../fish/guestfish.pod:366 +#: ../fish/guestfish.pod:389 msgid "SIZE SUFFIX" msgstr "" # type: textblock -#: ../fish/guestfish.pod:368 +#: ../fish/guestfish.pod:391 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:374 +#: ../fish/guestfish.pod:397 msgid "B<k> or B<K> or B<KiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:376 +#: ../fish/guestfish.pod:399 msgid "The size in kilobytes (multiplied by 1024)." msgstr "" # type: =item -#: ../fish/guestfish.pod:378 +#: ../fish/guestfish.pod:401 msgid "B<KB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:380 +#: ../fish/guestfish.pod:403 msgid "The size in SI 1000 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:382 +#: ../fish/guestfish.pod:405 msgid "B<M> or B<MiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:384 +#: ../fish/guestfish.pod:407 msgid "The size in megabytes (multiplied by 1048576)." msgstr "" # type: =item -#: ../fish/guestfish.pod:386 +#: ../fish/guestfish.pod:409 msgid "B<MB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:388 +#: ../fish/guestfish.pod:411 msgid "The size in SI 1000000 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:390 +#: ../fish/guestfish.pod:413 msgid "B<G> or B<GiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:392 +#: ../fish/guestfish.pod:415 msgid "The size in gigabytes (multiplied by 2**30)." msgstr "" # type: =item -#: ../fish/guestfish.pod:394 +#: ../fish/guestfish.pod:417 msgid "B<GB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:396 +#: ../fish/guestfish.pod:419 msgid "The size in SI 10**9 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:398 +#: ../fish/guestfish.pod:421 msgid "B<T> or B<TiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:400 +#: ../fish/guestfish.pod:423 msgid "The size in terabytes (multiplied by 2**40)." msgstr "" # type: =item -#: ../fish/guestfish.pod:402 +#: ../fish/guestfish.pod:425 msgid "B<TB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:404 +#: ../fish/guestfish.pod:427 msgid "The size in SI 10**12 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:406 +#: ../fish/guestfish.pod:429 msgid "B<P> or B<PiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:408 +#: ../fish/guestfish.pod:431 msgid "The size in petabytes (multiplied by 2**50)." msgstr "" # type: =item -#: ../fish/guestfish.pod:410 +#: ../fish/guestfish.pod:433 msgid "B<PB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:412 +#: ../fish/guestfish.pod:435 msgid "The size in SI 10**15 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:414 +#: ../fish/guestfish.pod:437 msgid "B<E> or B<EiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:416 +#: ../fish/guestfish.pod:439 msgid "The size in exabytes (multiplied by 2**60)." msgstr "" # type: =item -#: ../fish/guestfish.pod:418 +#: ../fish/guestfish.pod:441 msgid "B<EB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:420 +#: ../fish/guestfish.pod:443 msgid "The size in SI 10**18 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:422 +#: ../fish/guestfish.pod:445 msgid "B<Z> or B<ZiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:424 +#: ../fish/guestfish.pod:447 msgid "The size in zettabytes (multiplied by 2**70)." msgstr "" # type: =item -#: ../fish/guestfish.pod:426 +#: ../fish/guestfish.pod:449 msgid "B<ZB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:428 +#: ../fish/guestfish.pod:451 msgid "The size in SI 10**21 byte units." msgstr "" # type: =item -#: ../fish/guestfish.pod:430 +#: ../fish/guestfish.pod:453 msgid "B<Y> or B<YiB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:432 +#: ../fish/guestfish.pod:455 msgid "The size in yottabytes (multiplied by 2**80)." msgstr "" # type: =item -#: ../fish/guestfish.pod:434 +#: ../fish/guestfish.pod:457 msgid "B<YB>" msgstr "" # type: textblock -#: ../fish/guestfish.pod:436 +#: ../fish/guestfish.pod:459 msgid "The size in SI 10**24 byte units." msgstr "" # type: textblock -#: ../fish/guestfish.pod:440 +#: ../fish/guestfish.pod:463 msgid "For example:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:442 +#: ../fish/guestfish.pod:465 #, no-wrap msgid "" " truncate-size /file 1G\n" @@ -15240,12 +15375,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:444 +#: ../fish/guestfish.pod:467 msgid "would truncate the file to 1 gigabyte." msgstr "" # type: textblock -#: ../fish/guestfish.pod:446 +#: ../fish/guestfish.pod:469 msgid "" "Be careful because a few commands take sizes in kilobytes or megabytes " "(eg. the parameter to L</memsize> is specified in megabytes already). " @@ -15253,19 +15388,19 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:450 +#: ../fish/guestfish.pod:473 msgid "OCTAL AND HEXADECIMAL NUMBERS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:452 +#: ../fish/guestfish.pod:475 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:455 +#: ../fish/guestfish.pod:478 #, no-wrap msgid "" " 1234 decimal number 1234\n" @@ -15275,7 +15410,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:459 +#: ../fish/guestfish.pod:482 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 " @@ -15283,7 +15418,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:463 +#: ../fish/guestfish.pod:486 #, no-wrap msgid "" " chmod 0777 /public # OK\n" @@ -15292,7 +15427,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:466 +#: ../fish/guestfish.pod:489 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 " @@ -15300,12 +15435,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:470 +#: ../fish/guestfish.pod:493 msgid "WILDCARDS AND GLOBBING" msgstr "" # type: textblock -#: ../fish/guestfish.pod:472 +#: ../fish/guestfish.pod:495 msgid "" "Neither guestfish nor the underlying guestfs API performs wildcard expansion " "(globbing) by default. So for example the following will not do what you " @@ -15313,7 +15448,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:476 +#: ../fish/guestfish.pod:499 #, no-wrap msgid "" " rm-rf /home/*\n" @@ -15321,19 +15456,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:478 +#: ../fish/guestfish.pod:501 msgid "" -"Assuming you don't have a directory literally called C</home/*> then the " +"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:481 +#: ../fish/guestfish.pod:504 msgid "To perform wildcard expansion, use the C<glob> command." msgstr "" # type: verbatim -#: ../fish/guestfish.pod:483 +#: ../fish/guestfish.pod:506 #, no-wrap msgid "" " glob rm-rf /home/*\n" @@ -15341,14 +15476,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:485 +#: ../fish/guestfish.pod:508 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:488 +#: ../fish/guestfish.pod:511 #, no-wrap msgid "" " rm-rf /home/jim\n" @@ -15358,24 +15493,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:492 +#: ../fish/guestfish.pod:515 msgid "C<glob> only works on simple guest paths and not on device names." msgstr "" # type: textblock -#: ../fish/guestfish.pod:494 +#: ../fish/guestfish.pod:517 msgid "" "If you have several parameters, each containing a wildcard, then glob will " -"perform a cartesian product." +"perform a Cartesian product." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:497 +#: ../fish/guestfish.pod:520 msgid "COMMENTS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:499 +#: ../fish/guestfish.pod:522 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 " @@ -15383,7 +15518,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:503 +#: ../fish/guestfish.pod:526 #, no-wrap msgid "" " # this is a comment\n" @@ -15393,24 +15528,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:507 +#: ../fish/guestfish.pod:530 msgid "Blank lines are also ignored." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:509 +#: ../fish/guestfish.pod:532 msgid "RUNNING COMMANDS LOCALLY" msgstr "" # type: textblock -#: ../fish/guestfish.pod:511 +#: ../fish/guestfish.pod:534 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:515 +#: ../fish/guestfish.pod:538 #, no-wrap msgid "" " !mkdir local\n" @@ -15419,7 +15554,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:518 +#: ../fish/guestfish.pod:541 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>. " @@ -15427,19 +15562,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:522 +#: ../fish/guestfish.pod:545 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: =head1 -#: ../fish/guestfish.pod:525 +#: ../fish/guestfish.pod:548 msgid "PIPES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:527 +#: ../fish/guestfish.pod:550 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 " @@ -15447,7 +15582,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:531 +#: ../fish/guestfish.pod:554 #, no-wrap msgid "" " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n" @@ -15455,7 +15590,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:533 +#: ../fish/guestfish.pod:556 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 " @@ -15463,7 +15598,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:538 +#: ../fish/guestfish.pod:561 #, no-wrap msgid "" " hexdump /bin/ls | head\n" @@ -15473,7 +15608,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:542 +#: ../fish/guestfish.pod:565 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 " @@ -15482,14 +15617,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:547 +#: ../fish/guestfish.pod:570 msgid "" "To use a literal argument which begins with a pipe symbol, you have to quote " "it, eg:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:550 +#: ../fish/guestfish.pod:573 #, no-wrap msgid "" " echo \"|\"\n" @@ -15497,12 +15632,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:552 +#: ../fish/guestfish.pod:575 msgid "HOME DIRECTORIES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:554 +#: ../fish/guestfish.pod:577 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, " @@ -15510,21 +15645,21 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:558 +#: ../fish/guestfish.pod:581 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:561 +#: ../fish/guestfish.pod:584 msgid "" "To use a literal argument which begins with a tilde, you have to quote it, " "eg:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:564 +#: ../fish/guestfish.pod:587 #, no-wrap msgid "" " echo \"~\"\n" @@ -15532,7 +15667,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:568 +#: ../fish/guestfish.pod:591 msgid "" "Libguestfs has some support for Linux guests encrypted according to the " "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole " @@ -15541,12 +15676,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:573 +#: ../fish/guestfish.pod:596 msgid "Identify encrypted block devices and partitions using L</vfs-type>:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:575 +#: ../fish/guestfish.pod:598 #, no-wrap msgid "" " ><fs> vfs-type /dev/sda2\n" @@ -15555,14 +15690,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:578 +#: ../fish/guestfish.pod:601 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:581 +#: ../fish/guestfish.pod:604 #, no-wrap msgid "" " ><fs> luks-open /dev/sda2 luksdev\n" @@ -15571,28 +15706,28 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:584 +#: ../fish/guestfish.pod:607 msgid "" "Finally you have to tell LVM to scan for volume groups on the newly created " "mapper device:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:587 +#: ../fish/guestfish.pod:610 #, no-wrap msgid "" -" ><fs> vgscan\n" -" ><fs> vg-activate-all true\n" +" vgscan\n" +" vg-activate-all true\n" "\n" msgstr "" # type: textblock -#: ../fish/guestfish.pod:590 +#: ../fish/guestfish.pod:613 msgid "The logical volume(s) can now be mounted in the usual way." msgstr "" # type: textblock -#: ../fish/guestfish.pod:592 +#: ../fish/guestfish.pod:615 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 " @@ -15600,28 +15735,28 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:596 +#: ../fish/guestfish.pod:619 #, no-wrap msgid "" -" ><fs> vg-activate false /dev/VG\n" -" ><fs> luks-close /dev/mapper/luksdev\n" +" vg-activate false /dev/VG\n" +" luks-close /dev/mapper/luksdev\n" "\n" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:599 +#: ../fish/guestfish.pod:622 msgid "WINDOWS PATHS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:601 +#: ../fish/guestfish.pod:624 msgid "" "If a path is prefixed with C<win:> then you can use Windows-style paths " "(with some limitations). The following commands are equivalent:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:604 +#: ../fish/guestfish.pod:627 #, no-wrap msgid "" " file /WINDOWS/system32/config/system.LOG\n" @@ -15629,7 +15764,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:606 +#: ../fish/guestfish.pod:629 #, no-wrap msgid "" " file win:/windows/system32/config/system.log\n" @@ -15637,7 +15772,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:608 +#: ../fish/guestfish.pod:631 #, no-wrap msgid "" " file win:\\windows\\system32\\config\\system.log\n" @@ -15645,7 +15780,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:610 +#: ../fish/guestfish.pod:633 #, no-wrap msgid "" " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n" @@ -15653,7 +15788,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:612 +#: ../fish/guestfish.pod:635 msgid "" "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also " "handles case insensitivity like Windows would. This only works in argument " @@ -15661,12 +15796,12 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:616 +#: ../fish/guestfish.pod:639 msgid "UPLOADING AND DOWNLOADING FILES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:618 +#: ../fish/guestfish.pod:641 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 " @@ -15674,7 +15809,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:622 +#: ../fish/guestfish.pod:645 #, no-wrap msgid "" " upload - /foo\n" @@ -15682,12 +15817,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:624 +#: ../fish/guestfish.pod:647 msgid "reads stdin and creates from that a file C</foo> in the disk image, and:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:627 +#: ../fish/guestfish.pod:650 #, no-wrap msgid "" " tar-out /etc - | tar tf -\n" @@ -15695,14 +15830,14 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:629 +#: ../fish/guestfish.pod:652 msgid "" "writes the tarball to stdout and then pipes that into the external \"tar\" " "command (see L</PIPES>)." msgstr "" # type: textblock -#: ../fish/guestfish.pod:632 +#: ../fish/guestfish.pod:655 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 " @@ -15710,7 +15845,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:636 +#: ../fish/guestfish.pod:659 #, no-wrap msgid "" " upload -<<END /foo\n" @@ -15722,7 +15857,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:642 +#: ../fish/guestfish.pod:665 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 " @@ -15730,19 +15865,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:646 +#: ../fish/guestfish.pod:669 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:649 +#: ../fish/guestfish.pod:672 msgid "EXIT ON ERROR BEHAVIOUR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:651 +#: ../fish/guestfish.pod:674 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 " @@ -15750,19 +15885,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:656 +#: ../fish/guestfish.pod:679 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:660 +#: ../fish/guestfish.pod:683 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET" msgstr "" # type: textblock -#: ../fish/guestfish.pod:662 +#: ../fish/guestfish.pod:685 msgid "" "Guestfish can be remote-controlled over a socket. This is useful " "particularly in shell scripts where you want to make several different " @@ -15771,12 +15906,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:667 +#: ../fish/guestfish.pod:690 msgid "Start a guestfish server process using:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:669 +#: ../fish/guestfish.pod:692 #, no-wrap msgid "" " eval `guestfish --listen`\n" @@ -15784,12 +15919,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:671 +#: ../fish/guestfish.pod:694 msgid "and then send it commands by doing:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:673 +#: ../fish/guestfish.pod:696 #, no-wrap msgid "" " guestfish --remote cmd [...]\n" @@ -15797,12 +15932,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:675 +#: ../fish/guestfish.pod:698 msgid "To cause the server to exit, send it the exit command:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:677 +#: ../fish/guestfish.pod:700 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -15810,7 +15945,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:679 +#: ../fish/guestfish.pod:702 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 " @@ -15818,12 +15953,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:683 +#: ../fish/guestfish.pod:706 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:685 +#: ../fish/guestfish.pod:708 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 " @@ -15831,7 +15966,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:689 +#: ../fish/guestfish.pod:712 #, no-wrap msgid "" " eval `guestfish --listen`\n" @@ -15845,12 +15980,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish.pod:697 +#: ../fish/guestfish.pod:720 msgid "REMOTE CONTROL DETAILS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:699 +#: ../fish/guestfish.pod:722 msgid "" "Remote control happens over a Unix domain socket called " "C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID " @@ -15858,17 +15993,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:703 +#: ../fish/guestfish.pod:726 msgid "Guestfish client and server versions must match exactly." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:705 +#: ../fish/guestfish.pod:728 msgid "PREPARED DISK IMAGES" msgstr "" # type: textblock -#: ../fish/guestfish.pod:707 +#: ../fish/guestfish.pod:730 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. " @@ -15878,7 +16013,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:713 +#: ../fish/guestfish.pod:736 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 " @@ -15886,7 +16021,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:717 +#: ../fish/guestfish.pod:740 msgid "" "The type briefly describes how the disk should be sized, partitioned, how " "filesystem(s) should be created, and how content should be added. " @@ -15898,31 +16033,31 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:725 +#: ../fish/guestfish.pod:748 msgid "To list the available types and any extra parameters they take, run:" msgstr "" # type: textblock -#: ../fish/guestfish.pod:729 +#: ../fish/guestfish.pod:752 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:733 +#: ../fish/guestfish.pod:756 msgid "" "If any I<-N> or I<--new> options are given, the guest is automatically " "launched." msgstr "" # type: textblock -#: ../fish/guestfish.pod:738 +#: ../fish/guestfish.pod:761 msgid "Create a 100MB disk with an ext4-formatted partition:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:740 +#: ../fish/guestfish.pod:763 #, no-wrap msgid "" " guestfish -N fs:ext4\n" @@ -15930,12 +16065,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:742 +#: ../fish/guestfish.pod:765 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:744 +#: ../fish/guestfish.pod:767 #, no-wrap msgid "" " guestfish -N fs:vfat:32M -m /dev/sda1\n" @@ -15943,12 +16078,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:746 +#: ../fish/guestfish.pod:769 msgid "Create a blank 200MB disk:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:748 +#: ../fish/guestfish.pod:771 #, no-wrap msgid "" " guestfish -N disk:200M\n" @@ -15956,19 +16091,19 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:750 +#: ../fish/guestfish.pod:773 msgid "PROGRESS BARS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:752 +#: ../fish/guestfish.pod:775 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:756 +#: ../fish/guestfish.pod:779 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 " @@ -15976,7 +16111,7 @@ msgid "" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:760 +#: ../fish/guestfish.pod:783 #, no-wrap msgid "" " ><fs> copy-size /large-file /another-file 2048M\n" @@ -15985,7 +16120,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:763 +#: ../fish/guestfish.pod:786 msgid "" "The spinner on the left hand side moves round once for every progress " "notification received from the backend. This is a (reasonably) golden " @@ -15996,7 +16131,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:770 +#: ../fish/guestfish.pod:793 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>, " @@ -16004,24 +16139,24 @@ msgid "" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:775 +#: ../fish/guestfish.pod:798 msgid "GUESTFISH COMMANDS" msgstr "" # type: textblock -#: ../fish/guestfish.pod:777 +#: ../fish/guestfish.pod:800 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:780 +#: ../fish/guestfish.pod:803 msgid "help" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:782 +#: ../fish/guestfish.pod:805 #, no-wrap msgid "" " help\n" @@ -16030,152 +16165,152 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:785 +#: ../fish/guestfish.pod:808 msgid "" "Without any parameter, this lists all commands. With a C<cmd> parameter, " "this displays detailed help for a command." msgstr "" # type: =head2 -#: ../fish/guestfish.pod:788 +#: ../fish/guestfish.pod:811 msgid "quit | exit" msgstr "" # type: textblock -#: ../fish/guestfish.pod:790 +#: ../fish/guestfish.pod:813 msgid "This exits guestfish. You can also use C<^D> key." msgstr "" # type: textblock -#: ../fish/guestfish.pod:792 +#: ../fish/guestfish.pod:815 msgid "@FISH_COMMANDS@" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:794 +#: ../fish/guestfish.pod:817 msgid "COMMANDS" msgstr "" # type: =head1 -#: ../fish/guestfish.pod:798 ../test-tool/libguestfs-test-tool.pod:83 +#: ../fish/guestfish.pod:821 ../test-tool/libguestfs-test-tool.pod:83 msgid "EXIT CODE" msgstr "" # type: textblock -#: ../fish/guestfish.pod:800 +#: ../fish/guestfish.pod:823 msgid "" "guestfish returns 0 if the commands completed without error, or 1 if there " "was an error." msgstr "" # type: =item -#: ../fish/guestfish.pod:807 +#: ../fish/guestfish.pod:830 msgid "EDITOR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:809 +#: ../fish/guestfish.pod:832 msgid "" "The C<edit> command uses C<$EDITOR> as the editor. If not set, it uses " "C<vi>." msgstr "" # type: =item -#: ../fish/guestfish.pod:812 +#: ../fish/guestfish.pod:835 msgid "GUESTFISH_PID" msgstr "" # type: textblock -#: ../fish/guestfish.pod:814 +#: ../fish/guestfish.pod:837 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:818 +#: ../fish/guestfish.pod:841 msgid "HEXEDITOR" msgstr "" # type: textblock -#: ../fish/guestfish.pod:820 +#: ../fish/guestfish.pod:843 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:824 +#: ../fish/guestfish.pod:847 msgid "HOME" msgstr "" # type: textblock -#: ../fish/guestfish.pod:826 +#: ../fish/guestfish.pod:849 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L</FILES>." msgstr "" # type: textblock -#: ../fish/guestfish.pod:835 +#: ../fish/guestfish.pod:858 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" # type: textblock -#: ../fish/guestfish.pod:847 +#: ../fish/guestfish.pod:870 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: textblock -#: ../fish/guestfish.pod:858 +#: ../fish/guestfish.pod:881 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces." msgstr "" # type: =item -#: ../fish/guestfish.pod:860 +#: ../fish/guestfish.pod:883 msgid "PAGER" msgstr "" # type: textblock -#: ../fish/guestfish.pod:862 +#: ../fish/guestfish.pod:885 msgid "" "The C<more> command uses C<$PAGER> as the pager. If not set, it uses " "C<more>." msgstr "" # type: =head1 -#: ../fish/guestfish.pod:877 ../test-tool/libguestfs-test-tool.pod:88 +#: ../fish/guestfish.pod:900 ../test-tool/libguestfs-test-tool.pod:88 msgid "FILES" msgstr "" # type: =item -#: ../fish/guestfish.pod:881 +#: ../fish/guestfish.pod:904 msgid "$HOME/.guestfish" msgstr "" # type: textblock -#: ../fish/guestfish.pod:883 +#: ../fish/guestfish.pod:906 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" # type: =item -#: ../fish/guestfish.pod:886 +#: ../fish/guestfish.pod:909 msgid "$HOME/.inputrc" msgstr "" # type: =item -#: ../fish/guestfish.pod:888 +#: ../fish/guestfish.pod:911 msgid "/etc/inputrc" msgstr "" # type: textblock -#: ../fish/guestfish.pod:890 +#: ../fish/guestfish.pod:913 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -16183,12 +16318,12 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:894 +#: ../fish/guestfish.pod:917 msgid "To write rules which only apply to guestfish, use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:896 +#: ../fish/guestfish.pod:919 #, no-wrap msgid "" " $if guestfish\n" @@ -16198,26 +16333,26 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:900 +#: ../fish/guestfish.pod:923 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" # type: =item -#: ../fish/guestfish.pod:905 +#: ../fish/guestfish.pod:928 msgid "completion-ignore-case (default: on)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:907 +#: ../fish/guestfish.pod:930 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" # type: verbatim -#: ../fish/guestfish.pod:910 +#: ../fish/guestfish.pod:933 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -16225,22 +16360,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:912 +#: ../fish/guestfish.pod:935 msgid "to make guestfish case sensitive." msgstr "" # type: =item -#: ../fish/guestfish.pod:916 +#: ../fish/guestfish.pod:939 msgid "test1.img" msgstr "" # type: =item -#: ../fish/guestfish.pod:918 +#: ../fish/guestfish.pod:941 msgid "test2.img (etc)" msgstr "" # type: textblock -#: ../fish/guestfish.pod:920 +#: ../fish/guestfish.pod:943 msgid "" "When using the C<-N> or C<--new> option, the prepared disk or filesystem " "will be created in the file C<test1.img> in the current directory. The " @@ -16249,7 +16384,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:929 +#: ../fish/guestfish.pod:952 msgid "" "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-df(1)>, " "L<virt-edit(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, " @@ -16258,7 +16393,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:953 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:198 ../inspector/virt-inspector.pl:865 ../tools/virt-cat.pl:181 ../tools/virt-df.pl:553 ../tools/virt-edit.pl:345 ../tools/virt-list-filesystems.pl:211 ../tools/virt-list-partitions.pl:248 ../tools/virt-ls.pl:229 ../tools/virt-make-fs.pl:560 ../tools/virt-rescue.pl:249 ../tools/virt-resize.pl:1415 ../tools/virt-tar.pl:276 ../tools/virt-win-reg.pl:495 +#: ../fish/guestfish.pod:976 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:198 ../inspector/virt-inspector.pl:865 ../tools/virt-edit.pl:345 ../tools/virt-win-reg.pl:495 ../tools/virt-df.pl:553 ../tools/virt-ls.pl:229 ../tools/virt-resize.pl:1415 ../tools/virt-list-filesystems.pl:211 ../tools/virt-cat.pl:181 ../tools/virt-tar.pl:276 ../tools/virt-rescue.pl:249 ../tools/virt-make-fs.pl:560 ../tools/virt-list-partitions.pl:248 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 " @@ -16267,7 +16402,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:958 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:203 ../inspector/virt-inspector.pl:870 ../tools/virt-cat.pl:186 ../tools/virt-df.pl:558 ../tools/virt-edit.pl:350 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:253 ../tools/virt-ls.pl:234 ../tools/virt-make-fs.pl:565 ../tools/virt-rescue.pl:254 ../tools/virt-resize.pl:1420 ../tools/virt-tar.pl:281 ../tools/virt-win-reg.pl:500 +#: ../fish/guestfish.pod:981 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:203 ../inspector/virt-inspector.pl:870 ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:500 ../tools/virt-df.pl:558 ../tools/virt-ls.pl:234 ../tools/virt-resize.pl:1420 ../tools/virt-list-filesystems.pl:216 ../tools/virt-cat.pl:186 ../tools/virt-tar.pl:281 ../tools/virt-rescue.pl:254 ../tools/virt-make-fs.pl:565 ../tools/virt-list-partitions.pl:253 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 " @@ -16276,7 +16411,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish.pod:963 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:208 ../inspector/virt-inspector.pl:875 ../tools/virt-cat.pl:191 ../tools/virt-df.pl:563 ../tools/virt-edit.pl:355 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:258 ../tools/virt-ls.pl:239 ../tools/virt-make-fs.pl:570 ../tools/virt-rescue.pl:259 ../tools/virt-resize.pl:1425 ../tools/virt-tar.pl:286 ../tools/virt-win-reg.pl:505 +#: ../fish/guestfish.pod:986 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:208 ../inspector/virt-inspector.pl:875 ../tools/virt-edit.pl:355 ../tools/virt-win-reg.pl:505 ../tools/virt-df.pl:563 ../tools/virt-ls.pl:239 ../tools/virt-resize.pl:1425 ../tools/virt-list-filesystems.pl:221 ../tools/virt-cat.pl:191 ../tools/virt-tar.pl:286 ../tools/virt-rescue.pl:259 ../tools/virt-make-fs.pl:570 ../tools/virt-list-partitions.pl:258 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 " @@ -16721,7 +16856,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:356 ../fish/guestfish-actions.pod:365 ../fish/guestfish-actions.pod:589 ../fish/guestfish-actions.pod:736 ../fish/guestfish-actions.pod:783 ../fish/guestfish-actions.pod:802 ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:3803 ../fish/guestfish-actions.pod:3815 ../fish/guestfish-actions.pod:3826 ../fish/guestfish-actions.pod:3837 ../fish/guestfish-actions.pod:3889 ../fish/guestfish-actions.pod:3898 ../fish/guestfish-actions.pod:3952 ../fish/guestfish-actions.pod:3975 +#: ../fish/guestfish-actions.pod:356 ../fish/guestfish-actions.pod:365 ../fish/guestfish-actions.pod:589 ../fish/guestfish-actions.pod:736 ../fish/guestfish-actions.pod:783 ../fish/guestfish-actions.pod:802 ../fish/guestfish-actions.pod:1179 ../fish/guestfish-actions.pod:3820 ../fish/guestfish-actions.pod:3832 ../fish/guestfish-actions.pod:3843 ../fish/guestfish-actions.pod:3854 ../fish/guestfish-actions.pod:3906 ../fish/guestfish-actions.pod:3915 ../fish/guestfish-actions.pod:3969 ../fish/guestfish-actions.pod:3992 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" @@ -19931,7 +20066,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:2968 +#: ../fish/guestfish-actions.pod:2968 ../fish/guestfish-actions.pod:3061 msgid "See also L</pwrite>." msgstr "" @@ -20053,24 +20188,37 @@ msgstr "" # type: textblock #: ../fish/guestfish-actions.pod:3044 -msgid "See also L</pread>." +msgid "See also L</pread>, L</pwrite-device>." msgstr "" # type: =head2 #: ../fish/guestfish-actions.pod:3049 -msgid "read-file" +msgid "pwrite-device" msgstr "" # type: verbatim #: ../fish/guestfish-actions.pod:3051 #, no-wrap msgid "" +" pwrite-device device content offset\n" +"\n" +msgstr "" + +# type: =head2 +#: ../fish/guestfish-actions.pod:3066 +msgid "read-file" +msgstr "" + +# type: verbatim +#: ../fish/guestfish-actions.pod:3068 +#, no-wrap +msgid "" " read-file path\n" "\n" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3056 +#: ../fish/guestfish-actions.pod:3073 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -20078,12 +20226,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3064 +#: ../fish/guestfish-actions.pod:3081 msgid "read-lines" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3066 +#: ../fish/guestfish-actions.pod:3083 #, no-wrap msgid "" " read-lines path\n" @@ -20091,7 +20239,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3073 +#: ../fish/guestfish-actions.pod:3090 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -20100,12 +20248,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3078 +#: ../fish/guestfish-actions.pod:3095 msgid "readdir" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3080 +#: ../fish/guestfish-actions.pod:3097 #, no-wrap msgid "" " readdir dir\n" @@ -20113,7 +20261,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3132 +#: ../fish/guestfish-actions.pod:3149 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 " @@ -20121,12 +20269,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3136 +#: ../fish/guestfish-actions.pod:3153 msgid "readlink" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3138 +#: ../fish/guestfish-actions.pod:3155 #, no-wrap msgid "" " readlink path\n" @@ -20134,12 +20282,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3142 +#: ../fish/guestfish-actions.pod:3159 msgid "readlinklist" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3144 +#: ../fish/guestfish-actions.pod:3161 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -20147,12 +20295,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3168 +#: ../fish/guestfish-actions.pod:3185 msgid "realpath" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3170 +#: ../fish/guestfish-actions.pod:3187 #, no-wrap msgid "" " realpath path\n" @@ -20160,12 +20308,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3175 +#: ../fish/guestfish-actions.pod:3192 msgid "removexattr" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3177 +#: ../fish/guestfish-actions.pod:3194 #, no-wrap msgid "" " removexattr xattr path\n" @@ -20173,17 +20321,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3182 +#: ../fish/guestfish-actions.pod:3199 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3184 +#: ../fish/guestfish-actions.pod:3201 msgid "resize2fs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3186 +#: ../fish/guestfish-actions.pod:3203 #, no-wrap msgid "" " resize2fs device\n" @@ -20191,7 +20339,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3191 +#: ../fish/guestfish-actions.pod:3208 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 " @@ -20200,12 +20348,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3197 +#: ../fish/guestfish-actions.pod:3214 msgid "resize2fs-size" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3199 +#: ../fish/guestfish-actions.pod:3216 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -20213,19 +20361,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3201 +#: ../fish/guestfish-actions.pod:3218 msgid "" "This command is the same as L</resize2fs> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3204 +#: ../fish/guestfish-actions.pod:3221 msgid "rm" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3206 +#: ../fish/guestfish-actions.pod:3223 #, no-wrap msgid "" " rm path\n" @@ -20233,12 +20381,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3210 +#: ../fish/guestfish-actions.pod:3227 msgid "rm-rf" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3212 +#: ../fish/guestfish-actions.pod:3229 #, no-wrap msgid "" " rm-rf path\n" @@ -20246,12 +20394,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3218 +#: ../fish/guestfish-actions.pod:3235 msgid "rmdir" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3220 +#: ../fish/guestfish-actions.pod:3237 #, no-wrap msgid "" " rmdir path\n" @@ -20259,12 +20407,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3224 +#: ../fish/guestfish-actions.pod:3241 msgid "rmmountpoint" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3226 +#: ../fish/guestfish-actions.pod:3243 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -20272,19 +20420,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3228 +#: ../fish/guestfish-actions.pod:3245 msgid "" "This calls removes a mountpoint that was previously created with " "L</mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3232 +#: ../fish/guestfish-actions.pod:3249 msgid "scrub-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3234 +#: ../fish/guestfish-actions.pod:3251 #, no-wrap msgid "" " scrub-device device\n" @@ -20292,12 +20440,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3245 +#: ../fish/guestfish-actions.pod:3262 msgid "scrub-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3247 +#: ../fish/guestfish-actions.pod:3264 #, no-wrap msgid "" " scrub-file file\n" @@ -20305,12 +20453,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3257 +#: ../fish/guestfish-actions.pod:3274 msgid "scrub-freespace" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3259 +#: ../fish/guestfish-actions.pod:3276 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -20318,7 +20466,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3261 +#: ../fish/guestfish-actions.pod:3278 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 " @@ -20327,17 +20475,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3270 +#: ../fish/guestfish-actions.pod:3287 msgid "set-append" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3272 +#: ../fish/guestfish-actions.pod:3289 msgid "append" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3274 +#: ../fish/guestfish-actions.pod:3291 #, no-wrap msgid "" " set-append append\n" @@ -20345,17 +20493,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3285 +#: ../fish/guestfish-actions.pod:3302 msgid "set-autosync" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3287 +#: ../fish/guestfish-actions.pod:3304 msgid "autosync" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3289 +#: ../fish/guestfish-actions.pod:3306 #, no-wrap msgid "" " set-autosync true|false\n" @@ -20363,7 +20511,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3291 +#: ../fish/guestfish-actions.pod:3308 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to run L</umount-all> followed by L</sync> when the handle is " @@ -20371,17 +20519,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3299 +#: ../fish/guestfish-actions.pod:3316 msgid "set-direct" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3301 +#: ../fish/guestfish-actions.pod:3318 msgid "direct" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3303 +#: ../fish/guestfish-actions.pod:3320 #, no-wrap msgid "" " set-direct true|false\n" @@ -20389,19 +20537,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3309 +#: ../fish/guestfish-actions.pod:3326 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." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3318 +#: ../fish/guestfish-actions.pod:3335 msgid "set-e2label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3320 +#: ../fish/guestfish-actions.pod:3337 #, no-wrap msgid "" " set-e2label device label\n" @@ -20409,19 +20557,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3326 +#: ../fish/guestfish-actions.pod:3343 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3329 +#: ../fish/guestfish-actions.pod:3346 msgid "set-e2uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3331 +#: ../fish/guestfish-actions.pod:3348 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -20429,24 +20577,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3338 +#: ../fish/guestfish-actions.pod:3355 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:3341 +#: ../fish/guestfish-actions.pod:3358 msgid "set-memsize" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3343 +#: ../fish/guestfish-actions.pod:3360 msgid "memsize" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3345 +#: ../fish/guestfish-actions.pod:3362 #, no-wrap msgid "" " set-memsize memsize\n" @@ -20454,24 +20602,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3347 +#: ../fish/guestfish-actions.pod:3364 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:3358 +#: ../fish/guestfish-actions.pod:3375 msgid "set-network" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3360 +#: ../fish/guestfish-actions.pod:3377 msgid "network" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3362 +#: ../fish/guestfish-actions.pod:3379 #, no-wrap msgid "" " set-network true|false\n" @@ -20479,22 +20627,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3370 +#: ../fish/guestfish-actions.pod:3387 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3373 +#: ../fish/guestfish-actions.pod:3390 msgid "set-path" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3375 +#: ../fish/guestfish-actions.pod:3392 msgid "path" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3377 +#: ../fish/guestfish-actions.pod:3394 #, no-wrap msgid "" " set-path searchpath\n" @@ -20502,17 +20650,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3386 +#: ../fish/guestfish-actions.pod:3403 msgid "set-qemu" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3388 +#: ../fish/guestfish-actions.pod:3405 msgid "qemu" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3390 +#: ../fish/guestfish-actions.pod:3407 #, no-wrap msgid "" " set-qemu qemu\n" @@ -20520,17 +20668,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3410 +#: ../fish/guestfish-actions.pod:3427 msgid "set-recovery-proc" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3412 +#: ../fish/guestfish-actions.pod:3429 msgid "recovery-proc" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3431 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -20538,7 +20686,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3416 +#: ../fish/guestfish-actions.pod:3433 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 " @@ -20546,24 +20694,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3421 +#: ../fish/guestfish-actions.pod:3438 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3430 +#: ../fish/guestfish-actions.pod:3447 msgid "set-selinux" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3432 +#: ../fish/guestfish-actions.pod:3449 msgid "selinux" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3434 +#: ../fish/guestfish-actions.pod:3451 #, no-wrap msgid "" " set-selinux true|false\n" @@ -20571,17 +20719,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3445 +#: ../fish/guestfish-actions.pod:3462 msgid "set-trace" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3447 +#: ../fish/guestfish-actions.pod:3464 msgid "trace" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3449 +#: ../fish/guestfish-actions.pod:3466 #, no-wrap msgid "" " set-trace true|false\n" @@ -20589,17 +20737,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3465 +#: ../fish/guestfish-actions.pod:3482 msgid "set-verbose" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3467 +#: ../fish/guestfish-actions.pod:3484 msgid "verbose" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3469 +#: ../fish/guestfish-actions.pod:3486 #, no-wrap msgid "" " set-verbose true|false\n" @@ -20607,12 +20755,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3476 +#: ../fish/guestfish-actions.pod:3493 msgid "setcon" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3478 +#: ../fish/guestfish-actions.pod:3495 #, no-wrap msgid "" " setcon context\n" @@ -20620,12 +20768,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3485 +#: ../fish/guestfish-actions.pod:3502 msgid "setxattr" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3487 +#: ../fish/guestfish-actions.pod:3504 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -20633,17 +20781,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3493 +#: ../fish/guestfish-actions.pod:3510 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3495 +#: ../fish/guestfish-actions.pod:3512 msgid "sfdisk" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3497 +#: ../fish/guestfish-actions.pod:3514 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -20651,17 +20799,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3519 +#: ../fish/guestfish-actions.pod:3536 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3525 +#: ../fish/guestfish-actions.pod:3542 msgid "sfdiskM" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3527 +#: ../fish/guestfish-actions.pod:3544 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -20669,7 +20817,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3529 +#: ../fish/guestfish-actions.pod:3546 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 " @@ -20678,17 +20826,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3535 +#: ../fish/guestfish-actions.pod:3552 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3541 +#: ../fish/guestfish-actions.pod:3558 msgid "sfdisk-N" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3543 +#: ../fish/guestfish-actions.pod:3560 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -20696,24 +20844,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3548 +#: ../fish/guestfish-actions.pod:3565 msgid "" "For other parameters, see L</sfdisk>. You should usually pass C<0> for the " "cyls/heads/sectors parameters." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3551 +#: ../fish/guestfish-actions.pod:3568 msgid "See also: L</part-add>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3556 +#: ../fish/guestfish-actions.pod:3573 msgid "sfdisk-disk-geometry" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3558 +#: ../fish/guestfish-actions.pod:3575 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -20721,7 +20869,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3560 +#: ../fish/guestfish-actions.pod:3577 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, " @@ -20730,12 +20878,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3568 +#: ../fish/guestfish-actions.pod:3585 msgid "sfdisk-kernel-geometry" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3570 +#: ../fish/guestfish-actions.pod:3587 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -20743,12 +20891,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3577 +#: ../fish/guestfish-actions.pod:3594 msgid "sfdisk-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3579 +#: ../fish/guestfish-actions.pod:3596 #, no-wrap msgid "" " sfdisk-l device\n" @@ -20756,17 +20904,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3585 +#: ../fish/guestfish-actions.pod:3602 msgid "See also: L</part-list>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3587 +#: ../fish/guestfish-actions.pod:3604 msgid "sh" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3589 +#: ../fish/guestfish-actions.pod:3606 #, no-wrap msgid "" " sh command\n" @@ -20774,22 +20922,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3594 +#: ../fish/guestfish-actions.pod:3611 msgid "This is like L</command>, but passes the command to:" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3602 +#: ../fish/guestfish-actions.pod:3619 msgid "All the provisos about L</command> apply to this call." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3604 +#: ../fish/guestfish-actions.pod:3621 msgid "sh-lines" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3606 +#: ../fish/guestfish-actions.pod:3623 #, no-wrap msgid "" " sh-lines command\n" @@ -20797,22 +20945,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3608 +#: ../fish/guestfish-actions.pod:3625 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3611 +#: ../fish/guestfish-actions.pod:3628 msgid "See also: L</command-lines>" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3613 +#: ../fish/guestfish-actions.pod:3630 msgid "sleep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3615 +#: ../fish/guestfish-actions.pod:3632 #, no-wrap msgid "" " sleep secs\n" @@ -20820,12 +20968,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3619 +#: ../fish/guestfish-actions.pod:3636 msgid "stat" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3621 +#: ../fish/guestfish-actions.pod:3638 #, no-wrap msgid "" " stat path\n" @@ -20833,12 +20981,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3627 +#: ../fish/guestfish-actions.pod:3644 msgid "statvfs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3629 +#: ../fish/guestfish-actions.pod:3646 #, no-wrap msgid "" " statvfs path\n" @@ -20846,12 +20994,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3637 +#: ../fish/guestfish-actions.pod:3654 msgid "strings" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3639 +#: ../fish/guestfish-actions.pod:3656 #, no-wrap msgid "" " strings path\n" @@ -20859,12 +21007,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3647 +#: ../fish/guestfish-actions.pod:3664 msgid "strings-e" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3649 +#: ../fish/guestfish-actions.pod:3666 #, no-wrap msgid "" " strings-e encoding path\n" @@ -20872,26 +21020,26 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3651 +#: ../fish/guestfish-actions.pod:3668 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>." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3661 +#: ../fish/guestfish-actions.pod:3678 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what L</strings> uses)." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3693 +#: ../fish/guestfish-actions.pod:3710 msgid "swapoff-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3695 +#: ../fish/guestfish-actions.pod:3712 #, no-wrap msgid "" " swapoff-device device\n" @@ -20899,19 +21047,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3697 +#: ../fish/guestfish-actions.pod:3714 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See L</swapon-device>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3701 +#: ../fish/guestfish-actions.pod:3718 msgid "swapoff-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3720 #, no-wrap msgid "" " swapoff-file file\n" @@ -20919,12 +21067,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3707 +#: ../fish/guestfish-actions.pod:3724 msgid "swapoff-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3709 +#: ../fish/guestfish-actions.pod:3726 #, no-wrap msgid "" " swapoff-label label\n" @@ -20932,12 +21080,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3714 +#: ../fish/guestfish-actions.pod:3731 msgid "swapoff-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3716 +#: ../fish/guestfish-actions.pod:3733 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -20945,12 +21093,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3721 +#: ../fish/guestfish-actions.pod:3738 msgid "swapon-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3723 +#: ../fish/guestfish-actions.pod:3740 #, no-wrap msgid "" " swapon-device device\n" @@ -20958,7 +21106,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3725 +#: ../fish/guestfish-actions.pod:3742 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 " @@ -20966,12 +21114,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3737 +#: ../fish/guestfish-actions.pod:3754 msgid "swapon-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3739 +#: ../fish/guestfish-actions.pod:3756 #, no-wrap msgid "" " swapon-file file\n" @@ -20979,17 +21127,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3741 +#: ../fish/guestfish-actions.pod:3758 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3744 +#: ../fish/guestfish-actions.pod:3761 msgid "swapon-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3746 +#: ../fish/guestfish-actions.pod:3763 #, no-wrap msgid "" " swapon-label label\n" @@ -20997,19 +21145,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3748 +#: ../fish/guestfish-actions.pod:3765 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3751 +#: ../fish/guestfish-actions.pod:3768 msgid "swapon-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3753 +#: ../fish/guestfish-actions.pod:3770 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -21017,19 +21165,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3755 +#: ../fish/guestfish-actions.pod:3772 msgid "" "This command enables swap to a swap partition with the given UUID. See " "L</swapon-device> for other notes." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3758 +#: ../fish/guestfish-actions.pod:3775 msgid "sync" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3760 +#: ../fish/guestfish-actions.pod:3777 #, no-wrap msgid "" " sync\n" @@ -21037,12 +21185,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3768 +#: ../fish/guestfish-actions.pod:3785 msgid "tail" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3770 +#: ../fish/guestfish-actions.pod:3787 #, no-wrap msgid "" " tail path\n" @@ -21050,12 +21198,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3778 +#: ../fish/guestfish-actions.pod:3795 msgid "tail-n" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3780 +#: ../fish/guestfish-actions.pod:3797 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -21063,12 +21211,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3793 +#: ../fish/guestfish-actions.pod:3810 msgid "tar-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3795 +#: ../fish/guestfish-actions.pod:3812 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -21076,17 +21224,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3800 +#: ../fish/guestfish-actions.pod:3817 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3805 +#: ../fish/guestfish-actions.pod:3822 msgid "tar-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3807 +#: ../fish/guestfish-actions.pod:3824 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -21094,17 +21242,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3812 +#: ../fish/guestfish-actions.pod:3829 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3817 +#: ../fish/guestfish-actions.pod:3834 msgid "tgz-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3819 +#: ../fish/guestfish-actions.pod:3836 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -21112,17 +21260,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3824 +#: ../fish/guestfish-actions.pod:3841 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3828 +#: ../fish/guestfish-actions.pod:3845 msgid "tgz-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3830 +#: ../fish/guestfish-actions.pod:3847 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -21130,17 +21278,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3835 +#: ../fish/guestfish-actions.pod:3852 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3839 +#: ../fish/guestfish-actions.pod:3856 msgid "touch" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3841 +#: ../fish/guestfish-actions.pod:3858 #, no-wrap msgid "" " touch path\n" @@ -21148,12 +21296,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3850 +#: ../fish/guestfish-actions.pod:3867 msgid "truncate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3852 +#: ../fish/guestfish-actions.pod:3869 #, no-wrap msgid "" " truncate path\n" @@ -21161,12 +21309,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3857 +#: ../fish/guestfish-actions.pod:3874 msgid "truncate-size" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3876 #, no-wrap msgid "" " truncate-size path size\n" @@ -21174,7 +21322,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3864 +#: ../fish/guestfish-actions.pod:3881 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 " @@ -21183,12 +21331,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3870 +#: ../fish/guestfish-actions.pod:3887 msgid "tune2fs-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3872 +#: ../fish/guestfish-actions.pod:3889 #, no-wrap msgid "" " tune2fs-l device\n" @@ -21196,12 +21344,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3882 +#: ../fish/guestfish-actions.pod:3899 msgid "txz-in" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3884 +#: ../fish/guestfish-actions.pod:3901 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -21209,12 +21357,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3891 +#: ../fish/guestfish-actions.pod:3908 msgid "txz-out" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3893 +#: ../fish/guestfish-actions.pod:3910 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -21222,12 +21370,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3900 +#: ../fish/guestfish-actions.pod:3917 msgid "umask" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3902 +#: ../fish/guestfish-actions.pod:3919 #, no-wrap msgid "" " umask mask\n" @@ -21235,22 +21383,22 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3916 +#: ../fish/guestfish-actions.pod:3933 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3921 +#: ../fish/guestfish-actions.pod:3938 msgid "umount" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3923 +#: ../fish/guestfish-actions.pod:3940 msgid "unmount" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3925 +#: ../fish/guestfish-actions.pod:3942 #, no-wrap msgid "" " umount pathordevice\n" @@ -21258,17 +21406,17 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3931 +#: ../fish/guestfish-actions.pod:3948 msgid "umount-all" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3933 +#: ../fish/guestfish-actions.pod:3950 msgid "unmount-all" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3935 +#: ../fish/guestfish-actions.pod:3952 #, no-wrap msgid "" " umount-all\n" @@ -21276,12 +21424,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3941 +#: ../fish/guestfish-actions.pod:3958 msgid "upload" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3943 +#: ../fish/guestfish-actions.pod:3960 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -21289,17 +21437,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3950 +#: ../fish/guestfish-actions.pod:3967 msgid "See also L</download>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3954 +#: ../fish/guestfish-actions.pod:3971 msgid "upload-offset" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3956 +#: ../fish/guestfish-actions.pod:3973 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -21307,7 +21455,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3968 +#: ../fish/guestfish-actions.pod:3985 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 " @@ -21315,17 +21463,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:3973 +#: ../fish/guestfish-actions.pod:3990 msgid "See also L</upload>, L</pwrite>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3977 +#: ../fish/guestfish-actions.pod:3994 msgid "utimens" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:3979 +#: ../fish/guestfish-actions.pod:3996 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -21333,12 +21481,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:3998 +#: ../fish/guestfish-actions.pod:4015 msgid "version" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4000 +#: ../fish/guestfish-actions.pod:4017 #, no-wrap msgid "" " version\n" @@ -21346,7 +21494,7 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4027 +#: ../fish/guestfish-actions.pod:4044 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -21355,12 +21503,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4033 +#: ../fish/guestfish-actions.pod:4050 msgid "vfs-label" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4035 +#: ../fish/guestfish-actions.pod:4052 #, no-wrap msgid "" " vfs-label device\n" @@ -21368,17 +21516,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:4059 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4044 +#: ../fish/guestfish-actions.pod:4061 msgid "vfs-type" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4046 +#: ../fish/guestfish-actions.pod:4063 #, no-wrap msgid "" " vfs-type device\n" @@ -21386,12 +21534,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4056 +#: ../fish/guestfish-actions.pod:4073 msgid "vfs-uuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4058 +#: ../fish/guestfish-actions.pod:4075 #, no-wrap msgid "" " vfs-uuid device\n" @@ -21399,17 +21547,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4065 +#: ../fish/guestfish-actions.pod:4082 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4067 +#: ../fish/guestfish-actions.pod:4084 msgid "vg-activate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4069 +#: ../fish/guestfish-actions.pod:4086 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -21417,12 +21565,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4082 +#: ../fish/guestfish-actions.pod:4099 msgid "vg-activate-all" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4084 +#: ../fish/guestfish-actions.pod:4101 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -21430,12 +21578,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4094 +#: ../fish/guestfish-actions.pod:4111 msgid "vgcreate" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4096 +#: ../fish/guestfish-actions.pod:4113 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -21443,12 +21591,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4101 +#: ../fish/guestfish-actions.pod:4118 msgid "vglvuuids" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4103 +#: ../fish/guestfish-actions.pod:4120 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -21456,24 +21604,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4108 +#: ../fish/guestfish-actions.pod:4125 msgid "" "You can use this along with L</lvs> and L</lvuuid> calls to associate " "logical volumes and volume groups." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4111 +#: ../fish/guestfish-actions.pod:4128 msgid "See also L</vgpvuuids>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4113 +#: ../fish/guestfish-actions.pod:4130 msgid "vgpvuuids" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4115 +#: ../fish/guestfish-actions.pod:4132 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -21481,24 +21629,24 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4120 +#: ../fish/guestfish-actions.pod:4137 msgid "" "You can use this along with L</pvs> and L</pvuuid> calls to associate " "physical volumes and volume groups." msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4123 +#: ../fish/guestfish-actions.pod:4140 msgid "See also L</vglvuuids>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4125 +#: ../fish/guestfish-actions.pod:4142 msgid "vgremove" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4127 +#: ../fish/guestfish-actions.pod:4144 #, no-wrap msgid "" " vgremove vgname\n" @@ -21506,12 +21654,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4134 +#: ../fish/guestfish-actions.pod:4151 msgid "vgrename" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4153 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -21519,12 +21667,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4140 +#: ../fish/guestfish-actions.pod:4157 msgid "vgs" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4142 +#: ../fish/guestfish-actions.pod:4159 #, no-wrap msgid "" " vgs\n" @@ -21532,17 +21680,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4150 +#: ../fish/guestfish-actions.pod:4167 msgid "See also L</vgs-full>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4152 +#: ../fish/guestfish-actions.pod:4169 msgid "vgs-full" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4154 +#: ../fish/guestfish-actions.pod:4171 #, no-wrap msgid "" " vgs-full\n" @@ -21550,12 +21698,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4159 +#: ../fish/guestfish-actions.pod:4176 msgid "vgscan" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4161 +#: ../fish/guestfish-actions.pod:4178 #, no-wrap msgid "" " vgscan\n" @@ -21563,12 +21711,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4166 +#: ../fish/guestfish-actions.pod:4183 msgid "vguuid" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4168 +#: ../fish/guestfish-actions.pod:4185 #, no-wrap msgid "" " vguuid vgname\n" @@ -21576,12 +21724,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4172 +#: ../fish/guestfish-actions.pod:4189 msgid "wc-c" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4174 +#: ../fish/guestfish-actions.pod:4191 #, no-wrap msgid "" " wc-c path\n" @@ -21589,12 +21737,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4179 +#: ../fish/guestfish-actions.pod:4196 msgid "wc-l" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4181 +#: ../fish/guestfish-actions.pod:4198 #, no-wrap msgid "" " wc-l path\n" @@ -21602,12 +21750,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4186 +#: ../fish/guestfish-actions.pod:4203 msgid "wc-w" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4188 +#: ../fish/guestfish-actions.pod:4205 #, no-wrap msgid "" " wc-w path\n" @@ -21615,12 +21763,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4193 +#: ../fish/guestfish-actions.pod:4210 msgid "write" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4195 +#: ../fish/guestfish-actions.pod:4212 #, no-wrap msgid "" " write path content\n" @@ -21628,12 +21776,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4203 +#: ../fish/guestfish-actions.pod:4220 msgid "write-file" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4205 +#: ../fish/guestfish-actions.pod:4222 #, no-wrap msgid "" " write-file path content size\n" @@ -21641,12 +21789,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4228 +#: ../fish/guestfish-actions.pod:4245 msgid "zegrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4230 +#: ../fish/guestfish-actions.pod:4247 #, no-wrap msgid "" " zegrep regex path\n" @@ -21654,12 +21802,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4238 +#: ../fish/guestfish-actions.pod:4255 msgid "zegrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4240 +#: ../fish/guestfish-actions.pod:4257 #, no-wrap msgid "" " zegrepi regex path\n" @@ -21667,12 +21815,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4248 +#: ../fish/guestfish-actions.pod:4265 msgid "zero" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4250 +#: ../fish/guestfish-actions.pod:4267 #, no-wrap msgid "" " zero device\n" @@ -21680,17 +21828,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4258 +#: ../fish/guestfish-actions.pod:4275 msgid "See also: L</zero-device>, L</scrub-device>." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4260 +#: ../fish/guestfish-actions.pod:4277 msgid "zero-device" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4262 +#: ../fish/guestfish-actions.pod:4279 #, no-wrap msgid "" " zero-device device\n" @@ -21698,19 +21846,19 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4264 +#: ../fish/guestfish-actions.pod:4281 msgid "" "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 -#: ../fish/guestfish-actions.pod:4271 +#: ../fish/guestfish-actions.pod:4288 msgid "zerofree" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4273 +#: ../fish/guestfish-actions.pod:4290 #, no-wrap msgid "" " zerofree device\n" @@ -21718,12 +21866,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4286 +#: ../fish/guestfish-actions.pod:4303 msgid "zfgrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4288 +#: ../fish/guestfish-actions.pod:4305 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -21731,12 +21879,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4296 +#: ../fish/guestfish-actions.pod:4313 msgid "zfgrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4298 +#: ../fish/guestfish-actions.pod:4315 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -21744,12 +21892,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4306 +#: ../fish/guestfish-actions.pod:4323 msgid "zfile" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4308 +#: ../fish/guestfish-actions.pod:4325 #, no-wrap msgid "" " zfile meth path\n" @@ -21757,17 +21905,17 @@ msgid "" msgstr "" # type: textblock -#: ../fish/guestfish-actions.pod:4315 +#: ../fish/guestfish-actions.pod:4332 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4325 +#: ../fish/guestfish-actions.pod:4342 msgid "zgrep" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4327 +#: ../fish/guestfish-actions.pod:4344 #, no-wrap msgid "" " zgrep regex path\n" @@ -21775,12 +21923,12 @@ msgid "" msgstr "" # type: =head2 -#: ../fish/guestfish-actions.pod:4335 +#: ../fish/guestfish-actions.pod:4352 msgid "zgrepi" msgstr "" # type: verbatim -#: ../fish/guestfish-actions.pod:4337 +#: ../fish/guestfish-actions.pod:4354 #, no-wrap msgid "" " zgrepi regex path\n" @@ -22874,27 +23022,27 @@ msgid "" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:85 ../tools/virt-cat.pl:90 ../tools/virt-df.pl:81 ../tools/virt-edit.pl:83 ../tools/virt-list-filesystems.pl:60 ../tools/virt-list-partitions.pl:61 ../tools/virt-ls.pl:89 ../tools/virt-make-fs.pl:163 ../tools/virt-rescue.pl:113 ../tools/virt-tar.pl:109 ../tools/virt-win-reg.pl:182 +#: ../inspector/virt-inspector.pl:85 ../tools/virt-edit.pl:83 ../tools/virt-win-reg.pl:182 ../tools/virt-df.pl:81 ../tools/virt-ls.pl:89 ../tools/virt-list-filesystems.pl:60 ../tools/virt-cat.pl:90 ../tools/virt-tar.pl:109 ../tools/virt-rescue.pl:113 ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:61 msgid "Display brief help." msgstr "" # type: =item -#: ../inspector/virt-inspector.pl:91 ../tools/virt-cat.pl:96 ../tools/virt-df.pl:87 ../tools/virt-edit.pl:89 ../tools/virt-list-filesystems.pl:66 ../tools/virt-list-partitions.pl:67 ../tools/virt-ls.pl:95 ../tools/virt-make-fs.pl:169 ../tools/virt-rescue.pl:119 ../tools/virt-resize.pl:249 ../tools/virt-tar.pl:115 ../tools/virt-win-reg.pl:188 +#: ../inspector/virt-inspector.pl:91 ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:188 ../tools/virt-df.pl:87 ../tools/virt-ls.pl:95 ../tools/virt-resize.pl:249 ../tools/virt-list-filesystems.pl:66 ../tools/virt-cat.pl:96 ../tools/virt-tar.pl:115 ../tools/virt-rescue.pl:119 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:67 msgid "B<--version>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:93 ../tools/virt-cat.pl:98 ../tools/virt-df.pl:89 ../tools/virt-edit.pl:91 ../tools/virt-list-filesystems.pl:68 ../tools/virt-list-partitions.pl:69 ../tools/virt-ls.pl:97 ../tools/virt-make-fs.pl:171 ../tools/virt-rescue.pl:121 ../tools/virt-resize.pl:251 ../tools/virt-tar.pl:117 ../tools/virt-win-reg.pl:190 +#: ../inspector/virt-inspector.pl:93 ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:190 ../tools/virt-df.pl:89 ../tools/virt-ls.pl:97 ../tools/virt-resize.pl:251 ../tools/virt-list-filesystems.pl:68 ../tools/virt-cat.pl:98 ../tools/virt-tar.pl:117 ../tools/virt-rescue.pl:121 ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:69 msgid "Display version number and exit." msgstr "" # type: =item -#: ../inspector/virt-inspector.pl:99 ../tools/virt-cat.pl:104 ../tools/virt-df.pl:95 ../tools/virt-edit.pl:113 ../tools/virt-list-filesystems.pl:74 ../tools/virt-list-partitions.pl:75 ../tools/virt-ls.pl:103 ../tools/virt-rescue.pl:135 ../tools/virt-tar.pl:123 ../tools/virt-win-reg.pl:204 +#: ../inspector/virt-inspector.pl:99 ../tools/virt-edit.pl:113 ../tools/virt-win-reg.pl:204 ../tools/virt-df.pl:95 ../tools/virt-ls.pl:103 ../tools/virt-list-filesystems.pl:74 ../tools/virt-cat.pl:104 ../tools/virt-tar.pl:123 ../tools/virt-rescue.pl:135 ../tools/virt-list-partitions.pl:75 msgid "B<--connect URI> | B<-c URI>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:101 ../tools/virt-cat.pl:106 ../tools/virt-df.pl:97 ../tools/virt-edit.pl:115 ../tools/virt-list-filesystems.pl:76 ../tools/virt-list-partitions.pl:77 ../tools/virt-ls.pl:105 ../tools/virt-rescue.pl:137 ../tools/virt-tar.pl:125 ../tools/virt-win-reg.pl:206 +#: ../inspector/virt-inspector.pl:101 ../tools/virt-edit.pl:115 ../tools/virt-win-reg.pl:206 ../tools/virt-df.pl:97 ../tools/virt-ls.pl:105 ../tools/virt-list-filesystems.pl:76 ../tools/virt-cat.pl:106 ../tools/virt-tar.pl:125 ../tools/virt-rescue.pl:137 ../tools/virt-list-partitions.pl:77 msgid "" "If using libvirt, connect to the given I<URI>. If omitted, then we connect " "to the default libvirt hypervisor." @@ -23288,7 +23436,7 @@ msgid "" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:857 ../tools/virt-cat.pl:175 ../tools/virt-df.pl:547 ../tools/virt-edit.pl:339 ../tools/virt-list-filesystems.pl:205 ../tools/virt-list-partitions.pl:242 ../tools/virt-ls.pl:223 ../tools/virt-make-fs.pl:554 ../tools/virt-rescue.pl:243 ../tools/virt-resize.pl:1409 ../tools/virt-tar.pl:270 ../tools/virt-win-reg.pl:489 +#: ../inspector/virt-inspector.pl:857 ../tools/virt-edit.pl:339 ../tools/virt-win-reg.pl:489 ../tools/virt-df.pl:547 ../tools/virt-ls.pl:223 ../tools/virt-resize.pl:1409 ../tools/virt-list-filesystems.pl:205 ../tools/virt-cat.pl:175 ../tools/virt-tar.pl:270 ../tools/virt-rescue.pl:243 ../tools/virt-make-fs.pl:554 ../tools/virt-list-partitions.pl:242 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" @@ -23298,355 +23446,11 @@ msgid "Matthew Booth L<mbooth@redhat.com>" msgstr "" # type: textblock -#: ../inspector/virt-inspector.pl:863 ../tools/virt-cat.pl:179 ../tools/virt-list-filesystems.pl:209 ../tools/virt-ls.pl:227 ../tools/virt-tar.pl:274 +#: ../inspector/virt-inspector.pl:863 ../tools/virt-ls.pl:227 ../tools/virt-list-filesystems.pl:209 ../tools/virt-cat.pl:179 ../tools/virt-tar.pl:274 msgid "Copyright (C) 2009 Red Hat Inc." msgstr "" # type: textblock -#: ../tools/virt-cat.pl:34 -msgid "virt-cat - Display a file in a virtual machine" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:38 -#, no-wrap -msgid "" -" virt-cat [--options] domname file\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:40 -#, no-wrap -msgid "" -" virt-cat [--options] disk.img [disk.img ...] file\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:44 -msgid "" -"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 -#: ../tools/virt-cat.pl:47 -msgid "" -"C<virt-cat> can be used to quickly view a single file. To edit a file, use " -"C<virt-edit>. For more complex cases you should look at the L<guestfish(1)> " -"tool." -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:53 -msgid "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:56 -#, no-wrap -msgid "" -" virt-cat mydomain /etc/fstab\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:58 -msgid "List syslog messages from a VM:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:60 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/messages | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:62 -msgid "Find out what DHCP IP address a VM acquired:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:64 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/messages | grep 'dhclient: bound to' | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:66 -msgid "Find out what packages were recently installed:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:68 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/yum.log | tail\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:70 -msgid "Find out who is logged on inside a virtual machine:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:72 -#, no-wrap -msgid "" -" virt-cat mydomain /var/run/utmp > /tmp/utmp\n" -" who /tmp/utmp\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:75 -msgid "or who was logged on:" -msgstr "" - -# type: verbatim -#: ../tools/virt-cat.pl:77 -#, no-wrap -msgid "" -" virt-cat mydomain /var/log/wtmp > /tmp/wtmp\n" -" last -f /tmp/wtmp\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:109 ../tools/virt-df.pl:100 ../tools/virt-edit.pl:118 ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 ../tools/virt-ls.pl:108 ../tools/virt-rescue.pl:140 ../tools/virt-tar.pl:128 ../tools/virt-win-reg.pl:209 -msgid "" -"If you specify guest block devices directly, then libvirt is not used at " -"all." -msgstr "" - -# type: textblock -#: ../tools/virt-cat.pl:165 -msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-edit(1)>, L<Sys::Guestfs(3)>, " -"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." -msgstr "" - -# type: =head1 -#: ../tools/virt-cat.pl:173 ../tools/virt-df.pl:545 ../tools/virt-edit.pl:337 ../tools/virt-list-filesystems.pl:203 ../tools/virt-list-partitions.pl:240 ../tools/virt-ls.pl:221 ../tools/virt-make-fs.pl:552 ../tools/virt-rescue.pl:241 ../tools/virt-resize.pl:1407 ../tools/virt-tar.pl:268 ../tools/virt-win-reg.pl:487 -msgid "AUTHOR" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:36 -msgid "virt-df - Display free space on virtual filesystems" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:40 -#, no-wrap -msgid "" -" virt-df [--options]\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:42 -#, no-wrap -msgid "" -" virt-df [--options] domname\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:44 -#, no-wrap -msgid "" -" virt-df [--options] disk.img [disk.img ...]\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:48 -msgid "" -"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 amount of " -"space allocated to a virtual machine, but can look inside the virtual " -"machine to see how much space is really being used." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:53 -msgid "" -"It is like the L<df(1)> command, but for virtual machines, except that it " -"also works for Windows virtual machines." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:56 -msgid "" -"If used without any 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 -#: ../tools/virt-df.pl:60 -msgid "" -"If used with any argument(s), 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 -#: ../tools/virt-df.pl:67 -msgid "" -"Use the C<--csv> option to get a format which can be easily parsed by other " -"programs. Other options are mostly similar to standard C<df> options. See " -"below for the complete list." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:107 -msgid "B<--csv>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:109 -msgid "" -"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: =item -#: ../tools/virt-df.pl:117 -msgid "B<--human-readable> | B<-h>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:119 -msgid "Print sizes in human-readable format." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:121 -msgid "You are not allowed to use I<-h> and I<--csv> at the same time." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:127 -msgid "B<--inodes> | B<-i>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:129 -msgid "Print inodes instead of blocks." -msgstr "" - -# type: =item -#: ../tools/virt-df.pl:135 -msgid "B<--one-per-guest>" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:137 -msgid "" -"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 -#: ../tools/virt-df.pl:140 -msgid "You might use this option in the following circumstances:" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:146 -msgid "" -"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 -#: ../tools/virt-df.pl:152 -msgid "" -"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: =head1 -#: ../tools/virt-df.pl:512 -msgid "NOTE ABOUT CSV FORMAT" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:514 -msgid "" -"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 -#: ../tools/virt-df.pl:517 -msgid "" -"Myth: Just split fields at commas. Reality: This does I<not> work " -"reliably. This example has two columns:" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:520 -#, no-wrap -msgid "" -" \"foo,bar\",baz\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:522 -msgid "" -"Myth: Read the file one line at a time. Reality: This does I<not> work " -"reliably. This example has one row:" -msgstr "" - -# type: verbatim -#: ../tools/virt-df.pl:525 -#, no-wrap -msgid "" -" \"foo\n" -" bar\",baz\n" -"\n" -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:528 -msgid "" -"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " -"packaged in major Linux distributions)." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:531 -msgid "" -"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " -"or Python's built-in csv library)." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:534 -msgid "Most spreadsheets and databases can import CSV directly." -msgstr "" - -# type: textblock -#: ../tools/virt-df.pl:551 ../tools/virt-edit.pl:343 ../tools/virt-list-partitions.pl:246 ../tools/virt-rescue.pl:247 -msgid "Copyright (C) 2009-2010 Red Hat Inc." -msgstr "" - -# type: textblock #: ../tools/virt-edit.pl:35 msgid "virt-edit - Edit a file in a virtual machine" msgstr "" @@ -23765,6 +23569,13 @@ msgstr "" msgid "By default, no backup file is made." msgstr "" +# type: textblock +#: ../tools/virt-edit.pl:118 ../tools/virt-win-reg.pl:209 ../tools/virt-df.pl:100 ../tools/virt-ls.pl:108 ../tools/virt-list-filesystems.pl:79 ../tools/virt-cat.pl:109 ../tools/virt-tar.pl:128 ../tools/virt-rescue.pl:140 ../tools/virt-list-partitions.pl:80 +msgid "" +"If you specify guest block devices directly, then libvirt is not used at " +"all." +msgstr "" + # type: =item #: ../tools/virt-edit.pl:125 msgid "B<--expr EXPR> | B<-e EXPR>" @@ -23950,922 +23761,754 @@ msgid "" "L<perl(1)>, L<perlre(1)>." 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-list-filesystems.pl:36 -#, no-wrap -msgid "" -" virt-list-filesystems [--options] domname\n" -"\n" -msgstr "" - -# type: verbatim -#: ../tools/virt-list-filesystems.pl:38 -#, no-wrap -msgid "" -" virt-list-filesystems [--options] disk.img [disk.img ...]\n" -"\n" +# type: =head1 +#: ../tools/virt-edit.pl:337 ../tools/virt-win-reg.pl:487 ../tools/virt-df.pl:545 ../tools/virt-ls.pl:221 ../tools/virt-resize.pl:1407 ../tools/virt-list-filesystems.pl:203 ../tools/virt-cat.pl:173 ../tools/virt-tar.pl:268 ../tools/virt-rescue.pl:241 ../tools/virt-make-fs.pl:552 ../tools/virt-list-partitions.pl:240 +msgid "AUTHOR" msgstr "" # type: textblock -#: ../tools/virt-list-filesystems.pl:42 -msgid "" -"C<virt-list-filesystems> is a command line tool to list the filesystems that " -"are contained in a virtual machine or disk image." +#: ../tools/virt-edit.pl:343 ../tools/virt-df.pl:551 ../tools/virt-rescue.pl:247 ../tools/virt-list-partitions.pl:246 +msgid "Copyright (C) 2009-2010 Red Hat Inc." msgstr "" # type: textblock -#: ../tools/virt-list-filesystems.pl:46 +#: ../tools/virt-win-reg.pl:38 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." -msgstr "" - -# type: =item -#: ../tools/virt-list-filesystems.pl:86 ../tools/virt-list-partitions.pl:95 ../tools/virt-ls.pl:115 -msgid "B<-l> | B<--long>" +"virt-win-reg - Export and merge Windows Registry entries from a Windows " +"guest" msgstr "" -# type: textblock -#: ../tools/virt-list-filesystems.pl:88 +# type: verbatim +#: ../tools/virt-win-reg.pl:42 +#, no-wrap msgid "" -"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:95 -msgid "B<-a> | B<--all>" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" +"\n" msgstr "" -# type: textblock -#: ../tools/virt-list-filesystems.pl:97 +# type: verbatim +#: ../tools/virt-win-reg.pl:44 +#, no-wrap msgid "" -"Normally we only show mountable filesystems. If this option is given then " -"swap devices are shown too." +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" +"\n" msgstr "" -# type: textblock -#: ../tools/virt-list-filesystems.pl:193 +# type: verbatim +#: ../tools/virt-win-reg.pl:46 +#, no-wrap msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(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-list-partitions.pl:32 -msgid "virt-list-partitions - List partitions in a virtual machine or disk image" +" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-list-partitions.pl:36 +#: ../tools/virt-win-reg.pl:48 #, no-wrap msgid "" -" virt-list-partitions [--options] domname\n" +" virt-win-reg --merge domname [input.reg ...]\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-list-partitions.pl:38 +#: ../tools/virt-win-reg.pl:50 #, no-wrap msgid "" -" virt-list-partitions [--options] disk.img [disk.img ...]\n" +" virt-win-reg [--options] disk.img ... # instead of domname\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:42 +#: ../tools/virt-win-reg.pl:54 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)>." +"You must I<not> use C<virt-win-reg> with the C<--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-list-partitions.pl:47 +#: ../tools/virt-win-reg.pl:59 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." -msgstr "" - -# type: =item -#: ../tools/virt-list-partitions.pl:87 -msgid "B<-h> | B<--human-readable>" -msgstr "" - -# type: textblock -#: ../tools/virt-list-partitions.pl:89 -msgid "Show sizes in human-readable form (eg. \"1G\")." +"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 C<--merge> option, make sure " +"you have a reliable backup first." msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:97 +#: ../tools/virt-win-reg.pl:66 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-list-partitions.pl:104 -msgid "B<-t> | B<--total>" -msgstr "" - -# type: textblock -#: ../tools/virt-list-partitions.pl:106 -msgid "Display the total size of each block device (as a separate row or rows)." +"This program can export and merge Windows Registry entries from a Windows " +"guest." msgstr "" # type: textblock -#: ../tools/virt-list-partitions.pl:231 +#: ../tools/virt-win-reg.pl:69 msgid "" -"L<guestfs(3)>, L<guestfish(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/>." +"The first parameter is the libvirt guest name or the raw disk image of a " +"Windows guest." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:35 -msgid "virt-ls - List files in a virtual machine" -msgstr "" - -# type: verbatim -#: ../tools/virt-ls.pl:39 -#, no-wrap +#: ../tools/virt-win-reg.pl:72 msgid "" -" virt-ls [--options] domname directory\n" -"\n" +"If C<--merge> is I<not> specified, then the chosen registry key is " +"displayed/exported (recursively). For example:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:41 +#: ../tools/virt-win-reg.pl:75 #, no-wrap msgid "" -" virt-ls [--options] disk.img [disk.img ...] directory\n" +" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:45 -msgid "" -"C<virt-ls> is a command line tool to list the names of files in a directory " -"inside a virtual machine or disk image." -msgstr "" - -# type: textblock -#: ../tools/virt-ls.pl:48 -msgid "" -"C<virt-ls> 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-ls.pl:52 -msgid "" -"C<virt-ls> can be used in one of three modes: simple, long and recursive. A " -"simple listing is like the ordinary L<ls(1)> command:" +#: ../tools/virt-win-reg.pl:77 +msgid "You can also display single values from within registry keys, for example:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:55 +#: ../tools/virt-win-reg.pl:80 #, no-wrap msgid "" -" $ virt-ls myguest /\n" -" bin\n" -" boot\n" -" [etc.]\n" +" $ 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-ls.pl:60 -msgid "With the C<-l> (C<--long>) option, C<virt-ls> shows more detail:" +#: ../tools/virt-win-reg.pl:84 +msgid "" +"With C<--merge>, you can merge a textual regedit file into the Windows " +"Registry:" msgstr "" # type: verbatim -#: ../tools/virt-ls.pl:62 +#: ../tools/virt-win-reg.pl:87 #, no-wrap msgid "" -" $ virt-ls -l myguest /\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" +" $ virt-win-reg --merge Windows7 changes.reg\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-ls.pl:68 -msgid "" -"With the C<-R> (C<--recursive>) option, C<virt-ls> lists the names of files " -"and directories recursively:" +# type: =head2 +#: ../tools/virt-win-reg.pl:89 +msgid "SUPPORTED SYSTEMS" msgstr "" -# type: verbatim -#: ../tools/virt-ls.pl:71 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:91 msgid "" -" $ virt-ls -R myguest /tmp\n" -" foo\n" -" foo/bar\n" -" [etc.]\n" -"\n" +"The program currently supports Windows NT-derived guests starting with " +"Windows XP through to at least Windows 7." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:76 +#: ../tools/virt-win-reg.pl:94 msgid "" -"You I<cannot> combine these options. To do more complicated things, use " -"L<guestfish(1)>." -msgstr "" - -# type: =item -#: ../tools/virt-ls.pl:117 -msgid "B<-R> | B<--recursive>" +"Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, " +"C<HKEY_LOCAL_MACHINE\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, " +"C<HKEY_LOCAL_MACHINE\\SYSTEM> and C<HKEY_USERS\\.DEFAULT>." msgstr "" # type: textblock -#: ../tools/virt-ls.pl:119 +#: ../tools/virt-win-reg.pl:98 msgid "" -"Select the mode. With neither of these options, C<virt-ls> produces a " -"simple, flat list of the files in the named directory." +"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-ls.pl:122 +#: ../tools/virt-win-reg.pl:101 msgid "" -"C<virt-ls -l> produces a \"long listing\", which shows more detail (just " -"like the plain C<ls -l> command)." +"C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this " +"time." +msgstr "" + +# type: =head2 +#: ../tools/virt-win-reg.pl:104 +msgid "NOTE" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:125 +#: ../tools/virt-win-reg.pl:106 msgid "" -"C<virt-ls -R> produces a recursive list of files starting at the named " -"directory. See the documentation for the C<guestfs_find> command " -"L<guestfs(3)> for precise details." +"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: textblock -#: ../tools/virt-ls.pl:129 -msgid "You cannot combine these options." +# type: =head2 +#: ../tools/virt-win-reg.pl:112 +msgid "ENCODING" msgstr "" # type: textblock -#: ../tools/virt-ls.pl:212 +#: ../tools/virt-win-reg.pl:114 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, " -"L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, " -"L<http://libguestfs.org/>." +"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-make-fs.pl:37 -msgid "virt-make-fs - Make a filesystem from a tar archive or files" +#: ../tools/virt-win-reg.pl:120 +msgid "" +"To reencode a file from Windows format to Linux (before processing it with " +"the C<--merge> option), you would do something like this:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:41 +#: ../tools/virt-win-reg.pl:123 #, no-wrap msgid "" -" virt-make-fs [--options] input.tar output.img\n" +" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" "\n" msgstr "" -# type: verbatim -#: ../tools/virt-make-fs.pl:43 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:125 msgid "" -" virt-make-fs [--options] input.tar.gz output.img\n" -"\n" +"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-make-fs.pl:45 +#: ../tools/virt-win-reg.pl:128 #, no-wrap msgid "" -" virt-make-fs [--options] directory output.img\n" +" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:49 -msgid "" -"Virt-make-fs is a command line tool for creating a filesystem from a tar " -"archive or some files in a directory. It is similar to tools like " -"L<mkisofs(1)>, L<genisoimage(1)> and L<mksquashfs(1)>. Unlike those tools, " -"it can create common filesystem types like ext2/3 or NTFS, which can be " -"useful if you want to attach these filesystems to existing virtual machines " -"(eg. to import large amounts of read-only data to a VM)." +#: ../tools/virt-win-reg.pl:130 +msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:57 -msgid "Basic usage is:" +#: ../tools/virt-win-reg.pl:132 +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-make-fs.pl:59 +#: ../tools/virt-win-reg.pl:136 #, no-wrap msgid "" -" virt-make-fs input output\n" +" $ 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-make-fs.pl:61 -msgid "" -"where C<input> is either a directory containing files that you want to add, " -"or a tar archive (either uncompressed tar or gzip-compressed tar); and " -"C<output> is a disk image. The input type is detected automatically. The " -"output disk image defaults to a raw ext2 image unless you specify extra " -"flags (see L</OPTIONS> below)." +#: ../tools/virt-win-reg.pl:140 +msgid "This file would need conversion before you could C<--merge> it." msgstr "" # type: =head2 -#: ../tools/virt-make-fs.pl:67 -msgid "EXTRA SPACE" +#: ../tools/virt-win-reg.pl:142 +msgid "SHELL QUOTING" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:69 +#: ../tools/virt-win-reg.pl:144 msgid "" -"Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" " -"the files that it contains, but might have extra space. Depending on how " -"you are going to use the output, you might think this extra space is wasted " -"and want to minimize it, or you might want to leave space so that more files " -"can be added later. Virt-make-fs defaults to minimizing the extra space, " -"but you can use the C<--size> flag to leave space in the filesystem if you " -"want it." +"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-make-fs.pl:77 -msgid "" -"An alternative way to leave extra space but not make the output image any " -"bigger is to use an alternative disk image format (instead of the default " -"\"raw\" format). Using C<--format=qcow2> will use the native QEmu/KVM qcow2 " -"image format (check your hypervisor supports this before using it). This " -"allows you to choose a large C<--size> but the extra space won't actually be " -"allocated in the image until you try to store something in it." +#: ../tools/virt-win-reg.pl:148 +msgid "Paths and value names are case-insensitive." +msgstr "" + +# type: =head2 +#: ../tools/virt-win-reg.pl:150 +msgid "CurrentControlSet etc." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:85 +#: ../tools/virt-win-reg.pl:152 msgid "" -"Don't forget that you can also use local commands including L<resize2fs(8)> " -"and L<virt-resize(1)> to resize existing filesystems, or rerun " -"virt-make-resize to build another image from scratch." +"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: =head3 -#: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 ../tools/virt-make-fs.pl:142 -msgid "EXAMPLE" +# type: textblock +#: ../tools/virt-win-reg.pl:156 +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-make-fs.pl:91 +#: ../tools/virt-win-reg.pl:160 #, no-wrap msgid "" -" virt-make-fs --format=qcow2 --size=+200M input output.img\n" +" # 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: =head2 -#: ../tools/virt-make-fs.pl:93 -msgid "FILESYSTEM TYPE" +# type: textblock +#: ../tools/virt-win-reg.pl:167 +msgid "\"Default\" is the one which Windows will choose when it boots." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:95 -msgid "" -"The default filesystem type is C<ext2>. Just about any filesystem type that " -"libguestfs supports can be used (but I<not> read-only formats like " -"ISO9660). Here are some of the more common choices:" +#: ../tools/virt-win-reg.pl:169 +msgid "Similarly, other C<Current...> keys in the path may need to be replaced." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:101 -msgid "I<ext3>" +#: ../tools/virt-win-reg.pl:196 ../tools/virt-make-fs.pl:177 +msgid "B<--debug>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:103 -msgid "" -"Note that ext3 filesystems contain a journal, typically 1-32 MB in size. If " -"you are not going to use the filesystem in a way that requires the journal, " -"then this is just wasted overhead." +#: ../tools/virt-win-reg.pl:198 ../tools/virt-resize.pl:477 +msgid "Enable debugging messages." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:107 -msgid "I<ntfs> or I<vfat>" +#: ../tools/virt-win-reg.pl:216 +msgid "B<--merge>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:109 -msgid "Useful if exporting data to a Windows guest." +#: ../tools/virt-win-reg.pl:218 +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-make-fs.pl:111 +#: ../tools/virt-win-reg.pl:222 msgid "" -"I<Note for vfat>: The tar archive or local directory must only contain files " -"which are owned by root (ie. UID:GID = 0:0). The reason is that the tar " -"program running within libguestfs is unable to change the ownership of " -"non-root files, since vfat itself does not support this." +"Note that C<--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-make-fs.pl:116 -msgid "I<minix>" +#: ../tools/virt-win-reg.pl:230 +msgid "B<--encoding> UTF-16LE|ASCII" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:118 +#: ../tools/virt-win-reg.pl:232 msgid "" -"Lower overhead than C<ext2>, but certain limitations on filename length and " -"total filesystem size." +"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: verbatim -#: ../tools/virt-make-fs.pl:125 -#, no-wrap +# type: textblock +#: ../tools/virt-win-reg.pl:236 msgid "" -" virt-make-fs --type=minix input minixfs.img\n" -"\n" +"The default is to use UTF-16LE, which should work with recent versions of " +"Windows." msgstr "" -# type: =head2 -#: ../tools/virt-make-fs.pl:127 -msgid "TO PARTITION OR NOT TO PARTITION" +# type: textblock +#: ../tools/virt-win-reg.pl:463 +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: textblock -#: ../tools/virt-make-fs.pl:129 -msgid "Optionally virt-make-fs can add a partition table to the output disk." +#: ../tools/virt-win-reg.pl:478 ../tools/virt-make-fs.pl:543 +msgid "" +"When reporting bugs, please enable debugging and capture the I<complete> " +"output:" msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:131 +# type: verbatim +#: ../tools/virt-win-reg.pl:481 +#, no-wrap msgid "" -"Adding a partition can make the disk image more compatible with certain " -"virtualized operating systems which don't expect to see a filesystem " -"directly located on a block device (Linux doesn't care and will happily " -"handle both types)." +" export LIBGUESTFS_DEBUG=1\n" +" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:136 +#: ../tools/virt-win-reg.pl:484 msgid "" -"On the other hand, if you have a partition table then the output image is no " -"longer a straight filesystem. For example you cannot run L<fsck(8)> " -"directly on a partitioned disk image. (However libguestfs tools such as " -"L<guestfish(1)> and L<virt-resize(1)> can still be used)." +"Attach /tmp/virt-win-reg.log to a new bug report at " +"L<https://bugzilla.redhat.com/>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:144 -msgid "Add an MBR partition:" +#: ../tools/virt-win-reg.pl:493 ../tools/virt-resize.pl:1413 ../tools/virt-make-fs.pl:558 +msgid "Copyright (C) 2010 Red Hat Inc." +msgstr "" + +# type: textblock +#: ../tools/virt-df.pl:36 +msgid "virt-df - Display free space on virtual filesystems" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:146 +#: ../tools/virt-df.pl:40 #, no-wrap msgid "" -" virt-make-fs --partition -- input disk.img\n" +" virt-df [--options]\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:148 +# type: verbatim +#: ../tools/virt-df.pl:42 +#, no-wrap msgid "" -"If the output disk image could be terabyte-sized or larger, it's better to " -"use an EFI/GPT-compatible partition table:" +" virt-df [--options] domname\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:151 +#: ../tools/virt-df.pl:44 #, no-wrap msgid "" -" virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n" +" virt-df [--options] disk.img [disk.img ...]\n" "\n" msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:177 ../tools/virt-win-reg.pl:196 -msgid "B<--debug>" -msgstr "" - -# type: textblock -#: ../tools/virt-make-fs.pl:179 -msgid "Enable debugging information." -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:185 -msgid "B<--size=E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:187 -msgid "B<--size=+E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:189 -msgid "B<-s E<lt>NE<gt>>" -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:191 -msgid "B<-s +E<lt>NE<gt>>" -msgstr "" - # type: textblock -#: ../tools/virt-make-fs.pl:193 -msgid "Use the C<--size> (or C<-s>) option to choose the size of the output image." +#: ../tools/virt-df.pl:48 +msgid "" +"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 amount of " +"space allocated to a virtual machine, but can look inside the virtual " +"machine to see how much space is really being used." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:196 +#: ../tools/virt-df.pl:53 msgid "" -"If this option is I<not> given, then the output image will be just large " -"enough to contain all the files, with not much wasted space." +"It is like the L<df(1)> command, but for virtual machines, except that it " +"also works for Windows virtual machines." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:199 +#: ../tools/virt-df.pl:56 msgid "" -"To choose a fixed size output disk, specify an absolute number followed by " -"b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " -"Petabytes or Exabytes. This must be large enough to contain all the input " -"files, else you will get an error." +"If used without any 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 -#: ../tools/virt-make-fs.pl:204 +#: ../tools/virt-df.pl:60 msgid "" -"To leave extra space, specify C<+> (plus sign) and a number followed by " -"b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " -"Petabytes or Exabytes. For example: C<--size=+200M> means enough space for " -"the input files, and (approximately) an extra 200 MB free space." +"If used with any argument(s), 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 -#: ../tools/virt-make-fs.pl:210 +#: ../tools/virt-df.pl:67 msgid "" -"Note that virt-make-fs estimates free space, and therefore will not produce " -"filesystems containing precisely the free space requested. (It is much more " -"expensive and time-consuming to produce a filesystem which has precisely the " -"desired free space)." -msgstr "" - -# type: =item -#: ../tools/virt-make-fs.pl:219 -msgid "B<--format=E<lt>fmtE<gt>>" +"Use the C<--csv> option to get a format which can be easily parsed by other " +"programs. Other options are mostly similar to standard C<df> options. See " +"below for the complete list." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:221 -msgid "B<-F E<lt>fmtE<gt>>" +#: ../tools/virt-df.pl:107 +msgid "B<--csv>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:223 -msgid "Choose the output disk image format." +#: ../tools/virt-df.pl:109 +msgid "" +"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 -#: ../tools/virt-make-fs.pl:225 -msgid "The default is C<raw> (raw disk image)." +# type: =item +#: ../tools/virt-df.pl:117 +msgid "B<--human-readable> | B<-h>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:227 -msgid "" -"For other choices, see the L<qemu-img(1)> manpage. The only other choice " -"that would really make sense here is C<qcow2>." +#: ../tools/virt-df.pl:119 +msgid "Print sizes in human-readable format." msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:234 -msgid "B<--type=E<lt>fsE<gt>>" +# type: textblock +#: ../tools/virt-df.pl:121 +msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" # type: =item -#: ../tools/virt-make-fs.pl:236 -msgid "B<-t E<lt>fsE<gt>>" +#: ../tools/virt-df.pl:127 +msgid "B<--inodes> | B<-i>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:238 -msgid "Choose the output filesystem type." +#: ../tools/virt-df.pl:129 +msgid "Print inodes instead of blocks." msgstr "" -# type: textblock -#: ../tools/virt-make-fs.pl:240 -msgid "The default is C<ext2>." +# type: =item +#: ../tools/virt-df.pl:135 +msgid "B<--one-per-guest>" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:242 -msgid "Any filesystem which is supported read-write by libguestfs can be used here." +#: ../tools/virt-df.pl:137 +msgid "" +"Run one libguestfs appliance per guest. Normally C<virt-df> will add the " +"disks from several guests to a single libguestfs appliance." msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:249 -msgid "B<--partition>" +# type: textblock +#: ../tools/virt-df.pl:140 +msgid "You might use this option in the following circumstances:" msgstr "" -# type: =item -#: ../tools/virt-make-fs.pl:251 -msgid "B<--partition=E<lt>parttypeE<gt>>" +# type: textblock +#: ../tools/virt-df.pl:146 +msgid "" +"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 -#: ../tools/virt-make-fs.pl:253 +#: ../tools/virt-df.pl:152 msgid "" -"If specified, this flag adds an MBR partition table to the output disk " -"image." +"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: =head1 +#: ../tools/virt-df.pl:512 +msgid "NOTE ABOUT CSV FORMAT" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:256 +#: ../tools/virt-df.pl:514 msgid "" -"You can change the partition table type, eg. C<--partition=gpt> for large " -"disks." +"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 -#: ../tools/virt-make-fs.pl:259 +#: ../tools/virt-df.pl:517 msgid "" -"Note that if you just use a lonesome C<--partition>, the Perl option parser " -"might consider the next parameter to be the partition type. For example:" +"Myth: Just split fields at commas. Reality: This does I<not> work " +"reliably. This example has two columns:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:263 +#: ../tools/virt-df.pl:520 #, no-wrap msgid "" -" virt-make-fs --partition input.tar ...\n" +" \"foo,bar\",baz\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:265 +#: ../tools/virt-df.pl:522 msgid "" -"would cause virt-make-fs to think you wanted to use a partition type of " -"C<input.tar> which is completely wrong. To avoid this, use C<--> (a double " -"dash) between options and the input file argument:" +"Myth: Read the file one line at a time. Reality: This does I<not> work " +"reliably. This example has one row:" msgstr "" # type: verbatim -#: ../tools/virt-make-fs.pl:269 +#: ../tools/virt-df.pl:525 #, no-wrap msgid "" -" virt-make-fs --partition -- input.tar ...\n" +" \"foo\n" +" bar\",baz\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:529 -msgid "" -"L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, " -"L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, " -"L<guestfs(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>." -msgstr "" - -# type: textblock -#: ../tools/virt-make-fs.pl:543 ../tools/virt-win-reg.pl:478 -msgid "" -"When reporting bugs, please enable debugging and capture the I<complete> " -"output:" -msgstr "" - -# type: verbatim -#: ../tools/virt-make-fs.pl:546 -#, no-wrap +#: ../tools/virt-df.pl:528 msgid "" -" export LIBGUESTFS_DEBUG=1\n" -" virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n" -"\n" +"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also " +"packaged in major Linux distributions)." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:549 +#: ../tools/virt-df.pl:531 msgid "" -"Attach /tmp/virt-make-fs.log to a new bug report at " -"L<https://bugzilla.redhat.com/>" +"For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl " +"or Python's built-in csv library)." msgstr "" # type: textblock -#: ../tools/virt-make-fs.pl:558 ../tools/virt-resize.pl:1413 ../tools/virt-win-reg.pl:493 -msgid "Copyright (C) 2010 Red Hat Inc." +#: ../tools/virt-df.pl:534 +msgid "Most spreadsheets and databases can import CSV directly." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:33 -msgid "virt-rescue - Run a rescue shell on a virtual machine" +#: ../tools/virt-ls.pl:35 +msgid "virt-ls - List files in a virtual machine" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:37 +#: ../tools/virt-ls.pl:39 #, no-wrap msgid "" -" virt-rescue [--options] domname\n" +" virt-ls [--options] domname directory\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:39 +#: ../tools/virt-ls.pl:41 #, no-wrap msgid "" -" virt-rescue [--options] disk.img [disk.img ...]\n" +" virt-ls [--options] disk.img [disk.img ...] directory\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:43 -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 -#: ../tools/virt-rescue.pl:47 +#: ../tools/virt-ls.pl:45 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." +"C<virt-ls> is a command line tool to list the names of files in a directory " +"inside a virtual machine or disk image." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:53 +#: ../tools/virt-ls.pl:48 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." +"C<virt-ls> 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-rescue.pl:58 +#: ../tools/virt-ls.pl:52 msgid "" -"You can run virt-rescue on any virtual machine known to libvirt, or directly " -"on disk image(s):" +"C<virt-ls> can be used in one of three modes: simple, long and recursive. A " +"simple listing is like the ordinary L<ls(1)> command:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:61 +#: ../tools/virt-ls.pl:55 #, no-wrap msgid "" -" virt-rescue GuestName\n" +" $ virt-ls myguest /\n" +" bin\n" +" boot\n" +" [etc.]\n" "\n" msgstr "" -# type: verbatim -#: ../tools/virt-rescue.pl:63 -#, no-wrap -msgid "" -" virt-rescue --ro /path/to/disk.img\n" -"\n" +# type: textblock +#: ../tools/virt-ls.pl:60 +msgid "With the C<-l> (C<--long>) option, C<virt-ls> shows more detail:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:65 +#: ../tools/virt-ls.pl:62 #, no-wrap msgid "" -" virt-rescue /dev/sdc\n" +" $ virt-ls -l myguest /\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 -#: ../tools/virt-rescue.pl:67 -msgid "For live VMs you I<must> use the --ro option." -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:69 -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 -#: ../tools/virt-rescue.pl:76 +#: ../tools/virt-ls.pl:68 msgid "" -"In the example below, we list logical volumes, then choose one to mount " -"under C</sysroot>:" +"With the C<-R> (C<--recursive>) option, C<virt-ls> lists the names of files " +"and directories recursively:" msgstr "" # type: verbatim -#: ../tools/virt-rescue.pl:79 +#: ../tools/virt-ls.pl:71 #, 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" +" $ virt-ls -R myguest /tmp\n" +" foo\n" +" foo/bar\n" +" [etc.]\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:86 -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: =head1 -#: ../tools/virt-rescue.pl:90 ../tools/virt-resize.pl:1350 -msgid "NOTES" -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:92 -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 -#: ../tools/virt-rescue.pl:98 +#: ../tools/virt-ls.pl:76 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)>." +"You I<cannot> combine these options. To do more complicated things, use " +"L<guestfish(1)>." msgstr "" # type: =item -#: ../tools/virt-rescue.pl:127 -msgid "B<--append kernelopts>" -msgstr "" - -# type: textblock -#: ../tools/virt-rescue.pl:129 -msgid "Pass additional options to the rescue kernel." +#: ../tools/virt-ls.pl:115 ../tools/virt-list-filesystems.pl:86 ../tools/virt-list-partitions.pl:95 +msgid "B<-l> | B<--long>" msgstr "" # type: =item -#: ../tools/virt-rescue.pl:147 -msgid "B<--memsize MB> | B<-m MB>" +#: ../tools/virt-ls.pl:117 +msgid "B<-R> | B<--recursive>" msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:149 +#: ../tools/virt-ls.pl:119 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 -#: ../tools/virt-rescue.pl:158 -msgid "B<--ro> | B<-r>" +"Select the mode. With neither of these options, C<virt-ls> produces a " +"simple, flat list of the files in the named directory." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:160 -msgid "Open the image read-only." +#: ../tools/virt-ls.pl:122 +msgid "" +"C<virt-ls -l> produces a \"long listing\", which shows more detail (just " +"like the plain C<ls -l> command)." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:172 +#: ../tools/virt-ls.pl:125 msgid "" -"Enable SELinux in the rescue appliance. You should read " -"L<guestfs(3)/SELINUX> before using this option." +"C<virt-ls -R> produces a recursive list of files starting at the named " +"directory. See the documentation for the C<guestfs_find> command " +"L<guestfs(3)> for precise details." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:228 -msgid "" -"Several environment variables affect virt-rescue. See " -"L<guestfs(3)/ENVIRONMENT VARIABLES> for the complete list." +#: ../tools/virt-ls.pl:129 +msgid "You cannot combine these options." msgstr "" # type: textblock -#: ../tools/virt-rescue.pl:233 +#: ../tools/virt-ls.pl:212 msgid "" -"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(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-tar(1)>, " +"L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, " +"L<http://libguestfs.org/>." msgstr "" # type: textblock @@ -25642,11 +25285,6 @@ msgstr "" msgid "B<-d> | B<--debug>" msgstr "" -# type: textblock -#: ../tools/virt-resize.pl:477 ../tools/virt-win-reg.pl:198 -msgid "Enable debugging messages." -msgstr "" - # type: =item #: ../tools/virt-resize.pl:483 msgid "B<-n> | B<--dryrun>" @@ -25668,6 +25306,11 @@ msgid "Don't print the summary." msgstr "" # type: =head2 +#: ../tools/virt-resize.pl:1350 ../tools/virt-rescue.pl:90 +msgid "NOTES" +msgstr "" + +# type: =head2 #: ../tools/virt-resize.pl:1352 msgid "\"Partition 1 does not end on cylinder boundary.\"" msgstr "" @@ -25746,6 +25389,192 @@ msgid "" 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-list-filesystems.pl:36 +#, no-wrap +msgid "" +" virt-list-filesystems [--options] domname\n" +"\n" +msgstr "" + +# type: verbatim +#: ../tools/virt-list-filesystems.pl:38 +#, no-wrap +msgid "" +" virt-list-filesystems [--options] disk.img [disk.img ...]\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:42 +msgid "" +"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-list-filesystems.pl:46 +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." +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:88 +msgid "" +"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:95 +msgid "B<-a> | B<--all>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:97 +msgid "" +"Normally we only show mountable filesystems. If this option is given then " +"swap devices are shown too." +msgstr "" + +# type: textblock +#: ../tools/virt-list-filesystems.pl:193 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(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-cat.pl:34 +msgid "virt-cat - Display a file in a virtual machine" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:38 +#, no-wrap +msgid "" +" virt-cat [--options] domname file\n" +"\n" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:40 +#, no-wrap +msgid "" +" virt-cat [--options] disk.img [disk.img ...] file\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:44 +msgid "" +"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 +#: ../tools/virt-cat.pl:47 +msgid "" +"C<virt-cat> can be used to quickly view a single file. To edit a file, use " +"C<virt-edit>. For more complex cases you should look at the L<guestfish(1)> " +"tool." +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:53 +msgid "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:56 +#, no-wrap +msgid "" +" virt-cat mydomain /etc/fstab\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:58 +msgid "List syslog messages from a VM:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:60 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/messages | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:62 +msgid "Find out what DHCP IP address a VM acquired:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:64 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/messages | grep 'dhclient: bound to' | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:66 +msgid "Find out what packages were recently installed:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:68 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/yum.log | tail\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:70 +msgid "Find out who is logged on inside a virtual machine:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:72 +#, no-wrap +msgid "" +" virt-cat mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:75 +msgid "or who was logged on:" +msgstr "" + +# type: verbatim +#: ../tools/virt-cat.pl:77 +#, no-wrap +msgid "" +" virt-cat mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" +msgstr "" + +# type: textblock +#: ../tools/virt-cat.pl:165 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-edit(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:34 msgid "virt-tar - Extract or upload files to a virtual machine" msgstr "" @@ -25933,375 +25762,694 @@ msgid "" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:38 +#: ../tools/virt-rescue.pl:33 +msgid "virt-rescue - Run a rescue shell on a virtual machine" +msgstr "" + +# type: verbatim +#: ../tools/virt-rescue.pl:37 +#, no-wrap msgid "" -"virt-win-reg - Export and merge Windows Registry entries from a Windows " -"guest" +" virt-rescue [--options] domname\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:42 +#: ../tools/virt-rescue.pl:39 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n" +" virt-rescue [--options] disk.img [disk.img ...]\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-rescue.pl:43 +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 +#: ../tools/virt-rescue.pl:47 +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 +#: ../tools/virt-rescue.pl:53 +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 +#: ../tools/virt-rescue.pl:58 +msgid "" +"You can run virt-rescue on any virtual machine known to libvirt, or directly " +"on disk image(s):" +msgstr "" + # type: verbatim -#: ../tools/virt-win-reg.pl:44 +#: ../tools/virt-rescue.pl:61 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n" +" virt-rescue GuestName\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:46 +#: ../tools/virt-rescue.pl:63 #, no-wrap msgid "" -" virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n" +" virt-rescue --ro /path/to/disk.img\n" "\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:48 +#: ../tools/virt-rescue.pl:65 #, no-wrap msgid "" -" virt-win-reg --merge domname [input.reg ...]\n" +" virt-rescue /dev/sdc\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-rescue.pl:67 +msgid "For live VMs you I<must> use the --ro option." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:69 +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 +#: ../tools/virt-rescue.pl:76 +msgid "" +"In the example below, we list logical volumes, then choose one to mount " +"under C</sysroot>:" +msgstr "" + # type: verbatim -#: ../tools/virt-win-reg.pl:50 +#: ../tools/virt-rescue.pl:79 #, no-wrap msgid "" -" virt-win-reg [--options] disk.img ... # instead of domname\n" +" ><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 -#: ../tools/virt-win-reg.pl:54 +#: ../tools/virt-rescue.pl:86 msgid "" -"You must I<not> use C<virt-win-reg> with the C<--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." +"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 -#: ../tools/virt-win-reg.pl:59 +#: ../tools/virt-rescue.pl:92 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 C<--merge> option, make sure " -"you have a reliable backup first." +"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 -#: ../tools/virt-win-reg.pl:66 +#: ../tools/virt-rescue.pl:98 msgid "" -"This program can export and merge Windows Registry entries from a Windows " -"guest." +"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 +#: ../tools/virt-rescue.pl:127 +msgid "B<--append kernelopts>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:69 +#: ../tools/virt-rescue.pl:129 +msgid "Pass additional options to the rescue kernel." +msgstr "" + +# type: =item +#: ../tools/virt-rescue.pl:147 +msgid "B<--memsize MB> | B<-m MB>" +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:149 msgid "" -"The first parameter is the libvirt guest name or the raw disk image of a " -"Windows guest." +"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 +#: ../tools/virt-rescue.pl:158 +msgid "B<--ro> | B<-r>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:72 +#: ../tools/virt-rescue.pl:160 +msgid "Open the image read-only." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:172 msgid "" -"If C<--merge> is I<not> specified, then the chosen registry key is " -"displayed/exported (recursively). For example:" +"Enable SELinux in the rescue appliance. You should read " +"L<guestfs(3)/SELINUX> before using this option." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:228 +msgid "" +"Several environment variables affect virt-rescue. See " +"L<guestfs(3)/ENVIRONMENT VARIABLES> for the complete list." +msgstr "" + +# type: textblock +#: ../tools/virt-rescue.pl:233 +msgid "" +"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, " +"L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:37 +msgid "virt-make-fs - Make a filesystem from a tar archive or files" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:75 +#: ../tools/virt-make-fs.pl:41 #, no-wrap msgid "" -" $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n" +" virt-make-fs [--options] input.tar output.img\n" "\n" msgstr "" -# type: textblock -#: ../tools/virt-win-reg.pl:77 -msgid "You can also display single values from within registry keys, for example:" +# type: verbatim +#: ../tools/virt-make-fs.pl:43 +#, no-wrap +msgid "" +" virt-make-fs [--options] input.tar.gz output.img\n" +"\n" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:80 +#: ../tools/virt-make-fs.pl:45 #, no-wrap msgid "" -" $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n" -" $ virt-win-reg Windows7 $cvkey ProductName\n" -" Windows 7 Enterprise\n" +" virt-make-fs [--options] directory output.img\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:84 +#: ../tools/virt-make-fs.pl:49 msgid "" -"With C<--merge>, you can merge a textual regedit file into the Windows " -"Registry:" +"Virt-make-fs is a command line tool for creating a filesystem from a tar " +"archive or some files in a directory. It is similar to tools like " +"L<mkisofs(1)>, L<genisoimage(1)> and L<mksquashfs(1)>. Unlike those tools, " +"it can create common filesystem types like ext2/3 or NTFS, which can be " +"useful if you want to attach these filesystems to existing virtual machines " +"(eg. to import large amounts of read-only data to a VM)." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:57 +msgid "Basic usage is:" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:87 +#: ../tools/virt-make-fs.pl:59 #, no-wrap msgid "" -" $ virt-win-reg --merge Windows7 changes.reg\n" +" virt-make-fs input output\n" "\n" msgstr "" +# type: textblock +#: ../tools/virt-make-fs.pl:61 +msgid "" +"where C<input> is either a directory containing files that you want to add, " +"or a tar archive (either uncompressed tar or gzip-compressed tar); and " +"C<output> is a disk image. The input type is detected automatically. The " +"output disk image defaults to a raw ext2 image unless you specify extra " +"flags (see L</OPTIONS> below)." +msgstr "" + # type: =head2 -#: ../tools/virt-win-reg.pl:89 -msgid "SUPPORTED SYSTEMS" +#: ../tools/virt-make-fs.pl:67 +msgid "EXTRA SPACE" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:91 +#: ../tools/virt-make-fs.pl:69 msgid "" -"The program currently supports Windows NT-derived guests starting with " -"Windows XP through to at least Windows 7." +"Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" " +"the files that it contains, but might have extra space. Depending on how " +"you are going to use the output, you might think this extra space is wasted " +"and want to minimize it, or you might want to leave space so that more files " +"can be added later. Virt-make-fs defaults to minimizing the extra space, " +"but you can use the C<--size> flag to leave space in the filesystem if you " +"want it." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:94 +#: ../tools/virt-make-fs.pl:77 msgid "" -"Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, " -"C<HKEY_LOCAL_MACHINE\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, " -"C<HKEY_LOCAL_MACHINE\\SYSTEM> and C<HKEY_USERS\\.DEFAULT>." +"An alternative way to leave extra space but not make the output image any " +"bigger is to use an alternative disk image format (instead of the default " +"\"raw\" format). Using C<--format=qcow2> will use the native QEmu/KVM qcow2 " +"image format (check your hypervisor supports this before using it). This " +"allows you to choose a large C<--size> but the extra space won't actually be " +"allocated in the image until you try to store something in it." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:98 +#: ../tools/virt-make-fs.pl:85 msgid "" -"You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for " -"C<HKEY_USERS>." +"Don't forget that you can also use local commands including L<resize2fs(8)> " +"and L<virt-resize(1)> to resize existing filesystems, or rerun " +"virt-make-resize to build another image from scratch." msgstr "" -# type: textblock -#: ../tools/virt-win-reg.pl:101 +# type: =head3 +#: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 ../tools/virt-make-fs.pl:142 +msgid "EXAMPLE" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:91 +#, no-wrap msgid "" -"C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this " -"time." +" virt-make-fs --format=qcow2 --size=+200M input output.img\n" +"\n" msgstr "" # type: =head2 -#: ../tools/virt-win-reg.pl:104 -msgid "NOTE" +#: ../tools/virt-make-fs.pl:93 +msgid "FILESYSTEM TYPE" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:106 +#: ../tools/virt-make-fs.pl:95 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)>." +"The default filesystem type is C<ext2>. Just about any filesystem type that " +"libguestfs supports can be used (but I<not> read-only formats like " +"ISO9660). Here are some of the more common choices:" msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:112 -msgid "ENCODING" +# type: =item +#: ../tools/virt-make-fs.pl:101 +msgid "I<ext3>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:114 +#: ../tools/virt-make-fs.pl:103 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." +"Note that ext3 filesystems contain a journal, typically 1-32 MB in size. If " +"you are not going to use the filesystem in a way that requires the journal, " +"then this is just wasted overhead." +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:107 +msgid "I<ntfs> or I<vfat>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:120 +#: ../tools/virt-make-fs.pl:109 +msgid "Useful if exporting data to a Windows guest." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:111 msgid "" -"To reencode a file from Windows format to Linux (before processing it with " -"the C<--merge> option), you would do something like this:" +"I<Note for vfat>: The tar archive or local directory must only contain files " +"which are owned by root (ie. UID:GID = 0:0). The reason is that the tar " +"program running within libguestfs is unable to change the ownership of " +"non-root files, since vfat itself does not support this." +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:116 +msgid "I<minix>" +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:118 +msgid "" +"Lower overhead than C<ext2>, but certain limitations on filename length and " +"total filesystem size." msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:123 +#: ../tools/virt-make-fs.pl:125 #, no-wrap msgid "" -" iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n" +" virt-make-fs --type=minix input minixfs.img\n" "\n" msgstr "" +# type: =head2 +#: ../tools/virt-make-fs.pl:127 +msgid "TO PARTITION OR NOT TO PARTITION" +msgstr "" + # type: textblock -#: ../tools/virt-win-reg.pl:125 +#: ../tools/virt-make-fs.pl:129 +msgid "Optionally virt-make-fs can add a partition table to the output disk." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:131 msgid "" -"To go in the opposite direction, after exporting and before sending the file " -"to a Windows user, do something like this:" +"Adding a partition can make the disk image more compatible with certain " +"virtualized operating systems which don't expect to see a filesystem " +"directly located on a block device (Linux doesn't care and will happily " +"handle both types)." msgstr "" -# type: verbatim -#: ../tools/virt-win-reg.pl:128 -#, no-wrap +# type: textblock +#: ../tools/virt-make-fs.pl:136 msgid "" -" unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n" -"\n" +"On the other hand, if you have a partition table then the output image is no " +"longer a straight filesystem. For example you cannot run L<fsck(8)> " +"directly on a partitioned disk image. (However libguestfs tools such as " +"L<guestfish(1)> and L<virt-resize(1)> can still be used)." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:130 -msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>." +#: ../tools/virt-make-fs.pl:144 +msgid "Add an MBR partition:" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:146 +#, no-wrap +msgid "" +" virt-make-fs --partition -- input disk.img\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:132 +#: ../tools/virt-make-fs.pl:148 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:" +"If the output disk image could be terabyte-sized or larger, it's better to " +"use an EFI/GPT-compatible partition table:" msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:136 +#: ../tools/virt-make-fs.pl:151 #, 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" +" virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:140 -msgid "This file would need conversion before you could C<--merge> it." +#: ../tools/virt-make-fs.pl:179 +msgid "Enable debugging information." msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:142 -msgid "SHELL QUOTING" +# type: =item +#: ../tools/virt-make-fs.pl:185 +msgid "B<--size=E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:187 +msgid "B<--size=+E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:189 +msgid "B<-s E<lt>NE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:191 +msgid "B<-s +E<lt>NE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:144 -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." +#: ../tools/virt-make-fs.pl:193 +msgid "Use the C<--size> (or C<-s>) option to choose the size of the output image." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:148 -msgid "Paths and value names are case-insensitive." +#: ../tools/virt-make-fs.pl:196 +msgid "" +"If this option is I<not> given, then the output image will be just large " +"enough to contain all the files, with not much wasted space." msgstr "" -# type: =head2 -#: ../tools/virt-win-reg.pl:150 -msgid "CurrentControlSet etc." +# type: textblock +#: ../tools/virt-make-fs.pl:199 +msgid "" +"To choose a fixed size output disk, specify an absolute number followed by " +"b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " +"Petabytes or Exabytes. This must be large enough to contain all the input " +"files, else you will get an error." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:152 +#: ../tools/virt-make-fs.pl:204 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." +"To leave extra space, specify C<+> (plus sign) and a number followed by " +"b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, " +"Petabytes or Exabytes. For example: C<--size=+200M> means enough space for " +"the input files, and (approximately) an extra 200 MB free space." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:156 +#: ../tools/virt-make-fs.pl:210 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:" +"Note that virt-make-fs estimates free space, and therefore will not produce " +"filesystems containing precisely the free space requested. (It is much more " +"expensive and time-consuming to produce a filesystem which has precisely the " +"desired free space)." msgstr "" -# type: verbatim -#: ../tools/virt-win-reg.pl:160 -#, no-wrap +# type: =item +#: ../tools/virt-make-fs.pl:219 +msgid "B<--format=E<lt>fmtE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:221 +msgid "B<-F E<lt>fmtE<gt>>" +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:223 +msgid "Choose the output disk image format." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:225 +msgid "The default is C<raw> (raw disk image)." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:227 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" +"For other choices, see the L<qemu-img(1)> manpage. The only other choice " +"that would really make sense here is C<qcow2>." +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:234 +msgid "B<--type=E<lt>fsE<gt>>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:236 +msgid "B<-t E<lt>fsE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:167 -msgid "\"Default\" is the one which Windows will choose when it boots." +#: ../tools/virt-make-fs.pl:238 +msgid "Choose the output filesystem type." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:169 -msgid "Similarly, other C<Current...> keys in the path may need to be replaced." +#: ../tools/virt-make-fs.pl:240 +msgid "The default is C<ext2>." +msgstr "" + +# type: textblock +#: ../tools/virt-make-fs.pl:242 +msgid "Any filesystem which is supported read-write by libguestfs can be used here." msgstr "" # type: =item -#: ../tools/virt-win-reg.pl:216 -msgid "B<--merge>" +#: ../tools/virt-make-fs.pl:249 +msgid "B<--partition>" +msgstr "" + +# type: =item +#: ../tools/virt-make-fs.pl:251 +msgid "B<--partition=E<lt>parttypeE<gt>>" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:218 +#: ../tools/virt-make-fs.pl:253 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." +"If specified, this flag adds an MBR partition table to the output disk " +"image." msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:222 +#: ../tools/virt-make-fs.pl:256 msgid "" -"Note that C<--merge> is I<unsafe> to use on live virtual machines, and will " -"result in disk corruption. However exporting (without this flag) is always " -"safe." +"You can change the partition table type, eg. C<--partition=gpt> for large " +"disks." msgstr "" -# type: =item -#: ../tools/virt-win-reg.pl:230 -msgid "B<--encoding> UTF-16LE|ASCII" +# type: textblock +#: ../tools/virt-make-fs.pl:259 +msgid "" +"Note that if you just use a lonesome C<--partition>, the Perl option parser " +"might consider the next parameter to be the partition type. For example:" msgstr "" -# type: textblock -#: ../tools/virt-win-reg.pl:232 +# type: verbatim +#: ../tools/virt-make-fs.pl:263 +#, no-wrap 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>." +" virt-make-fs --partition input.tar ...\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:236 +#: ../tools/virt-make-fs.pl:265 msgid "" -"The default is to use UTF-16LE, which should work with recent versions of " -"Windows." +"would cause virt-make-fs to think you wanted to use a partition type of " +"C<input.tar> which is completely wrong. To avoid this, use C<--> (a double " +"dash) between options and the input file argument:" +msgstr "" + +# type: verbatim +#: ../tools/virt-make-fs.pl:269 +#, no-wrap +msgid "" +" virt-make-fs --partition -- input.tar ...\n" +"\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:463 +#: ../tools/virt-make-fs.pl:529 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/>." +"L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, " +"L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, " +"L<guestfs(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>." msgstr "" # type: verbatim -#: ../tools/virt-win-reg.pl:481 +#: ../tools/virt-make-fs.pl:546 #, no-wrap msgid "" " export LIBGUESTFS_DEBUG=1\n" -" virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n" +" virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n" "\n" msgstr "" # type: textblock -#: ../tools/virt-win-reg.pl:484 +#: ../tools/virt-make-fs.pl:549 msgid "" -"Attach /tmp/virt-win-reg.log to a new bug report at " +"Attach /tmp/virt-make-fs.log to a new bug report at " "L<https://bugzilla.redhat.com/>" msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:32 +msgid "virt-list-partitions - List partitions in a virtual machine or disk image" +msgstr "" + +# 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-list-partitions.pl:42 +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)>." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:47 +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." +msgstr "" + +# type: =item +#: ../tools/virt-list-partitions.pl:87 +msgid "B<-h> | B<--human-readable>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:89 +msgid "Show sizes in human-readable form (eg. \"1G\")." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:97 +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-list-partitions.pl:104 +msgid "B<-t> | B<--total>" +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:106 +msgid "Display the total size of each block device (as a separate row or rows)." +msgstr "" + +# type: textblock +#: ../tools/virt-list-partitions.pl:231 +msgid "" +"L<guestfs(3)>, L<guestfish(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 "" |