X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Flibguestfs-docs.pot;h=0cf7964d1195c8589827984993267f4a1531f376;hp=6f532ca52731ac67a67d3afe5958248560c9a211;hb=03459c8fa754e45c7e492b378456e0afac1b0dcb;hpb=9ce239a8365b2209de24f72aa75a7a049ee72d01 diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 6f532ca..0cf7964 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.11.9\n" +"Project-Id-Version: libguestfs 1.11.18\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-06-04 22:42+0200\n" +"POT-Creation-Date: 2011-07-15 17:18+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -807,7 +807,7 @@ msgid "There are many limitations to this:" msgstr "" #. type: =item -#: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064 ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652 ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763 ../src/guestfs.pod:1773 ../src/guestfs.pod:2008 ../src/guestfs.pod:2013 ../src/guestfs.pod:2019 ../src/guestfs.pod:2027 ../src/guestfs.pod:2381 ../src/guestfs.pod:2387 ../src/guestfs.pod:2392 ../src/guestfs.pod:2398 ../src/guestfs.pod:2967 ../src/guestfs.pod:2971 ../src/guestfs.pod:2975 ../src/guestfs.pod:2979 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1627 ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1641 ../src/guestfs-actions.pod:1645 ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1787 ../src/guestfs-actions.pod:1791 ../src/guestfs-actions.pod:1796 ../src/guestfs-actions.pod:1801 ../src/guestfs-actions.pod:1862 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:1871 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1074 ../fish/guestfish-actions.pod:1078 ../fish/guestfish-actions.pod:1082 ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1094 ../fish/guestfish-actions.pod:1098 ../fish/guestfish-actions.pod:1102 ../fish/guestfish-actions.pod:1112 ../fish/guestfish-actions.pod:1116 ../fish/guestfish-actions.pod:1120 ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:1214 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1275 ../tools/virt-win-reg.pl:195 ../tools/virt-win-reg.pl:200 ../tools/virt-win-reg.pl:206 ../tools/virt-win-reg.pl:708 ../tools/virt-win-reg.pl:714 ../tools/virt-win-reg.pl:720 +#: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064 ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652 ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763 ../src/guestfs.pod:1773 ../src/guestfs.pod:2047 ../src/guestfs.pod:2052 ../src/guestfs.pod:2058 ../src/guestfs.pod:2066 ../src/guestfs.pod:2420 ../src/guestfs.pod:2426 ../src/guestfs.pod:2431 ../src/guestfs.pod:2437 ../src/guestfs.pod:3011 ../src/guestfs.pod:3015 ../src/guestfs.pod:3019 ../src/guestfs.pod:3023 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1666 ../src/guestfs-actions.pod:1670 ../src/guestfs-actions.pod:1674 ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1686 ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1855 ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:2863 ../src/guestfs-actions.pod:2871 ../src/guestfs-actions.pod:2878 ../src/guestfs-actions.pod:2885 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1099 ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1107 ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1119 ../fish/guestfish-actions.pod:1123 ../fish/guestfish-actions.pod:1127 ../fish/guestfish-actions.pod:1137 ../fish/guestfish-actions.pod:1141 ../fish/guestfish-actions.pod:1145 ../fish/guestfish-actions.pod:1235 ../fish/guestfish-actions.pod:1239 ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1291 ../fish/guestfish-actions.pod:1295 ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1933 ../fish/guestfish-actions.pod:1939 ../fish/guestfish-actions.pod:1947 ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1961 ../tools/virt-win-reg.pl:195 ../tools/virt-win-reg.pl:200 ../tools/virt-win-reg.pl:206 ../tools/virt-win-reg.pl:708 ../tools/virt-win-reg.pl:714 ../tools/virt-win-reg.pl:720 msgid "*" msgstr "" @@ -933,7 +933,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2426 +#: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2465 msgid "1." msgstr "" @@ -951,7 +951,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2451 +#: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2490 msgid "2." msgstr "" @@ -1045,7 +1045,7 @@ msgid "For more information about umask, see L." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:519 ../fish/guestfish.pod:767 +#: ../src/guestfs.pod:519 ../fish/guestfish.pod:825 msgid "ENCRYPTED DISKS" msgstr "" @@ -2862,7 +2862,7 @@ msgid "API CALLS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1010 +#: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1068 msgid "@ACTIONS@" msgstr "" @@ -3211,7 +3211,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1858 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1262 ../tools/virt-win-reg.pl:704 +#: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:2853 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929 ../tools/virt-win-reg.pl:704 msgid "Notes:" msgstr "" @@ -3754,24 +3754,102 @@ msgstr "" #. type: =head1 #: ../src/guestfs.pod:1952 -msgid "PRIVATE DATA AREA" +msgid "CANCELLING LONG TRANSFERS" msgstr "" #. type: textblock #: ../src/guestfs.pod:1954 msgid "" +"Some operations can be cancelled by the caller while they are in progress. " +"Currently only operations that involve uploading or downloading data can be " +"cancelled (technically: operations that have C or C " +"parameters in the generator)." +msgstr "" + +#. type: =head2 +#: ../src/guestfs.pod:1959 +msgid "guestfs_user_cancel" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1961 +#, no-wrap +msgid "" +" void guestfs_user_cancel (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1963 +msgid "C cancels the current upload or download operation." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1966 +msgid "" +"Unlike most other libguestfs calls, this function is signal safe and thread " +"safe. You can call it from a signal handler or from another thread, without " +"needing to do any locking." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1970 +msgid "" +"The transfer that was in progress (if there is one) will stop shortly " +"afterwards, and will return an error. The errno (see " +"L) is set to C, so you can test for this to find " +"out if the operation was cancelled or failed because of another error." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1976 +msgid "" +"No cleanup is performed: for example, if a file was being uploaded then " +"after cancellation there may be a partially uploaded file. It is the " +"caller's responsibility to clean up if necessary." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1980 +msgid "There are two common places that you might call C." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1982 +msgid "" +"In an interactive text-based program, you might call it from a C " +"signal handler so that pressing C<^C> cancels the current operation. (You " +"also need to call L so that child processes don't " +"receive the C<^C> signal)." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1987 +msgid "" +"In a graphical program, when the main thread is displaying a progress bar " +"with a cancel button, wire up the cancel button to call this function." +msgstr "" + +#. type: =head1 +#: ../src/guestfs.pod:1991 +msgid "PRIVATE DATA AREA" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1993 +msgid "" "You can attach named pieces of private data to the libguestfs handle, fetch " "them by name, and walk over them, for the lifetime of the handle. This is " "called the private data area and is only available from the C API." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1959 +#: ../src/guestfs.pod:1998 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1961 +#: ../src/guestfs.pod:2000 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -3779,7 +3857,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1963 +#: ../src/guestfs.pod:2002 msgid "" "C is the name to associate with this data, and C is an arbitrary " "pointer (which can be C). Any previous item with the same key is " @@ -3787,7 +3865,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1967 +#: ../src/guestfs.pod:2006 msgid "" "You can use any C you want, but your key should I start with an " "underscore character. Keys beginning with an underscore character are " @@ -3797,12 +3875,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1973 +#: ../src/guestfs.pod:2012 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1975 +#: ../src/guestfs.pod:2014 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -3810,7 +3888,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1977 +#: ../src/guestfs.pod:2016 msgid "" "This function returns C if either no data is found associated with " "C, or if the user previously set the C's C pointer to " @@ -3818,7 +3896,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1981 +#: ../src/guestfs.pod:2020 msgid "" "Libguestfs does not try to look at or interpret the C pointer in any " "way. As far as libguestfs is concerned, it need not be a valid pointer at " @@ -3829,12 +3907,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1988 +#: ../src/guestfs.pod:2027 msgid "To walk over all entries, use these two functions:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1990 +#: ../src/guestfs.pod:2029 #, no-wrap msgid "" " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n" @@ -3842,7 +3920,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1992 +#: ../src/guestfs.pod:2031 #, no-wrap msgid "" " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n" @@ -3850,7 +3928,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1994 +#: ../src/guestfs.pod:2033 msgid "" "C returns the first key, pointer pair (\"first\" does " "not have any particular meaning -- keys are not returned in any defined " @@ -3860,7 +3938,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2000 +#: ../src/guestfs.pod:2039 msgid "" "C returns the next key, pointer pair. The return " "value of this function is also C is there are no further entries to " @@ -3868,17 +3946,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2004 +#: ../src/guestfs.pod:2043 msgid "Notes about walking over entries:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2010 +#: ../src/guestfs.pod:2049 msgid "You must not call C while walking over the entries." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2015 +#: ../src/guestfs.pod:2054 msgid "" "The handle maintains an internal iterator which is reset when you call " "C. This internal iterator is invalidated when you " @@ -3886,12 +3964,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2021 +#: ../src/guestfs.pod:2060 msgid "If you have set the data pointer associated with a key to C, ie:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2023 +#: ../src/guestfs.pod:2062 #, no-wrap msgid "" " guestfs_set_private (g, key, NULL);\n" @@ -3899,26 +3977,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2025 +#: ../src/guestfs.pod:2064 msgid "then that C is not returned when walking." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2029 +#: ../src/guestfs.pod:2068 msgid "" "C<*key_rtn> is only valid until the next call to C, " "C or C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2035 +#: ../src/guestfs.pod:2074 msgid "" "The following example code shows how to print all keys and data pointers " "that are associated with the handle C:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2038 +#: ../src/guestfs.pod:2077 #, no-wrap msgid "" " const char *key;\n" @@ -3932,14 +4010,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2046 +#: ../src/guestfs.pod:2085 msgid "" "More commonly you are only interested in keys that begin with an " "application-specific prefix C. Modify the loop like so:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2049 +#: ../src/guestfs.pod:2088 #, no-wrap msgid "" " const char *key;\n" @@ -3954,7 +4032,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2058 +#: ../src/guestfs.pod:2097 msgid "" "If you need to modify keys while walking, then you have to jump back to the " "beginning of the loop. For example, to delete all keys prefixed with " @@ -3962,7 +4040,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2062 +#: ../src/guestfs.pod:2101 #, no-wrap msgid "" " const char *key;\n" @@ -3984,7 +4062,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2078 +#: ../src/guestfs.pod:2117 msgid "" "Note that the above loop is guaranteed to terminate because the keys are " "being deleted, but other manipulations of keys within the loop might not " @@ -3993,24 +4071,24 @@ msgid "" msgstr "" #. type: =end -#: ../src/guestfs.pod:2083 ../src/guestfs.pod:2088 +#: ../src/guestfs.pod:2122 ../src/guestfs.pod:2127 msgid "html" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2085 +#: ../src/guestfs.pod:2124 msgid "" " " msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2090 +#: ../src/guestfs.pod:2129 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2092 +#: ../src/guestfs.pod:2131 msgid "" "Internally, libguestfs is implemented by running an appliance (a special " "type of small virtual machine) using L. Qemu runs as a child " @@ -4018,7 +4096,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2096 +#: ../src/guestfs.pod:2135 #, no-wrap msgid "" " ___________________\n" @@ -4044,14 +4122,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2116 +#: ../src/guestfs.pod:2155 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L function." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2119 +#: ../src/guestfs.pod:2158 msgid "" "Inside the appliance is a Linux kernel and a complete stack of userspace " "tools (such as LVM and ext2 programs) and a small controlling daemon called " @@ -4063,7 +4141,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2128 +#: ../src/guestfs.pod:2167 msgid "" "A common misunderstanding is that the appliance \"is\" the virtual machine. " "Although the disk image you are attached to might also be used by some " @@ -4074,17 +4152,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2135 +#: ../src/guestfs.pod:2174 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2137 +#: ../src/guestfs.pod:2176 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2139 +#: ../src/guestfs.pod:2178 #, no-wrap msgid "" " |\n" @@ -4112,7 +4190,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2161 +#: ../src/guestfs.pod:2200 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), " @@ -4121,7 +4199,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2166 +#: ../src/guestfs.pod:2205 msgid "" "The guest may be killed by L, or may die " "asynchronously at any time (eg. due to some internal error), and that causes " @@ -4129,14 +4207,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2170 +#: ../src/guestfs.pod:2209 msgid "" "Configuration commands for qemu such as L can only be " "issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2173 +#: ../src/guestfs.pod:2212 msgid "" "The API offers one call that goes from CONFIG through LAUNCHING to READY. " "L blocks until the child process is READY to accept " @@ -4145,7 +4223,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2179 +#: ../src/guestfs.pod:2218 msgid "" "API actions such as L can only be issued when in the READY " "state. These API calls block waiting for the command to be carried out " @@ -4155,7 +4233,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2185 +#: ../src/guestfs.pod:2224 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -4163,24 +4241,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2189 +#: ../src/guestfs.pod:2228 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2191 +#: ../src/guestfs.pod:2230 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2193 +#: ../src/guestfs.pod:2232 msgid "" "Don't rely on using this protocol directly. This section documents how it " "currently works, but it may change at any time." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2196 +#: ../src/guestfs.pod:2235 msgid "" "The protocol used to talk between the library and the daemon running inside " "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC " @@ -4188,14 +4266,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2200 +#: ../src/guestfs.pod:2239 msgid "" "The detailed format of structures is in C (note: " "this file is automatically generated)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2203 +#: ../src/guestfs.pod:2242 msgid "" "There are two broad cases, ordinary functions that don't have any C " "and C parameters, which are handled with very simple request/reply " @@ -4205,17 +4283,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2210 +#: ../src/guestfs.pod:2249 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2212 +#: ../src/guestfs.pod:2251 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2214 +#: ../src/guestfs.pod:2253 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -4226,7 +4304,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2219 +#: ../src/guestfs.pod:2258 msgid "" "The total length field allows the daemon to allocate a fixed size buffer " "into which it slurps the rest of the message. As a result, the total length " @@ -4235,21 +4313,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2225 +#: ../src/guestfs.pod:2264 msgid "" "Note also that many functions don't take any arguments, in which case the " "C_args> is completely omitted." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2228 +#: ../src/guestfs.pod:2267 msgid "" "The header contains the procedure number (C) which is how the " "receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2232 +#: ../src/guestfs.pod:2271 msgid "" "For functions that take optional arguments, the optional arguments are " "encoded in the C_args> structure in the same way as ordinary " @@ -4261,12 +4339,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2240 +#: ../src/guestfs.pod:2279 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2242 +#: ../src/guestfs.pod:2281 #, no-wrap msgid "" " total length (header + ret,\n" @@ -4277,26 +4355,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2247 +#: ../src/guestfs.pod:2286 msgid "" "As above the C_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2250 +#: ../src/guestfs.pod:2289 msgid "As above the total length of the reply is limited to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2253 +#: ../src/guestfs.pod:2292 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:2256 +#: ../src/guestfs.pod:2295 #, no-wrap msgid "" " total length (header + error,\n" @@ -4307,19 +4385,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2261 +#: ../src/guestfs.pod:2300 msgid "" "The C structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2264 +#: ../src/guestfs.pod:2303 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2266 +#: ../src/guestfs.pod:2305 msgid "" "A C parameter indicates that we transfer a file I the guest. " "The normal request message is sent (see above). However this is followed by " @@ -4327,7 +4405,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2270 +#: ../src/guestfs.pod:2309 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -4341,12 +4419,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2278 +#: ../src/guestfs.pod:2317 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2280 +#: ../src/guestfs.pod:2319 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -4360,7 +4438,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2288 +#: ../src/guestfs.pod:2327 msgid "" "The final chunk has the C field set to zero. Additionally a flag " "is set in the final chunk to indicate either successful completion or early " @@ -4368,7 +4446,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2292 +#: ../src/guestfs.pod:2331 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -4377,7 +4455,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2297 +#: ../src/guestfs.pod:2336 msgid "" "Both the library (sender) I the daemon (receiver) may cancel the " "transfer. The library does this by sending a chunk with a special flag set " @@ -4386,7 +4464,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2303 +#: ../src/guestfs.pod:2342 msgid "" "The daemon may also cancel. It does this by writing a special word " "C to the socket. The library listens for this during " @@ -4398,7 +4476,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2312 +#: ../src/guestfs.pod:2351 msgid "" "This protocol allows the transfer of arbitrary sized files (no 32 bit " "limit), and also files where the size is not known in advance (eg. from " @@ -4408,19 +4486,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2318 +#: ../src/guestfs.pod:2357 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2320 +#: ../src/guestfs.pod:2359 msgid "" "The protocol for FileOut parameters is exactly the same as for FileIn " "parameters, but with the roles of daemon and library reversed." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2323 +#: ../src/guestfs.pod:2362 #, no-wrap msgid "" " total length (header + ret,\n" @@ -4434,12 +4512,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2331 +#: ../src/guestfs.pod:2370 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2333 +#: ../src/guestfs.pod:2372 msgid "" "When the daemon launches it sends an initial word (C) " "which indicates that the guest and daemon is alive. This is what " @@ -4447,12 +4525,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2337 +#: ../src/guestfs.pod:2376 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2339 +#: ../src/guestfs.pod:2378 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -4460,7 +4538,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2343 +#: ../src/guestfs.pod:2382 msgid "" "The library turns them into progress callbacks (see " "L) if there is a callback registered, or discards " @@ -4468,7 +4546,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2347 +#: ../src/guestfs.pod:2386 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C). Not all calls generate progress " @@ -4476,12 +4554,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2351 +#: ../src/guestfs.pod:2390 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2353 +#: ../src/guestfs.pod:2392 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -4489,7 +4567,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2358 +#: ../src/guestfs.pod:2397 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -4506,12 +4584,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2369 +#: ../src/guestfs.pod:2408 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2371 +#: ../src/guestfs.pod:2410 msgid "" "As time passes we cherry pick fixes from the development branch and backport " "those into the stable branch, the effect being that the stable branch should " @@ -4521,26 +4599,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2377 +#: ../src/guestfs.pod:2416 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2383 +#: ../src/guestfs.pod:2422 msgid "" "Documentation changes which don't affect any code are backported unless the " "documentation refers to a future feature which is not in stable." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2389 +#: ../src/guestfs.pod:2428 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2394 +#: ../src/guestfs.pod:2433 msgid "" "Simple rearrangements of code which shouldn't affect how it works get " "backported. This is so that the code in the two branches doesn't get too " @@ -4548,7 +4626,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2400 +#: ../src/guestfs.pod:2439 msgid "" "We I backport new features, new APIs, new tools etc, except in one " "exceptional case: the new feature is required in order to implement an " @@ -4556,7 +4634,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2406 +#: ../src/guestfs.pod:2445 msgid "" "A new stable branch starts when we think the new features in development are " "substantial and compelling enough over the current stable branch to warrant " @@ -4567,17 +4645,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2414 +#: ../src/guestfs.pod:2453 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2416 +#: ../src/guestfs.pod:2455 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2418 +#: ../src/guestfs.pod:2457 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -4585,19 +4663,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2422 +#: ../src/guestfs.pod:2461 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2428 +#: ../src/guestfs.pod:2467 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2431 +#: ../src/guestfs.pod:2470 msgid "" "There are two sorts of API action, depending on whether the call goes " "through to the daemon in the appliance, or is serviced entirely by the " @@ -4608,7 +4686,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2439 +#: ../src/guestfs.pod:2478 msgid "" "Most new actions are of the first type, and get added to the " "C list. Each function has a unique procedure number used " @@ -4618,7 +4696,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2445 +#: ../src/guestfs.pod:2484 msgid "" "For library-only actions of the second type, add to the " "C list. Since these functions are serviced by the " @@ -4628,36 +4706,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2453 +#: ../src/guestfs.pod:2492 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2455 +#: ../src/guestfs.pod:2494 msgid "" "For daemon actions, implement the function CnameE> in the " "C directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2458 +#: ../src/guestfs.pod:2497 msgid "" "For library actions, implement the function CnameE> " "(note: double underscore) in the C directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2461 +#: ../src/guestfs.pod:2500 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2465 +#: ../src/guestfs.pod:2504 msgid "After making these changes, use C to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2467 +#: ../src/guestfs.pod:2506 msgid "" "Note that you don't need to implement the RPC, language bindings, manual " "pages or anything else. It's all automatically generated from the OCaml " @@ -4665,12 +4743,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2471 +#: ../src/guestfs.pod:2510 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2473 +#: ../src/guestfs.pod:2512 msgid "" "You can supply zero or as many tests as you want per API call. The tests " "can either be added as part of the API description " @@ -4680,61 +4758,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2479 +#: ../src/guestfs.pod:2518 msgid "" "The following describes the test environment used when you add an API test " "in C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2482 +#: ../src/guestfs.pod:2521 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2486 +#: ../src/guestfs.pod:2525 msgid "C 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2488 +#: ../src/guestfs.pod:2527 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2490 +#: ../src/guestfs.pod:2529 msgid "C 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2492 +#: ../src/guestfs.pod:2531 msgid "" "C is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2495 +#: ../src/guestfs.pod:2534 msgid "C 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2497 +#: ../src/guestfs.pod:2536 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2499 +#: ../src/guestfs.pod:2538 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2501 +#: ../src/guestfs.pod:2540 msgid "ISO with fixed content (see C)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2505 +#: ../src/guestfs.pod:2544 msgid "" "To be able to run the tests in a reasonable amount of time, the libguestfs " "appliance and block devices are reused between tests. So don't try testing " @@ -4742,7 +4820,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2509 +#: ../src/guestfs.pod:2548 msgid "" "Each test starts with an initial scenario, selected using one of the " "C expressions, described in C. These " @@ -4752,7 +4830,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2515 +#: ../src/guestfs.pod:2554 msgid "" "You can add a prerequisite clause to any individual test. This is a " "run-time check, which, if it fails, causes the test to be skipped. Useful " @@ -4762,14 +4840,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2521 +#: ../src/guestfs.pod:2560 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2524 +#: ../src/guestfs.pod:2563 #, no-wrap msgid "" " SKIP_TEST__=1\n" @@ -4777,17 +4855,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2526 +#: ../src/guestfs.pod:2565 msgid "eg: C skips test #3 of L." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2528 +#: ../src/guestfs.pod:2567 msgid "or:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2530 +#: ../src/guestfs.pod:2569 #, no-wrap msgid "" " SKIP_TEST_=1\n" @@ -4795,17 +4873,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2532 +#: ../src/guestfs.pod:2571 msgid "eg: C skips all L tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2534 +#: ../src/guestfs.pod:2573 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2536 +#: ../src/guestfs.pod:2575 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -4813,29 +4891,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2538 +#: ../src/guestfs.pod:2577 msgid "" "See C for more details of how these environment variables " "work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2541 +#: ../src/guestfs.pod:2580 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2543 +#: ../src/guestfs.pod:2582 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2545 +#: ../src/guestfs.pod:2584 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2547 +#: ../src/guestfs.pod:2586 msgid "" "Debugging the daemon is a problem because it runs inside a minimal " "environment. However you can fprintf messages in the daemon to stderr, and " @@ -4843,12 +4921,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2551 +#: ../src/guestfs.pod:2590 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2553 +#: ../src/guestfs.pod:2592 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -4858,14 +4936,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2559 +#: ../src/guestfs.pod:2598 msgid "" "If you use Emacs, add the following to one of one of your start-up files " "(e.g., ~/.emacs), to help ensure that you get indentation right:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2562 +#: ../src/guestfs.pod:2601 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -4881,7 +4959,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2572 +#: ../src/guestfs.pod:2611 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -4899,12 +4977,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2584 +#: ../src/guestfs.pod:2623 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2587 +#: ../src/guestfs.pod:2626 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -4912,12 +4990,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2589 +#: ../src/guestfs.pod:2628 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2591 +#: ../src/guestfs.pod:2630 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -4926,48 +5004,48 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2594 +#: ../src/guestfs.pod:2633 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2596 +#: ../src/guestfs.pod:2635 msgid "" "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, " "which are used to do shell quoting." msgstr "" #. type: =item -#: ../src/guestfs.pod:2601 +#: ../src/guestfs.pod:2640 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2603 +#: ../src/guestfs.pod:2642 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2606 +#: ../src/guestfs.pod:2645 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2608 +#: ../src/guestfs.pod:2647 msgid "" "Same as C<%Q> except the string is treated as a path which is prefixed by " "the sysroot." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2613 ../fish/guestfish.pod:242 ../fish/guestfish.pod:615 +#: ../src/guestfs.pod:2652 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 msgid "For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2615 +#: ../src/guestfs.pod:2654 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -4975,12 +5053,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2617 +#: ../src/guestfs.pod:2656 msgid "would produce C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2619 +#: ../src/guestfs.pod:2658 msgid "" "I Do I use these when you are passing parameters to the " "C functions. These parameters do NOT need to be quoted " @@ -4989,12 +5067,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2625 +#: ../src/guestfs.pod:2664 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2627 +#: ../src/guestfs.pod:2666 msgid "" "Submit patches to the mailing list: " "L and CC to " @@ -5002,17 +5080,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2631 +#: ../src/guestfs.pod:2670 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2633 +#: ../src/guestfs.pod:2672 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2635 +#: ../src/guestfs.pod:2674 msgid "" "However many messages come from the daemon, and we don't translate those at " "the moment. One reason is that the appliance generally has all locale files " @@ -5021,108 +5099,120 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2641 +#: ../src/guestfs.pod:2680 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2644 +#: ../src/guestfs.pod:2683 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2648 ../src/guestfs-actions.pod:5847 ../fish/guestfish-actions.pod:3932 +#: ../src/guestfs.pod:2687 ../src/guestfs-actions.pod:6174 ../fish/guestfish-actions.pod:4072 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2650 +#: ../src/guestfs.pod:2689 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2652 +#: ../src/guestfs.pod:2691 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2654 +#: ../src/guestfs.pod:2693 msgid "Automated tests of the C API." msgstr "" #. type: =item -#: ../src/guestfs.pod:2656 +#: ../src/guestfs.pod:2695 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2658 +#: ../src/guestfs.pod:2697 msgid "" "The L, L and L commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2661 +#: ../src/guestfs.pod:2700 +msgid "C" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:2702 +msgid "" +"Safety and liveness tests of components that libguestfs depends upon (not of " +"libguestfs itself). Mainly this is for qemu and the kernel." +msgstr "" + +#. type: =item +#: ../src/guestfs.pod:2705 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2663 +#: ../src/guestfs.pod:2707 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2665 +#: ../src/guestfs.pod:2709 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2667 +#: ../src/guestfs.pod:2711 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:2670 +#: ../src/guestfs.pod:2714 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2672 +#: ../src/guestfs.pod:2716 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2674 +#: ../src/guestfs.pod:2718 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2676 +#: ../src/guestfs.pod:2720 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2678 +#: ../src/guestfs.pod:2722 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2680 +#: ../src/guestfs.pod:2724 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:2682 +#: ../src/guestfs.pod:2726 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2684 +#: ../src/guestfs.pod:2728 msgid "" "L, the command-line shell, and various shell scripts built on " "top such as L, L, L, " @@ -5130,89 +5220,89 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2688 +#: ../src/guestfs.pod:2732 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2690 +#: ../src/guestfs.pod:2734 msgid "L, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2692 +#: ../src/guestfs.pod:2736 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2694 +#: ../src/guestfs.pod:2738 msgid "" "The crucially important generator, used to automatically generate large " "amounts of boilerplate C code for things like RPC and bindings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2697 +#: ../src/guestfs.pod:2741 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2699 +#: ../src/guestfs.pod:2743 msgid "Files used by the test suite." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2701 +#: ../src/guestfs.pod:2745 msgid "Some \"phony\" guest images which we test against." msgstr "" #. type: =item -#: ../src/guestfs.pod:2703 +#: ../src/guestfs.pod:2747 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2705 +#: ../src/guestfs.pod:2749 msgid "L, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:2707 +#: ../src/guestfs.pod:2751 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2709 +#: ../src/guestfs.pod:2753 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:2711 +#: ../src/guestfs.pod:2755 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2713 +#: ../src/guestfs.pod:2757 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:2715 +#: ../src/guestfs.pod:2759 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2717 +#: ../src/guestfs.pod:2761 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2719 +#: ../src/guestfs.pod:2763 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2721 +#: ../src/guestfs.pod:2765 msgid "" "The build infrastructure and PO files for translations of manpages and POD " "files. Eventually this will be combined with the C directory, but that " @@ -5220,114 +5310,114 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2725 +#: ../src/guestfs.pod:2769 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2727 +#: ../src/guestfs.pod:2771 msgid "Regression tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:2729 +#: ../src/guestfs.pod:2773 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2731 +#: ../src/guestfs.pod:2775 msgid "L command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2733 +#: ../src/guestfs.pod:2777 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2735 +#: ../src/guestfs.pod:2779 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:2737 +#: ../src/guestfs.pod:2781 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2739 +#: ../src/guestfs.pod:2783 msgid "Command line tools written in Perl (L and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:2741 +#: ../src/guestfs.pod:2785 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2743 +#: ../src/guestfs.pod:2787 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2746 +#: ../src/guestfs.pod:2790 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2748 +#: ../src/guestfs.pod:2792 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2750 +#: ../src/guestfs.pod:2794 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2752 +#: ../src/guestfs.pod:2796 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2754 +#: ../src/guestfs.pod:2798 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2756 +#: ../src/guestfs.pod:2800 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2758 +#: ../src/guestfs.pod:2802 msgid "C" msgstr "" #. type: =item -#: ../src/guestfs.pod:2760 +#: ../src/guestfs.pod:2804 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2762 +#: ../src/guestfs.pod:2806 msgid "Language bindings." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2766 +#: ../src/guestfs.pod:2810 msgid "LIMITS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2768 +#: ../src/guestfs.pod:2812 msgid "PROTOCOL LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2770 +#: ../src/guestfs.pod:2814 msgid "" "Internally libguestfs uses a message-based protocol to pass API calls and " "their responses to and from a small \"appliance\" (see L for " @@ -5338,7 +5428,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2778 +#: ../src/guestfs.pod:2822 msgid "" "A simple call such as L returns its result (the file data) in " "a simple string. Because this string is at some point internally encoded as " @@ -5347,7 +5437,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2784 +#: ../src/guestfs.pod:2828 msgid "" "In order to transfer large files into and out of the guest filesystem, you " "need to use particular calls that support this. The sections L " @@ -5355,24 +5445,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2788 +#: ../src/guestfs.pod:2832 msgid "" "You might also consider mounting the disk image using our FUSE filesystem " "support (L)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2791 +#: ../src/guestfs.pod:2835 msgid "MAXIMUM NUMBER OF DISKS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2793 +#: ../src/guestfs.pod:2837 msgid "When using virtio disks (the default) the current limit is B<25> disks." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2796 +#: ../src/guestfs.pod:2840 msgid "" "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 " "slots. However febootstrap only understands disks with names C " @@ -5381,14 +5471,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2801 +#: ../src/guestfs.pod:2845 msgid "" "We are working to substantially raise this limit in future versions but it " "requires complex changes to qemu." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2804 +#: ../src/guestfs.pod:2848 msgid "" "In future versions of libguestfs it should also be possible to \"hot plug\" " "disks (add and remove disks after calling L). This also " @@ -5396,41 +5486,41 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2808 +#: ../src/guestfs.pod:2852 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2810 +#: ../src/guestfs.pod:2854 msgid "Virtio limits the maximum number of partitions per disk to B<15>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2812 +#: ../src/guestfs.pod:2856 msgid "" "This is because it reserves 4 bits for the minor device number (thus " "C, and C through C)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2815 +#: ../src/guestfs.pod:2859 msgid "" "If you attach a disk with more than 15 partitions, the extra partitions are " "ignored by libguestfs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2818 +#: ../src/guestfs.pod:2862 msgid "MAXIMUM SIZE OF A DISK" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2820 +#: ../src/guestfs.pod:2864 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2822 +#: ../src/guestfs.pod:2866 msgid "" "We have tested block devices up to 1 exabyte (2**60 or " "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host " @@ -5438,7 +5528,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2826 +#: ../src/guestfs.pod:2870 msgid "" "Although libguestfs probably does not impose any limit, the underlying host " "storage will. If you store disk images on a host ext4 filesystem, then the " @@ -5448,19 +5538,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2832 +#: ../src/guestfs.pod:2876 msgid "" "For the hugest disk image files, we recommend using XFS on the host for " "storage." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2835 +#: ../src/guestfs.pod:2879 msgid "MAXIMUM SIZE OF A PARTITION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2837 +#: ../src/guestfs.pod:2881 msgid "" "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector " "numbers. Assuming a 512 byte sector size, this means that MBR cannot " @@ -5468,7 +5558,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2841 +#: ../src/guestfs.pod:2885 msgid "" "It is recommended that you use GPT partitions on disks which are larger than " "this size. GPT uses 64 bit sector numbers and so can address partitions " @@ -5476,12 +5566,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2846 +#: ../src/guestfs.pod:2890 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2848 +#: ../src/guestfs.pod:2892 msgid "" "This depends on the filesystem type. libguestfs itself does not impose any " "known limit. Consult Wikipedia or the filesystem documentation to find out " @@ -5489,12 +5579,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2852 +#: ../src/guestfs.pod:2896 msgid "MAXIMUM UPLOAD AND DOWNLOAD" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2854 +#: ../src/guestfs.pod:2898 msgid "" "The API functions L, L, " "L, L and the like allow unlimited sized " @@ -5502,12 +5592,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2858 +#: ../src/guestfs.pod:2902 msgid "INSPECTION LIMITS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2860 +#: ../src/guestfs.pod:2904 msgid "" "The inspection code has several arbitrary limits on things like the size of " "Windows Registry hive it will read, and the length of product name. These " @@ -5517,44 +5607,44 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1017 ../test-tool/libguestfs-test-tool.pod:82 +#: ../src/guestfs.pod:2910 ../fish/guestfish.pod:1075 ../test-tool/libguestfs-test-tool.pod:82 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1043 +#: ../src/guestfs.pod:2914 ../fish/guestfish.pod:1106 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1045 +#: ../src/guestfs.pod:2916 ../fish/guestfish.pod:1108 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1047 +#: ../src/guestfs.pod:2918 ../fish/guestfish.pod:1110 msgid "LIBGUESTFS_DEBUG" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2876 +#: ../src/guestfs.pod:2920 msgid "" "Set C to enable verbose messages. This has the same " "effect as calling C." msgstr "" #. type: =item -#: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1052 +#: ../src/guestfs.pod:2923 ../fish/guestfish.pod:1115 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1054 +#: ../src/guestfs.pod:2925 ../fish/guestfish.pod:1117 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1057 +#: ../src/guestfs.pod:2928 ../fish/guestfish.pod:1120 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -5562,60 +5652,60 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1059 +#: ../src/guestfs.pod:2930 ../fish/guestfish.pod:1122 msgid "LIBGUESTFS_PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2888 +#: ../src/guestfs.pod:2932 msgid "" "Set the path that libguestfs uses to search for a supermin appliance. See " "the discussion of paths in section L above." msgstr "" #. type: =item -#: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1064 +#: ../src/guestfs.pod:2935 ../fish/guestfish.pod:1127 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1066 +#: ../src/guestfs.pod:2937 ../fish/guestfish.pod:1129 msgid "" "Set the default qemu binary that libguestfs uses. If not set, then the qemu " "which was found at compile time by the configure script is used." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2897 +#: ../src/guestfs.pod:2941 msgid "See also L above." msgstr "" #. type: =item -#: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1070 +#: ../src/guestfs.pod:2943 ../fish/guestfish.pod:1133 msgid "LIBGUESTFS_TRACE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2901 +#: ../src/guestfs.pod:2945 msgid "" "Set C to enable command traces. This has the same " "effect as calling C." msgstr "" #. type: =item -#: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1079 +#: ../src/guestfs.pod:2948 ../fish/guestfish.pod:1142 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1081 +#: ../src/guestfs.pod:2950 ../fish/guestfish.pod:1144 msgid "" "Location of temporary directory, defaults to C except for the cached " "supermin appliance which defaults to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1084 +#: ../src/guestfs.pod:2953 ../fish/guestfish.pod:1147 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -5624,12 +5714,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1151 ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:279 ../tools/virt-win-reg.pl:744 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257 +#: ../src/guestfs.pod:2961 ../fish/guestfish.pod:1214 ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:279 ../tools/virt-win-reg.pl:744 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257 msgid "SEE ALSO" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2919 +#: ../src/guestfs.pod:2963 msgid "" "L, L, L, " "L, L, L, L, " @@ -5642,86 +5732,86 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2946 +#: ../src/guestfs.pod:2990 msgid "" "Tools with a similar purpose: L, L, L, " "L, L." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2953 ../tools/virt-win-reg.pl:759 ../tools/virt-make-fs.pl:553 +#: ../src/guestfs.pod:2997 ../tools/virt-win-reg.pl:759 ../tools/virt-make-fs.pl:553 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2955 +#: ../src/guestfs.pod:2999 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2957 +#: ../src/guestfs.pod:3001 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2959 +#: ../src/guestfs.pod:3003 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2961 +#: ../src/guestfs.pod:3005 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2963 +#: ../src/guestfs.pod:3007 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2969 +#: ../src/guestfs.pod:3013 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2973 +#: ../src/guestfs.pod:3017 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2977 +#: ../src/guestfs.pod:3021 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2981 +#: ../src/guestfs.pod:3025 msgid "" "Run libguestfs-test-tool and paste the B output into the " "bug report." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2986 ../fish/guestfish.pod:1174 ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:290 +#: ../src/guestfs.pod:3030 ../fish/guestfish.pod:1238 ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:290 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2988 ../fish/guestfish.pod:1176 ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:292 +#: ../src/guestfs.pod:3032 ../fish/guestfish.pod:1240 ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:292 msgid "Richard W.M. Jones (C)" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2990 ../fish/guestfish.pod:1178 ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:294 ../tools/virt-win-reg.pl:774 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273 +#: ../src/guestfs.pod:3034 ../fish/guestfish.pod:1242 ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:294 ../tools/virt-win-reg.pl:774 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273 msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2992 ../fish/guestfish.pod:1180 ../test-tool/libguestfs-test-tool.pod:99 +#: ../src/guestfs.pod:3036 ../fish/guestfish.pod:1244 ../test-tool/libguestfs-test-tool.pod:99 msgid "Copyright (C) 2009-2011 Red Hat Inc. L" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2995 +#: ../src/guestfs.pod:3039 msgid "" "This library is free software; you can redistribute it and/or modify it " "under the terms of the GNU Lesser General Public License as published by the " @@ -5730,7 +5820,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3000 +#: ../src/guestfs.pod:3044 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 " @@ -5739,7 +5829,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:3005 +#: ../src/guestfs.pod:3049 msgid "" "You should have received a copy of the GNU Lesser General Public License " "along with this library; if not, write to the Free Software Foundation, " @@ -5789,7 +5879,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:982 ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:1020 ../src/guestfs-actions.pod:1104 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1141 ../src/guestfs-actions.pod:1155 ../src/guestfs-actions.pod:1175 ../src/guestfs-actions.pod:1245 ../src/guestfs-actions.pod:1276 ../src/guestfs-actions.pod:1301 ../src/guestfs-actions.pod:1343 ../src/guestfs-actions.pod:1449 ../src/guestfs-actions.pod:1483 ../src/guestfs-actions.pod:1698 ../src/guestfs-actions.pod:1720 ../src/guestfs-actions.pod:1807 ../src/guestfs-actions.pod:2269 ../src/guestfs-actions.pod:2413 ../src/guestfs-actions.pod:2474 ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:3525 ../src/guestfs-actions.pod:3680 ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3772 ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3881 ../src/guestfs-actions.pod:3904 ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:3959 ../src/guestfs-actions.pod:3978 ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4044 ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4096 ../src/guestfs-actions.pod:4109 ../src/guestfs-actions.pod:4124 ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4254 ../src/guestfs-actions.pod:4267 ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4336 ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4370 ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4398 ../src/guestfs-actions.pod:4415 ../src/guestfs-actions.pod:4430 ../src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4508 ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:4631 ../src/guestfs-actions.pod:4650 ../src/guestfs-actions.pod:4662 ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4692 ../src/guestfs-actions.pod:4707 ../src/guestfs-actions.pod:4722 ../src/guestfs-actions.pod:4757 ../src/guestfs-actions.pod:4779 ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4813 ../src/guestfs-actions.pod:4830 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:4916 ../src/guestfs-actions.pod:4930 ../src/guestfs-actions.pod:4958 ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:4993 ../src/guestfs-actions.pod:5127 ../src/guestfs-actions.pod:5184 ../src/guestfs-actions.pod:5206 ../src/guestfs-actions.pod:5224 ../src/guestfs-actions.pod:5256 ../src/guestfs-actions.pod:5322 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5352 ../src/guestfs-actions.pod:5366 ../src/guestfs-actions.pod:5655 ../src/guestfs-actions.pod:5674 ../src/guestfs-actions.pod:5693 ../src/guestfs-actions.pod:5705 ../src/guestfs-actions.pod:5717 ../src/guestfs-actions.pod:5731 ../src/guestfs-actions.pod:5743 ../src/guestfs-actions.pod:5757 ../src/guestfs-actions.pod:5773 ../src/guestfs-actions.pod:5794 ../src/guestfs-actions.pod:5813 ../src/guestfs-actions.pod:5832 ../src/guestfs-actions.pod:5862 ../src/guestfs-actions.pod:5878 ../src/guestfs-actions.pod:5901 ../src/guestfs-actions.pod:5919 ../src/guestfs-actions.pod:5938 ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:5978 ../src/guestfs-actions.pod:5995 ../src/guestfs-actions.pod:6023 ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:6090 ../src/guestfs-actions.pod:6109 ../src/guestfs-actions.pod:6124 ../src/guestfs-actions.pod:6143 ../src/guestfs-actions.pod:6180 ../src/guestfs-actions.pod:6210 ../src/guestfs-actions.pod:6243 ../src/guestfs-actions.pod:6365 ../src/guestfs-actions.pod:6486 ../src/guestfs-actions.pod:6498 ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6524 ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6559 ../src/guestfs-actions.pod:6572 ../src/guestfs-actions.pod:6585 ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6659 ../src/guestfs-actions.pod:6676 ../src/guestfs-actions.pod:6692 ../src/guestfs-actions.pod:6708 ../src/guestfs-actions.pod:6725 ../src/guestfs-actions.pod:6738 ../src/guestfs-actions.pod:6758 ../src/guestfs-actions.pod:6794 ../src/guestfs-actions.pod:6808 ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:6862 ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6914 ../src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7087 ../src/guestfs-actions.pod:7101 ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7169 ../src/guestfs-actions.pod:7214 ../src/guestfs-actions.pod:7247 ../src/guestfs-actions.pod:7308 ../src/guestfs-actions.pod:7334 ../src/guestfs-actions.pod:7401 ../src/guestfs-actions.pod:7420 ../src/guestfs-actions.pod:7449 +#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140 ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307 ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547 ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676 ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821 ../src/guestfs-actions.pod:858 ../src/guestfs-actions.pod:1041 ../src/guestfs-actions.pod:1061 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1163 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1214 ../src/guestfs-actions.pod:1234 ../src/guestfs-actions.pod:1304 ../src/guestfs-actions.pod:1335 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1402 ../src/guestfs-actions.pod:1508 ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1757 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:2339 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:2544 ../src/guestfs-actions.pod:2579 ../src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3634 ../src/guestfs-actions.pod:3659 ../src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3889 ../src/guestfs-actions.pod:3904 ../src/guestfs-actions.pod:3940 ../src/guestfs-actions.pod:4012 ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4049 ../src/guestfs-actions.pod:4072 ../src/guestfs-actions.pod:4095 ../src/guestfs-actions.pod:4130 ../src/guestfs-actions.pod:4149 ../src/guestfs-actions.pod:4168 ../src/guestfs-actions.pod:4203 ../src/guestfs-actions.pod:4215 ../src/guestfs-actions.pod:4251 ../src/guestfs-actions.pod:4267 ../src/guestfs-actions.pod:4280 ../src/guestfs-actions.pod:4295 ../src/guestfs-actions.pod:4312 ../src/guestfs-actions.pod:4405 ../src/guestfs-actions.pod:4425 ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:4489 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4525 ../src/guestfs-actions.pod:4541 ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:4569 ../src/guestfs-actions.pod:4586 ../src/guestfs-actions.pod:4601 ../src/guestfs-actions.pod:4621 ../src/guestfs-actions.pod:4691 ../src/guestfs-actions.pod:4764 ../src/guestfs-actions.pod:4795 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4833 ../src/guestfs-actions.pod:4845 ../src/guestfs-actions.pod:4862 ../src/guestfs-actions.pod:4875 ../src/guestfs-actions.pod:4890 ../src/guestfs-actions.pod:4905 ../src/guestfs-actions.pod:4940 ../src/guestfs-actions.pod:4973 ../src/guestfs-actions.pod:5012 ../src/guestfs-actions.pod:5032 ../src/guestfs-actions.pod:5046 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5112 ../src/guestfs-actions.pod:5158 ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:5248 ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:5300 ../src/guestfs-actions.pod:5318 ../src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5509 ../src/guestfs-actions.pod:5531 ../src/guestfs-actions.pod:5549 ../src/guestfs-actions.pod:5581 ../src/guestfs-actions.pod:5647 ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:5677 ../src/guestfs-actions.pod:5691 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:5999 ../src/guestfs-actions.pod:6018 ../src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6044 ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6070 ../src/guestfs-actions.pod:6084 ../src/guestfs-actions.pod:6100 ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6140 ../src/guestfs-actions.pod:6159 ../src/guestfs-actions.pod:6189 ../src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:6230 ../src/guestfs-actions.pod:6248 ../src/guestfs-actions.pod:6267 ../src/guestfs-actions.pod:6288 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6324 ../src/guestfs-actions.pod:6343 ../src/guestfs-actions.pod:6369 ../src/guestfs-actions.pod:6393 ../src/guestfs-actions.pod:6412 ../src/guestfs-actions.pod:6436 ../src/guestfs-actions.pod:6455 ../src/guestfs-actions.pod:6470 ../src/guestfs-actions.pod:6489 ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6556 ../src/guestfs-actions.pod:6589 ../src/guestfs-actions.pod:6711 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6844 ../src/guestfs-actions.pod:6857 ../src/guestfs-actions.pod:6870 ../src/guestfs-actions.pod:6892 ../src/guestfs-actions.pod:6905 ../src/guestfs-actions.pod:6918 ../src/guestfs-actions.pod:6931 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:7005 ../src/guestfs-actions.pod:7022 ../src/guestfs-actions.pod:7038 ../src/guestfs-actions.pod:7054 ../src/guestfs-actions.pod:7071 ../src/guestfs-actions.pod:7084 ../src/guestfs-actions.pod:7104 ../src/guestfs-actions.pod:7140 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7195 ../src/guestfs-actions.pod:7208 ../src/guestfs-actions.pod:7226 ../src/guestfs-actions.pod:7260 ../src/guestfs-actions.pod:7296 ../src/guestfs-actions.pod:7412 ../src/guestfs-actions.pod:7427 ../src/guestfs-actions.pod:7441 ../src/guestfs-actions.pod:7496 ../src/guestfs-actions.pod:7509 ../src/guestfs-actions.pod:7554 ../src/guestfs-actions.pod:7587 ../src/guestfs-actions.pod:7650 ../src/guestfs-actions.pod:7670 ../src/guestfs-actions.pod:7694 ../src/guestfs-actions.pod:7761 ../src/guestfs-actions.pod:7780 ../src/guestfs-actions.pod:7809 msgid "This function returns 0 on success or -1 on error." msgstr "" @@ -5801,7 +5891,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1454 ../src/guestfs-actions.pod:1947 ../src/guestfs-actions.pod:1968 ../src/guestfs-actions.pod:4455 ../src/guestfs-actions.pod:4762 ../src/guestfs-actions.pod:6188 ../src/guestfs-actions.pod:6218 ../src/guestfs-actions.pod:6251 ../src/guestfs-actions.pod:6310 ../src/guestfs-actions.pod:7252 ../src/guestfs-actions.pod:7342 ../src/guestfs-actions.pod:7512 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1321 ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:3025 ../fish/guestfish-actions.pod:3222 ../fish/guestfish-actions.pod:4194 ../fish/guestfish-actions.pod:4217 ../fish/guestfish-actions.pod:4239 ../fish/guestfish-actions.pod:4277 ../fish/guestfish-actions.pod:4918 ../fish/guestfish-actions.pod:5016 +#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257 ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1513 ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:4626 ../src/guestfs-actions.pod:4945 ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5253 ../src/guestfs-actions.pod:6534 ../src/guestfs-actions.pod:6564 ../src/guestfs-actions.pod:6597 ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:7592 ../src/guestfs-actions.pod:7702 ../src/guestfs-actions.pod:7872 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360 ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292 ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454 ../fish/guestfish-actions.pod:4349 ../fish/guestfish-actions.pod:4372 ../fish/guestfish-actions.pod:4394 ../fish/guestfish-actions.pod:4432 ../fish/guestfish-actions.pod:5081 ../fish/guestfish-actions.pod:5179 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 " @@ -5809,7 +5899,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1106 ../src/guestfs-actions.pod:1919 ../src/guestfs-actions.pod:2017 ../src/guestfs-actions.pod:2120 ../src/guestfs-actions.pod:3487 ../src/guestfs-actions.pod:3507 ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:5880 ../src/guestfs-actions.pod:5997 ../src/guestfs-actions.pod:6111 ../src/guestfs-actions.pod:6602 ../src/guestfs-actions.pod:6727 ../src/guestfs-actions.pod:7256 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142 ../src/guestfs-actions.pod:1165 ../src/guestfs-actions.pod:1980 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2190 ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3641 ../src/guestfs-actions.pod:4949 ../src/guestfs-actions.pod:6209 ../src/guestfs-actions.pod:6326 ../src/guestfs-actions.pod:6457 ../src/guestfs-actions.pod:6948 ../src/guestfs-actions.pod:7073 ../src/guestfs-actions.pod:7596 msgid "(Added in 0.3)" msgstr "" @@ -5830,7 +5920,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:4469 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151 ../src/guestfs-actions.pod:832 ../src/guestfs-actions.pod:2824 ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:4959 ../src/guestfs-actions.pod:5176 msgid "" "You may supply a list of optional arguments to this call. Use zero or more " "of the following pairs of parameters, and terminate the list with C<-1> on " @@ -5917,7 +6007,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350 ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:693 ../src/guestfs-actions.pod:724 ../src/guestfs-actions.pod:742 ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:1321 ../src/guestfs-actions.pod:1677 ../src/guestfs-actions.pod:1880 ../src/guestfs-actions.pod:1989 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:2084 ../src/guestfs-actions.pod:2107 ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:2804 ../src/guestfs-actions.pod:4902 ../src/guestfs-actions.pod:5030 ../src/guestfs-actions.pod:5436 ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:6835 ../src/guestfs-actions.pod:7267 ../src/guestfs-actions.pod:7280 ../src/guestfs-actions.pod:7293 +#: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350 ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:693 ../src/guestfs-actions.pod:724 ../src/guestfs-actions.pod:742 ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:1380 ../src/guestfs-actions.pod:1736 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:2050 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2154 ../src/guestfs-actions.pod:2177 ../src/guestfs-actions.pod:2470 ../src/guestfs-actions.pod:2942 ../src/guestfs-actions.pod:2960 ../src/guestfs-actions.pod:5135 ../src/guestfs-actions.pod:5355 ../src/guestfs-actions.pod:5761 ../src/guestfs-actions.pod:5787 ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7607 ../src/guestfs-actions.pod:7620 ../src/guestfs-actions.pod:7633 msgid "On error this function returns -1." msgstr "" @@ -5948,7 +6038,7 @@ msgid "This is the \"va_list variant\" of L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225 ../src/guestfs-actions.pod:4522 ../src/guestfs-actions.pod:4534 +#: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225 ../src/guestfs-actions.pod:871 ../src/guestfs-actions.pod:882 ../src/guestfs-actions.pod:2908 ../src/guestfs-actions.pod:2920 ../src/guestfs-actions.pod:4705 ../src/guestfs-actions.pod:4717 ../src/guestfs-actions.pod:4987 ../src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:5225 ../src/guestfs-actions.pod:5236 msgid "See L." msgstr "" @@ -6055,7 +6145,7 @@ msgid "This call checks that C exists." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4480 ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3036 +#: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4653 ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3096 msgid "The optional arguments are:" msgstr "" @@ -6205,7 +6295,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282 ../src/guestfs-actions.pod:2359 +#: ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282 ../src/guestfs-actions.pod:2429 msgid "(Added in 1.0.84)" msgstr "" @@ -6255,7 +6345,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2109 +#: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2179 msgid "(Added in 1.3.4)" msgstr "" @@ -6282,7 +6372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366 ../src/guestfs-actions.pod:424 ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:5513 +#: ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366 ../src/guestfs-actions.pod:424 ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549 ../src/guestfs-actions.pod:5838 msgid "(Added in 0.7)" msgstr "" @@ -6383,7 +6473,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:941 ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1190 ../src/guestfs-actions.pod:1207 ../src/guestfs-actions.pod:1226 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1548 ../src/guestfs-actions.pod:1660 ../src/guestfs-actions.pod:1823 ../src/guestfs-actions.pod:1840 ../src/guestfs-actions.pod:1907 ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:2132 ../src/guestfs-actions.pod:2324 ../src/guestfs-actions.pod:2531 ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2735 ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:2875 ../src/guestfs-actions.pod:2906 ../src/guestfs-actions.pod:2930 ../src/guestfs-actions.pod:2967 ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3050 ../src/guestfs-actions.pod:3071 ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:4016 ../src/guestfs-actions.pod:4186 ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5241 ../src/guestfs-actions.pod:5411 ../src/guestfs-actions.pod:5589 ../src/guestfs-actions.pod:5638 ../src/guestfs-actions.pod:6271 ../src/guestfs-actions.pod:6287 ../src/guestfs-actions.pod:6304 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:7009 ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7046 ../src/guestfs-actions.pod:7226 ../src/guestfs-actions.pod:7506 +#: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:922 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1119 ../src/guestfs-actions.pod:1249 ../src/guestfs-actions.pod:1266 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1966 ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:2023 ../src/guestfs-actions.pod:2202 ../src/guestfs-actions.pod:2394 ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:2811 ../src/guestfs-actions.pod:3025 ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074 ../src/guestfs-actions.pod:3108 ../src/guestfs-actions.pod:3167 ../src/guestfs-actions.pod:3187 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3834 ../src/guestfs-actions.pod:4187 ../src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:4467 ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:5566 ../src/guestfs-actions.pod:5736 ../src/guestfs-actions.pod:5914 ../src/guestfs-actions.pod:5963 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:6633 ../src/guestfs-actions.pod:6650 ../src/guestfs-actions.pod:6681 ../src/guestfs-actions.pod:7355 ../src/guestfs-actions.pod:7374 ../src/guestfs-actions.pod:7392 ../src/guestfs-actions.pod:7566 ../src/guestfs-actions.pod:7866 msgid "" "This function returns a string, or NULL on error. I." @@ -6580,7 +6670,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:485 ../src/guestfs-actions.pod:631 ../src/guestfs-actions.pod:1079 ../src/guestfs-actions.pod:1375 ../src/guestfs-actions.pod:1394 ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1516 ../src/guestfs-actions.pod:1762 ../src/guestfs-actions.pod:2204 ../src/guestfs-actions.pod:2220 ../src/guestfs-actions.pod:2239 ../src/guestfs-actions.pod:2282 ../src/guestfs-actions.pod:2306 ../src/guestfs-actions.pod:2377 ../src/guestfs-actions.pod:2426 ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2984 ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:3586 ../src/guestfs-actions.pod:3648 ../src/guestfs-actions.pod:3753 ../src/guestfs-actions.pod:4158 ../src/guestfs-actions.pod:4863 ../src/guestfs-actions.pod:5383 ../src/guestfs-actions.pod:5509 ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6412 ../src/guestfs-actions.pod:6467 ../src/guestfs-actions.pod:6613 ../src/guestfs-actions.pod:6637 ../src/guestfs-actions.pod:7119 ../src/guestfs-actions.pod:7139 ../src/guestfs-actions.pod:7186 ../src/guestfs-actions.pod:7358 ../src/guestfs-actions.pod:7377 ../src/guestfs-actions.pod:7463 ../src/guestfs-actions.pod:7482 ../src/guestfs-actions.pod:7528 ../src/guestfs-actions.pod:7547 +#: ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:485 ../src/guestfs-actions.pod:631 ../src/guestfs-actions.pod:1138 ../src/guestfs-actions.pod:1434 ../src/guestfs-actions.pod:1453 ../src/guestfs-actions.pod:1556 ../src/guestfs-actions.pod:1575 ../src/guestfs-actions.pod:1821 ../src/guestfs-actions.pod:2274 ../src/guestfs-actions.pod:2290 ../src/guestfs-actions.pod:2309 ../src/guestfs-actions.pod:2352 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2496 ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:3127 ../src/guestfs-actions.pod:3403 ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3754 ../src/guestfs-actions.pod:3816 ../src/guestfs-actions.pod:3921 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:5096 ../src/guestfs-actions.pod:5708 ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5948 ../src/guestfs-actions.pod:6697 ../src/guestfs-actions.pod:6758 ../src/guestfs-actions.pod:6813 ../src/guestfs-actions.pod:6959 ../src/guestfs-actions.pod:6983 ../src/guestfs-actions.pod:7459 ../src/guestfs-actions.pod:7479 ../src/guestfs-actions.pod:7526 ../src/guestfs-actions.pod:7718 ../src/guestfs-actions.pod:7737 ../src/guestfs-actions.pod:7823 ../src/guestfs-actions.pod:7842 ../src/guestfs-actions.pod:7888 ../src/guestfs-actions.pod:7907 msgid "" "This function returns a NULL-terminated array of strings (like " "L), or NULL if there was an error. I" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:851 ../fish/guestfish-actions.pod:561 +msgid "" +"The new size (in bytes) of the filesystem. If omitted, the filesystem is " +"resized to the maximum size." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:856 ../fish/guestfish-actions.pod:566 +msgid "See also L." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:860 +msgid "(Added in 1.11.17)" +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:862 +msgid "guestfs_btrfs_filesystem_resize_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:864 +#, no-wrap +msgid "" +" int\n" +" guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n" +" const char *mountpoint,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:869 +msgid "This is the \"va_list variant\" of L." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:873 +msgid "guestfs_btrfs_filesystem_resize_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:875 +#, no-wrap +msgid "" +" int\n" +" guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n" +" const char *mountpoint,\n" +" const struct " +"guestfs_btrfs_filesystem_resize_argv *optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:880 +msgid "This is the \"argv variant\" of L." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:884 +msgid "guestfs_case_sensitive_path" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:886 +#, no-wrap +msgid "" " char *\n" " guestfs_case_sensitive_path (guestfs_h *g,\n" " const char *path);\n" @@ -7168,7 +7365,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:831 ../fish/guestfish-actions.pod:549 +#: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:574 msgid "" "This can be used to resolve case insensitive paths on a filesystem which is " "case sensitive. The use case is to resolve paths which you have read from " @@ -7176,7 +7373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:836 ../fish/guestfish-actions.pod:554 +#: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:579 msgid "" "The command handles a peculiarity of the Linux ntfs-3g filesystem driver " "(and probably others), which is that although the underlying filesystem is " @@ -7185,7 +7382,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:559 +#: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:584 msgid "" "One consequence of this is that special directories such as C " "may appear as C or C (or other things) depending on the " @@ -7194,21 +7391,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:847 ../fish/guestfish-actions.pod:565 +#: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:590 msgid "" "Bug or feature? You decide: " "L" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:850 ../fish/guestfish-actions.pod:568 +#: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:593 msgid "" "This function resolves the true case of each element in the path and returns " "the case-sensitive path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:853 +#: ../src/guestfs-actions.pod:912 msgid "" "Thus C (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " @@ -7216,27 +7413,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:858 ../fish/guestfish-actions.pod:576 +#: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:601 msgid "I: This function does not handle drive names, backslashes etc." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:861 +#: ../src/guestfs-actions.pod:920 msgid "See also C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:866 ../src/guestfs-actions.pod:7031 +#: ../src/guestfs-actions.pod:925 ../src/guestfs-actions.pod:7377 msgid "(Added in 1.0.75)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:868 +#: ../src/guestfs-actions.pod:927 msgid "guestfs_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:870 +#: ../src/guestfs-actions.pod:929 #, no-wrap msgid "" " char *\n" @@ -7246,12 +7443,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:5499 ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:3691 +#: ../src/guestfs-actions.pod:933 ../src/guestfs-actions.pod:5824 ../fish/guestfish-actions.pod:610 ../fish/guestfish-actions.pod:3831 msgid "Return the contents of the file named C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:876 +#: ../src/guestfs-actions.pod:935 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -7260,24 +7457,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:884 ../src/guestfs-actions.pod:1063 ../src/guestfs-actions.pod:1083 ../src/guestfs-actions.pod:1379 ../src/guestfs-actions.pod:1398 ../src/guestfs-actions.pod:1501 ../src/guestfs-actions.pod:1520 ../src/guestfs-actions.pod:1766 ../src/guestfs-actions.pod:2224 ../src/guestfs-actions.pod:2243 ../src/guestfs-actions.pod:2286 ../src/guestfs-actions.pod:2310 ../src/guestfs-actions.pod:2327 ../src/guestfs-actions.pod:2356 ../src/guestfs-actions.pod:5281 ../src/guestfs-actions.pod:5307 ../src/guestfs-actions.pod:5438 ../src/guestfs-actions.pod:5464 ../src/guestfs-actions.pod:5488 ../src/guestfs-actions.pod:6416 ../src/guestfs-actions.pod:6471 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:6641 ../src/guestfs-actions.pod:7310 ../src/guestfs-actions.pod:7336 ../src/guestfs-actions.pod:7362 ../src/guestfs-actions.pod:7381 ../src/guestfs-actions.pod:7467 ../src/guestfs-actions.pod:7486 ../src/guestfs-actions.pod:7532 ../src/guestfs-actions.pod:7551 ../fish/guestfish-actions.pod:592 ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739 ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925 ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002 ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1495 ../fish/guestfish-actions.pod:1505 ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:1548 ../fish/guestfish-actions.pod:1558 ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:3561 ../fish/guestfish-actions.pod:3576 ../fish/guestfish-actions.pod:3652 ../fish/guestfish-actions.pod:3669 ../fish/guestfish-actions.pod:3684 ../fish/guestfish-actions.pod:4338 ../fish/guestfish-actions.pod:4384 ../fish/guestfish-actions.pod:4469 ../fish/guestfish-actions.pod:4484 ../fish/guestfish-actions.pod:4894 ../fish/guestfish-actions.pod:4912 ../fish/guestfish-actions.pod:4929 ../fish/guestfish-actions.pod:4939 ../fish/guestfish-actions.pod:4988 ../fish/guestfish-actions.pod:4998 ../fish/guestfish-actions.pod:5027 ../fish/guestfish-actions.pod:5037 +#: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1560 ../src/guestfs-actions.pod:1579 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:2294 ../src/guestfs-actions.pod:2313 ../src/guestfs-actions.pod:2356 ../src/guestfs-actions.pod:2380 ../src/guestfs-actions.pod:2397 ../src/guestfs-actions.pod:2426 ../src/guestfs-actions.pod:5606 ../src/guestfs-actions.pod:5632 ../src/guestfs-actions.pod:5763 ../src/guestfs-actions.pod:5789 ../src/guestfs-actions.pod:5813 ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:6817 ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:6987 ../src/guestfs-actions.pod:7652 ../src/guestfs-actions.pod:7672 ../src/guestfs-actions.pod:7696 ../src/guestfs-actions.pod:7722 ../src/guestfs-actions.pod:7741 ../src/guestfs-actions.pod:7827 ../src/guestfs-actions.pod:7846 ../src/guestfs-actions.pod:7892 ../src/guestfs-actions.pod:7911 ../fish/guestfish-actions.pod:617 ../fish/guestfish-actions.pod:752 ../fish/guestfish-actions.pod:764 ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:1017 ../fish/guestfish-actions.pod:1027 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:1536 ../fish/guestfish-actions.pod:1564 ../fish/guestfish-actions.pod:1579 ../fish/guestfish-actions.pod:1589 ../fish/guestfish-actions.pod:1608 ../fish/guestfish-actions.pod:3701 ../fish/guestfish-actions.pod:3716 ../fish/guestfish-actions.pod:3792 ../fish/guestfish-actions.pod:3809 ../fish/guestfish-actions.pod:3824 ../fish/guestfish-actions.pod:4493 ../fish/guestfish-actions.pod:4539 ../fish/guestfish-actions.pod:4624 ../fish/guestfish-actions.pod:4639 ../fish/guestfish-actions.pod:5045 ../fish/guestfish-actions.pod:5057 ../fish/guestfish-actions.pod:5075 ../fish/guestfish-actions.pod:5092 ../fish/guestfish-actions.pod:5102 ../fish/guestfish-actions.pod:5151 ../fish/guestfish-actions.pod:5161 ../fish/guestfish-actions.pod:5190 ../fish/guestfish-actions.pod:5200 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:887 ../src/guestfs-actions.pod:3590 ../src/guestfs-actions.pod:3652 ../src/guestfs-actions.pod:3669 ../src/guestfs-actions.pod:3757 ../src/guestfs-actions.pod:4162 ../src/guestfs-actions.pod:4176 ../src/guestfs-actions.pod:5387 ../src/guestfs-actions.pod:5401 ../src/guestfs-actions.pod:7190 ../src/guestfs-actions.pod:7204 +#: ../src/guestfs-actions.pod:946 ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3837 ../src/guestfs-actions.pod:3925 ../src/guestfs-actions.pod:4333 ../src/guestfs-actions.pod:4347 ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5726 ../src/guestfs-actions.pod:7530 ../src/guestfs-actions.pod:7544 msgid "(Added in 0.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:889 +#: ../src/guestfs-actions.pod:948 msgid "guestfs_checksum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:891 +#: ../src/guestfs-actions.pod:950 #, no-wrap msgid "" " char *\n" @@ -7288,116 +7485,116 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:896 ../fish/guestfish-actions.pod:599 +#: ../src/guestfs-actions.pod:955 ../fish/guestfish-actions.pod:624 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:899 ../fish/guestfish-actions.pod:602 +#: ../src/guestfs-actions.pod:958 ../fish/guestfish-actions.pod:627 msgid "" "The type of checksum to compute is given by the C parameter which " "must have one of the following values:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:904 ../fish/guestfish-actions.pod:607 +#: ../src/guestfs-actions.pod:963 ../fish/guestfish-actions.pod:632 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:609 +#: ../src/guestfs-actions.pod:965 ../fish/guestfish-actions.pod:634 msgid "" "Compute the cyclic redundancy check (CRC) specified by POSIX for the " "C command." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:612 +#: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:637 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:614 +#: ../src/guestfs-actions.pod:970 ../fish/guestfish-actions.pod:639 msgid "Compute the MD5 hash (using the C program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:616 +#: ../src/guestfs-actions.pod:972 ../fish/guestfish-actions.pod:641 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:618 +#: ../src/guestfs-actions.pod:974 ../fish/guestfish-actions.pod:643 msgid "Compute the SHA1 hash (using the C program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:620 +#: ../src/guestfs-actions.pod:976 ../fish/guestfish-actions.pod:645 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:622 +#: ../src/guestfs-actions.pod:978 ../fish/guestfish-actions.pod:647 msgid "Compute the SHA224 hash (using the C program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:624 +#: ../src/guestfs-actions.pod:980 ../fish/guestfish-actions.pod:649 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:626 +#: ../src/guestfs-actions.pod:982 ../fish/guestfish-actions.pod:651 msgid "Compute the SHA256 hash (using the C program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:628 +#: ../src/guestfs-actions.pod:984 ../fish/guestfish-actions.pod:653 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:927 ../fish/guestfish-actions.pod:630 +#: ../src/guestfs-actions.pod:986 ../fish/guestfish-actions.pod:655 msgid "Compute the SHA384 hash (using the C program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:632 +#: ../src/guestfs-actions.pod:988 ../fish/guestfish-actions.pod:657 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:931 ../fish/guestfish-actions.pod:634 +#: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:659 msgid "Compute the SHA512 hash (using the C program)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:935 ../fish/guestfish-actions.pod:638 +#: ../src/guestfs-actions.pod:994 ../fish/guestfish-actions.pod:663 msgid "The checksum is returned as a printable string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:937 +#: ../src/guestfs-actions.pod:996 msgid "To get the checksum for a device, use C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:939 +#: ../src/guestfs-actions.pod:998 msgid "To get the checksums for many files, use C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:1252 ../src/guestfs-actions.pod:2086 ../src/guestfs-actions.pod:3306 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3396 ../src/guestfs-actions.pod:3423 ../src/guestfs-actions.pod:6887 +#: ../src/guestfs-actions.pod:1003 ../src/guestfs-actions.pod:1311 ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:3436 ../src/guestfs-actions.pod:3465 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:7233 msgid "(Added in 1.0.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:946 +#: ../src/guestfs-actions.pod:1005 msgid "guestfs_checksum_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:948 +#: ../src/guestfs-actions.pod:1007 #, no-wrap msgid "" " char *\n" @@ -7408,7 +7605,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:953 +#: ../src/guestfs-actions.pod:1012 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C. For the types of checksums supported see the " @@ -7416,17 +7613,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:960 ../src/guestfs-actions.pod:4918 ../src/guestfs-actions.pod:4977 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:5032 ../src/guestfs-actions.pod:5208 ../src/guestfs-actions.pod:6796 ../src/guestfs-actions.pod:6810 ../src/guestfs-actions.pod:7216 +#: ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5357 ../src/guestfs-actions.pod:5533 ../src/guestfs-actions.pod:7142 ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7556 msgid "(Added in 1.3.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:962 +#: ../src/guestfs-actions.pod:1021 msgid "guestfs_checksums_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:964 +#: ../src/guestfs-actions.pod:1023 #, no-wrap msgid "" " int\n" @@ -7438,14 +7635,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:970 ../fish/guestfish-actions.pod:656 +#: ../src/guestfs-actions.pod:1029 ../fish/guestfish-actions.pod:681 msgid "" "This command computes the checksums of all regular files in C and " "then emits a list of those checksums to the local output file C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:974 ../fish/guestfish-actions.pod:660 +#: ../src/guestfs-actions.pod:1033 ../fish/guestfish-actions.pod:685 msgid "" "This can be used for verifying the integrity of a virtual machine. However " "to be properly secure you should pay attention to the output of the checksum " @@ -7455,17 +7652,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:984 +#: ../src/guestfs-actions.pod:1043 msgid "(Added in 1.3.7)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:986 +#: ../src/guestfs-actions.pod:1045 msgid "guestfs_chmod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:988 +#: ../src/guestfs-actions.pod:1047 #, no-wrap msgid "" " int\n" @@ -7476,14 +7673,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:993 ../fish/guestfish-actions.pod:674 +#: ../src/guestfs-actions.pod:1052 ../fish/guestfish-actions.pod:699 msgid "" "Change the mode (permissions) of C to C. Only numeric modes are " "supported." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:996 ../fish/guestfish-actions.pod:677 +#: ../src/guestfs-actions.pod:1055 ../fish/guestfish-actions.pod:702 msgid "" "I: When using this command from guestfish, C by default would be " "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not " @@ -7491,17 +7688,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4610 ../src/guestfs-actions.pod:4629 ../src/guestfs-actions.pod:4648 ../fish/guestfish-actions.pod:681 ../fish/guestfish-actions.pod:3000 ../fish/guestfish-actions.pod:3129 ../fish/guestfish-actions.pod:3139 ../fish/guestfish-actions.pod:3149 +#: ../src/guestfs-actions.pod:1059 ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:4793 ../src/guestfs-actions.pod:4812 ../src/guestfs-actions.pod:4831 ../fish/guestfish-actions.pod:706 ../fish/guestfish-actions.pod:3060 ../fish/guestfish-actions.pod:3199 ../fish/guestfish-actions.pod:3209 ../fish/guestfish-actions.pod:3219 msgid "The mode actually set is affected by the umask." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1006 +#: ../src/guestfs-actions.pod:1065 msgid "guestfs_chown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1008 +#: ../src/guestfs-actions.pod:1067 #, no-wrap msgid "" " int\n" @@ -7513,12 +7710,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1014 ../fish/guestfish-actions.pod:687 +#: ../src/guestfs-actions.pod:1073 ../fish/guestfish-actions.pod:712 msgid "Change the file owner to C and group to C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:3521 ../fish/guestfish-actions.pod:689 ../fish/guestfish-actions.pod:2458 +#: ../src/guestfs-actions.pod:1075 ../src/guestfs-actions.pod:3655 ../fish/guestfish-actions.pod:714 ../fish/guestfish-actions.pod:2495 msgid "" "Only numeric uid and gid are supported. If you want to use names, you will " "need to locate and parse the password file yourself (Augeas support makes " @@ -7526,12 +7723,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1024 +#: ../src/guestfs-actions.pod:1083 msgid "guestfs_command" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1026 +#: ../src/guestfs-actions.pod:1085 #, no-wrap msgid "" " char *\n" @@ -7541,7 +7738,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1030 ../fish/guestfish-actions.pod:697 +#: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:722 msgid "" "This call runs a command from the guest filesystem. The filesystem must be " "mounted, and must contain a compatible operating system (ie. something " @@ -7549,7 +7746,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1035 +#: ../src/guestfs-actions.pod:1094 msgid "" "The single parameter is an argv-style list of arguments. The first element " "is the name of the program to run. Subsequent elements are parameters. The " @@ -7559,12 +7756,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1042 ../fish/guestfish-actions.pod:709 +#: ../src/guestfs-actions.pod:1101 ../fish/guestfish-actions.pod:734 msgid "The return value is anything printed to I by the command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1045 ../fish/guestfish-actions.pod:712 +#: ../src/guestfs-actions.pod:1104 ../fish/guestfish-actions.pod:737 msgid "" "If the command returns a non-zero exit status, then this function returns an " "error message. The error message string is the content of I from " @@ -7572,7 +7769,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1049 ../fish/guestfish-actions.pod:716 +#: ../src/guestfs-actions.pod:1108 ../fish/guestfish-actions.pod:741 msgid "" "The C<$PATH> environment variable will contain at least C and " "C. If you require a program from another location, you should provide " @@ -7580,7 +7777,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1054 ../fish/guestfish-actions.pod:721 +#: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:746 msgid "" "Shared libraries and data files required by the program must be available on " "filesystems which are mounted in the correct places. It is the caller's " @@ -7589,17 +7786,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1066 ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:1551 +#: ../src/guestfs-actions.pod:1125 ../src/guestfs-actions.pod:1145 ../src/guestfs-actions.pod:1610 msgid "(Added in 0.9.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1068 +#: ../src/guestfs-actions.pod:1127 msgid "guestfs_command_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1070 +#: ../src/guestfs-actions.pod:1129 #, no-wrap msgid "" " char **\n" @@ -7609,24 +7806,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1074 +#: ../src/guestfs-actions.pod:1133 msgid "" "This is the same as C, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1077 +#: ../src/guestfs-actions.pod:1136 msgid "See also: C" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1088 +#: ../src/guestfs-actions.pod:1147 msgid "guestfs_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1090 +#: ../src/guestfs-actions.pod:1149 #, no-wrap msgid "" " int\n" @@ -7637,7 +7834,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1095 ../fish/guestfish-actions.pod:746 +#: ../src/guestfs-actions.pod:1154 ../fish/guestfish-actions.pod:771 msgid "" "This can be used to add arbitrary qemu command line parameters of the form " "I<-param value>. Actually it's not quite arbitrary - we prevent you from " @@ -7645,22 +7842,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1100 ../fish/guestfish-actions.pod:751 +#: ../src/guestfs-actions.pod:1159 ../fish/guestfish-actions.pod:776 msgid "The first character of C string must be a C<-> (dash)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1102 ../fish/guestfish-actions.pod:753 +#: ../src/guestfs-actions.pod:1161 ../fish/guestfish-actions.pod:778 msgid "C can be NULL." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1108 +#: ../src/guestfs-actions.pod:1167 msgid "guestfs_copy_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1110 +#: ../src/guestfs-actions.pod:1169 #, no-wrap msgid "" " int\n" @@ -7672,21 +7869,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1116 ../fish/guestfish-actions.pod:759 +#: ../src/guestfs-actions.pod:1175 ../fish/guestfish-actions.pod:784 msgid "" "This command copies exactly C bytes from one source device or file " "C to another destination device or file C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1119 ../fish/guestfish-actions.pod:762 +#: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:787 msgid "" "Note this will fail if the source is too short or if the destination is not " "large enough." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1124 ../src/guestfs-actions.pod:1247 ../src/guestfs-actions.pod:1278 ../src/guestfs-actions.pod:1323 ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:3502 ../src/guestfs-actions.pod:6882 ../src/guestfs-actions.pod:6916 ../src/guestfs-actions.pod:7403 ../src/guestfs-actions.pod:7422 +#: ../src/guestfs-actions.pod:1183 ../src/guestfs-actions.pod:1306 ../src/guestfs-actions.pod:1337 ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:1781 ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:7228 ../src/guestfs-actions.pod:7262 ../src/guestfs-actions.pod:7763 ../src/guestfs-actions.pod:7782 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -7695,17 +7892,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:4189 ../src/guestfs-actions.pod:5414 ../src/guestfs-actions.pod:7123 ../src/guestfs-actions.pod:7143 ../src/guestfs-actions.pod:7229 +#: ../src/guestfs-actions.pod:1188 ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:5739 ../src/guestfs-actions.pod:7463 ../src/guestfs-actions.pod:7483 ../src/guestfs-actions.pod:7569 msgid "(Added in 1.0.87)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1131 +#: ../src/guestfs-actions.pod:1190 msgid "guestfs_cp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1133 +#: ../src/guestfs-actions.pod:1192 #, no-wrap msgid "" " int\n" @@ -7716,24 +7913,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1138 ../fish/guestfish-actions.pod:769 +#: ../src/guestfs-actions.pod:1197 ../fish/guestfish-actions.pod:794 msgid "" "This copies a file from C to C where C is either a " "destination filename or destination directory." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1157 ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1303 ../src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:4881 ../src/guestfs-actions.pod:5258 +#: ../src/guestfs-actions.pod:1202 ../src/guestfs-actions.pod:1216 ../src/guestfs-actions.pod:1288 ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:1476 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5583 msgid "(Added in 1.0.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1145 +#: ../src/guestfs-actions.pod:1204 msgid "guestfs_cp_a" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1147 +#: ../src/guestfs-actions.pod:1206 #, no-wrap msgid "" " int\n" @@ -7744,19 +7941,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1152 ../fish/guestfish-actions.pod:776 +#: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:801 msgid "" "This copies a file or directory from C to C recursively using the " "C command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1159 +#: ../src/guestfs-actions.pod:1218 msgid "guestfs_dd" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1161 +#: ../src/guestfs-actions.pod:1220 #, no-wrap msgid "" " int\n" @@ -7767,7 +7964,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1166 ../fish/guestfish-actions.pod:783 +#: ../src/guestfs-actions.pod:1225 ../fish/guestfish-actions.pod:808 msgid "" "This command copies from one source device or file C to another " "destination device or file C. Normally you would use this to copy to " @@ -7775,7 +7972,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1171 +#: ../src/guestfs-actions.pod:1230 msgid "" "If the destination is a device, it must be as large or larger than the " "source file or device, otherwise the copy will fail. This command cannot do " @@ -7783,12 +7980,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1179 +#: ../src/guestfs-actions.pod:1238 msgid "guestfs_df" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1181 +#: ../src/guestfs-actions.pod:1240 #, no-wrap msgid "" " char *\n" @@ -7797,12 +7994,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1184 ../fish/guestfish-actions.pod:796 +#: ../src/guestfs-actions.pod:1243 ../fish/guestfish-actions.pod:821 msgid "This command runs the C command to report disk space used." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1186 ../src/guestfs-actions.pod:1203 +#: ../src/guestfs-actions.pod:1245 ../src/guestfs-actions.pod:1262 msgid "" "This command is mostly useful for interactive sessions. It is I " "intended that you try to parse the output string. Use C " @@ -7810,17 +8007,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1193 ../src/guestfs-actions.pod:1210 ../src/guestfs-actions.pod:1328 ../src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2313 ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:4299 ../src/guestfs-actions.pod:4781 ../src/guestfs-actions.pod:6620 ../src/guestfs-actions.pod:6644 ../src/guestfs-actions.pod:7269 ../src/guestfs-actions.pod:7282 ../src/guestfs-actions.pod:7295 +#: ../src/guestfs-actions.pod:1252 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:2359 ../src/guestfs-actions.pod:2383 ../src/guestfs-actions.pod:2451 ../src/guestfs-actions.pod:4470 ../src/guestfs-actions.pod:5014 ../src/guestfs-actions.pod:6966 ../src/guestfs-actions.pod:6990 ../src/guestfs-actions.pod:7609 ../src/guestfs-actions.pod:7622 ../src/guestfs-actions.pod:7635 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1195 +#: ../src/guestfs-actions.pod:1254 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1197 +#: ../src/guestfs-actions.pod:1256 #, no-wrap msgid "" " char *\n" @@ -7829,19 +8026,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1200 ../fish/guestfish-actions.pod:806 +#: ../src/guestfs-actions.pod:1259 ../fish/guestfish-actions.pod:831 msgid "" "This command runs the C command to report disk space used in " "human-readable format." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1212 +#: ../src/guestfs-actions.pod:1271 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1214 +#: ../src/guestfs-actions.pod:1273 #, no-wrap msgid "" " char *\n" @@ -7850,14 +8047,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1217 ../fish/guestfish-actions.pod:817 +#: ../src/guestfs-actions.pod:1276 ../fish/guestfish-actions.pod:842 msgid "" "This returns the kernel messages (C output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1221 +#: ../src/guestfs-actions.pod:1280 msgid "" "Another way to get the same information is to enable verbose messages with " "C or by setting the environment variable " @@ -7865,12 +8062,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1231 +#: ../src/guestfs-actions.pod:1290 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1233 +#: ../src/guestfs-actions.pod:1292 #, no-wrap msgid "" " int\n" @@ -7881,29 +8078,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1263 ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:843 +#: ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1322 ../fish/guestfish-actions.pod:855 ../fish/guestfish-actions.pod:868 msgid "" "Download file C and save it as C on the local " "machine." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:6876 ../fish/guestfish-actions.pod:833 ../fish/guestfish-actions.pod:4642 +#: ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:7222 ../fish/guestfish-actions.pod:858 ../fish/guestfish-actions.pod:4797 msgid "C can also be a named pipe." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1243 +#: ../src/guestfs-actions.pod:1302 msgid "See also C, C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1254 +#: ../src/guestfs-actions.pod:1313 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1256 +#: ../src/guestfs-actions.pod:1315 #, no-wrap msgid "" " int\n" @@ -7916,14 +8113,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1266 ../fish/guestfish-actions.pod:846 +#: ../src/guestfs-actions.pod:1325 ../fish/guestfish-actions.pod:871 msgid "" "C is read for C bytes starting at C (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1269 +#: ../src/guestfs-actions.pod:1328 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with C, and this call always reads the " @@ -7931,22 +8128,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1274 +#: ../src/guestfs-actions.pod:1333 msgid "See also C, C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:6921 +#: ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:7267 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1285 +#: ../src/guestfs-actions.pod:1344 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1287 +#: ../src/guestfs-actions.pod:1346 #, no-wrap msgid "" " int\n" @@ -7956,7 +8153,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1291 ../fish/guestfish-actions.pod:862 +#: ../src/guestfs-actions.pod:1350 ../fish/guestfish-actions.pod:887 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C tells the kernel what precisely " @@ -7964,24 +8161,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1296 ../fish/guestfish-actions.pod:867 +#: ../src/guestfs-actions.pod:1355 ../fish/guestfish-actions.pod:892 msgid "Setting C to 3 should drop everything." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1298 ../fish/guestfish-actions.pod:869 +#: ../src/guestfs-actions.pod:1357 ../fish/guestfish-actions.pod:894 msgid "" "This automatically calls L before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1305 +#: ../src/guestfs-actions.pod:1364 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1307 +#: ../src/guestfs-actions.pod:1366 #, no-wrap msgid "" " int64_t\n" @@ -7991,14 +8188,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1311 ../fish/guestfish-actions.pod:876 +#: ../src/guestfs-actions.pod:1370 ../fish/guestfish-actions.pod:901 msgid "" "This command runs the C command to estimate file space usage for " "C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1314 ../fish/guestfish-actions.pod:879 +#: ../src/guestfs-actions.pod:1373 ../fish/guestfish-actions.pod:904 msgid "" "C can be a file or a directory. If C is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -8006,17 +8203,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1318 ../fish/guestfish-actions.pod:883 +#: ../src/guestfs-actions.pod:1377 ../fish/guestfish-actions.pod:908 msgid "The result is the estimated size in I (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1330 +#: ../src/guestfs-actions.pod:1389 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1332 +#: ../src/guestfs-actions.pod:1391 #, no-wrap msgid "" " int\n" @@ -8026,7 +8223,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1336 ../fish/guestfish-actions.pod:890 +#: ../src/guestfs-actions.pod:1395 ../fish/guestfish-actions.pod:915 msgid "" "This runs C, ie. runs the ext2/ext3 filesystem checker " "on C, noninteractively (I<-p>), even if the filesystem appears to be " @@ -8034,24 +8231,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1340 +#: ../src/guestfs-actions.pod:1399 msgid "" "This command is only needed because of C (q.v.). " "Normally you should use C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1345 +#: ../src/guestfs-actions.pod:1404 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1347 +#: ../src/guestfs-actions.pod:1406 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1349 +#: ../src/guestfs-actions.pod:1408 #, no-wrap msgid "" " char *\n" @@ -8061,34 +8258,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1353 ../fish/guestfish-actions.pod:901 +#: ../src/guestfs-actions.pod:1412 ../fish/guestfish-actions.pod:926 msgid "" "This command concatenates the list of C passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1356 ../fish/guestfish-actions.pod:904 +#: ../src/guestfs-actions.pod:1415 ../fish/guestfish-actions.pod:929 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1358 +#: ../src/guestfs-actions.pod:1417 msgid "See also C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1363 ../src/guestfs-actions.pod:2097 ../src/guestfs-actions.pod:6092 +#: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:2167 ../src/guestfs-actions.pod:6438 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1365 +#: ../src/guestfs-actions.pod:1424 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1367 +#: ../src/guestfs-actions.pod:1426 #, no-wrap msgid "" " char **\n" @@ -8099,22 +8296,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1372 ../fish/guestfish-actions.pod:912 +#: ../src/guestfs-actions.pod:1431 ../fish/guestfish-actions.pod:937 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1401 ../src/guestfs-actions.pod:1458 ../src/guestfs-actions.pod:1504 ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:2227 ../src/guestfs-actions.pod:2246 ../src/guestfs-actions.pod:2402 ../src/guestfs-actions.pod:2415 ../src/guestfs-actions.pod:2430 ../src/guestfs-actions.pod:2476 ../src/guestfs-actions.pod:2498 ../src/guestfs-actions.pod:2511 ../src/guestfs-actions.pod:3682 ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:3723 ../src/guestfs-actions.pod:4709 ../src/guestfs-actions.pod:5592 ../src/guestfs-actions.pod:5641 ../src/guestfs-actions.pod:6488 ../src/guestfs-actions.pod:6500 ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6548 ../src/guestfs-actions.pod:6561 ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:6587 ../src/guestfs-actions.pod:7365 ../src/guestfs-actions.pod:7384 ../src/guestfs-actions.pod:7470 ../src/guestfs-actions.pod:7489 ../src/guestfs-actions.pod:7535 ../src/guestfs-actions.pod:7554 +#: ../src/guestfs-actions.pod:1441 ../src/guestfs-actions.pod:1460 ../src/guestfs-actions.pod:1517 ../src/guestfs-actions.pod:1563 ../src/guestfs-actions.pod:1582 ../src/guestfs-actions.pod:2297 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2472 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:2500 ../src/guestfs-actions.pod:2546 ../src/guestfs-actions.pod:2568 ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:4892 ../src/guestfs-actions.pod:5917 ../src/guestfs-actions.pod:5966 ../src/guestfs-actions.pod:6834 ../src/guestfs-actions.pod:6846 ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:6872 ../src/guestfs-actions.pod:6894 ../src/guestfs-actions.pod:6907 ../src/guestfs-actions.pod:6920 ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:7725 ../src/guestfs-actions.pod:7744 ../src/guestfs-actions.pod:7830 ../src/guestfs-actions.pod:7849 ../src/guestfs-actions.pod:7895 ../src/guestfs-actions.pod:7914 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1384 +#: ../src/guestfs-actions.pod:1443 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1386 +#: ../src/guestfs-actions.pod:1445 #, no-wrap msgid "" " char **\n" @@ -8125,17 +8322,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1391 ../fish/guestfish-actions.pod:922 +#: ../src/guestfs-actions.pod:1450 ../fish/guestfish-actions.pod:947 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1403 +#: ../src/guestfs-actions.pod:1462 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1405 +#: ../src/guestfs-actions.pod:1464 #, no-wrap msgid "" " int\n" @@ -8146,24 +8343,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1410 ../fish/guestfish-actions.pod:932 +#: ../src/guestfs-actions.pod:1469 ../fish/guestfish-actions.pod:957 msgid "" "This compares the two files C and C and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1413 ../fish/guestfish-actions.pod:935 +#: ../src/guestfs-actions.pod:1472 ../fish/guestfish-actions.pod:960 msgid "The external L program is used for the comparison." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1419 +#: ../src/guestfs-actions.pod:1478 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1421 +#: ../src/guestfs-actions.pod:1480 #, no-wrap msgid "" " int\n" @@ -8173,24 +8370,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1425 ../fish/guestfish-actions.pod:941 +#: ../src/guestfs-actions.pod:1484 ../fish/guestfish-actions.pod:966 msgid "" "This returns C if and only if there is a file, directory (or anything) " "with the given C name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1428 +#: ../src/guestfs-actions.pod:1487 msgid "See also C, C, C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1434 +#: ../src/guestfs-actions.pod:1493 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1436 +#: ../src/guestfs-actions.pod:1495 #, no-wrap msgid "" " int\n" @@ -8201,33 +8398,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1441 ../src/guestfs-actions.pod:1467 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:969 +#: ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1526 ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:994 msgid "" "This command preallocates a file (containing zero bytes) named C of " "size C bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1445 ../fish/guestfish-actions.pod:954 +#: ../src/guestfs-actions.pod:1504 ../fish/guestfish-actions.pod:979 msgid "" "Do not confuse this with the guestfish-specific C command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1451 ../fish/guestfish-actions.pod:958 +#: ../src/guestfs-actions.pod:1510 ../fish/guestfish-actions.pod:983 msgid "" "This function is deprecated. In new code, use the C call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1460 +#: ../src/guestfs-actions.pod:1519 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1462 +#: ../src/guestfs-actions.pod:1521 #, no-wrap msgid "" " int\n" @@ -8238,14 +8435,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1471 +#: ../src/guestfs-actions.pod:1530 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use C instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1474 +#: ../src/guestfs-actions.pod:1533 msgid "" "The deprecated call C does the same, but owing to an " "oversight it only allowed 30 bit lengths to be specified, effectively " @@ -8253,24 +8450,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1479 ../fish/guestfish-actions.pod:981 +#: ../src/guestfs-actions.pod:1538 ../fish/guestfish-actions.pod:1006 msgid "" "Do not confuse this with the guestfish-specific C and C " "commands which create a file in the host and attach it as a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1485 +#: ../src/guestfs-actions.pod:1544 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1487 +#: ../src/guestfs-actions.pod:1546 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1489 +#: ../src/guestfs-actions.pod:1548 #, no-wrap msgid "" " char **\n" @@ -8281,17 +8478,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1494 ../fish/guestfish-actions.pod:989 +#: ../src/guestfs-actions.pod:1553 ../fish/guestfish-actions.pod:1014 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1506 +#: ../src/guestfs-actions.pod:1565 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1508 +#: ../src/guestfs-actions.pod:1567 #, no-wrap msgid "" " char **\n" @@ -8302,17 +8499,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1513 ../fish/guestfish-actions.pod:999 +#: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1024 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1525 +#: ../src/guestfs-actions.pod:1584 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1527 +#: ../src/guestfs-actions.pod:1586 #, no-wrap msgid "" " char *\n" @@ -8322,28 +8519,28 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1531 ../fish/guestfish-actions.pod:1009 +#: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1034 msgid "" "This call uses the standard L command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1534 ../fish/guestfish-actions.pod:1012 +#: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1037 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1537 ../fish/guestfish-actions.pod:1015 +#: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1040 msgid "" "The exact command which runs is C. Note in particular that " "the filename is not prepended to the output (the I<-b> option)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1541 ../fish/guestfish-actions.pod:1019 +#: ../src/guestfs-actions.pod:1600 ../fish/guestfish-actions.pod:1044 msgid "" "The output depends on the output of the underlying L command and it " "can change in future in ways beyond our control. In other words, the output " @@ -8351,19 +8548,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1545 +#: ../src/guestfs-actions.pod:1604 msgid "" "See also: L, C, C, " "C, C (etc), C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1553 +#: ../src/guestfs-actions.pod:1612 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1555 +#: ../src/guestfs-actions.pod:1614 #, no-wrap msgid "" " char *\n" @@ -8373,166 +8570,166 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1030 +#: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1055 msgid "" "This detects the architecture of the binary C, and returns it if " "known." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1562 ../fish/guestfish-actions.pod:1033 +#: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1058 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1566 ../fish/guestfish-actions.pod:1037 +#: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1062 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1568 ../fish/guestfish-actions.pod:1039 +#: ../src/guestfs-actions.pod:1627 ../fish/guestfish-actions.pod:1064 msgid "" "This string is returned for all 32 bit i386, i486, i586, i686 binaries " "irrespective of the precise processor requirements of the binary." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1042 +#: ../src/guestfs-actions.pod:1630 ../fish/guestfish-actions.pod:1067 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1044 +#: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1069 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1046 +#: ../src/guestfs-actions.pod:1634 ../fish/guestfish-actions.pod:1071 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1048 +#: ../src/guestfs-actions.pod:1636 ../fish/guestfish-actions.pod:1073 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1050 +#: ../src/guestfs-actions.pod:1638 ../fish/guestfish-actions.pod:1075 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1052 +#: ../src/guestfs-actions.pod:1640 ../fish/guestfish-actions.pod:1077 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1054 +#: ../src/guestfs-actions.pod:1642 ../fish/guestfish-actions.pod:1079 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1056 +#: ../src/guestfs-actions.pod:1644 ../fish/guestfish-actions.pod:1081 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1587 ../fish/guestfish-actions.pod:1058 +#: ../src/guestfs-actions.pod:1646 ../fish/guestfish-actions.pod:1083 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1060 +#: ../src/guestfs-actions.pod:1648 ../fish/guestfish-actions.pod:1085 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1062 +#: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1087 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1064 +#: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1089 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1068 +#: ../src/guestfs-actions.pod:1656 ../fish/guestfish-actions.pod:1093 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1599 ../fish/guestfish-actions.pod:1070 +#: ../src/guestfs-actions.pod:1658 ../fish/guestfish-actions.pod:1095 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1076 +#: ../src/guestfs-actions.pod:1664 ../fish/guestfish-actions.pod:1101 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1080 +#: ../src/guestfs-actions.pod:1668 ../fish/guestfish-actions.pod:1105 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1084 +#: ../src/guestfs-actions.pod:1672 ../fish/guestfish-actions.pod:1109 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1088 +#: ../src/guestfs-actions.pod:1676 ../fish/guestfish-actions.pod:1113 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1619 ../fish/guestfish-actions.pod:1090 +#: ../src/guestfs-actions.pod:1678 ../fish/guestfish-actions.pod:1115 msgid "Win32 binaries and DLLs return C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1092 +#: ../src/guestfs-actions.pod:1680 ../fish/guestfish-actions.pod:1117 msgid "Win64 binaries and DLLs return C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1096 +#: ../src/guestfs-actions.pod:1684 ../fish/guestfish-actions.pod:1121 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1100 +#: ../src/guestfs-actions.pod:1688 ../fish/guestfish-actions.pod:1125 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1633 ../fish/guestfish-actions.pod:1104 +#: ../src/guestfs-actions.pod:1692 ../fish/guestfish-actions.pod:1129 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1108 +#: ../src/guestfs-actions.pod:1696 ../fish/guestfish-actions.pod:1133 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1643 ../fish/guestfish-actions.pod:1114 +#: ../src/guestfs-actions.pod:1702 ../fish/guestfish-actions.pod:1139 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1647 ../fish/guestfish-actions.pod:1118 +#: ../src/guestfs-actions.pod:1706 ../fish/guestfish-actions.pod:1143 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1651 ../fish/guestfish-actions.pod:1122 +#: ../src/guestfs-actions.pod:1710 ../fish/guestfish-actions.pod:1147 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1653 ../fish/guestfish-actions.pod:1124 +#: ../src/guestfs-actions.pod:1712 ../fish/guestfish-actions.pod:1149 msgid "" "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " "compressed code, and are horribly hard to unpack. If you want to find the " @@ -8541,17 +8738,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1663 ../src/guestfs-actions.pod:1826 ../src/guestfs-actions.pod:1843 ../src/guestfs-actions.pod:2534 ../src/guestfs-actions.pod:2627 ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2806 ../src/guestfs-actions.pod:2849 ../src/guestfs-actions.pod:2933 ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3277 ../src/guestfs-actions.pod:3409 +#: ../src/guestfs-actions.pod:1722 ../src/guestfs-actions.pod:1885 ../src/guestfs-actions.pod:1902 ../src/guestfs-actions.pod:2601 ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2757 ../src/guestfs-actions.pod:2944 ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:3002 ../src/guestfs-actions.pod:3077 ../src/guestfs-actions.pod:3170 ../src/guestfs-actions.pod:3407 ../src/guestfs-actions.pod:3539 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1665 +#: ../src/guestfs-actions.pod:1724 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1667 +#: ../src/guestfs-actions.pod:1726 #, no-wrap msgid "" " int64_t\n" @@ -8561,12 +8758,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1671 ../fish/guestfish-actions.pod:1135 +#: ../src/guestfs-actions.pod:1730 ../fish/guestfish-actions.pod:1160 msgid "This command returns the size of C in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1673 +#: ../src/guestfs-actions.pod:1732 msgid "" "To get other stats about a file, use C, C, " "C, C etc. To get the size of block " @@ -8574,17 +8771,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1679 +#: ../src/guestfs-actions.pod:1738 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1681 +#: ../src/guestfs-actions.pod:1740 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1683 +#: ../src/guestfs-actions.pod:1742 #, no-wrap msgid "" " int\n" @@ -8596,7 +8793,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1689 ../fish/guestfish-actions.pod:1145 +#: ../src/guestfs-actions.pod:1748 ../fish/guestfish-actions.pod:1170 msgid "" "This command creates a new file called C. The initial content of the " "file is C octets of C, where C must be a number in the range " @@ -8604,7 +8801,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1693 +#: ../src/guestfs-actions.pod:1752 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "C. To create a file with a pattern of repeating " @@ -8612,17 +8809,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1705 +#: ../src/guestfs-actions.pod:1764 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1707 +#: ../src/guestfs-actions.pod:1766 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1709 +#: ../src/guestfs-actions.pod:1768 #, no-wrap msgid "" " int\n" @@ -8634,7 +8831,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1715 +#: ../src/guestfs-actions.pod:1774 msgid "" "This function is like C except that it creates a new file of " "length C containing the repeating pattern of bytes in C. The " @@ -8643,17 +8840,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1727 +#: ../src/guestfs-actions.pod:1786 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1729 +#: ../src/guestfs-actions.pod:1788 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1731 +#: ../src/guestfs-actions.pod:1790 #, no-wrap msgid "" " char **\n" @@ -8663,7 +8860,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1735 ../fish/guestfish-actions.pod:1167 +#: ../src/guestfs-actions.pod:1794 ../fish/guestfish-actions.pod:1192 msgid "" "This command lists out all files and directories, recursively, starting at " "C. It is essentially equivalent to running the shell command " @@ -8672,14 +8869,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1740 ../fish/guestfish-actions.pod:1172 +#: ../src/guestfs-actions.pod:1799 ../fish/guestfish-actions.pod:1197 msgid "" "This returns a list of strings I. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1743 ../fish/guestfish-actions.pod:1175 +#: ../src/guestfs-actions.pod:1802 ../fish/guestfish-actions.pod:1200 #, no-wrap msgid "" " /tmp/a\n" @@ -8689,12 +8886,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1747 +#: ../src/guestfs-actions.pod:1806 msgid "then the returned list from C C would be 4 elements:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1750 ../fish/guestfish-actions.pod:1182 +#: ../src/guestfs-actions.pod:1809 ../fish/guestfish-actions.pod:1207 #, no-wrap msgid "" " a\n" @@ -8705,32 +8902,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1755 ../fish/guestfish-actions.pod:1187 +#: ../src/guestfs-actions.pod:1814 ../fish/guestfish-actions.pod:1212 msgid "If C is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1758 ../fish/guestfish-actions.pod:1190 +#: ../src/guestfs-actions.pod:1817 ../fish/guestfish-actions.pod:1215 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1760 +#: ../src/guestfs-actions.pod:1819 msgid "See also C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1769 ../src/guestfs-actions.pod:4126 ../src/guestfs-actions.pod:5676 +#: ../src/guestfs-actions.pod:1828 ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:6001 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1771 +#: ../src/guestfs-actions.pod:1830 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1773 +#: ../src/guestfs-actions.pod:1832 #, no-wrap msgid "" " int\n" @@ -8741,7 +8938,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1778 ../fish/guestfish-actions.pod:1201 +#: ../src/guestfs-actions.pod:1837 ../fish/guestfish-actions.pod:1226 msgid "" "This command lists out all files and directories, recursively, starting at " "C, placing the resulting list in the external file called " @@ -8749,46 +8946,46 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1782 +#: ../src/guestfs-actions.pod:1841 msgid "" "This command works the same way as C with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1789 ../fish/guestfish-actions.pod:1212 +#: ../src/guestfs-actions.pod:1848 ../fish/guestfish-actions.pod:1237 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1793 ../fish/guestfish-actions.pod:1216 +#: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1241 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L option I<-print0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1798 ../fish/guestfish-actions.pod:1221 +#: ../src/guestfs-actions.pod:1857 ../fish/guestfish-actions.pod:1246 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1803 ../fish/guestfish-actions.pod:1226 +#: ../src/guestfs-actions.pod:1862 ../fish/guestfish-actions.pod:1251 msgid "The result list is not sorted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1809 +#: ../src/guestfs-actions.pod:1868 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1811 +#: ../src/guestfs-actions.pod:1870 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1813 +#: ../src/guestfs-actions.pod:1872 #, no-wrap msgid "" " char *\n" @@ -8798,24 +8995,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1817 ../fish/guestfish-actions.pod:1236 +#: ../src/guestfs-actions.pod:1876 ../fish/guestfish-actions.pod:1261 msgid "" "This command searches the filesystems and returns the one which has the " "given label. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1821 +#: ../src/guestfs-actions.pod:1880 msgid "To find the label of a filesystem, use C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1828 +#: ../src/guestfs-actions.pod:1887 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1830 +#: ../src/guestfs-actions.pod:1889 #, no-wrap msgid "" " char *\n" @@ -8825,24 +9022,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1834 ../fish/guestfish-actions.pod:1246 +#: ../src/guestfs-actions.pod:1893 ../fish/guestfish-actions.pod:1271 msgid "" "This command searches the filesystems and returns the one which has the " "given UUID. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1838 +#: ../src/guestfs-actions.pod:1897 msgid "To find the UUID of a filesystem, use C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1845 +#: ../src/guestfs-actions.pod:1904 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1847 +#: ../src/guestfs-actions.pod:1906 #, no-wrap msgid "" " int\n" @@ -8853,53 +9050,53 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1256 +#: ../src/guestfs-actions.pod:1911 ../fish/guestfish-actions.pod:1281 msgid "" "This runs the filesystem checker (fsck) on C which should have " "filesystem type C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1855 ../fish/guestfish-actions.pod:1259 +#: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1284 msgid "" "The returned integer is the status. See L for the list of status " "codes from C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1864 ../fish/guestfish-actions.pod:1268 +#: ../src/guestfs-actions.pod:1923 ../fish/guestfish-actions.pod:1293 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1868 ../fish/guestfish-actions.pod:1272 +#: ../src/guestfs-actions.pod:1927 ../fish/guestfish-actions.pod:1297 msgid "" "A non-zero return code can mean \"success\", for example if errors have been " "corrected on the filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1873 ../fish/guestfish-actions.pod:1277 +#: ../src/guestfs-actions.pod:1932 ../fish/guestfish-actions.pod:1302 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1878 ../fish/guestfish-actions.pod:1282 +#: ../src/guestfs-actions.pod:1937 ../fish/guestfish-actions.pod:1307 msgid "This command is entirely equivalent to running C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:7408 +#: ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:7768 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1884 +#: ../src/guestfs-actions.pod:1943 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1886 +#: ../src/guestfs-actions.pod:1945 #, no-wrap msgid "" " const char *\n" @@ -8908,19 +9105,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1889 ../fish/guestfish-actions.pod:1288 +#: ../src/guestfs-actions.pod:1948 ../fish/guestfish-actions.pod:1313 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1892 ../fish/guestfish-actions.pod:1291 +#: ../src/guestfs-actions.pod:1951 ../fish/guestfish-actions.pod:1316 msgid "If C then no options are added." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1894 +#: ../src/guestfs-actions.pod:1953 msgid "" "This function returns a string which may be NULL. There is no way to return " "an error from this function. The string is owned by the guest handle and " @@ -8928,17 +9125,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1898 ../src/guestfs-actions.pod:5354 ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:6255 ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6290 ../src/guestfs-actions.pod:6314 ../src/guestfs-actions.pod:7071 ../src/guestfs-actions.pod:7089 ../src/guestfs-actions.pod:7451 +#: ../src/guestfs-actions.pod:1957 ../src/guestfs-actions.pod:5679 ../src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:6620 ../src/guestfs-actions.pod:6636 ../src/guestfs-actions.pod:6660 ../src/guestfs-actions.pod:7414 ../src/guestfs-actions.pod:7429 ../src/guestfs-actions.pod:7811 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1900 +#: ../src/guestfs-actions.pod:1959 msgid "guestfs_get_attach_method" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1902 +#: ../src/guestfs-actions.pod:1961 #, no-wrap msgid "" " char *\n" @@ -8947,17 +9144,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1905 +#: ../src/guestfs-actions.pod:1964 msgid "Return the current attach method. See C." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:1969 ../src/guestfs-actions.pod:6191 +msgid "(Added in 1.9.8)" +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:1910 +#: ../src/guestfs-actions.pod:1971 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1912 +#: ../src/guestfs-actions.pod:1973 #, no-wrap msgid "" " int\n" @@ -8966,17 +9168,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1915 ../fish/guestfish-actions.pod:1303 +#: ../src/guestfs-actions.pod:1976 ../fish/guestfish-actions.pod:1328 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1921 +#: ../src/guestfs-actions.pod:1982 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1923 +#: ../src/guestfs-actions.pod:1984 #, no-wrap msgid "" " int\n" @@ -8985,22 +9187,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1926 ../fish/guestfish-actions.pod:1309 +#: ../src/guestfs-actions.pod:1987 ../fish/guestfish-actions.pod:1334 msgid "Return the direct appliance mode flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:5903 +#: ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:6232 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1932 +#: ../src/guestfs-actions.pod:1993 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1934 +#: ../src/guestfs-actions.pod:1995 #, no-wrap msgid "" " char *\n" @@ -9010,29 +9212,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1938 ../fish/guestfish-actions.pod:1315 +#: ../src/guestfs-actions.pod:1999 ../fish/guestfish-actions.pod:1340 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1944 ../fish/guestfish-actions.pod:1318 +#: ../src/guestfs-actions.pod:2005 ../fish/guestfish-actions.pod:1343 msgid "" "This function is deprecated. In new code, use the C call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1951 ../src/guestfs-actions.pod:1972 ../src/guestfs-actions.pod:5921 ../src/guestfs-actions.pod:5940 +#: ../src/guestfs-actions.pod:2012 ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:6250 ../src/guestfs-actions.pod:6269 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1953 +#: ../src/guestfs-actions.pod:2014 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1955 +#: ../src/guestfs-actions.pod:2016 #, no-wrap msgid "" " char *\n" @@ -9042,22 +9244,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1959 ../fish/guestfish-actions.pod:1329 +#: ../src/guestfs-actions.pod:2020 ../fish/guestfish-actions.pod:1354 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1965 ../fish/guestfish-actions.pod:1332 +#: ../src/guestfs-actions.pod:2026 ../fish/guestfish-actions.pod:1357 msgid "This function is deprecated. In new code, use the C call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1974 +#: ../src/guestfs-actions.pod:2035 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1976 +#: ../src/guestfs-actions.pod:2037 #, no-wrap msgid "" " int\n" @@ -9066,12 +9268,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1979 ../fish/guestfish-actions.pod:1343 +#: ../src/guestfs-actions.pod:2040 ../fish/guestfish-actions.pod:1368 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1982 +#: ../src/guestfs-actions.pod:2043 msgid "" "If C was not called on this handle, and if " "C was not set, then this returns the compiled-in default " @@ -9079,22 +9281,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1986 ../src/guestfs-actions.pod:2067 ../src/guestfs-actions.pod:5956 ../src/guestfs-actions.pod:6063 ../fish/guestfish-actions.pod:1350 ../fish/guestfish-actions.pod:1401 ../fish/guestfish-actions.pod:4017 ../fish/guestfish-actions.pod:4104 +#: ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2137 ../src/guestfs-actions.pod:6285 ../src/guestfs-actions.pod:6409 ../fish/guestfish-actions.pod:1375 ../fish/guestfish-actions.pod:1432 ../fish/guestfish-actions.pod:4157 ../fish/guestfish-actions.pod:4259 msgid "For more information on the architecture of libguestfs, see L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:4417 ../src/guestfs-actions.pod:4614 ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4664 ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4694 ../src/guestfs-actions.pod:5579 ../src/guestfs-actions.pod:5961 ../src/guestfs-actions.pod:6222 ../src/guestfs-actions.pod:6837 +#: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:4864 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:6290 ../src/guestfs-actions.pod:6568 ../src/guestfs-actions.pod:7183 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1993 +#: ../src/guestfs-actions.pod:2054 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1995 +#: ../src/guestfs-actions.pod:2056 #, no-wrap msgid "" " int\n" @@ -9103,22 +9305,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1998 ../fish/guestfish-actions.pod:1357 +#: ../src/guestfs-actions.pod:2059 ../fish/guestfish-actions.pod:1382 msgid "This returns the enable network flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:5980 +#: ../src/guestfs-actions.pod:2063 ../src/guestfs-actions.pod:6309 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2004 +#: ../src/guestfs-actions.pod:2065 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2006 +#: ../src/guestfs-actions.pod:2067 #, no-wrap msgid "" " const char *\n" @@ -9127,31 +9329,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2009 ../fish/guestfish-actions.pod:1363 +#: ../src/guestfs-actions.pod:2070 ../fish/guestfish-actions.pod:1388 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2011 ../fish/guestfish-actions.pod:1365 +#: ../src/guestfs-actions.pod:2072 ../fish/guestfish-actions.pod:1390 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2014 ../src/guestfs-actions.pod:2043 +#: ../src/guestfs-actions.pod:2075 ../src/guestfs-actions.pod:2113 msgid "" "This function returns a string, or NULL on error. The string is owned by " "the guest handle and must I be freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2019 +#: ../src/guestfs-actions.pod:2080 +msgid "guestfs_get_pgroup" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:2082 +#, no-wrap +msgid "" +" int\n" +" guestfs_get_pgroup (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2085 ../fish/guestfish-actions.pod:1397 +msgid "This returns the process group flag." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:2089 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2021 +#: ../src/guestfs-actions.pod:2091 #, no-wrap msgid "" " int\n" @@ -9160,29 +9381,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2024 ../fish/guestfish-actions.pod:1374 +#: ../src/guestfs-actions.pod:2094 ../fish/guestfish-actions.pod:1405 msgid "" "Return the process ID of the qemu subprocess. If there is no qemu " "subprocess, then this will return an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2027 ../fish/guestfish-actions.pod:1377 +#: ../src/guestfs-actions.pod:2097 ../fish/guestfish-actions.pod:1408 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2031 +#: ../src/guestfs-actions.pod:2101 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2033 +#: ../src/guestfs-actions.pod:2103 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2035 +#: ../src/guestfs-actions.pod:2105 #, no-wrap msgid "" " const char *\n" @@ -9191,29 +9412,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2038 ../fish/guestfish-actions.pod:1383 +#: ../src/guestfs-actions.pod:2108 ../fish/guestfish-actions.pod:1414 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2040 ../fish/guestfish-actions.pod:1385 +#: ../src/guestfs-actions.pod:2110 ../fish/guestfish-actions.pod:1416 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default qemu binary name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:6025 +#: ../src/guestfs-actions.pod:2116 ../src/guestfs-actions.pod:6371 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2048 +#: ../src/guestfs-actions.pod:2118 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2050 +#: ../src/guestfs-actions.pod:2120 #, no-wrap msgid "" " int\n" @@ -9222,22 +9443,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2053 ../fish/guestfish-actions.pod:1392 +#: ../src/guestfs-actions.pod:2123 ../fish/guestfish-actions.pod:1423 msgid "Return the recovery process enabled flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2057 ../src/guestfs-actions.pod:3527 ../src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:4224 ../src/guestfs-actions.pod:4256 ../src/guestfs-actions.pod:5284 ../src/guestfs-actions.pod:5627 ../src/guestfs-actions.pod:6049 ../src/guestfs-actions.pod:6740 ../src/guestfs-actions.pod:6760 ../src/guestfs-actions.pod:6952 +#: ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:3661 ../src/guestfs-actions.pod:3992 ../src/guestfs-actions.pod:4395 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:5609 ../src/guestfs-actions.pod:5952 ../src/guestfs-actions.pod:6395 ../src/guestfs-actions.pod:7086 ../src/guestfs-actions.pod:7106 ../src/guestfs-actions.pod:7298 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2059 +#: ../src/guestfs-actions.pod:2129 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2061 +#: ../src/guestfs-actions.pod:2131 #, no-wrap msgid "" " int\n" @@ -9246,24 +9467,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2064 +#: ../src/guestfs-actions.pod:2134 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2072 ../src/guestfs-actions.pod:2135 ../src/guestfs-actions.pod:6068 ../src/guestfs-actions.pod:6126 +#: ../src/guestfs-actions.pod:2142 ../src/guestfs-actions.pod:2205 ../src/guestfs-actions.pod:6414 ../src/guestfs-actions.pod:6472 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2074 +#: ../src/guestfs-actions.pod:2144 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2076 +#: ../src/guestfs-actions.pod:2146 #, no-wrap msgid "" " int\n" @@ -9272,24 +9493,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2079 ../fish/guestfish-actions.pod:1408 +#: ../src/guestfs-actions.pod:2149 ../fish/guestfish-actions.pod:1439 msgid "" "This returns the current state as an opaque integer. This is only useful " "for printing debug and internal error messages." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2082 ../src/guestfs-actions.pod:3302 ../src/guestfs-actions.pod:3331 ../src/guestfs-actions.pod:3392 ../src/guestfs-actions.pod:3419 ../fish/guestfish-actions.pod:1411 ../fish/guestfish-actions.pod:2325 ../fish/guestfish-actions.pod:2343 ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2397 +#: ../src/guestfs-actions.pod:2152 ../src/guestfs-actions.pod:3432 ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:3522 ../src/guestfs-actions.pod:3549 ../fish/guestfish-actions.pod:1442 ../fish/guestfish-actions.pod:2362 ../fish/guestfish-actions.pod:2380 ../fish/guestfish-actions.pod:2418 ../fish/guestfish-actions.pod:2434 msgid "For more information on states, see L." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2088 +#: ../src/guestfs-actions.pod:2158 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2090 +#: ../src/guestfs-actions.pod:2160 #, no-wrap msgid "" " int\n" @@ -9298,17 +9519,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2093 ../fish/guestfish-actions.pod:1417 +#: ../src/guestfs-actions.pod:2163 ../fish/guestfish-actions.pod:1448 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2099 +#: ../src/guestfs-actions.pod:2169 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2101 +#: ../src/guestfs-actions.pod:2171 #, no-wrap msgid "" " int\n" @@ -9317,19 +9538,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2104 +#: ../src/guestfs-actions.pod:2174 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2111 +#: ../src/guestfs-actions.pod:2181 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2113 +#: ../src/guestfs-actions.pod:2183 #, no-wrap msgid "" " int\n" @@ -9338,17 +9559,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2116 ../fish/guestfish-actions.pod:1430 +#: ../src/guestfs-actions.pod:2186 ../fish/guestfish-actions.pod:1461 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2122 +#: ../src/guestfs-actions.pod:2192 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2124 +#: ../src/guestfs-actions.pod:2194 #, no-wrap msgid "" " char *\n" @@ -9357,22 +9578,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2127 ../fish/guestfish-actions.pod:1436 +#: ../src/guestfs-actions.pod:2197 ../fish/guestfish-actions.pod:1467 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2129 +#: ../src/guestfs-actions.pod:2199 msgid "See the documentation about SELINUX in L, and C" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2137 +#: ../src/guestfs-actions.pod:2207 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2139 +#: ../src/guestfs-actions.pod:2209 #, no-wrap msgid "" " char *\n" @@ -9384,7 +9605,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2145 +#: ../src/guestfs-actions.pod:2215 msgid "" "Get a single extended attribute from file C named C. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -9392,7 +9613,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2149 ../src/guestfs-actions.pod:3541 +#: ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:3675 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling C. However some Linux filesystem " @@ -9402,19 +9623,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:3548 ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:2477 +#: ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:3682 ../fish/guestfish-actions.pod:1487 ../fish/guestfish-actions.pod:2514 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C, this returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2159 +#: ../src/guestfs-actions.pod:2229 msgid "See also: C, C, L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:2352 ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:5277 ../src/guestfs-actions.pod:5303 ../src/guestfs-actions.pod:5484 +#: ../src/guestfs-actions.pod:2231 ../src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2892 ../src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:5602 ../src/guestfs-actions.pod:5628 ../src/guestfs-actions.pod:5809 msgid "" "This function returns a buffer, or NULL on error. The size of the returned " "buffer is written to C<*size_r>. I." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2176 ../fish/guestfish-actions.pod:1468 +#: ../src/guestfs-actions.pod:2246 ../fish/guestfish-actions.pod:1499 msgid "" "At the system call level, this is a combination of the L and " "L calls." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2179 +#: ../src/guestfs-actions.pod:2249 msgid "See also: C, L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2181 ../src/guestfs-actions.pod:3569 ../src/guestfs-actions.pod:4220 +#: ../src/guestfs-actions.pod:2251 ../src/guestfs-actions.pod:3703 ../src/guestfs-actions.pod:4391 msgid "" "This function returns a C, or NULL if there was " "an error. I after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2185 ../src/guestfs-actions.pod:3573 ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3774 ../src/guestfs-actions.pod:5657 ../src/guestfs-actions.pod:6145 ../src/guestfs-actions.pod:7516 +#: ../src/guestfs-actions.pod:2255 ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:5982 ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:7876 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2187 +#: ../src/guestfs-actions.pod:2257 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2189 +#: ../src/guestfs-actions.pod:2259 #, no-wrap msgid "" " char **\n" @@ -9486,36 +9707,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2193 ../fish/guestfish-actions.pod:1477 +#: ../src/guestfs-actions.pod:2263 ../fish/guestfish-actions.pod:1508 msgid "" "This command searches for all the pathnames matching C according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2197 ../fish/guestfish-actions.pod:1481 +#: ../src/guestfs-actions.pod:2267 ../fish/guestfish-actions.pod:1512 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2200 ../fish/guestfish-actions.pod:1484 +#: ../src/guestfs-actions.pod:2270 ../fish/guestfish-actions.pod:1515 msgid "" "It is just a wrapper around the C L function with flags " "C. See that manual page for more details." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2208 ../src/guestfs-actions.pod:6338 ../src/guestfs-actions.pod:6355 +#: ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:6684 ../src/guestfs-actions.pod:6701 msgid "(Added in 1.0.50)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2210 +#: ../src/guestfs-actions.pod:2280 msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2212 +#: ../src/guestfs-actions.pod:2282 #, no-wrap msgid "" " char **\n" @@ -9526,17 +9747,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2217 ../fish/guestfish-actions.pod:1492 +#: ../src/guestfs-actions.pod:2287 ../fish/guestfish-actions.pod:1523 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2229 +#: ../src/guestfs-actions.pod:2299 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2231 +#: ../src/guestfs-actions.pod:2301 #, no-wrap msgid "" " char **\n" @@ -9547,17 +9768,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2236 ../fish/guestfish-actions.pod:1502 +#: ../src/guestfs-actions.pod:2306 ../fish/guestfish-actions.pod:1533 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2248 +#: ../src/guestfs-actions.pod:2318 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2250 +#: ../src/guestfs-actions.pod:2320 #, no-wrap msgid "" " int\n" @@ -9568,14 +9789,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2255 ../fish/guestfish-actions.pod:1512 +#: ../src/guestfs-actions.pod:2325 ../fish/guestfish-actions.pod:1543 msgid "" "This command installs GRUB (the Grand Unified Bootloader) on C, with " "the root directory being C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2258 ../fish/guestfish-actions.pod:1515 +#: ../src/guestfs-actions.pod:2328 ../fish/guestfish-actions.pod:1546 msgid "" "Note: If grub-install reports the error \"No suitable drive was found in the " "generated device map.\" it may be that you need to create a " @@ -9585,7 +9806,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2265 ../fish/guestfish-actions.pod:1522 +#: ../src/guestfs-actions.pod:2335 ../fish/guestfish-actions.pod:1553 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -9593,22 +9814,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2267 ../fish/guestfish-actions.pod:1524 +#: ../src/guestfs-actions.pod:2337 ../fish/guestfish-actions.pod:1555 msgid "replacing C with the name of the installation device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2271 +#: ../src/guestfs-actions.pod:2341 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2273 +#: ../src/guestfs-actions.pod:2343 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2275 +#: ../src/guestfs-actions.pod:2345 #, no-wrap msgid "" " char **\n" @@ -9618,19 +9839,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2279 ../fish/guestfish-actions.pod:1530 +#: ../src/guestfs-actions.pod:2349 ../fish/guestfish-actions.pod:1561 msgid "" "This command returns up to the first 10 lines of a file as a list of " "strings." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2291 +#: ../src/guestfs-actions.pod:2361 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2293 +#: ../src/guestfs-actions.pod:2363 #, no-wrap msgid "" " char **\n" @@ -9641,31 +9862,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2298 ../fish/guestfish-actions.pod:1540 +#: ../src/guestfs-actions.pod:2368 ../fish/guestfish-actions.pod:1571 msgid "" "If the parameter C is a positive number, this returns the first " "C lines of the file C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2301 ../fish/guestfish-actions.pod:1543 +#: ../src/guestfs-actions.pod:2371 ../fish/guestfish-actions.pod:1574 msgid "" "If the parameter C is a negative number, this returns lines from " "the file C, excluding the last C lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:6635 ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:4482 +#: ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:6981 ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:4637 msgid "If the parameter C is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2315 +#: ../src/guestfs-actions.pod:2385 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2317 +#: ../src/guestfs-actions.pod:2387 #, no-wrap msgid "" " char *\n" @@ -9675,24 +9896,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2321 ../fish/guestfish-actions.pod:1555 +#: ../src/guestfs-actions.pod:2391 ../fish/guestfish-actions.pod:1586 msgid "" "This runs C on the given C. The result is the " "human-readable, canonical hex dump of the file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:6419 ../src/guestfs-actions.pod:6474 +#: ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:6765 ../src/guestfs-actions.pod:6820 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2332 +#: ../src/guestfs-actions.pod:2402 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2334 +#: ../src/guestfs-actions.pod:2404 #, no-wrap msgid "" " char *\n" @@ -9704,7 +9925,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1565 +#: ../src/guestfs-actions.pod:2410 ../fish/guestfish-actions.pod:1596 msgid "" "This command unpacks the file C from the initrd file called " "C. The filename must be given I the initial C " @@ -9712,7 +9933,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2344 ../fish/guestfish-actions.pod:1569 +#: ../src/guestfs-actions.pod:2414 ../fish/guestfish-actions.pod:1600 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C) contained in a Linux initrd or " @@ -9720,7 +9941,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2348 ../fish/guestfish-actions.pod:1573 +#: ../src/guestfs-actions.pod:2418 ../fish/guestfish-actions.pod:1604 #, no-wrap msgid "" " initrd-cat /boot/initrd-.img init\n" @@ -9728,17 +9949,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2350 +#: ../src/guestfs-actions.pod:2420 msgid "See also C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2361 +#: ../src/guestfs-actions.pod:2431 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2363 +#: ../src/guestfs-actions.pod:2433 #, no-wrap msgid "" " char **\n" @@ -9748,12 +9969,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1584 +#: ../src/guestfs-actions.pod:2437 ../fish/guestfish-actions.pod:1615 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2369 ../fish/guestfish-actions.pod:1586 +#: ../src/guestfs-actions.pod:2439 ../fish/guestfish-actions.pod:1617 msgid "" "The files are listed without any initial C character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -9761,7 +9982,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2373 ../fish/guestfish-actions.pod:1590 +#: ../src/guestfs-actions.pod:2443 ../fish/guestfish-actions.pod:1621 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I support the newer initramfs format (compressed cpio " @@ -9769,12 +9990,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2383 +#: ../src/guestfs-actions.pod:2453 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2385 +#: ../src/guestfs-actions.pod:2455 #, no-wrap msgid "" " int64_t\n" @@ -9785,31 +10006,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1598 +#: ../src/guestfs-actions.pod:2460 ../fish/guestfish-actions.pod:1629 msgid "Watch C for the events listed in C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2392 ../fish/guestfish-actions.pod:1600 +#: ../src/guestfs-actions.pod:2462 ../fish/guestfish-actions.pod:1631 msgid "" "Note that if C is a directory then events within that directory are " "watched, but this does I happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2396 ../fish/guestfish-actions.pod:1604 +#: ../src/guestfs-actions.pod:2466 ../fish/guestfish-actions.pod:1635 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2404 +#: ../src/guestfs-actions.pod:2474 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2406 +#: ../src/guestfs-actions.pod:2476 #, no-wrap msgid "" " int\n" @@ -9818,7 +10039,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2409 ../fish/guestfish-actions.pod:1612 +#: ../src/guestfs-actions.pod:2479 ../fish/guestfish-actions.pod:1643 msgid "" "This closes the inotify handle which was previously opened by inotify_init. " "It removes all watches, throws away any pending events, and deallocates all " @@ -9826,12 +10047,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2417 +#: ../src/guestfs-actions.pod:2487 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2419 +#: ../src/guestfs-actions.pod:2489 #, no-wrap msgid "" " char **\n" @@ -9840,7 +10061,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2422 +#: ../src/guestfs-actions.pod:2492 msgid "" "This function is a helpful wrapper around C which just " "returns a list of pathnames of objects that were touched. The returned " @@ -9848,12 +10069,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2432 +#: ../src/guestfs-actions.pod:2502 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2434 +#: ../src/guestfs-actions.pod:2504 #, no-wrap msgid "" " int\n" @@ -9863,14 +10084,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2438 ../fish/guestfish-actions.pod:1628 +#: ../src/guestfs-actions.pod:2508 ../fish/guestfish-actions.pod:1659 msgid "" "This command creates a new inotify handle. The inotify subsystem can be " "used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2442 +#: ../src/guestfs-actions.pod:2512 msgid "" "C is the maximum number of events which will be queued up between " "calls to C or C. If this is " @@ -9882,7 +10103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2452 +#: ../src/guestfs-actions.pod:2522 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C, " @@ -9890,7 +10111,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2458 +#: ../src/guestfs-actions.pod:2528 msgid "" "Queued up events should be read periodically by calling " "C (or C which is just a helpful " @@ -9899,14 +10120,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2465 +#: ../src/guestfs-actions.pod:2535 msgid "" "The handle should be closed after use by calling C. " "This also removes any watches automatically." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2469 ../fish/guestfish-actions.pod:1659 +#: ../src/guestfs-actions.pod:2539 ../fish/guestfish-actions.pod:1690 msgid "" "See also L for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -9914,12 +10135,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2478 +#: ../src/guestfs-actions.pod:2548 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2480 +#: ../src/guestfs-actions.pod:2550 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -9928,19 +10149,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2483 ../fish/guestfish-actions.pod:1668 +#: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1699 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2486 ../fish/guestfish-actions.pod:1671 +#: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1702 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2488 ../fish/guestfish-actions.pod:1673 +#: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1704 msgid "" "I: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -9949,7 +10170,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2494 +#: ../src/guestfs-actions.pod:2564 msgid "" "This function returns a C, or NULL if " "there was an error. I." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2513 +#: ../src/guestfs-actions.pod:2583 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2515 +#: ../src/guestfs-actions.pod:2585 #, no-wrap msgid "" " char *\n" @@ -9994,38 +10215,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2519 ../src/guestfs-actions.pod:2542 ../src/guestfs-actions.pod:2635 ../src/guestfs-actions.pod:2679 ../src/guestfs-actions.pod:2705 ../src/guestfs-actions.pod:2744 ../src/guestfs-actions.pod:2766 ../src/guestfs-actions.pod:2793 ../src/guestfs-actions.pod:2814 ../src/guestfs-actions.pod:2857 ../src/guestfs-actions.pod:2886 ../src/guestfs-actions.pod:2917 ../src/guestfs-actions.pod:2941 ../src/guestfs-actions.pod:2996 ../src/guestfs-actions.pod:3038 ../src/guestfs-actions.pod:3059 ../src/guestfs-actions.pod:3082 ../src/guestfs-actions.pod:3099 ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3135 -msgid "" -"This function should only be called with a root device string as returned by " -"C." -msgstr "" - -#. type: textblock -#: ../src/guestfs-actions.pod:2522 +#: ../src/guestfs-actions.pod:2589 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2526 ../fish/guestfish-actions.pod:1697 +#: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1725 msgid "" "If the architecture could not be determined, then the string C is " "returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2529 ../src/guestfs-actions.pod:2622 ../src/guestfs-actions.pod:2733 ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2904 ../src/guestfs-actions.pod:2928 ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:3025 ../src/guestfs-actions.pod:3048 ../src/guestfs-actions.pod:3069 ../src/guestfs-actions.pod:3089 ../src/guestfs-actions.pod:3106 ../src/guestfs-actions.pod:3125 ../src/guestfs-actions.pod:3228 ../src/guestfs-actions.pod:3269 ../fish/guestfish-actions.pod:1700 ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:1874 ../fish/guestfish-actions.pod:1889 ../fish/guestfish-actions.pod:1910 ../fish/guestfish-actions.pod:1980 ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2021 ../fish/guestfish-actions.pod:2064 ../fish/guestfish-actions.pod:2099 ../fish/guestfish-actions.pod:2115 ../fish/guestfish-actions.pod:2131 ../fish/guestfish-actions.pod:2144 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2172 ../fish/guestfish-actions.pod:2271 ../fish/guestfish-actions.pod:2305 +#: ../src/guestfs-actions.pod:2596 ../src/guestfs-actions.pod:2686 ../src/guestfs-actions.pod:2790 ../src/guestfs-actions.pod:2809 ../src/guestfs-actions.pod:2940 ../src/guestfs-actions.pod:3023 ../src/guestfs-actions.pod:3051 ../src/guestfs-actions.pod:3072 ../src/guestfs-actions.pod:3125 ../src/guestfs-actions.pod:3165 ../src/guestfs-actions.pod:3185 ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3222 ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3358 ../src/guestfs-actions.pod:3399 ../fish/guestfish-actions.pod:1728 ../fish/guestfish-actions.pod:1811 ../fish/guestfish-actions.pod:1890 ../fish/guestfish-actions.pod:1902 ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2047 ../fish/guestfish-actions.pod:2068 ../fish/guestfish-actions.pod:2082 ../fish/guestfish-actions.pod:2122 ../fish/guestfish-actions.pod:2154 ../fish/guestfish-actions.pod:2167 ../fish/guestfish-actions.pod:2180 ../fish/guestfish-actions.pod:2190 ../fish/guestfish-actions.pod:2200 ../fish/guestfish-actions.pod:2212 ../fish/guestfish-actions.pod:2308 ../fish/guestfish-actions.pod:2342 msgid "Please read L for more details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2536 +#: ../src/guestfs-actions.pod:2603 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2538 +#: ../src/guestfs-actions.pod:2605 #, no-wrap msgid "" " char *\n" @@ -10035,191 +10249,191 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2545 ../fish/guestfish-actions.pod:1709 +#: ../src/guestfs-actions.pod:2609 ../fish/guestfish-actions.pod:1734 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1712 +#: ../src/guestfs-actions.pod:2612 ../fish/guestfish-actions.pod:1737 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1716 +#: ../src/guestfs-actions.pod:2616 ../fish/guestfish-actions.pod:1741 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1718 +#: ../src/guestfs-actions.pod:2618 ../fish/guestfish-actions.pod:1743 msgid "Arch Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1720 +#: ../src/guestfs-actions.pod:2620 ../fish/guestfish-actions.pod:1745 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1722 +#: ../src/guestfs-actions.pod:2622 ../fish/guestfish-actions.pod:1747 msgid "CentOS." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1724 +#: ../src/guestfs-actions.pod:2624 ../fish/guestfish-actions.pod:1749 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1726 +#: ../src/guestfs-actions.pod:2626 ../fish/guestfish-actions.pod:1751 msgid "Debian." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1728 +#: ../src/guestfs-actions.pod:2628 ../fish/guestfish-actions.pod:1753 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1730 +#: ../src/guestfs-actions.pod:2630 ../fish/guestfish-actions.pod:1755 msgid "Fedora." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1732 +#: ../src/guestfs-actions.pod:2632 ../fish/guestfish-actions.pod:1757 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1734 +#: ../src/guestfs-actions.pod:2634 ../fish/guestfish-actions.pod:1759 msgid "Gentoo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1736 +#: ../src/guestfs-actions.pod:2636 ../fish/guestfish-actions.pod:1761 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1738 +#: ../src/guestfs-actions.pod:2638 ../fish/guestfish-actions.pod:1763 msgid "Linux Mint." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1740 +#: ../src/guestfs-actions.pod:2640 ../fish/guestfish-actions.pod:1765 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1742 +#: ../src/guestfs-actions.pod:2642 ../fish/guestfish-actions.pod:1767 msgid "Mandriva." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1744 +#: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1769 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1746 +#: ../src/guestfs-actions.pod:2646 ../fish/guestfish-actions.pod:1771 msgid "MeeGo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1748 +#: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1773 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1750 +#: ../src/guestfs-actions.pod:2650 ../fish/guestfish-actions.pod:1775 msgid "Pardus." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1752 +#: ../src/guestfs-actions.pod:2652 ../fish/guestfish-actions.pod:1777 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1754 +#: ../src/guestfs-actions.pod:2654 ../fish/guestfish-actions.pod:1779 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2592 ../fish/guestfish-actions.pod:1756 +#: ../src/guestfs-actions.pod:2656 ../fish/guestfish-actions.pod:1781 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1758 +#: ../src/guestfs-actions.pod:2658 ../fish/guestfish-actions.pod:1783 msgid "Red Hat Enterprise Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2596 ../fish/guestfish-actions.pod:1760 +#: ../src/guestfs-actions.pod:2660 ../fish/guestfish-actions.pod:1785 msgid "\"scientificlinux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2598 ../fish/guestfish-actions.pod:1762 +#: ../src/guestfs-actions.pod:2662 ../fish/guestfish-actions.pod:1787 msgid "Scientific Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1764 +#: ../src/guestfs-actions.pod:2664 ../fish/guestfish-actions.pod:1789 msgid "\"slackware\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2602 ../fish/guestfish-actions.pod:1766 +#: ../src/guestfs-actions.pod:2666 ../fish/guestfish-actions.pod:1791 msgid "Slackware." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2604 ../fish/guestfish-actions.pod:1768 +#: ../src/guestfs-actions.pod:2668 ../fish/guestfish-actions.pod:1793 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2606 ../fish/guestfish-actions.pod:1770 +#: ../src/guestfs-actions.pod:2670 ../fish/guestfish-actions.pod:1795 msgid "Ubuntu." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:3016 ../fish/guestfish-actions.pod:1772 ../fish/guestfish-actions.pod:1865 ../fish/guestfish-actions.pod:2090 +#: ../src/guestfs-actions.pod:2672 ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:1797 ../fish/guestfish-actions.pod:1881 ../fish/guestfish-actions.pod:2145 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2610 ../fish/guestfish-actions.pod:1774 +#: ../src/guestfs-actions.pod:2674 ../fish/guestfish-actions.pod:1799 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2612 ../src/guestfs-actions.pod:3008 ../fish/guestfish-actions.pod:1776 ../fish/guestfish-actions.pod:2082 +#: ../src/guestfs-actions.pod:2676 ../src/guestfs-actions.pod:3148 ../fish/guestfish-actions.pod:1801 ../fish/guestfish-actions.pod:2137 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2614 ../fish/guestfish-actions.pod:1778 +#: ../src/guestfs-actions.pod:2678 ../fish/guestfish-actions.pod:1803 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2619 ../src/guestfs-actions.pod:2730 ../src/guestfs-actions.pod:3022 ../fish/guestfish-actions.pod:1783 ../fish/guestfish-actions.pod:1871 ../fish/guestfish-actions.pod:2096 +#: ../src/guestfs-actions.pod:2683 ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1887 ../fish/guestfish-actions.pod:2151 msgid "" "Future versions of libguestfs may return other strings here. The caller " "should be prepared to handle any string." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2629 +#: ../src/guestfs-actions.pod:2693 msgid "guestfs_inspect_get_drive_mappings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2631 +#: ../src/guestfs-actions.pod:2695 #, no-wrap msgid "" " char **\n" @@ -10229,7 +10443,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2638 ../fish/guestfish-actions.pod:1795 +#: ../src/guestfs-actions.pod:2699 ../fish/guestfish-actions.pod:1817 msgid "" "This call is useful for Windows which uses a primitive system of assigning " "drive letters (like \"C:\") to partitions. This inspection API examines the " @@ -10238,7 +10452,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1801 +#: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1823 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -10248,7 +10462,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1805 +#: ../src/guestfs-actions.pod:2709 ../fish/guestfish-actions.pod:1827 msgid "" "Note that keys are drive letters. For Windows, the key is case insensitive " "and just contains the drive letter, without the customary colon separator " @@ -10256,7 +10470,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2652 ../fish/guestfish-actions.pod:1809 +#: ../src/guestfs-actions.pod:2713 ../fish/guestfish-actions.pod:1831 msgid "" "In future we may support other operating systems that also used drive " "letters, but the keys for those might not be case insensitive and might be " @@ -10265,28 +10479,28 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1814 +#: ../src/guestfs-actions.pod:2718 ../fish/guestfish-actions.pod:1836 msgid "" "For Windows guests, currently only hard drive mappings are returned. " "Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2660 ../fish/guestfish-actions.pod:1817 +#: ../src/guestfs-actions.pod:2721 ../fish/guestfish-actions.pod:1839 msgid "" "For guests that do not use drive mappings, or if the drive mappings could " "not be determined, this returns an empty hash table." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2663 +#: ../src/guestfs-actions.pod:2724 msgid "" "Please read L for more details. See also " "C, C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2667 ../src/guestfs-actions.pod:2843 ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:4843 ../src/guestfs-actions.pod:6776 +#: ../src/guestfs-actions.pod:2728 ../src/guestfs-actions.pod:2996 ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:5076 ../src/guestfs-actions.pod:7122 msgid "" "This function returns a NULL-terminated array of strings, or NULL if there " "was an error. The array of strings will always have length C<2n+1>, where " @@ -10294,13 +10508,18 @@ msgid "" "caller must free the strings and the array after use>." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:2734 ../src/guestfs-actions.pod:3190 +msgid "(Added in 1.9.17)" +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:2673 +#: ../src/guestfs-actions.pod:2736 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2675 +#: ../src/guestfs-actions.pod:2738 #, no-wrap msgid "" " char **\n" @@ -10310,7 +10529,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2682 ../fish/guestfish-actions.pod:1831 +#: ../src/guestfs-actions.pod:2742 ../fish/guestfish-actions.pod:1850 msgid "" "This returns a list of all the filesystems that we think are associated with " "this operating system. This includes the root filesystem, other ordinary " @@ -10318,26 +10537,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2687 ../fish/guestfish-actions.pod:1836 +#: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1855 msgid "" "In the case of a multi-boot virtual machine, it is possible for a filesystem " "to be shared between operating systems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2690 +#: ../src/guestfs-actions.pod:2750 msgid "" "Please read L for more details. See also " "C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2699 +#: ../src/guestfs-actions.pod:2759 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2701 +#: ../src/guestfs-actions.pod:2761 #, no-wrap msgid "" " char *\n" @@ -10347,51 +10566,56 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1849 +#: ../src/guestfs-actions.pod:2765 ../fish/guestfish-actions.pod:1865 msgid "" "This returns the format of the inspected operating system. You can use it " "to detect install images, live CDs and similar." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2711 ../fish/guestfish-actions.pod:1852 +#: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1868 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2715 ../fish/guestfish-actions.pod:1856 +#: ../src/guestfs-actions.pod:2772 ../fish/guestfish-actions.pod:1872 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2717 ../fish/guestfish-actions.pod:1858 +#: ../src/guestfs-actions.pod:2774 ../fish/guestfish-actions.pod:1874 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2719 ../fish/guestfish-actions.pod:1860 +#: ../src/guestfs-actions.pod:2776 ../fish/guestfish-actions.pod:1876 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2721 ../fish/guestfish-actions.pod:1862 +#: ../src/guestfs-actions.pod:2778 ../fish/guestfish-actions.pod:1878 msgid "" "The disk image being inspected is not an installed operating system, but a " "I install disk, live CD, or similar." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2726 ../fish/guestfish-actions.pod:1867 +#: ../src/guestfs-actions.pod:2783 ../fish/guestfish-actions.pod:1883 msgid "The format of this disk image is not known." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:2795 ../src/guestfs-actions.pod:3226 ../src/guestfs-actions.pod:3242 ../src/guestfs-actions.pod:3260 ../src/guestfs-actions.pod:6020 +msgid "(Added in 1.9.4)" +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:2738 +#: ../src/guestfs-actions.pod:2797 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2740 +#: ../src/guestfs-actions.pod:2799 #, no-wrap msgid "" " char *\n" @@ -10401,31 +10625,188 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1883 +#: ../src/guestfs-actions.pod:2803 ../fish/guestfish-actions.pod:1896 msgid "" "This function returns the hostname of the operating system as found by " "inspection of the guest's configuration files." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2750 ../fish/guestfish-actions.pod:1886 +#: ../src/guestfs-actions.pod:2806 ../fish/guestfish-actions.pod:1899 msgid "" "If the hostname could not be determined, then the string C is " "returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2758 +#: ../src/guestfs-actions.pod:2814 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2760 +#: ../src/guestfs-actions.pod:2816 +msgid "guestfs_inspect_get_icon" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:2818 +#, no-wrap +msgid "" +" char *\n" +" guestfs_inspect_get_icon (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" ...);\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:2829 +#, no-wrap +msgid "" +" GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n" +" GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2832 ../fish/guestfish-actions.pod:1908 +msgid "" +"This function returns an icon corresponding to the inspected operating " +"system. The icon is returned as a buffer containing a PNG image (re-encoded " +"to PNG if necessary)." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2836 ../fish/guestfish-actions.pod:1912 +msgid "" +"If it was not possible to get an icon this function returns a zero-length " +"(non-NULL) buffer. I." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2839 ../fish/guestfish-actions.pod:1915 +msgid "" +"Libguestfs will start by looking for a file called C or " +"C and if it has the correct format, the contents of " +"this file will be returned. You can disable favicons by passing the " +"optional C boolean as false (default is true)." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2845 ../fish/guestfish-actions.pod:1921 +msgid "" +"If finding the favicon fails, then we look in other places in the guest for " +"a suitable icon." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2848 ../fish/guestfish-actions.pod:1924 +msgid "" +"If the optional C boolean is true then only high quality icons " +"are returned, which means only icons of high resolution with an alpha " +"channel. The default (false) is to return any icon we can, even if it is of " +"substandard quality." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2859 ../fish/guestfish-actions.pod:1935 +msgid "" +"Unlike most other inspection API calls, the guest's disks must be mounted up " +"before you call this, since it needs to read information from the guest " +"filesystem during the call." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2865 ../fish/guestfish-actions.pod:1941 +msgid "" +"B The icon data comes from the untrusted guest, and should be " +"treated with caution. PNG files have been known to contain exploits. " +"Ensure that libpng (or other relevant libraries) are fully up to date before " +"trying to process or display the icon." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2873 ../fish/guestfish-actions.pod:1949 +msgid "" +"The PNG image returned can be any size. It might not be square. Libguestfs " +"tries to return the largest, highest quality icon available. The " +"application must scale the icon to the required size." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2880 ../fish/guestfish-actions.pod:1956 +msgid "" +"Extracting icons from Windows guests requires the external C " +"program from the C package, and several programs (C, " +"C, C) from the C package. These must be " +"installed separately." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2887 ../fish/guestfish-actions.pod:1963 +msgid "" +"Operating system icons are usually trademarks. Seek legal advice before " +"using trademarks in applications." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2896 ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:4975 +msgid "(Added in 1.11.12)" +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:2898 +msgid "guestfs_inspect_get_icon_va" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:2900 +#, no-wrap +msgid "" +" char *\n" +" guestfs_inspect_get_icon_va (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" va_list args);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2906 +msgid "This is the \"va_list variant\" of L." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:2910 +msgid "guestfs_inspect_get_icon_argv" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:2912 +#, no-wrap +msgid "" +" char *\n" +" guestfs_inspect_get_icon_argv (guestfs_h *g,\n" +" const char *root,\n" +" size_t *size_r,\n" +" const struct guestfs_inspect_get_icon_argv " +"*optargs);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:2918 +msgid "This is the \"argv variant\" of L." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:2922 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2762 +#: ../src/guestfs-actions.pod:2924 #, no-wrap msgid "" " int\n" @@ -10435,12 +10816,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2769 ../fish/guestfish-actions.pod:1898 +#: ../src/guestfs-actions.pod:2928 ../fish/guestfish-actions.pod:1974 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2772 ../fish/guestfish-actions.pod:1901 +#: ../src/guestfs-actions.pod:2931 ../fish/guestfish-actions.pod:1977 msgid "" "Windows uses a consistent versioning scheme which is I reflected in the " "popular public names used by the operating system. Notably the operating " @@ -10450,17 +10831,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2779 ../src/guestfs-actions.pod:2799 ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1922 +#: ../src/guestfs-actions.pod:2938 ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:1984 ../fish/guestfish-actions.pod:1995 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2787 +#: ../src/guestfs-actions.pod:2946 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2789 +#: ../src/guestfs-actions.pod:2948 #, no-wrap msgid "" " int\n" @@ -10470,24 +10851,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1919 +#: ../src/guestfs-actions.pod:2952 ../fish/guestfish-actions.pod:1992 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2801 +#: ../src/guestfs-actions.pod:2957 msgid "" "Please read L for more details. See also " "C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2808 +#: ../src/guestfs-actions.pod:2964 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2810 +#: ../src/guestfs-actions.pod:2966 #, no-wrap msgid "" " char **\n" @@ -10497,7 +10878,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2817 ../fish/guestfish-actions.pod:1934 +#: ../src/guestfs-actions.pod:2970 ../fish/guestfish-actions.pod:2004 msgid "" "This returns a hash of where we think the filesystems associated with this " "operating system should be mounted. Callers should note that this is at " @@ -10508,7 +10889,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2826 ../fish/guestfish-actions.pod:1943 +#: ../src/guestfs-actions.pod:2979 ../fish/guestfish-actions.pod:2013 msgid "" "Each element in the returned hashtable has a key which is the path of the " "mountpoint (eg. C) and a value which is the filesystem that would be " @@ -10516,12 +10897,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2831 ../fish/guestfish-actions.pod:1948 +#: ../src/guestfs-actions.pod:2984 ../fish/guestfish-actions.pod:2018 msgid "Non-mounted devices such as swap devices are I returned in this list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2834 +#: ../src/guestfs-actions.pod:2987 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C. For " @@ -10530,19 +10911,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2840 +#: ../src/guestfs-actions.pod:2993 msgid "" "Please read L for more details. See also " "C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2851 +#: ../src/guestfs-actions.pod:3004 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2853 +#: ../src/guestfs-actions.pod:3006 #, no-wrap msgid "" " char *\n" @@ -10552,7 +10933,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2860 +#: ../src/guestfs-actions.pod:3010 msgid "" "This function and C return the " "package format and package management tool used by the inspected operating " @@ -10561,7 +10942,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2866 ../fish/guestfish-actions.pod:1973 +#: ../src/guestfs-actions.pod:3016 ../fish/guestfish-actions.pod:2040 msgid "" "This returns the string C if we could not determine the package " "format I if the operating system does not have a real packaging system " @@ -10569,24 +10950,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2870 ../fish/guestfish-actions.pod:1977 +#: ../src/guestfs-actions.pod:3020 ../fish/guestfish-actions.pod:2044 msgid "" "Possible strings include: C, C, C, C, C. " "Future versions of libguestfs may return other strings." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2878 ../src/guestfs-actions.pod:2909 +#: ../src/guestfs-actions.pod:3028 ../src/guestfs-actions.pod:3056 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2880 +#: ../src/guestfs-actions.pod:3030 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2882 +#: ../src/guestfs-actions.pod:3032 #, no-wrap msgid "" " char *\n" @@ -10596,7 +10977,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2889 +#: ../src/guestfs-actions.pod:3036 msgid "" "C and this function return the package " "format and package management tool used by the inspected operating system. " @@ -10605,7 +10986,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2895 ../fish/guestfish-actions.pod:1995 +#: ../src/guestfs-actions.pod:3042 ../fish/guestfish-actions.pod:2059 msgid "" "This returns the string C if we could not determine the package " "management tool I if the operating system does not have a real packaging " @@ -10613,7 +10994,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1999 +#: ../src/guestfs-actions.pod:3046 ../fish/guestfish-actions.pod:2063 msgid "" "Possible strings include: C, C, C (for all Debian " "derivatives), C, C, C, C. Future versions of " @@ -10621,12 +11002,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2911 +#: ../src/guestfs-actions.pod:3058 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2913 +#: ../src/guestfs-actions.pod:3060 #, no-wrap msgid "" " char *\n" @@ -10636,7 +11017,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2920 ../fish/guestfish-actions.pod:2013 +#: ../src/guestfs-actions.pod:3064 ../fish/guestfish-actions.pod:2074 msgid "" "This returns the product name of the inspected operating system. The " "product name is generally some freeform string which can be displayed to the " @@ -10644,19 +11025,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2925 ../fish/guestfish-actions.pod:2018 +#: ../src/guestfs-actions.pod:3069 ../fish/guestfish-actions.pod:2079 msgid "" "If the product name could not be determined, then the string C is " "returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2935 +#: ../src/guestfs-actions.pod:3079 msgid "guestfs_inspect_get_product_variant" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2937 +#: ../src/guestfs-actions.pod:3081 #, no-wrap msgid "" " char *\n" @@ -10666,12 +11047,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2944 ../fish/guestfish-actions.pod:2030 +#: ../src/guestfs-actions.pod:3085 ../fish/guestfish-actions.pod:2088 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2947 ../fish/guestfish-actions.pod:2033 +#: ../src/guestfs-actions.pod:3088 ../fish/guestfish-actions.pod:2091 msgid "" "For Windows guests, this returns the contents of the Registry key " "C C " @@ -10683,7 +11064,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2956 ../fish/guestfish-actions.pod:2042 +#: ../src/guestfs-actions.pod:3097 ../fish/guestfish-actions.pod:2100 msgid "" "For enterprise Linux guests, in future we intend this to return the product " "variant such as C, C and so on. But this is not " @@ -10691,26 +11072,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2960 ../fish/guestfish-actions.pod:2046 +#: ../src/guestfs-actions.pod:3101 ../fish/guestfish-actions.pod:2104 msgid "" "If the product variant could not be determined, then the string C " "is returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2963 +#: ../src/guestfs-actions.pod:3104 msgid "" "Please read L for more details. See also " "C, C." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:3111 +msgid "(Added in 1.9.13)" +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:2970 +#: ../src/guestfs-actions.pod:3113 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2972 +#: ../src/guestfs-actions.pod:3115 #, no-wrap msgid "" " char **\n" @@ -10719,7 +11105,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2975 +#: ../src/guestfs-actions.pod:3118 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to C, but without redoing " @@ -10727,24 +11113,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2979 +#: ../src/guestfs-actions.pod:3122 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2988 +#: ../src/guestfs-actions.pod:3131 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2990 +#: ../src/guestfs-actions.pod:3133 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2992 +#: ../src/guestfs-actions.pod:3135 #, no-wrap msgid "" " char *\n" @@ -10754,49 +11140,49 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2999 ../fish/guestfish-actions.pod:2073 +#: ../src/guestfs-actions.pod:3139 ../fish/guestfish-actions.pod:2128 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3004 ../fish/guestfish-actions.pod:2078 +#: ../src/guestfs-actions.pod:3144 ../fish/guestfish-actions.pod:2133 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2080 +#: ../src/guestfs-actions.pod:3146 ../fish/guestfish-actions.pod:2135 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3010 ../fish/guestfish-actions.pod:2084 +#: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2139 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3012 ../fish/guestfish-actions.pod:2086 +#: ../src/guestfs-actions.pod:3152 ../fish/guestfish-actions.pod:2141 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3014 ../fish/guestfish-actions.pod:2088 +#: ../src/guestfs-actions.pod:3154 ../fish/guestfish-actions.pod:2143 msgid "FreeBSD." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3018 ../fish/guestfish-actions.pod:2092 +#: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2147 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3032 +#: ../src/guestfs-actions.pod:3172 msgid "guestfs_inspect_get_windows_current_control_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3034 +#: ../src/guestfs-actions.pod:3174 #, no-wrap msgid "" " char *\n" @@ -10806,26 +11192,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3041 ../fish/guestfish-actions.pod:2108 +#: ../src/guestfs-actions.pod:3178 ../fish/guestfish-actions.pod:2160 msgid "" "This returns the Windows CurrentControlSet of the inspected guest. The " "CurrentControlSet is a registry key name such as C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3044 ../fish/guestfish-actions.pod:2111 +#: ../src/guestfs-actions.pod:3181 ../fish/guestfish-actions.pod:2163 msgid "" "This call assumes that the guest is Windows and that the Registry could be " "examined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3053 +#: ../src/guestfs-actions.pod:3192 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3055 +#: ../src/guestfs-actions.pod:3194 #, no-wrap msgid "" " char *\n" @@ -10835,14 +11221,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2124 +#: ../src/guestfs-actions.pod:3198 ../fish/guestfish-actions.pod:2173 msgid "" "This returns the Windows systemroot of the inspected guest. The systemroot " "is a directory path such as C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3065 ../fish/guestfish-actions.pod:2127 +#: ../src/guestfs-actions.pod:3201 ../fish/guestfish-actions.pod:2176 msgid "" "This call assumes that the guest is Windows and that the systemroot could be " "determined by inspection. If this is not the case then an error is " @@ -10850,17 +11236,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3074 +#: ../src/guestfs-actions.pod:3210 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3076 +#: ../src/guestfs-actions.pod:3212 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3078 +#: ../src/guestfs-actions.pod:3214 #, no-wrap msgid "" " int\n" @@ -10870,19 +11256,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3085 +#: ../src/guestfs-actions.pod:3218 msgid "" "If C returns C (this is an install " "disk), then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3093 +#: ../src/guestfs-actions.pod:3228 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3095 +#: ../src/guestfs-actions.pod:3230 #, no-wrap msgid "" " int\n" @@ -10892,19 +11278,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3102 +#: ../src/guestfs-actions.pod:3234 msgid "" "If C returns C (this is an install " "disk), then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3110 +#: ../src/guestfs-actions.pod:3244 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3112 +#: ../src/guestfs-actions.pod:3246 #, no-wrap msgid "" " int\n" @@ -10914,7 +11300,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3119 +#: ../src/guestfs-actions.pod:3250 msgid "" "If C returns C (this is an install " "disk), then this returns true if the disk is a network installer, ie. not a " @@ -10923,12 +11309,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3129 +#: ../src/guestfs-actions.pod:3262 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3131 +#: ../src/guestfs-actions.pod:3264 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -10938,12 +11324,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3138 ../fish/guestfish-actions.pod:2181 +#: ../src/guestfs-actions.pod:3268 ../fish/guestfish-actions.pod:2218 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3140 +#: ../src/guestfs-actions.pod:3270 msgid "" "I This call works differently from other parts of the inspection " "API. You have to call C, then " @@ -10956,91 +11342,91 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2193 +#: ../src/guestfs-actions.pod:3280 ../fish/guestfish-actions.pod:2230 msgid "" "This returns an empty list if the inspection code was not able to determine " "the list of applications." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3153 ../fish/guestfish-actions.pod:2196 +#: ../src/guestfs-actions.pod:3283 ../fish/guestfish-actions.pod:2233 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3157 ../fish/guestfish-actions.pod:2200 +#: ../src/guestfs-actions.pod:3287 ../fish/guestfish-actions.pod:2237 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2202 +#: ../src/guestfs-actions.pod:3289 ../fish/guestfish-actions.pod:2239 msgid "" "The name of the application. For Red Hat-derived and Debian-derived Linux " "guests, this is the package name." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:2205 +#: ../src/guestfs-actions.pod:3292 ../fish/guestfish-actions.pod:2242 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3164 ../fish/guestfish-actions.pod:2207 +#: ../src/guestfs-actions.pod:3294 ../fish/guestfish-actions.pod:2244 msgid "" "The display name of the application, sometimes localized to the install " "language of the guest operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3167 ../fish/guestfish-actions.pod:2210 +#: ../src/guestfs-actions.pod:3297 ../fish/guestfish-actions.pod:2247 msgid "" "If unavailable this is returned as an empty string C<\"\">. Callers needing " "to display something can use C instead." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3170 ../fish/guestfish-actions.pod:2213 +#: ../src/guestfs-actions.pod:3300 ../fish/guestfish-actions.pod:2250 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3172 ../fish/guestfish-actions.pod:2215 +#: ../src/guestfs-actions.pod:3302 ../fish/guestfish-actions.pod:2252 msgid "" "For package managers which use epochs, this contains the epoch of the " "package (an integer). If unavailable, this is returned as C<0>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3175 ../fish/guestfish-actions.pod:2218 +#: ../src/guestfs-actions.pod:3305 ../fish/guestfish-actions.pod:2255 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2220 +#: ../src/guestfs-actions.pod:3307 ../fish/guestfish-actions.pod:2257 msgid "" "The version string of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3180 ../fish/guestfish-actions.pod:2223 +#: ../src/guestfs-actions.pod:3310 ../fish/guestfish-actions.pod:2260 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3182 ../fish/guestfish-actions.pod:2225 +#: ../src/guestfs-actions.pod:3312 ../fish/guestfish-actions.pod:2262 msgid "" "The release string of the application or package, for package managers that " "use this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3186 ../fish/guestfish-actions.pod:2229 +#: ../src/guestfs-actions.pod:3316 ../fish/guestfish-actions.pod:2266 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3188 ../fish/guestfish-actions.pod:2231 +#: ../src/guestfs-actions.pod:3318 ../fish/guestfish-actions.pod:2268 msgid "" "The installation path of the application (on operating systems such as " "Windows which use installation paths). This path is in the format used by " @@ -11048,84 +11434,84 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3193 ../fish/guestfish-actions.pod:2236 +#: ../src/guestfs-actions.pod:3323 ../fish/guestfish-actions.pod:2273 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3195 ../fish/guestfish-actions.pod:2238 +#: ../src/guestfs-actions.pod:3325 ../fish/guestfish-actions.pod:2275 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3197 ../fish/guestfish-actions.pod:2240 +#: ../src/guestfs-actions.pod:3327 ../fish/guestfish-actions.pod:2277 msgid "" "The install path translated into a libguestfs path. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3200 ../fish/guestfish-actions.pod:2243 +#: ../src/guestfs-actions.pod:3330 ../fish/guestfish-actions.pod:2280 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3202 ../fish/guestfish-actions.pod:2245 +#: ../src/guestfs-actions.pod:3332 ../fish/guestfish-actions.pod:2282 msgid "" "The name of the publisher of the application, for package managers that use " "this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3206 ../fish/guestfish-actions.pod:2249 +#: ../src/guestfs-actions.pod:3336 ../fish/guestfish-actions.pod:2286 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3208 ../fish/guestfish-actions.pod:2251 +#: ../src/guestfs-actions.pod:3338 ../fish/guestfish-actions.pod:2288 msgid "" "The URL (eg. upstream URL) of the application. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3211 ../fish/guestfish-actions.pod:2254 +#: ../src/guestfs-actions.pod:3341 ../fish/guestfish-actions.pod:2291 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3213 ../fish/guestfish-actions.pod:2256 +#: ../src/guestfs-actions.pod:3343 ../fish/guestfish-actions.pod:2293 msgid "" "For packaging systems which support this, the name of the source package. " "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3216 ../fish/guestfish-actions.pod:2259 +#: ../src/guestfs-actions.pod:3346 ../fish/guestfish-actions.pod:2296 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3218 ../fish/guestfish-actions.pod:2261 +#: ../src/guestfs-actions.pod:3348 ../fish/guestfish-actions.pod:2298 msgid "" "A short (usually one line) description of the application or package. If " "unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3221 ../fish/guestfish-actions.pod:2264 +#: ../src/guestfs-actions.pod:3351 ../fish/guestfish-actions.pod:2301 msgid "C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3223 ../fish/guestfish-actions.pod:2266 +#: ../src/guestfs-actions.pod:3353 ../fish/guestfish-actions.pod:2303 msgid "" "A longer description of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3230 +#: ../src/guestfs-actions.pod:3360 msgid "" "This function returns a C, or NULL if " "there was an error. I " @@ -11133,17 +11519,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3234 +#: ../src/guestfs-actions.pod:3364 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3236 +#: ../src/guestfs-actions.pod:3366 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3238 +#: ../src/guestfs-actions.pod:3368 #, no-wrap msgid "" " char **\n" @@ -11152,7 +11538,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3241 ../fish/guestfish-actions.pod:2277 +#: ../src/guestfs-actions.pod:3371 ../fish/guestfish-actions.pod:2314 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -11160,12 +11546,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3245 ../fish/guestfish-actions.pod:2281 +#: ../src/guestfs-actions.pod:3375 ../fish/guestfish-actions.pod:2318 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3247 ../fish/guestfish-actions.pod:2283 +#: ../src/guestfs-actions.pod:3377 ../fish/guestfish-actions.pod:2320 msgid "" "If one operating system was found, then this returns a list with a single " "element, which is the name of the root filesystem of this operating system. " @@ -11175,7 +11561,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3254 +#: ../src/guestfs-actions.pod:3384 msgid "" "You can pass the root string(s) returned to other C " "functions in order to query further information about each operating system, " @@ -11183,7 +11569,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3259 +#: ../src/guestfs-actions.pod:3389 msgid "" "This function uses other libguestfs features such as C and " "C in order to mount and unmount filesystems and look at " @@ -11192,24 +11578,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3265 ../fish/guestfish-actions.pod:2301 +#: ../src/guestfs-actions.pod:3395 ../fish/guestfish-actions.pod:2338 msgid "" "This function cannot decrypt encrypted disks. The caller must do that first " "(supplying the necessary keys) if the disk is encrypted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3271 ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3646 +#: ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3814 msgid "See also C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3279 +#: ../src/guestfs-actions.pod:3409 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3281 +#: ../src/guestfs-actions.pod:3411 #, no-wrap msgid "" " int\n" @@ -11219,29 +11605,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3285 ../fish/guestfish-actions.pod:2313 +#: ../src/guestfs-actions.pod:3415 ../fish/guestfish-actions.pod:2350 msgid "" "This returns C if and only if there is a block device with the given " "C name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3288 ../src/guestfs-actions.pod:3317 ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3362 ../src/guestfs-actions.pod:3378 ../src/guestfs-actions.pod:3434 ../src/guestfs-actions.pod:3449 +#: ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3447 ../src/guestfs-actions.pod:3477 ../src/guestfs-actions.pod:3492 ../src/guestfs-actions.pod:3508 ../src/guestfs-actions.pod:3564 ../src/guestfs-actions.pod:3579 msgid "See also C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3292 ../src/guestfs-actions.pod:3321 ../src/guestfs-actions.pod:3366 ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:3453 +#: ../src/guestfs-actions.pod:3422 ../src/guestfs-actions.pod:3451 ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3568 ../src/guestfs-actions.pod:3583 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3294 +#: ../src/guestfs-actions.pod:3424 msgid "guestfs_is_busy" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3296 +#: ../src/guestfs-actions.pod:3426 #, no-wrap msgid "" " int\n" @@ -11250,19 +11636,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3299 ../fish/guestfish-actions.pod:2322 +#: ../src/guestfs-actions.pod:3429 ../fish/guestfish-actions.pod:2359 msgid "" "This returns true iff this handle is busy processing a command (in the " "C state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3308 +#: ../src/guestfs-actions.pod:3438 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3310 +#: ../src/guestfs-actions.pod:3440 #, no-wrap msgid "" " int\n" @@ -11272,19 +11658,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3314 ../fish/guestfish-actions.pod:2331 +#: ../src/guestfs-actions.pod:3444 ../fish/guestfish-actions.pod:2368 msgid "" "This returns C if and only if there is a character device with the " "given C name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3323 +#: ../src/guestfs-actions.pod:3453 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3325 +#: ../src/guestfs-actions.pod:3455 #, no-wrap msgid "" " int\n" @@ -11293,19 +11679,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3328 ../fish/guestfish-actions.pod:2340 +#: ../src/guestfs-actions.pod:3458 ../fish/guestfish-actions.pod:2377 msgid "" "This returns true iff this handle is being configured (in the C " "state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3337 +#: ../src/guestfs-actions.pod:3467 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3339 +#: ../src/guestfs-actions.pod:3469 #, no-wrap msgid "" " int\n" @@ -11315,19 +11701,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3343 ../fish/guestfish-actions.pod:2349 +#: ../src/guestfs-actions.pod:3473 ../fish/guestfish-actions.pod:2386 msgid "" "This returns C if and only if there is a directory with the given " "C name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3353 +#: ../src/guestfs-actions.pod:3483 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3355 +#: ../src/guestfs-actions.pod:3485 #, no-wrap msgid "" " int\n" @@ -11337,19 +11723,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3359 ../fish/guestfish-actions.pod:2359 +#: ../src/guestfs-actions.pod:3489 ../fish/guestfish-actions.pod:2396 msgid "" "This returns C if and only if there is a FIFO (named pipe) with the " "given C name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3368 +#: ../src/guestfs-actions.pod:3498 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3370 +#: ../src/guestfs-actions.pod:3500 #, no-wrap msgid "" " int\n" @@ -11359,7 +11745,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3374 ../fish/guestfish-actions.pod:2368 +#: ../src/guestfs-actions.pod:3504 ../fish/guestfish-actions.pod:2405 msgid "" "This returns C if and only if there is a regular file with the given " "C name. Note that it returns false for other objects like " @@ -11367,12 +11753,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3384 +#: ../src/guestfs-actions.pod:3514 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3386 +#: ../src/guestfs-actions.pod:3516 #, no-wrap msgid "" " int\n" @@ -11381,19 +11767,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3389 ../fish/guestfish-actions.pod:2378 +#: ../src/guestfs-actions.pod:3519 ../fish/guestfish-actions.pod:2415 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3398 +#: ../src/guestfs-actions.pod:3528 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3400 +#: ../src/guestfs-actions.pod:3530 #, no-wrap msgid "" " int\n" @@ -11403,19 +11789,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3404 ../fish/guestfish-actions.pod:2387 +#: ../src/guestfs-actions.pod:3534 ../fish/guestfish-actions.pod:2424 msgid "" "This command tests whether C is a logical volume, and returns true " "iff this is the case." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3411 +#: ../src/guestfs-actions.pod:3541 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3413 +#: ../src/guestfs-actions.pod:3543 #, no-wrap msgid "" " int\n" @@ -11424,19 +11810,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3416 ../fish/guestfish-actions.pod:2394 +#: ../src/guestfs-actions.pod:3546 ../fish/guestfish-actions.pod:2431 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3425 +#: ../src/guestfs-actions.pod:3555 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3427 +#: ../src/guestfs-actions.pod:3557 #, no-wrap msgid "" " int\n" @@ -11446,19 +11832,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3431 ../fish/guestfish-actions.pod:2403 +#: ../src/guestfs-actions.pod:3561 ../fish/guestfish-actions.pod:2440 msgid "" "This returns C if and only if there is a Unix domain socket with the " "given C name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3440 +#: ../src/guestfs-actions.pod:3570 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3442 +#: ../src/guestfs-actions.pod:3572 #, no-wrap msgid "" " int\n" @@ -11468,19 +11854,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3446 ../fish/guestfish-actions.pod:2412 +#: ../src/guestfs-actions.pod:3576 ../fish/guestfish-actions.pod:2449 msgid "" "This returns C if and only if there is a symbolic link with the given " "C name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3455 +#: ../src/guestfs-actions.pod:3585 msgid "guestfs_is_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3457 +#: ../src/guestfs-actions.pod:3587 #, no-wrap msgid "" " int\n" @@ -11490,19 +11876,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3461 ../fish/guestfish-actions.pod:2421 +#: ../src/guestfs-actions.pod:3591 ../fish/guestfish-actions.pod:2458 msgid "" "This returns true iff the file exists and the file is empty or it contains " "all zero bytes." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:3596 ../src/guestfs-actions.pod:3610 +msgid "(Added in 1.11.8)" +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:3466 +#: ../src/guestfs-actions.pod:3598 msgid "guestfs_is_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3468 +#: ../src/guestfs-actions.pod:3600 #, no-wrap msgid "" " int\n" @@ -11512,22 +11903,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3472 ../fish/guestfish-actions.pod:2428 +#: ../src/guestfs-actions.pod:3604 ../fish/guestfish-actions.pod:2465 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3474 ../fish/guestfish-actions.pod:2430 +#: ../src/guestfs-actions.pod:3606 ../fish/guestfish-actions.pod:2467 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3478 +#: ../src/guestfs-actions.pod:3612 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3480 +#: ../src/guestfs-actions.pod:3614 #, no-wrap msgid "" " int\n" @@ -11536,17 +11927,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3483 ../fish/guestfish-actions.pod:2436 +#: ../src/guestfs-actions.pod:3617 ../fish/guestfish-actions.pod:2473 msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3489 +#: ../src/guestfs-actions.pod:3623 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3491 +#: ../src/guestfs-actions.pod:3625 #, no-wrap msgid "" " int\n" @@ -11555,26 +11946,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3494 ../fish/guestfish-actions.pod:2444 +#: ../src/guestfs-actions.pod:3628 ../fish/guestfish-actions.pod:2481 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3497 ../fish/guestfish-actions.pod:2447 +#: ../src/guestfs-actions.pod:3631 ../fish/guestfish-actions.pod:2484 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3509 +#: ../src/guestfs-actions.pod:3643 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3511 +#: ../src/guestfs-actions.pod:3645 #, no-wrap msgid "" " int\n" @@ -11586,7 +11977,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3517 +#: ../src/guestfs-actions.pod:3651 msgid "" "Change the file owner to C and group to C. This is like " "C but if C is a symlink then the link itself is " @@ -11594,12 +11985,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3529 +#: ../src/guestfs-actions.pod:3663 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3531 +#: ../src/guestfs-actions.pod:3665 #, no-wrap msgid "" " char *\n" @@ -11611,24 +12002,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3537 ../fish/guestfish-actions.pod:2466 +#: ../src/guestfs-actions.pod:3671 ../fish/guestfish-actions.pod:2503 msgid "" "Get a single extended attribute from file C named C. If C " "is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3551 +#: ../src/guestfs-actions.pod:3685 msgid "See also: C, C, L." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3559 +#: ../src/guestfs-actions.pod:3693 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3561 +#: ../src/guestfs-actions.pod:3695 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -11638,19 +12029,40 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3565 +#: ../src/guestfs-actions.pod:3699 msgid "" "This is the same as C, but if C is a symbolic link, " "then it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3575 +#: ../src/guestfs-actions.pod:3709 +msgid "guestfs_list_9p" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:3711 +#, no-wrap +msgid "" +" char **\n" +" guestfs_list_9p (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:3714 ../fish/guestfish-actions.pod:2531 +msgid "" +"List all 9p filesystems attached to the guest. A list of mount tags is " +"returned." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:3723 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3577 +#: ../src/guestfs-actions.pod:3725 #, no-wrap msgid "" " char **\n" @@ -11659,22 +12071,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3580 ../fish/guestfish-actions.pod:2494 +#: ../src/guestfs-actions.pod:3728 ../fish/guestfish-actions.pod:2538 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3582 ../fish/guestfish-actions.pod:2496 +#: ../src/guestfs-actions.pod:3730 ../fish/guestfish-actions.pod:2540 msgid "The full block device names are returned, eg. C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3592 +#: ../src/guestfs-actions.pod:3740 +msgid "guestfs_list_dm_devices" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:3742 +#, no-wrap +msgid "" +" char **\n" +" guestfs_list_dm_devices (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:3745 ../fish/guestfish-actions.pod:2548 +msgid "List all device mapper devices." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:3747 +msgid "" +"The returned list contains C devices, eg. ones created by a " +"previous call to C." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:3750 +msgid "" +"Device mapper devices which correspond to logical volumes are I " +"returned in this list. Call C if you want to list logical " +"volumes." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:3758 ../src/guestfs-actions.pod:5214 +msgid "(Added in 1.11.15)" +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:3760 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3594 +#: ../src/guestfs-actions.pod:3762 #, no-wrap msgid "" " char **\n" @@ -11683,7 +12134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3597 ../fish/guestfish-actions.pod:2504 +#: ../src/guestfs-actions.pod:3765 ../fish/guestfish-actions.pod:2561 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -11691,14 +12142,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3601 ../fish/guestfish-actions.pod:2508 +#: ../src/guestfs-actions.pod:3769 ../fish/guestfish-actions.pod:2565 msgid "" "The return value is a hash, where the keys are the devices containing " "filesystems, and the values are the filesystem types. For example:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3605 ../fish/guestfish-actions.pod:2512 +#: ../src/guestfs-actions.pod:3773 ../fish/guestfish-actions.pod:2569 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -11709,14 +12160,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3610 ../fish/guestfish-actions.pod:2517 +#: ../src/guestfs-actions.pod:3778 ../fish/guestfish-actions.pod:2574 msgid "" "The value can have the special value \"unknown\", meaning the content of the " "device is undetermined or empty. \"swap\" means a Linux swap partition." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3614 +#: ../src/guestfs-actions.pod:3782 msgid "" "This command runs other libguestfs commands, which might include " "C and C, and therefore you should use this " @@ -11724,7 +12175,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3618 +#: ../src/guestfs-actions.pod:3786 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " @@ -11735,17 +12186,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3632 ../src/guestfs-actions.pod:5244 +#: ../src/guestfs-actions.pod:3800 ../src/guestfs-actions.pod:5569 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3634 +#: ../src/guestfs-actions.pod:3802 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3636 +#: ../src/guestfs-actions.pod:3804 #, no-wrap msgid "" " char **\n" @@ -11754,29 +12205,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3639 ../fish/guestfish-actions.pod:2537 +#: ../src/guestfs-actions.pod:3807 ../fish/guestfish-actions.pod:2594 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3641 ../fish/guestfish-actions.pod:2539 +#: ../src/guestfs-actions.pod:3809 ../fish/guestfish-actions.pod:2596 msgid "The full partition device names are returned, eg. C" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3643 +#: ../src/guestfs-actions.pod:3811 msgid "" "This does not return logical volumes. For that you will need to call " "C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3654 +#: ../src/guestfs-actions.pod:3822 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3656 +#: ../src/guestfs-actions.pod:3824 #, no-wrap msgid "" " char *\n" @@ -11786,26 +12237,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3660 ../fish/guestfish-actions.pod:2550 +#: ../src/guestfs-actions.pod:3828 ../fish/guestfish-actions.pod:2607 msgid "" "List the files in C (relative to the root directory, there is no " "cwd) in the format of 'ls -la'." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3663 ../fish/guestfish-actions.pod:2553 +#: ../src/guestfs-actions.pod:3831 ../fish/guestfish-actions.pod:2610 msgid "" "This command is mostly useful for interactive sessions. It is I " "intended that you try to parse the output string." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3671 +#: ../src/guestfs-actions.pod:3839 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3673 +#: ../src/guestfs-actions.pod:3841 #, no-wrap msgid "" " int\n" @@ -11816,17 +12267,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3678 ../fish/guestfish-actions.pod:2560 +#: ../src/guestfs-actions.pod:3846 ../fish/guestfish-actions.pod:2617 msgid "This command creates a hard link using the C command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3684 +#: ../src/guestfs-actions.pod:3852 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3686 +#: ../src/guestfs-actions.pod:3854 #, no-wrap msgid "" " int\n" @@ -11837,19 +12288,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3691 ../fish/guestfish-actions.pod:2566 +#: ../src/guestfs-actions.pod:3859 ../fish/guestfish-actions.pod:2623 msgid "" "This command creates a hard link using the C command. The I<-f> " "option removes the link (C) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3698 +#: ../src/guestfs-actions.pod:3866 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3700 +#: ../src/guestfs-actions.pod:3868 #, no-wrap msgid "" " int\n" @@ -11860,17 +12311,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3705 ../fish/guestfish-actions.pod:2573 +#: ../src/guestfs-actions.pod:3873 ../fish/guestfish-actions.pod:2630 msgid "This command creates a symbolic link using the C command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3711 +#: ../src/guestfs-actions.pod:3879 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3713 +#: ../src/guestfs-actions.pod:3881 #, no-wrap msgid "" " int\n" @@ -11881,19 +12332,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3718 ../fish/guestfish-actions.pod:2579 +#: ../src/guestfs-actions.pod:3886 ../fish/guestfish-actions.pod:2636 msgid "" "This command creates a symbolic link using the C command, The I<-f> " "option removes the link (C) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3725 +#: ../src/guestfs-actions.pod:3893 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3727 +#: ../src/guestfs-actions.pod:3895 #, no-wrap msgid "" " int\n" @@ -11904,19 +12355,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3732 +#: ../src/guestfs-actions.pod:3900 msgid "" "This is the same as C, but if C is a symbolic " "link, then it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3740 +#: ../src/guestfs-actions.pod:3908 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3742 +#: ../src/guestfs-actions.pod:3910 #, no-wrap msgid "" " char **\n" @@ -11926,7 +12377,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3746 ../fish/guestfish-actions.pod:2594 +#: ../src/guestfs-actions.pod:3914 ../fish/guestfish-actions.pod:2651 msgid "" "List the files in C (relative to the root directory, there is no " "cwd). The '.' and '..' entries are not returned, but hidden files are " @@ -11934,19 +12385,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3750 +#: ../src/guestfs-actions.pod:3918 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3759 +#: ../src/guestfs-actions.pod:3927 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3761 +#: ../src/guestfs-actions.pod:3929 #, no-wrap msgid "" " int\n" @@ -11959,19 +12410,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3768 +#: ../src/guestfs-actions.pod:3936 msgid "" "This is the same as C, but if C is a symbolic link, " "then it sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3776 +#: ../src/guestfs-actions.pod:3944 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3778 +#: ../src/guestfs-actions.pod:3946 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -11981,41 +12432,41 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:6375 ../fish/guestfish-actions.pod:2613 ../fish/guestfish-actions.pod:4317 +#: ../src/guestfs-actions.pod:3950 ../src/guestfs-actions.pod:6721 ../fish/guestfish-actions.pod:2670 ../fish/guestfish-actions.pod:4472 msgid "Returns file information for the given C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3784 +#: ../src/guestfs-actions.pod:3952 msgid "" "This is the same as C except that if C is a symbolic " "link, then the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3788 ../fish/guestfish-actions.pod:2619 +#: ../src/guestfs-actions.pod:3956 ../fish/guestfish-actions.pod:2676 msgid "This is the same as the C system call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3790 ../src/guestfs-actions.pod:6379 +#: ../src/guestfs-actions.pod:3958 ../src/guestfs-actions.pod:6725 msgid "" "This function returns a C, or NULL if there was an " "error. I after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:6383 ../src/guestfs-actions.pod:6401 ../src/guestfs-actions.pod:6782 +#: ../src/guestfs-actions.pod:3962 ../src/guestfs-actions.pod:6729 ../src/guestfs-actions.pod:6747 ../src/guestfs-actions.pod:7128 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3796 +#: ../src/guestfs-actions.pod:3964 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3798 +#: ../src/guestfs-actions.pod:3966 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -12026,7 +12477,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3803 +#: ../src/guestfs-actions.pod:3971 msgid "" "This call allows you to perform the C operation on multiple " "files, where all files are in the directory C. C is the list " @@ -12034,7 +12485,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3807 ../fish/guestfish-actions.pod:2629 +#: ../src/guestfs-actions.pod:3975 ../fish/guestfish-actions.pod:2686 msgid "" "On return you get a list of stat structs, with a one-to-one correspondence " "to the C list. If any name did not exist or could not be lstat'd, " @@ -12042,7 +12493,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3812 +#: ../src/guestfs-actions.pod:3980 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C " @@ -12053,19 +12504,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3820 +#: ../src/guestfs-actions.pod:3988 msgid "" "This function returns a C, or NULL if there was " "an error. I after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3826 +#: ../src/guestfs-actions.pod:3994 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3828 +#: ../src/guestfs-actions.pod:3996 #, no-wrap msgid "" " int\n" @@ -12078,7 +12529,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3835 ../fish/guestfish-actions.pod:2646 +#: ../src/guestfs-actions.pod:4003 ../fish/guestfish-actions.pod:2703 msgid "" "This command adds a new key on LUKS device C. C is any " "existing key, and is used to access the device. C is the new key to " @@ -12086,14 +12537,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3840 +#: ../src/guestfs-actions.pod:4008 msgid "" "Note that if C already contains a key, then this command will " "fail. You have to use C first to remove that key." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3886 ../src/guestfs-actions.pod:3909 ../src/guestfs-actions.pod:3929 ../src/guestfs-actions.pod:3961 ../src/guestfs-actions.pod:3980 +#: ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4054 ../src/guestfs-actions.pod:4077 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4151 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L for more " @@ -12101,17 +12552,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3890 ../src/guestfs-actions.pod:3913 ../src/guestfs-actions.pod:3933 +#: ../src/guestfs-actions.pod:4018 ../src/guestfs-actions.pod:4058 ../src/guestfs-actions.pod:4081 ../src/guestfs-actions.pod:4101 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3852 +#: ../src/guestfs-actions.pod:4020 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3854 +#: ../src/guestfs-actions.pod:4022 #, no-wrap msgid "" " int\n" @@ -12121,7 +12572,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3858 +#: ../src/guestfs-actions.pod:4026 msgid "" "This closes a LUKS device that was created earlier by C " "or C. The C parameter must be the name of the " @@ -12130,17 +12581,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:3965 ../src/guestfs-actions.pod:3984 ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4082 +#: ../src/guestfs-actions.pod:4034 ../src/guestfs-actions.pod:4136 ../src/guestfs-actions.pod:4155 ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4253 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3868 +#: ../src/guestfs-actions.pod:4036 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3870 +#: ../src/guestfs-actions.pod:4038 #, no-wrap msgid "" " int\n" @@ -12152,7 +12603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3876 ../fish/guestfish-actions.pod:2672 +#: ../src/guestfs-actions.pod:4044 ../fish/guestfish-actions.pod:2729 msgid "" "This command erases existing data on C and formats the device as a " "LUKS encrypted device. C is the initial key, which is added to key " @@ -12160,19 +12611,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3883 ../src/guestfs-actions.pod:3906 ../src/guestfs-actions.pod:4046 ../src/guestfs-actions.pod:4995 ../src/guestfs-actions.pod:5775 ../src/guestfs-actions.pod:6182 ../src/guestfs-actions.pod:6212 ../src/guestfs-actions.pod:6245 ../src/guestfs-actions.pod:7427 ../fish/guestfish-actions.pod:2680 ../fish/guestfish-actions.pod:2693 ../fish/guestfish-actions.pod:2777 ../fish/guestfish-actions.pod:3358 ../fish/guestfish-actions.pod:3878 ../fish/guestfish-actions.pod:4188 ../fish/guestfish-actions.pod:4211 ../fish/guestfish-actions.pod:4233 ../fish/guestfish-actions.pod:4963 +#: ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:4217 ../src/guestfs-actions.pod:5320 ../src/guestfs-actions.pod:6102 ../src/guestfs-actions.pod:6528 ../src/guestfs-actions.pod:6558 ../src/guestfs-actions.pod:6591 ../src/guestfs-actions.pod:7787 ../fish/guestfish-actions.pod:2737 ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2837 ../fish/guestfish-actions.pod:3498 ../fish/guestfish-actions.pod:4018 ../fish/guestfish-actions.pod:4343 ../fish/guestfish-actions.pod:4366 ../fish/guestfish-actions.pod:4388 ../fish/guestfish-actions.pod:5126 msgid "" "B." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3892 +#: ../src/guestfs-actions.pod:4060 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3894 +#: ../src/guestfs-actions.pod:4062 #, no-wrap msgid "" " int\n" @@ -12185,19 +12636,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3901 +#: ../src/guestfs-actions.pod:4069 msgid "" "This command is the same as C but it also allows you to " "set the C used." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3915 +#: ../src/guestfs-actions.pod:4083 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3917 +#: ../src/guestfs-actions.pod:4085 #, no-wrap msgid "" " int\n" @@ -12209,19 +12660,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3923 ../fish/guestfish-actions.pod:2700 +#: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2757 msgid "" "This command deletes the key in key slot C from the encrypted LUKS " "device C. C must be one of the I keys." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3935 +#: ../src/guestfs-actions.pod:4103 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3937 +#: ../src/guestfs-actions.pod:4105 #, no-wrap msgid "" " int\n" @@ -12233,26 +12684,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3943 ../fish/guestfish-actions.pod:2711 +#: ../src/guestfs-actions.pod:4111 ../fish/guestfish-actions.pod:2768 msgid "" "This command opens a block device which has been encrypted according to the " "Linux Unified Key Setup (LUKS) standard." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3946 ../fish/guestfish-actions.pod:2714 +#: ../src/guestfs-actions.pod:4114 ../fish/guestfish-actions.pod:2771 msgid "C is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3948 ../fish/guestfish-actions.pod:2716 +#: ../src/guestfs-actions.pod:4116 ../fish/guestfish-actions.pod:2773 msgid "" "The caller must supply one of the keys associated with the LUKS block " "device, in the C parameter." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3951 ../fish/guestfish-actions.pod:2719 +#: ../src/guestfs-actions.pod:4119 ../fish/guestfish-actions.pod:2776 msgid "" "This creates a new block device called C. Reads and " "writes to this block device are decrypted from and encrypted to the " @@ -12260,20 +12711,25 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3955 +#: ../src/guestfs-actions.pod:4123 msgid "" "If this block device contains LVM volume groups, then calling " "C followed by C will make them " "visible." msgstr "" +#. type: textblock +#: ../src/guestfs-actions.pod:4127 +msgid "Use C to list all device mapper devices." +msgstr "" + #. type: =head2 -#: ../src/guestfs-actions.pod:3967 +#: ../src/guestfs-actions.pod:4138 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3969 +#: ../src/guestfs-actions.pod:4140 #, no-wrap msgid "" " int\n" @@ -12285,19 +12741,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3975 +#: ../src/guestfs-actions.pod:4146 msgid "" "This is the same as C except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3986 +#: ../src/guestfs-actions.pod:4157 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3988 +#: ../src/guestfs-actions.pod:4159 #, no-wrap msgid "" " int\n" @@ -12309,19 +12765,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3994 ../fish/guestfish-actions.pod:2744 +#: ../src/guestfs-actions.pod:4165 ../fish/guestfish-actions.pod:2804 msgid "" "This creates an LVM logical volume called C on the volume group " "C, with C megabytes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4001 +#: ../src/guestfs-actions.pod:4172 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4003 +#: ../src/guestfs-actions.pod:4174 #, no-wrap msgid "" " char *\n" @@ -12331,7 +12787,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4007 ../fish/guestfish-actions.pod:2751 +#: ../src/guestfs-actions.pod:4178 ../fish/guestfish-actions.pod:2811 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, C is converted to " @@ -12339,29 +12795,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4011 ../fish/guestfish-actions.pod:2755 +#: ../src/guestfs-actions.pod:4182 ../fish/guestfish-actions.pod:2815 msgid "" "This command returns an error if the C parameter does not refer to a " "logical volume." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4014 +#: ../src/guestfs-actions.pod:4185 msgid "See also C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4019 +#: ../src/guestfs-actions.pod:4190 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4021 +#: ../src/guestfs-actions.pod:4192 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4023 +#: ../src/guestfs-actions.pod:4194 #, no-wrap msgid "" " int\n" @@ -12370,24 +12826,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4026 +#: ../src/guestfs-actions.pod:4197 msgid "" "This undoes the effect of C. LVM will be able to " "see every block device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4029 ../src/guestfs-actions.pod:4071 ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:2798 +#: ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4242 ../fish/guestfish-actions.pod:2827 ../fish/guestfish-actions.pod:2858 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4036 +#: ../src/guestfs-actions.pod:4207 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4038 +#: ../src/guestfs-actions.pod:4209 #, no-wrap msgid "" " int\n" @@ -12396,19 +12852,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4041 ../fish/guestfish-actions.pod:2774 +#: ../src/guestfs-actions.pod:4212 ../fish/guestfish-actions.pod:2834 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4051 +#: ../src/guestfs-actions.pod:4222 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4053 +#: ../src/guestfs-actions.pod:4224 #, no-wrap msgid "" " int\n" @@ -12418,7 +12874,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4057 ../fish/guestfish-actions.pod:2784 +#: ../src/guestfs-actions.pod:4228 ../fish/guestfish-actions.pod:2844 msgid "" "This sets the LVM device filter so that LVM will only be able to \"see\" the " "block devices in the list C, and will ignore all other attached " @@ -12426,7 +12882,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4061 ../fish/guestfish-actions.pod:2788 +#: ../src/guestfs-actions.pod:4232 ../fish/guestfish-actions.pod:2848 msgid "" "Where disk image(s) contain duplicate PVs or VGs, this command is useful to " "get LVM to ignore the duplicates, otherwise LVM can get confused. Note also " @@ -12438,24 +12894,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4074 ../fish/guestfish-actions.pod:2801 +#: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2861 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4076 ../fish/guestfish-actions.pod:2803 +#: ../src/guestfs-actions.pod:4247 ../fish/guestfish-actions.pod:2863 msgid "" "You cannot use this if any VG is currently in use (eg. contains a mounted " "filesystem), even if you are not filtering out that VG." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4084 +#: ../src/guestfs-actions.pod:4255 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4086 +#: ../src/guestfs-actions.pod:4257 #, no-wrap msgid "" " int\n" @@ -12465,31 +12921,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4090 ../fish/guestfish-actions.pod:2811 +#: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:2871 msgid "" "Remove an LVM logical volume C, where C is the path to the " "LV, such as C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4093 ../fish/guestfish-actions.pod:2814 +#: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2874 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, " "C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4098 ../src/guestfs-actions.pod:5341 ../src/guestfs-actions.pod:7158 +#: ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:5666 ../src/guestfs-actions.pod:7498 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4100 +#: ../src/guestfs-actions.pod:4271 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4102 +#: ../src/guestfs-actions.pod:4273 #, no-wrap msgid "" " int\n" @@ -12500,22 +12956,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4107 ../fish/guestfish-actions.pod:2821 +#: ../src/guestfs-actions.pod:4278 ../fish/guestfish-actions.pod:2881 msgid "Rename a logical volume C with the new name C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4111 ../src/guestfs-actions.pod:7171 +#: ../src/guestfs-actions.pod:4282 ../src/guestfs-actions.pod:7511 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4113 +#: ../src/guestfs-actions.pod:4284 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4115 +#: ../src/guestfs-actions.pod:4286 #, no-wrap msgid "" " int\n" @@ -12526,19 +12982,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4120 ../fish/guestfish-actions.pod:2827 +#: ../src/guestfs-actions.pod:4291 ../fish/guestfish-actions.pod:2887 msgid "" "This resizes (expands or shrinks) an existing LVM logical volume to " "C. When reducing, data in the reduced part is lost." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4128 +#: ../src/guestfs-actions.pod:4299 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4130 +#: ../src/guestfs-actions.pod:4301 #, no-wrap msgid "" " int\n" @@ -12549,7 +13005,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4135 ../fish/guestfish-actions.pod:2835 +#: ../src/guestfs-actions.pod:4306 ../fish/guestfish-actions.pod:2895 msgid "" "This expands an existing logical volume C so that it fills C% of the " "remaining free space in the volume group. Commonly you would call this with " @@ -12558,17 +13014,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4143 +#: ../src/guestfs-actions.pod:4314 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4145 +#: ../src/guestfs-actions.pod:4316 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4147 +#: ../src/guestfs-actions.pod:4318 #, no-wrap msgid "" " char **\n" @@ -12577,31 +13033,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4150 ../fish/guestfish-actions.pod:2845 +#: ../src/guestfs-actions.pod:4321 ../fish/guestfish-actions.pod:2905 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4153 ../fish/guestfish-actions.pod:2848 +#: ../src/guestfs-actions.pod:4324 ../fish/guestfish-actions.pod:2908 msgid "" "This returns a list of the logical volume device names " "(eg. C)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4156 +#: ../src/guestfs-actions.pod:4327 msgid "See also C, C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4164 +#: ../src/guestfs-actions.pod:4335 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4166 +#: ../src/guestfs-actions.pod:4337 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -12610,14 +13066,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4169 ../fish/guestfish-actions.pod:2857 +#: ../src/guestfs-actions.pod:4340 ../fish/guestfish-actions.pod:2917 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L command. The \"full\" version includes all fields." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4172 +#: ../src/guestfs-actions.pod:4343 msgid "" "This function returns a C, or NULL if there " "was an error. I after " @@ -12625,12 +13081,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4178 +#: ../src/guestfs-actions.pod:4349 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4180 +#: ../src/guestfs-actions.pod:4351 #, no-wrap msgid "" " char *\n" @@ -12640,17 +13096,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4184 ../fish/guestfish-actions.pod:2864 +#: ../src/guestfs-actions.pod:4355 ../fish/guestfish-actions.pod:2924 msgid "This command returns the UUID of the LVM LV C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4191 +#: ../src/guestfs-actions.pod:4362 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4193 +#: ../src/guestfs-actions.pod:4364 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -12661,7 +13117,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4198 ../fish/guestfish-actions.pod:2870 +#: ../src/guestfs-actions.pod:4369 ../fish/guestfish-actions.pod:2930 msgid "" "This call allows you to get the extended attributes of multiple files, where " "all files are in the directory C. C is the list of files from " @@ -12669,7 +13125,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4202 ../fish/guestfish-actions.pod:2874 +#: ../src/guestfs-actions.pod:4373 ../fish/guestfish-actions.pod:2934 msgid "" "On return you get a flat list of xattr structs which must be interpreted " "sequentially. The first xattr struct always has a zero-length C. " @@ -12682,7 +13138,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4212 +#: ../src/guestfs-actions.pod:4383 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C for " @@ -12693,12 +13149,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4226 +#: ../src/guestfs-actions.pod:4397 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4228 +#: ../src/guestfs-actions.pod:4399 #, no-wrap msgid "" " int\n" @@ -12708,17 +13164,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4232 ../fish/guestfish-actions.pod:2896 +#: ../src/guestfs-actions.pod:4403 ../fish/guestfish-actions.pod:2956 msgid "Create a directory named C." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4238 +#: ../src/guestfs-actions.pod:4409 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4240 +#: ../src/guestfs-actions.pod:4411 #, no-wrap msgid "" " int\n" @@ -12729,14 +13185,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2902 +#: ../src/guestfs-actions.pod:4416 ../fish/guestfish-actions.pod:2962 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4248 ../fish/guestfish-actions.pod:2905 +#: ../src/guestfs-actions.pod:4419 ../fish/guestfish-actions.pod:2965 msgid "" "For common Linux filesystems, the actual mode which is set will be C. Non-native-Linux filesystems may interpret the mode in " @@ -12744,17 +13200,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4252 +#: ../src/guestfs-actions.pod:4423 msgid "See also C, C" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4258 +#: ../src/guestfs-actions.pod:4429 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4260 +#: ../src/guestfs-actions.pod:4431 #, no-wrap msgid "" " int\n" @@ -12764,19 +13220,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2915 +#: ../src/guestfs-actions.pod:4435 ../fish/guestfish-actions.pod:2975 msgid "" "Create a directory named C, creating any parent directories as " "necessary. This is like the C shell command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4271 +#: ../src/guestfs-actions.pod:4442 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4273 +#: ../src/guestfs-actions.pod:4444 #, no-wrap msgid "" " char *\n" @@ -12786,7 +13242,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4277 ../fish/guestfish-actions.pod:2922 +#: ../src/guestfs-actions.pod:4448 ../fish/guestfish-actions.pod:2982 msgid "" "This command creates a temporary directory. The C