diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2011-02-06 17:18:24 +0000 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2011-02-06 17:18:24 +0000 |
commit | f455dc3814bf9f7e7e894ba81360acb0edd92464 (patch) | |
tree | 8b8e0987efe554c1937fa8ad64fc0a52dea8e97a /po-docs/libguestfs-docs.pot | |
parent | 8d7d7c4ecfd202e04d18736718e9c5bb125ce4f0 (diff) | |
download | libguestfs-f455dc3814bf9f7e7e894ba81360acb0edd92464.tar.gz libguestfs-f455dc3814bf9f7e7e894ba81360acb0edd92464.tar.xz libguestfs-f455dc3814bf9f7e7e894ba81360acb0edd92464.zip |
Version 1.9.8.1.9.8
Diffstat (limited to 'po-docs/libguestfs-docs.pot')
-rw-r--r-- | po-docs/libguestfs-docs.pot | 6947 |
1 files changed, 3591 insertions, 3356 deletions
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 27f79f48..837e525e 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.9.7\n" +"Project-Id-Version: libguestfs 1.9.8\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-01-30 23:51+0000\n" +"POT-Creation-Date: 2011-02-06 17:14+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -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:1031 ../src/guestfs.pod:1035 ../src/guestfs.pod:1039 ../src/guestfs.pod:1044 ../src/guestfs.pod:1052 ../src/guestfs.pod:1071 ../src/guestfs.pod:1079 ../src/guestfs.pod:1101 ../src/guestfs.pod:1105 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113 ../src/guestfs.pod:1117 ../src/guestfs.pod:1121 ../src/guestfs.pod:1603 ../src/guestfs.pod:1608 ../src/guestfs.pod:1612 ../src/guestfs.pod:1722 ../src/guestfs.pod:1727 ../src/guestfs.pod:1731 ../src/guestfs.pod:2083 ../src/guestfs.pod:2089 ../src/guestfs.pod:2094 ../src/guestfs.pod:2100 ../src/guestfs.pod:2565 ../src/guestfs.pod:2569 ../src/guestfs.pod:2573 ../src/guestfs.pod:2577 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:569 ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:584 ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:1587 ../src/guestfs-actions.pod:1591 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1611 ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1625 ../src/guestfs-actions.pod:1629 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1771 ../src/guestfs-actions.pod:1775 ../src/guestfs-actions.pod:1780 ../src/guestfs-actions.pod:1785 ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1850 ../src/guestfs-actions.pod:1855 ../fish/guestfish.pod:427 ../fish/guestfish.pod:431 ../fish/guestfish.pod:435 ../fish/guestfish.pod:439 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:373 ../fish/guestfish-actions.pod:381 ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:1065 ../fish/guestfish-actions.pod:1069 ../fish/guestfish-actions.pod:1073 ../fish/guestfish-actions.pod:1077 ../fish/guestfish-actions.pod:1085 ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1093 ../fish/guestfish-actions.pod:1103 ../fish/guestfish-actions.pod:1107 ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1201 ../fish/guestfish-actions.pod:1205 ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:1215 ../fish/guestfish-actions.pod:1257 ../fish/guestfish-actions.pod:1261 ../fish/guestfish-actions.pod:1266 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345 ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360 +#: ../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:1088 ../src/guestfs.pod:1092 ../src/guestfs.pod:1096 ../src/guestfs.pod:1101 ../src/guestfs.pod:1109 ../src/guestfs.pod:1128 ../src/guestfs.pod:1136 ../src/guestfs.pod:1158 ../src/guestfs.pod:1162 ../src/guestfs.pod:1166 ../src/guestfs.pod:1170 ../src/guestfs.pod:1174 ../src/guestfs.pod:1178 ../src/guestfs.pod:1660 ../src/guestfs.pod:1665 ../src/guestfs.pod:1669 ../src/guestfs.pod:1779 ../src/guestfs.pod:1784 ../src/guestfs.pod:1788 ../src/guestfs.pod:2140 ../src/guestfs.pod:2146 ../src/guestfs.pod:2151 ../src/guestfs.pod:2157 ../src/guestfs.pod:2622 ../src/guestfs.pod:2626 ../src/guestfs.pod:2630 ../src/guestfs.pod:2634 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:599 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599 ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1641 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1783 ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:1858 ../src/guestfs-actions.pod:1863 ../fish/guestfish.pod:432 ../fish/guestfish.pod:436 ../fish/guestfish.pod:440 ../fish/guestfish.pod:444 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:380 ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:402 ../fish/guestfish-actions.pod:1072 ../fish/guestfish-actions.pod:1076 ../fish/guestfish-actions.pod:1080 ../fish/guestfish-actions.pod:1084 ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1100 ../fish/guestfish-actions.pod:1110 ../fish/guestfish-actions.pod:1114 ../fish/guestfish-actions.pod:1118 ../fish/guestfish-actions.pod:1208 ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217 ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1273 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345 ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360 msgid "*" msgstr "" @@ -933,7 +933,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:469 ../src/guestfs.pod:1224 ../src/guestfs.pod:1355 ../src/guestfs.pod:2128 +#: ../src/guestfs.pod:469 ../src/guestfs.pod:1281 ../src/guestfs.pod:1412 ../src/guestfs.pod:2185 msgid "1." msgstr "" @@ -951,7 +951,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:475 ../src/guestfs.pod:1228 ../src/guestfs.pod:1359 ../src/guestfs.pod:2153 +#: ../src/guestfs.pod:475 ../src/guestfs.pod:1285 ../src/guestfs.pod:1416 ../src/guestfs.pod:2210 msgid "2." msgstr "" @@ -978,7 +978,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:486 ../src/guestfs.pod:1365 +#: ../src/guestfs.pod:486 ../src/guestfs.pod:1422 msgid "3." msgstr "" @@ -1045,7 +1045,7 @@ msgid "For more information about umask, see L<umask(2)>." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:519 ../fish/guestfish.pod:746 +#: ../src/guestfs.pod:519 ../fish/guestfish.pod:751 msgid "ENCRYPTED DISKS" msgstr "" @@ -1950,12 +1950,122 @@ msgstr "" #. type: =head2 #: ../src/guestfs.pod:975 -msgid "ABI GUARANTEE" +msgid "ATTACHING TO RUNNING DAEMONS" msgstr "" #. type: textblock #: ../src/guestfs.pod:977 msgid "" +"I<Note (1):> This is B<highly experimental> and has a tendency to eat " +"babies. Use with caution." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:980 +msgid "" +"I<Note (2):> This section explains how to attach to a running daemon from a " +"low level perspective. For most users, simply using virt tools such as " +"L<guestfish(1)> with the I<--live> option will \"just work\"." +msgstr "" + +#. type: =head3 +#: ../src/guestfs.pod:984 +msgid "Using guestfs_set_attach_method" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:986 +msgid "" +"By calling L</guestfs_set_attach_method> you can change how the library " +"connects to the C<guestfsd> daemon in L</guestfs_launch> (read " +"L</ARCHITECTURE> for some background)." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:990 +msgid "" +"The normal attach method is C<appliance>, where a small appliance is created " +"containing the daemon, and then the library connects to this." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:993 +msgid "" +"Setting attach method to C<unix:I<path>> (where I<path> is the path of a " +"Unix domain socket) causes L</guestfs_launch> to connect to an existing " +"daemon over the Unix domain socket." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:997 +msgid "" +"The normal use for this is to connect to a running virtual machine that " +"contains a C<guestfsd> daemon, and send commands so you can read and write " +"files inside the live virtual machine." +msgstr "" + +#. type: =head3 +#: ../src/guestfs.pod:1001 +msgid "Using guestfs_add_domain with live flag" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1003 +msgid "" +"L</guestfs_add_domain> provides some help for getting the correct attach " +"method. If you pass the C<live> option to this function, then (if the " +"virtual machine is running) it will examine the libvirt XML looking for a " +"virtio-serial channel to connect to:" +msgstr "" + +#. type: verbatim +#: ../src/guestfs.pod:1009 +#, no-wrap +msgid "" +" <domain>\n" +" ...\n" +" <devices>\n" +" ...\n" +" <channel type='unix'>\n" +" <source mode='bind' path='/path/to/socket'/>\n" +" <target type='virtio' name='org.libguestfs.channel.0'/>\n" +" </channel>\n" +" ...\n" +" </devices>\n" +" </domain>\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1021 +msgid "" +"L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach " +"method to C<unix:/path/to/socket>." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1024 +msgid "" +"Some of the libguestfs tools (including guestfish) support a I<--live> " +"option which is passed through to L</guestfs_add_domain> thus allowing you " +"to attach to and modify live virtual machines." +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1028 +msgid "" +"The virtual machine needs to have been set up beforehand so that it has the " +"virtio-serial channel and so that guestfsd is running inside it." +msgstr "" + +#. type: =head2 +#: ../src/guestfs.pod:1032 +msgid "ABI GUARANTEE" +msgstr "" + +#. type: textblock +#: ../src/guestfs.pod:1034 +msgid "" "We guarantee the libguestfs ABI (binary interface), for public, high-level " "actions as outlined in this section. Although we will deprecate some " "actions, for example if they get replaced by newer calls, we will keep the " @@ -1964,12 +2074,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:983 +#: ../src/guestfs.pod:1040 msgid "BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:985 +#: ../src/guestfs.pod:1042 msgid "" "In the kernel there is now quite a profusion of schemata for naming block " "devices (in this context, by I<block device> I mean a physical or virtual " @@ -1984,7 +2094,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:997 +#: ../src/guestfs.pod:1054 msgid "" "As discussed above, libguestfs uses a qemu appliance running an embedded " "Linux kernel to access block devices. We can run a variety of appliances " @@ -1992,7 +2102,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1001 +#: ../src/guestfs.pod:1058 msgid "" "This causes a problem for libguestfs because many API calls use device or " "partition names. Working scripts and the recipe (example) scripts that we " @@ -2000,7 +2110,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1006 +#: ../src/guestfs.pod:1063 msgid "" "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. " "Internally C</dev/sd*> names are translated, if necessary, to other names as " @@ -2009,7 +2119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1012 +#: ../src/guestfs.pod:1069 msgid "" "Note that this I<only> applies to parameters. The L</guestfs_list_devices>, " "L</guestfs_list_partitions> and similar calls return the true names of the " @@ -2017,12 +2127,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1017 +#: ../src/guestfs.pod:1074 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1019 +#: ../src/guestfs.pod:1076 msgid "" "Usually this translation is transparent. However in some (very rare) cases " "you may need to know the exact algorithm. Such cases include where you use " @@ -2032,7 +2142,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1025 +#: ../src/guestfs.pod:1082 msgid "" "The algorithm is applied only to I<parameters> which are known to be either " "device or partition names. Return values from functions such as " @@ -2040,54 +2150,54 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1033 +#: ../src/guestfs.pod:1090 msgid "Is the string a parameter which is a device or partition name?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1037 +#: ../src/guestfs.pod:1094 msgid "Does the string begin with C</dev/sd>?" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1041 +#: ../src/guestfs.pod:1098 msgid "" "Does the named device exist? If so, we use that device. However if I<not> " "then we continue with this algorithm." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1046 +#: ../src/guestfs.pod:1103 msgid "Replace initial C</dev/sd> string with C</dev/hd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1048 +#: ../src/guestfs.pod:1105 msgid "For example, change C</dev/sda2> to C</dev/hda2>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1050 +#: ../src/guestfs.pod:1107 msgid "If that named device exists, use it. If not, continue." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1054 +#: ../src/guestfs.pod:1111 msgid "Replace initial C</dev/sd> string with C</dev/vd>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1056 +#: ../src/guestfs.pod:1113 msgid "If that named device exists, use it. If not, return an error." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1060 +#: ../src/guestfs.pod:1117 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1062 +#: ../src/guestfs.pod:1119 msgid "" "Although the standard naming scheme and automatic translation is useful for " "simple programs and guestfish scripts, for larger programs it is best not to " @@ -2095,50 +2205,50 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1066 +#: ../src/guestfs.pod:1123 msgid "" "Where possible for maximum future portability programs using libguestfs " "should use these future-proof techniques:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1073 +#: ../src/guestfs.pod:1130 msgid "" "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual " "device names, and then use those names directly." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1076 +#: ../src/guestfs.pod:1133 msgid "Since those device names exist by definition, they will never be translated." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1081 +#: ../src/guestfs.pod:1138 msgid "" "Use higher level ways to identify filesystems, such as LVM names, UUIDs and " "filesystem labels." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1086 +#: ../src/guestfs.pod:1143 msgid "SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1088 +#: ../src/guestfs.pod:1145 msgid "" "This section discusses security implications of using libguestfs, " "particularly with untrusted or malicious guests or disk images." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1091 +#: ../src/guestfs.pod:1148 msgid "GENERAL SECURITY CONSIDERATIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1093 +#: ../src/guestfs.pod:1150 msgid "" "Be careful with any files or data that you download from a guest (by " "\"download\" we mean not just the L</guestfs_download> command but any " @@ -2148,42 +2258,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1103 +#: ../src/guestfs.pod:1160 msgid "the data (file etc) not being present" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1107 +#: ../src/guestfs.pod:1164 msgid "being present but empty" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1111 +#: ../src/guestfs.pod:1168 msgid "being much larger than normal" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1115 +#: ../src/guestfs.pod:1172 msgid "containing arbitrary 8 bit data" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1119 +#: ../src/guestfs.pod:1176 msgid "being in an unexpected character encoding" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1123 +#: ../src/guestfs.pod:1180 msgid "containing homoglyphs." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1127 +#: ../src/guestfs.pod:1184 msgid "SECURITY OF MOUNTING FILESYSTEMS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1129 +#: ../src/guestfs.pod:1186 msgid "" "When you mount a filesystem under Linux, mistakes in the kernel filesystem " "(VFS) module can sometimes be escalated into exploits by deliberately " @@ -2199,7 +2309,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1142 +#: ../src/guestfs.pod:1199 msgid "" "That explains why you should never mount a filesystem from an untrusted " "guest on your host kernel. How about libguestfs? We run a Linux kernel " @@ -2213,19 +2323,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1153 +#: ../src/guestfs.pod:1210 msgid "" "In any case callers can reduce the attack surface by forcing the filesystem " "type when mounting (use L</guestfs_mount_vfs>)." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1156 +#: ../src/guestfs.pod:1213 msgid "PROTOCOL SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1158 +#: ../src/guestfs.pod:1215 msgid "" "The protocol is designed to be secure, being based on RFC 4506 (XDR) with a " "defined upper message size. However a program that uses libguestfs must " @@ -2235,12 +2345,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1164 +#: ../src/guestfs.pod:1221 msgid "INSPECTION SECURITY" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1166 +#: ../src/guestfs.pod:1223 msgid "" "Parts of the inspection API (see L</INSPECTION>) return untrusted strings " "directly from the guest, and these could contain any 8 bit data. Callers " @@ -2249,7 +2359,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1172 +#: ../src/guestfs.pod:1229 msgid "" "Guest configuration may be altered in unusual ways by the administrator of " "the virtual machine, and may not reflect reality (particularly for untrusted " @@ -2260,7 +2370,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1180 +#: ../src/guestfs.pod:1237 msgid "" "The inspection API parses guest configuration using two external libraries: " "Augeas (Linux configuration) and hivex (Windows Registry). Both are " @@ -2270,12 +2380,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1186 +#: ../src/guestfs.pod:1243 msgid "RUNNING UNTRUSTED GUEST COMMANDS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1188 +#: ../src/guestfs.pod:1245 msgid "" "Be very cautious about running commands from the guest. By running a " "command in the guest, you are giving CPU time to a binary that you do not " @@ -2285,24 +2395,24 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1194 +#: ../src/guestfs.pod:1251 msgid "CVE-2010-3851" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1196 +#: ../src/guestfs.pod:1253 msgid "https://bugzilla.redhat.com/642934" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1198 +#: ../src/guestfs.pod:1255 msgid "" "This security bug concerns the automatic disk format detection that qemu " "does on disk images." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1201 +#: ../src/guestfs.pod:1258 msgid "" "A raw disk image is just the raw bytes, there is no header. Other disk " "images like qcow2 contain a special header. Qemu deals with this by looking " @@ -2311,7 +2421,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1206 +#: ../src/guestfs.pod:1263 msgid "" "This allows a guest which has been given a raw disk image to write some " "other header. At next boot (or when the disk image is accessed by " @@ -2320,7 +2430,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1211 +#: ../src/guestfs.pod:1268 msgid "" "This in itself would not be a problem, but qcow2 offers many features, one " "of which is to allow a disk image to refer to another image (called the " @@ -2332,24 +2442,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1219 +#: ../src/guestfs.pod:1276 msgid "In libguestfs this is rather hard to exploit except under two circumstances:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1226 +#: ../src/guestfs.pod:1283 msgid "You have enabled the network or have opened the disk in write mode." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1230 +#: ../src/guestfs.pod:1287 msgid "" "You are also running untrusted code from the guest (see L</RUNNING " "COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1235 +#: ../src/guestfs.pod:1292 msgid "" "The way to avoid this is to specify the expected disk format when adding " "disks (the optional C<format> option to L</guestfs_add_drive_opts>). You " @@ -2358,31 +2468,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1240 +#: ../src/guestfs.pod:1297 msgid "" "For disks added from libvirt using calls like L</guestfs_add_domain>, the " "format is fetched from libvirt and passed through." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1243 +#: ../src/guestfs.pod:1300 msgid "" "For libguestfs tools, use the I<--format> command line parameter as " "appropriate." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1246 +#: ../src/guestfs.pod:1303 msgid "CONNECTION MANAGEMENT" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1248 +#: ../src/guestfs.pod:1305 msgid "guestfs_h *" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1250 +#: ../src/guestfs.pod:1307 msgid "" "C<guestfs_h> is the opaque type representing a connection handle. Create a " "handle by calling L</guestfs_create>. Call L</guestfs_close> to free the " @@ -2390,19 +2500,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1254 +#: ../src/guestfs.pod:1311 msgid "" "For information on using multiple handles and threads, see the section " "L</MULTIPLE HANDLES AND MULTIPLE THREADS> below." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1257 +#: ../src/guestfs.pod:1314 msgid "guestfs_create" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1259 +#: ../src/guestfs.pod:1316 #, no-wrap msgid "" " guestfs_h *guestfs_create (void);\n" @@ -2410,43 +2520,43 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1261 +#: ../src/guestfs.pod:1318 msgid "Create a connection handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1263 +#: ../src/guestfs.pod:1320 msgid "" "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) " "on the handle at least once." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1266 +#: ../src/guestfs.pod:1323 msgid "" "This function returns a non-NULL pointer to a handle on success or NULL on " "error." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1269 +#: ../src/guestfs.pod:1326 msgid "After configuring the handle, you have to call L</guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1271 +#: ../src/guestfs.pod:1328 msgid "" "You may also want to configure error handling for the handle. See L</ERROR " "HANDLING> section below." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1274 +#: ../src/guestfs.pod:1331 msgid "guestfs_close" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1276 +#: ../src/guestfs.pod:1333 #, no-wrap msgid "" " void guestfs_close (guestfs_h *g);\n" @@ -2454,24 +2564,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1278 +#: ../src/guestfs.pod:1335 msgid "This closes the connection handle and frees up all resources used." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1280 +#: ../src/guestfs.pod:1337 msgid "ERROR HANDLING" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1282 +#: ../src/guestfs.pod:1339 msgid "" "API functions can return errors. For example, almost all functions that " "return C<int> will return C<-1> to indicate an error." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1285 +#: ../src/guestfs.pod:1342 msgid "" "Additional information is available for errors: an error message string and " "optionally an error number (errno) if the thing that failed was a system " @@ -2479,7 +2589,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1289 +#: ../src/guestfs.pod:1346 msgid "" "You can get at the additional information about the last error on the handle " "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting " @@ -2487,7 +2597,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1294 +#: ../src/guestfs.pod:1351 msgid "" "When the handle is created, a default error handler is installed which " "prints the error message string to C<stderr>. For small short-running " @@ -2495,7 +2605,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1298 +#: ../src/guestfs.pod:1355 #, no-wrap msgid "" " if (guestfs_launch (g) == -1)\n" @@ -2504,21 +2614,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1301 +#: ../src/guestfs.pod:1358 msgid "" "since the default error handler will ensure that an error message has been " "printed to C<stderr> before the program exits." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1304 +#: ../src/guestfs.pod:1361 msgid "" "For other programs the caller will almost certainly want to install an " "alternate error handler or do error handling in-line like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1307 +#: ../src/guestfs.pod:1364 #, no-wrap msgid "" " g = guestfs_create ();\n" @@ -2526,7 +2636,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1309 +#: ../src/guestfs.pod:1366 #, no-wrap msgid "" " /* This disables the default behaviour of printing errors\n" @@ -2536,7 +2646,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1313 +#: ../src/guestfs.pod:1370 #, no-wrap msgid "" " if (guestfs_launch (g) == -1) {\n" @@ -2550,7 +2660,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1321 +#: ../src/guestfs.pod:1378 msgid "" "Out of memory errors are handled differently. The default action is to call " "L<abort(3)>. If this is undesirable, then you can set a handler using " @@ -2558,7 +2668,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1325 +#: ../src/guestfs.pod:1382 msgid "" "L</guestfs_create> returns C<NULL> if the handle cannot be created, and " "because there is no handle if this happens there is no way to get additional " @@ -2568,12 +2678,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1331 +#: ../src/guestfs.pod:1388 msgid "guestfs_last_error" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1333 +#: ../src/guestfs.pod:1390 #, no-wrap msgid "" " const char *guestfs_last_error (guestfs_h *g);\n" @@ -2581,26 +2691,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1335 +#: ../src/guestfs.pod:1392 msgid "" "This returns the last error message that happened on C<g>. If there has not " "been an error since the handle was created, then this returns C<NULL>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1339 +#: ../src/guestfs.pod:1396 msgid "" "The lifetime of the returned string is until the next error occurs, or " "L</guestfs_close> is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1342 +#: ../src/guestfs.pod:1399 msgid "guestfs_last_errno" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1344 +#: ../src/guestfs.pod:1401 #, no-wrap msgid "" " int guestfs_last_errno (guestfs_h *g);\n" @@ -2608,27 +2718,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1346 +#: ../src/guestfs.pod:1403 msgid "This returns the last error number (errno) that happened on C<g>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1348 +#: ../src/guestfs.pod:1405 msgid "If successful, an errno integer not equal to zero is returned." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1350 +#: ../src/guestfs.pod:1407 msgid "If no error, this returns 0. This call can return 0 in three situations:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1357 +#: ../src/guestfs.pod:1414 msgid "There has not been any error on the handle." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1361 +#: ../src/guestfs.pod:1418 msgid "" "There has been an error but the errno was meaningless. This corresponds to " "the case where the error did not come from a failed system call, but for " @@ -2636,14 +2746,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1367 +#: ../src/guestfs.pod:1424 msgid "" "There was an error from a failed system call, but for some reason the errno " "was not captured and returned. This usually indicates a bug in libguestfs." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1373 +#: ../src/guestfs.pod:1430 msgid "" "Libguestfs tries to convert the errno from inside the applicance into a " "corresponding errno for the caller (not entirely trivial: the appliance " @@ -2654,12 +2764,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1381 +#: ../src/guestfs.pod:1438 msgid "guestfs_set_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1383 +#: ../src/guestfs.pod:1440 #, no-wrap msgid "" " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n" @@ -2672,7 +2782,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1390 +#: ../src/guestfs.pod:1447 msgid "" "The callback C<cb> will be called if there is an error. The parameters " "passed to the callback are an opaque data pointer and the error message " @@ -2680,14 +2790,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1394 +#: ../src/guestfs.pod:1451 msgid "" "C<errno> is not passed to the callback. To get that the callback must call " "L</guestfs_last_errno>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1397 +#: ../src/guestfs.pod:1454 msgid "" "Note that the message string C<msg> is freed as soon as the callback " "function returns, so if you want to stash it somewhere you must make your " @@ -2695,22 +2805,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1401 +#: ../src/guestfs.pod:1458 msgid "The default handler prints messages on C<stderr>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1403 +#: ../src/guestfs.pod:1460 msgid "If you set C<cb> to C<NULL> then I<no> handler is called." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1405 +#: ../src/guestfs.pod:1462 msgid "guestfs_get_error_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1407 +#: ../src/guestfs.pod:1464 #, no-wrap msgid "" " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n" @@ -2719,17 +2829,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1410 +#: ../src/guestfs.pod:1467 msgid "Returns the current error handler callback." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1412 +#: ../src/guestfs.pod:1469 msgid "guestfs_set_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1414 +#: ../src/guestfs.pod:1471 #, no-wrap msgid "" " typedef void (*guestfs_abort_cb) (void);\n" @@ -2739,29 +2849,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1418 +#: ../src/guestfs.pod:1475 msgid "" "The callback C<cb> will be called if there is an out of memory situation. " "I<Note this callback must not return>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1421 +#: ../src/guestfs.pod:1478 msgid "The default is to call L<abort(3)>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1423 +#: ../src/guestfs.pod:1480 msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1426 +#: ../src/guestfs.pod:1483 msgid "guestfs_get_out_of_memory_handler" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1428 +#: ../src/guestfs.pod:1485 #, no-wrap msgid "" " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n" @@ -2769,42 +2879,42 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1430 +#: ../src/guestfs.pod:1487 msgid "This returns the current out of memory handler." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1432 +#: ../src/guestfs.pod:1489 msgid "API CALLS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1434 ../fish/guestfish.pod:984 +#: ../src/guestfs.pod:1491 ../fish/guestfish.pod:989 msgid "@ACTIONS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1436 +#: ../src/guestfs.pod:1493 msgid "STRUCTURES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1438 +#: ../src/guestfs.pod:1495 msgid "@STRUCTS@" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1440 +#: ../src/guestfs.pod:1497 msgid "AVAILABILITY" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1442 +#: ../src/guestfs.pod:1499 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1444 +#: ../src/guestfs.pod:1501 msgid "" "Using L</guestfs_available> you can test availability of the following " "groups of functions. This test queries the appliance to see if the " @@ -2812,17 +2922,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1449 +#: ../src/guestfs.pod:1506 msgid "@AVAILABILITY@" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1451 +#: ../src/guestfs.pod:1508 msgid "GUESTFISH supported COMMAND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1453 +#: ../src/guestfs.pod:1510 msgid "" "In L<guestfish(3)> there is a handy interactive command C<supported> which " "prints out the available groups and whether they are supported by this build " @@ -2830,19 +2940,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1458 +#: ../src/guestfs.pod:1515 msgid "SINGLE CALLS AT COMPILE TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1460 +#: ../src/guestfs.pod:1517 msgid "" "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API " "function, such as:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1463 +#: ../src/guestfs.pod:1520 #, no-wrap msgid "" " #define LIBGUESTFS_HAVE_DD 1\n" @@ -2850,12 +2960,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1465 +#: ../src/guestfs.pod:1522 msgid "if L</guestfs_dd> is available." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1467 +#: ../src/guestfs.pod:1524 msgid "" "Before version 1.5.8, if you needed to test whether a single libguestfs " "function is available at compile time, we recommended using build tools such " @@ -2863,7 +2973,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1472 +#: ../src/guestfs.pod:1529 #, no-wrap msgid "" " AC_CHECK_LIB([guestfs],[guestfs_create])\n" @@ -2872,19 +2982,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1475 +#: ../src/guestfs.pod:1532 msgid "" "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined " "in your program." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1478 +#: ../src/guestfs.pod:1535 msgid "SINGLE CALLS AT RUN TIME" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1480 +#: ../src/guestfs.pod:1537 msgid "" "Testing at compile time doesn't guarantee that a function really exists in " "the library. The reason is that you might be dynamically linked against a " @@ -2894,7 +3004,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1487 +#: ../src/guestfs.pod:1544 msgid "" "You can use L<dlopen(3)> to test if a function is available at run time, as " "in this example program (note that you still need the compile time check as " @@ -2902,7 +3012,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1491 +#: ../src/guestfs.pod:1548 #, no-wrap msgid "" " #include <stdio.h>\n" @@ -2914,7 +3024,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1497 +#: ../src/guestfs.pod:1554 #, no-wrap msgid "" " main ()\n" @@ -2926,7 +3036,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1503 +#: ../src/guestfs.pod:1560 #, no-wrap msgid "" " /* Test if the function guestfs_dd is really available. */\n" @@ -2941,7 +3051,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1512 +#: ../src/guestfs.pod:1569 #, no-wrap msgid "" " if (!has_function)\n" @@ -2960,7 +3070,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1525 +#: ../src/guestfs.pod:1582 msgid "" "You may think the above is an awful lot of hassle, and it is. There are " "other ways outside of the C linking system to ensure that this kind of " @@ -2968,7 +3078,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1530 +#: ../src/guestfs.pod:1587 #, no-wrap msgid "" " Requires: libguestfs >= 1.0.80\n" @@ -2976,12 +3086,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1532 +#: ../src/guestfs.pod:1589 msgid "CALLS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1534 +#: ../src/guestfs.pod:1591 msgid "" "A recent feature of the API is the introduction of calls which take optional " "arguments. In C these are declared 3 ways. The main way is as a call which " @@ -2989,7 +3099,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1539 +#: ../src/guestfs.pod:1596 #, no-wrap msgid "" " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n" @@ -2997,14 +3107,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1541 +#: ../src/guestfs.pod:1598 msgid "" "Call this with a list of optional arguments, terminated by C<-1>. So to " "call with no optional arguments specified:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1544 +#: ../src/guestfs.pod:1601 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename, -1);\n" @@ -3012,12 +3122,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1546 +#: ../src/guestfs.pod:1603 msgid "With a single optional argument:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1548 +#: ../src/guestfs.pod:1605 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -3027,12 +3137,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1552 +#: ../src/guestfs.pod:1609 msgid "With two:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1554 +#: ../src/guestfs.pod:1611 #, no-wrap msgid "" " guestfs_add_drive_opts (g, filename,\n" @@ -3043,19 +3153,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1559 +#: ../src/guestfs.pod:1616 msgid "" "and so forth. Don't forget the terminating C<-1> otherwise Bad Things will " "happen!" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1562 +#: ../src/guestfs.pod:1619 msgid "USING va_list FOR OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1564 +#: ../src/guestfs.pod:1621 msgid "" "The second variant has the same name with the suffix C<_va>, which works the " "same way but takes a C<va_list>. See the C manual for details. For the " @@ -3063,7 +3173,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1568 +#: ../src/guestfs.pod:1625 #, no-wrap msgid "" " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" @@ -3072,12 +3182,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1571 +#: ../src/guestfs.pod:1628 msgid "CONSTRUCTING OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1573 +#: ../src/guestfs.pod:1630 msgid "" "The third variant is useful where you need to construct these calls. You " "pass in a structure where you fill in the optional fields. The structure " @@ -3087,7 +3197,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1579 +#: ../src/guestfs.pod:1636 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv {\n" @@ -3102,12 +3212,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1588 +#: ../src/guestfs.pod:1645 msgid "You could call it like this:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1590 +#: ../src/guestfs.pod:1647 #, no-wrap msgid "" " struct guestfs_add_drive_opts_argv optargs = {\n" @@ -3120,7 +3230,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1597 +#: ../src/guestfs.pod:1654 #, no-wrap msgid "" " guestfs_add_drive_opts_argv (g, filename, &optargs);\n" @@ -3128,34 +3238,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1599 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1842 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1253 ../tools/virt-win-reg.pl:532 +#: ../src/guestfs.pod:1656 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1850 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1260 ../tools/virt-win-reg.pl:532 msgid "Notes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1605 +#: ../src/guestfs.pod:1662 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1610 +#: ../src/guestfs.pod:1667 msgid "You do not need to fill in all fields of the structure." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1614 +#: ../src/guestfs.pod:1671 msgid "" "There must be a one-to-one correspondence between fields of the structure " "that are filled in, and bits set in the bitmask." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1619 +#: ../src/guestfs.pod:1676 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1621 +#: ../src/guestfs.pod:1678 msgid "" "In other languages, optional arguments are expressed in the way that is " "natural for that language. We refer you to the language-specific " @@ -3163,31 +3273,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1625 +#: ../src/guestfs.pod:1682 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1627 +#: ../src/guestfs.pod:1684 msgid "SETTING CALLBACKS TO HANDLE EVENTS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1629 +#: ../src/guestfs.pod:1686 msgid "" "The child process generates events in some situations. Current events " "include: receiving a log message, the child process exits." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1632 +#: ../src/guestfs.pod:1689 msgid "" "Use the C<guestfs_set_*_callback> functions to set a callback for different " "types of events." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1635 +#: ../src/guestfs.pod:1692 msgid "" "Only I<one callback of each type> can be registered for each handle. " "Calling C<guestfs_set_*_callback> again overwrites the previous callback of " @@ -3196,12 +3306,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1640 +#: ../src/guestfs.pod:1697 msgid "guestfs_set_log_message_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1642 +#: ../src/guestfs.pod:1699 #, no-wrap msgid "" " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n" @@ -3213,31 +3323,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1648 +#: ../src/guestfs.pod:1705 msgid "" "The callback function C<cb> will be called whenever qemu or the guest writes " "anything to the console." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1651 +#: ../src/guestfs.pod:1708 msgid "Use this function to capture kernel messages and similar." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1653 +#: ../src/guestfs.pod:1710 msgid "" "Normally there is no log message handler, and log messages are just " "discarded." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1656 +#: ../src/guestfs.pod:1713 msgid "guestfs_set_subprocess_quit_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1658 +#: ../src/guestfs.pod:1715 #, no-wrap msgid "" " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n" @@ -3248,7 +3358,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1663 +#: ../src/guestfs.pod:1720 msgid "" "The callback function C<cb> will be called when the child process quits, " "either asynchronously or if killed by L</guestfs_kill_subprocess>. (This " @@ -3256,12 +3366,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1668 +#: ../src/guestfs.pod:1725 msgid "guestfs_set_launch_done_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1670 +#: ../src/guestfs.pod:1727 #, no-wrap msgid "" " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n" @@ -3272,7 +3382,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1675 +#: ../src/guestfs.pod:1732 msgid "" "The callback function C<cb> will be called when the child process becomes " "ready first time after it has been launched. (This corresponds to a " @@ -3280,12 +3390,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1679 +#: ../src/guestfs.pod:1736 msgid "guestfs_set_close_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1681 +#: ../src/guestfs.pod:1738 #, no-wrap msgid "" " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n" @@ -3296,14 +3406,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1686 +#: ../src/guestfs.pod:1743 msgid "" "The callback function C<cb> will be called while the handle is being closed " "(synchronously from L</guestfs_close>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1689 +#: ../src/guestfs.pod:1746 msgid "" "Note that libguestfs installs an L<atexit(3)> handler to try to clean up " "handles that are open when the program exits. This means that this callback " @@ -3314,12 +3424,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1697 +#: ../src/guestfs.pod:1754 msgid "guestfs_set_progress_callback" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1699 +#: ../src/guestfs.pod:1756 #, no-wrap msgid "" " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n" @@ -3332,7 +3442,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1706 +#: ../src/guestfs.pod:1763 msgid "" "Some long-running operations can generate progress messages. If this " "callback is registered, then it will be called each time a progress message " @@ -3342,7 +3452,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1712 +#: ../src/guestfs.pod:1769 msgid "" "The callback receives two numbers: C<position> and C<total>. The units of " "C<total> are not defined, although for some operations C<total> may relate " @@ -3351,31 +3461,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1718 +#: ../src/guestfs.pod:1775 msgid "The only defined and stable parts of the API are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1724 +#: ../src/guestfs.pod:1781 msgid "" "The callback can display to the user some type of progress bar or indicator " "which shows the ratio of C<position>:C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1729 +#: ../src/guestfs.pod:1786 msgid "0 E<lt>= C<position> E<lt>= C<total>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1733 +#: ../src/guestfs.pod:1790 msgid "" "If any progress notification is sent during a call, then a final progress " "notification is always sent when C<position> = C<total>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1736 +#: ../src/guestfs.pod:1793 msgid "" "This is to simplify caller code, so callers can easily set the progress " "indicator to \"100%\" at the end of the operation, without requiring special " @@ -3383,7 +3493,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1742 +#: ../src/guestfs.pod:1799 msgid "" "The callback also receives the procedure number and serial number of the " "call. These are only useful for debugging protocol issues, and the callback " @@ -3392,12 +3502,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1747 +#: ../src/guestfs.pod:1804 msgid "PRIVATE DATA AREA" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1749 +#: ../src/guestfs.pod:1806 msgid "" "You can attach named pieces of private data to the libguestfs handle, and " "fetch them by name for the lifetime of the handle. This is called the " @@ -3405,12 +3515,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1753 +#: ../src/guestfs.pod:1810 msgid "To attach a named piece of data, use the following call:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1755 +#: ../src/guestfs.pod:1812 #, no-wrap msgid "" " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n" @@ -3418,7 +3528,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1757 +#: ../src/guestfs.pod:1814 msgid "" "C<key> is the name to associate with this data, and C<data> is an arbitrary " "pointer (which can be C<NULL>). Any previous item with the same name is " @@ -3426,7 +3536,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1761 +#: ../src/guestfs.pod:1818 msgid "" "You can use any C<key> you want, but names beginning with an underscore " "character are reserved for internal libguestfs purposes (for implementing " @@ -3435,12 +3545,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1766 +#: ../src/guestfs.pod:1823 msgid "To retrieve the pointer, use:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1768 +#: ../src/guestfs.pod:1825 #, no-wrap msgid "" " void *guestfs_get_private (guestfs_h *g, const char *key);\n" @@ -3448,7 +3558,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1770 +#: ../src/guestfs.pod:1827 msgid "" "This function returns C<NULL> if either no data is found associated with " "C<key>, or if the user previously set the C<key>'s C<data> pointer to " @@ -3456,7 +3566,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1774 +#: ../src/guestfs.pod:1831 msgid "" "Libguestfs does not try to look at or interpret the C<data> pointer in any " "way. As far as libguestfs is concerned, it need not be a valid pointer at " @@ -3468,31 +3578,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1782 +#: ../src/guestfs.pod:1839 msgid "" "The private data area is implemented using a hash table, and should be " "reasonably efficient for moderate numbers of keys." msgstr "" #. type: =end -#: ../src/guestfs.pod:1785 ../src/guestfs.pod:1790 +#: ../src/guestfs.pod:1842 ../src/guestfs.pod:1847 msgid "html" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1787 +#: ../src/guestfs.pod:1844 msgid "" "<!-- old anchor for the next section --> <a " "name=\"state_machine_and_low_level_event_api\"/>" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1792 +#: ../src/guestfs.pod:1849 msgid "ARCHITECTURE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1794 +#: ../src/guestfs.pod:1851 msgid "" "Internally, libguestfs is implemented by running an appliance (a special " "type of small virtual machine) using L<qemu(1)>. Qemu runs as a child " @@ -3500,7 +3610,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1798 +#: ../src/guestfs.pod:1855 #, no-wrap msgid "" " ___________________\n" @@ -3526,14 +3636,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1818 +#: ../src/guestfs.pod:1875 msgid "" "The library, linked to the main program, creates the child process and hence " "the appliance in the L</guestfs_launch> function." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1821 +#: ../src/guestfs.pod:1878 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 " @@ -3545,7 +3655,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1830 +#: ../src/guestfs.pod:1887 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 " @@ -3556,17 +3666,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1837 +#: ../src/guestfs.pod:1894 msgid "STATE MACHINE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1839 +#: ../src/guestfs.pod:1896 msgid "libguestfs uses a state machine to model the child process:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1841 +#: ../src/guestfs.pod:1898 #, no-wrap msgid "" " |\n" @@ -3594,7 +3704,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1863 +#: ../src/guestfs.pod:1920 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), " @@ -3603,7 +3713,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1868 +#: ../src/guestfs.pod:1925 msgid "" "The guest may be killed by L</guestfs_kill_subprocess>, or may die " "asynchronously at any time (eg. due to some internal error), and that causes " @@ -3611,14 +3721,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1872 +#: ../src/guestfs.pod:1929 msgid "" "Configuration commands for qemu such as L</guestfs_add_drive> can only be " "issued when in the CONFIG state." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1875 +#: ../src/guestfs.pod:1932 msgid "" "The API offers one call that goes from CONFIG through LAUNCHING to READY. " "L</guestfs_launch> blocks until the child process is READY to accept " @@ -3627,7 +3737,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1881 +#: ../src/guestfs.pod:1938 msgid "" "API actions such as L</guestfs_mount> can only be issued when in the READY " "state. These API calls block waiting for the command to be carried out " @@ -3637,7 +3747,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1887 +#: ../src/guestfs.pod:1944 msgid "" "Finally, the child process sends asynchronous messages back to the main " "program, such as kernel log messages. You can register a callback to " @@ -3645,24 +3755,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:1891 +#: ../src/guestfs.pod:1948 msgid "INTERNALS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:1893 +#: ../src/guestfs.pod:1950 msgid "COMMUNICATION PROTOCOL" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1895 +#: ../src/guestfs.pod:1952 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:1898 +#: ../src/guestfs.pod:1955 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 " @@ -3670,14 +3780,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1902 +#: ../src/guestfs.pod:1959 msgid "" "The detailed format of structures is in C<src/guestfs_protocol.x> (note: " "this file is automatically generated)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1905 +#: ../src/guestfs.pod:1962 msgid "" "There are two broad cases, ordinary functions that don't have any C<FileIn> " "and C<FileOut> parameters, which are handled with very simple request/reply " @@ -3687,17 +3797,17 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1912 +#: ../src/guestfs.pod:1969 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1914 +#: ../src/guestfs.pod:1971 msgid "For ordinary functions, the request message is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1916 +#: ../src/guestfs.pod:1973 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -3708,7 +3818,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1921 +#: ../src/guestfs.pod:1978 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 " @@ -3717,21 +3827,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1927 +#: ../src/guestfs.pod:1984 msgid "" "Note also that many functions don't take any arguments, in which case the " "C<guestfs_I<foo>_args> is completely omitted." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1930 +#: ../src/guestfs.pod:1987 msgid "" "The header contains the procedure number (C<guestfs_proc>) which is how the " "receiver knows what type of args structure to expect, or none at all." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1934 +#: ../src/guestfs.pod:1991 msgid "" "For functions that take optional arguments, the optional arguments are " "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary " @@ -3743,12 +3853,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1942 +#: ../src/guestfs.pod:1999 msgid "The reply message for ordinary functions is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1944 +#: ../src/guestfs.pod:2001 #, no-wrap msgid "" " total length (header + ret,\n" @@ -3759,26 +3869,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1949 +#: ../src/guestfs.pod:2006 msgid "" "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for " "functions that return no formal return values." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1952 +#: ../src/guestfs.pod:2009 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:1955 +#: ../src/guestfs.pod:2012 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:1958 +#: ../src/guestfs.pod:2015 #, no-wrap msgid "" " total length (header + error,\n" @@ -3789,19 +3899,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1963 +#: ../src/guestfs.pod:2020 msgid "" "The C<guestfs_message_error> structure contains the error message as a " "string." msgstr "" #. type: =head3 -#: ../src/guestfs.pod:1966 +#: ../src/guestfs.pod:2023 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1968 +#: ../src/guestfs.pod:2025 msgid "" "A C<FileIn> parameter indicates that we transfer a file I<into> the guest. " "The normal request message is sent (see above). However this is followed by " @@ -3809,7 +3919,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1972 +#: ../src/guestfs.pod:2029 #, no-wrap msgid "" " total length (header + arguments,\n" @@ -3823,12 +3933,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1980 +#: ../src/guestfs.pod:2037 msgid "The \"sequence of chunks\" is:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:1982 +#: ../src/guestfs.pod:2039 #, no-wrap msgid "" " length of chunk (not including length word itself)\n" @@ -3842,7 +3952,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1990 +#: ../src/guestfs.pod:2047 msgid "" "The final chunk has the C<data_len> field set to zero. Additionally a flag " "is set in the final chunk to indicate either successful completion or early " @@ -3850,7 +3960,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1994 +#: ../src/guestfs.pod:2051 msgid "" "At time of writing there are no functions that have more than one FileIn " "parameter. However this is (theoretically) supported, by sending the " @@ -3859,7 +3969,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1999 +#: ../src/guestfs.pod:2056 msgid "" "Both the library (sender) I<and> the daemon (receiver) may cancel the " "transfer. The library does this by sending a chunk with a special flag set " @@ -3868,7 +3978,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2005 +#: ../src/guestfs.pod:2062 msgid "" "The daemon may also cancel. It does this by writing a special word " "C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during " @@ -3880,7 +3990,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2014 +#: ../src/guestfs.pod:2071 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 " @@ -3890,19 +4000,19 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2020 +#: ../src/guestfs.pod:2077 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2022 +#: ../src/guestfs.pod:2079 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:2025 +#: ../src/guestfs.pod:2082 #, no-wrap msgid "" " total length (header + ret,\n" @@ -3916,12 +4026,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2033 +#: ../src/guestfs.pod:2090 msgid "INITIAL MESSAGE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2035 +#: ../src/guestfs.pod:2092 msgid "" "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) " "which indicates that the guest and daemon is alive. This is what " @@ -3929,12 +4039,12 @@ msgid "" msgstr "" #. type: =head3 -#: ../src/guestfs.pod:2039 +#: ../src/guestfs.pod:2096 msgid "PROGRESS NOTIFICATION MESSAGES" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2041 +#: ../src/guestfs.pod:2098 msgid "" "The daemon may send progress notification messages at any time. These are " "distinguished by the normal length word being replaced by " @@ -3942,7 +4052,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2045 +#: ../src/guestfs.pod:2102 msgid "" "The library turns them into progress callbacks (see " "C<guestfs_set_progress_callback>) if there is a callback registered, or " @@ -3950,7 +4060,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2049 +#: ../src/guestfs.pod:2106 msgid "" "The daemon self-limits the frequency of progress messages it sends (see " "C<daemon/proto.c:notify_progress>). Not all calls generate progress " @@ -3958,12 +4068,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2053 +#: ../src/guestfs.pod:2110 msgid "LIBGUESTFS VERSION NUMBERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2055 +#: ../src/guestfs.pod:2112 msgid "" "Since April 2010, libguestfs has started to make separate development and " "stable releases, along with corresponding branches in our git repository. " @@ -3971,7 +4081,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2060 +#: ../src/guestfs.pod:2117 #, no-wrap msgid "" " even numbers for stable: 1.2.x, 1.4.x, ...\n" @@ -3988,12 +4098,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2071 +#: ../src/guestfs.pod:2128 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2073 +#: ../src/guestfs.pod:2130 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 " @@ -4003,26 +4113,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2079 +#: ../src/guestfs.pod:2136 msgid "Our criteria for backporting changes are:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2085 +#: ../src/guestfs.pod:2142 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:2091 +#: ../src/guestfs.pod:2148 msgid "" "Bug fixes which are not controversial, fix obvious problems, and have been " "well tested are backported." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2096 +#: ../src/guestfs.pod:2153 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 " @@ -4030,7 +4140,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2102 +#: ../src/guestfs.pod:2159 msgid "" "We I<don't> backport new features, new APIs, new tools etc, except in one " "exceptional case: the new feature is required in order to implement an " @@ -4038,7 +4148,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2108 +#: ../src/guestfs.pod:2165 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 " @@ -4049,17 +4159,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2116 +#: ../src/guestfs.pod:2173 msgid "EXTENDING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2118 +#: ../src/guestfs.pod:2175 msgid "ADDING A NEW API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2120 +#: ../src/guestfs.pod:2177 msgid "" "Large amounts of boilerplate code in libguestfs (RPC, bindings, " "documentation) are generated, and this makes it easy to extend the " @@ -4067,19 +4177,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2124 +#: ../src/guestfs.pod:2181 msgid "To add a new API action there are two changes:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2130 +#: ../src/guestfs.pod:2187 msgid "" "You need to add a description of the call (name, parameters, return type, " "tests, documentation) to C<generator/generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2133 +#: ../src/guestfs.pod:2190 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 " @@ -4090,7 +4200,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2141 +#: ../src/guestfs.pod:2198 msgid "" "Most new actions are of the first type, and get added to the " "C<daemon_functions> list. Each function has a unique procedure number used " @@ -4100,7 +4210,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2147 +#: ../src/guestfs.pod:2204 msgid "" "For library-only actions of the second type, add to the " "C<non_daemon_functions> list. Since these functions are serviced by the " @@ -4110,36 +4220,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2155 +#: ../src/guestfs.pod:2212 msgid "Implement the action (in C):" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2157 +#: ../src/guestfs.pod:2214 msgid "" "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the " "C<daemon/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2160 +#: ../src/guestfs.pod:2217 msgid "" "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> " "(note: double underscore) in the C<src/> directory." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2163 +#: ../src/guestfs.pod:2220 msgid "In either case, use another function as an example of what to do." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2167 +#: ../src/guestfs.pod:2224 msgid "After making these changes, use C<make> to compile." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2169 +#: ../src/guestfs.pod:2226 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 " @@ -4147,12 +4257,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2173 +#: ../src/guestfs.pod:2230 msgid "ADDING TESTS FOR AN API ACTION" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2175 +#: ../src/guestfs.pod:2232 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 " @@ -4162,61 +4272,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2181 +#: ../src/guestfs.pod:2238 msgid "" "The following describes the test environment used when you add an API test " "in C<generator_actions.ml>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2184 +#: ../src/guestfs.pod:2241 msgid "The test environment has 4 block devices:" msgstr "" #. type: =item -#: ../src/guestfs.pod:2188 +#: ../src/guestfs.pod:2245 msgid "C</dev/sda> 500MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2190 +#: ../src/guestfs.pod:2247 msgid "General block device for testing." msgstr "" #. type: =item -#: ../src/guestfs.pod:2192 +#: ../src/guestfs.pod:2249 msgid "C</dev/sdb> 50MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2194 +#: ../src/guestfs.pod:2251 msgid "" "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write " "operations." msgstr "" #. type: =item -#: ../src/guestfs.pod:2197 +#: ../src/guestfs.pod:2254 msgid "C</dev/sdc> 10MB" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2199 +#: ../src/guestfs.pod:2256 msgid "Used in a few tests where two block devices are needed." msgstr "" #. type: =item -#: ../src/guestfs.pod:2201 +#: ../src/guestfs.pod:2258 msgid "C</dev/sdd>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2203 +#: ../src/guestfs.pod:2260 msgid "ISO with fixed content (see C<images/test.iso>)." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2207 +#: ../src/guestfs.pod:2264 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 " @@ -4224,7 +4334,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2211 +#: ../src/guestfs.pod:2268 msgid "" "Each test starts with an initial scenario, selected using one of the " "C<Init*> expressions, described in C<generator/generator_types.ml>. These " @@ -4234,7 +4344,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2217 +#: ../src/guestfs.pod:2274 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 " @@ -4244,14 +4354,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2223 +#: ../src/guestfs.pod:2280 msgid "" "In addition, packagers can skip individual tests by setting environment " "variables before running C<make check>." msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2226 +#: ../src/guestfs.pod:2283 #, no-wrap msgid "" " SKIP_TEST_<CMD>_<NUM>=1\n" @@ -4259,17 +4369,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2228 +#: ../src/guestfs.pod:2285 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2230 +#: ../src/guestfs.pod:2287 msgid "or:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2232 +#: ../src/guestfs.pod:2289 #, no-wrap msgid "" " SKIP_TEST_<CMD>=1\n" @@ -4277,17 +4387,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2234 +#: ../src/guestfs.pod:2291 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2236 +#: ../src/guestfs.pod:2293 msgid "Packagers can run only certain tests by setting for example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2238 +#: ../src/guestfs.pod:2295 #, no-wrap msgid "" " TEST_ONLY=\"vfs_type zerofree\"\n" @@ -4295,29 +4405,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2240 +#: ../src/guestfs.pod:2297 msgid "" "See C<capitests/tests.c> for more details of how these environment variables " "work." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2243 +#: ../src/guestfs.pod:2300 msgid "DEBUGGING NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2245 +#: ../src/guestfs.pod:2302 msgid "Test new actions work before submitting them." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2247 +#: ../src/guestfs.pod:2304 msgid "You can use guestfish to try out new commands." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2249 +#: ../src/guestfs.pod:2306 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 " @@ -4325,12 +4435,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2253 +#: ../src/guestfs.pod:2310 msgid "FORMATTING CODE AND OTHER CONVENTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2255 +#: ../src/guestfs.pod:2312 msgid "" "Our C source code generally adheres to some basic code-formatting " "conventions. The existing code base is not totally consistent on this " @@ -4340,14 +4450,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2261 +#: ../src/guestfs.pod:2318 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:2264 +#: ../src/guestfs.pod:2321 #, no-wrap msgid "" " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n" @@ -4363,7 +4473,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2274 +#: ../src/guestfs.pod:2331 #, no-wrap msgid "" " ;;; When editing C sources in libguestfs, use this style.\n" @@ -4381,12 +4491,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2286 +#: ../src/guestfs.pod:2343 msgid "Enable warnings when compiling (and fix any problems this finds):" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2289 +#: ../src/guestfs.pod:2346 #, no-wrap msgid "" " ./configure --enable-gcc-warnings\n" @@ -4394,12 +4504,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2291 +#: ../src/guestfs.pod:2348 msgid "Useful targets are:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2293 +#: ../src/guestfs.pod:2350 #, no-wrap msgid "" " make syntax-check # checks the syntax of the C code\n" @@ -4408,48 +4518,48 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2296 +#: ../src/guestfs.pod:2353 msgid "DAEMON CUSTOM PRINTF FORMATTERS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2298 +#: ../src/guestfs.pod:2355 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:2303 +#: ../src/guestfs.pod:2360 msgid "%Q" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2305 +#: ../src/guestfs.pod:2362 msgid "" "Simple shell quoted string. Any spaces or other shell characters are " "escaped for you." msgstr "" #. type: =item -#: ../src/guestfs.pod:2308 +#: ../src/guestfs.pod:2365 msgid "%R" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2310 +#: ../src/guestfs.pod:2367 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:2315 ../fish/guestfish.pod:240 ../fish/guestfish.pod:594 +#: ../src/guestfs.pod:2372 ../fish/guestfish.pod:240 ../fish/guestfish.pod:599 msgid "For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2317 +#: ../src/guestfs.pod:2374 #, no-wrap msgid "" " asprintf (&cmd, \"cat %R\", path);\n" @@ -4457,12 +4567,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2319 +#: ../src/guestfs.pod:2376 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2321 +#: ../src/guestfs.pod:2378 msgid "" "I<Note:> Do I<not> use these when you are passing parameters to the " "C<command{,r,v,rv}()> functions. These parameters do NOT need to be quoted " @@ -4471,12 +4581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2327 +#: ../src/guestfs.pod:2384 msgid "SUBMITTING YOUR NEW API ACTIONS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2329 +#: ../src/guestfs.pod:2386 msgid "" "Submit patches to the mailing list: " "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to " @@ -4484,17 +4594,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2333 +#: ../src/guestfs.pod:2390 msgid "INTERNATIONALIZATION (I18N) SUPPORT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2335 +#: ../src/guestfs.pod:2392 msgid "We support i18n (gettext anyhow) in the library." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2337 +#: ../src/guestfs.pod:2394 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 " @@ -4503,98 +4613,98 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2343 +#: ../src/guestfs.pod:2400 msgid "" "Debugging messages are never translated, since they are intended for the " "programmers." msgstr "" #. type: =head2 -#: ../src/guestfs.pod:2346 +#: ../src/guestfs.pod:2403 msgid "SOURCE CODE SUBDIRECTORIES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2350 +#: ../src/guestfs.pod:2407 ../src/guestfs-actions.pod:5686 ../fish/guestfish-actions.pod:3808 msgid "C<appliance>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2352 +#: ../src/guestfs.pod:2409 msgid "The libguestfs appliance, build scripts and so on." msgstr "" #. type: =item -#: ../src/guestfs.pod:2354 +#: ../src/guestfs.pod:2411 msgid "C<capitests>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2356 +#: ../src/guestfs.pod:2413 msgid "Automated tests of the C API." msgstr "" #. type: =item -#: ../src/guestfs.pod:2358 +#: ../src/guestfs.pod:2415 msgid "C<cat>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2360 +#: ../src/guestfs.pod:2417 msgid "" "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and " "documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2363 +#: ../src/guestfs.pod:2420 msgid "C<contrib>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2365 +#: ../src/guestfs.pod:2422 msgid "Outside contributions, experimental parts." msgstr "" #. type: =item -#: ../src/guestfs.pod:2367 +#: ../src/guestfs.pod:2424 msgid "C<daemon>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2369 +#: ../src/guestfs.pod:2426 msgid "" "The daemon that runs inside the libguestfs appliance and carries out " "actions." msgstr "" #. type: =item -#: ../src/guestfs.pod:2372 +#: ../src/guestfs.pod:2429 msgid "C<df>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2374 +#: ../src/guestfs.pod:2431 msgid "L<virt-df(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2376 +#: ../src/guestfs.pod:2433 msgid "C<examples>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2378 +#: ../src/guestfs.pod:2435 msgid "C API example code." msgstr "" #. type: =item -#: ../src/guestfs.pod:2380 +#: ../src/guestfs.pod:2437 msgid "C<fish>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2382 +#: ../src/guestfs.pod:2439 msgid "" "L<guestfish(1)>, the command-line shell, and various shell scripts built on " "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, " @@ -4602,89 +4712,89 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2386 +#: ../src/guestfs.pod:2443 msgid "C<fuse>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2388 +#: ../src/guestfs.pod:2445 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2390 +#: ../src/guestfs.pod:2447 msgid "C<generator>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2392 +#: ../src/guestfs.pod:2449 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:2395 +#: ../src/guestfs.pod:2452 msgid "C<images>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2397 +#: ../src/guestfs.pod:2454 msgid "Files used by the test suite." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2399 +#: ../src/guestfs.pod:2456 msgid "Some \"phony\" guest images which we test against." msgstr "" #. type: =item -#: ../src/guestfs.pod:2401 +#: ../src/guestfs.pod:2458 msgid "C<inspector>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2403 +#: ../src/guestfs.pod:2460 msgid "L<virt-inspector(1)>, the virtual machine image inspector." msgstr "" #. type: =item -#: ../src/guestfs.pod:2405 +#: ../src/guestfs.pod:2462 msgid "C<logo>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2407 +#: ../src/guestfs.pod:2464 msgid "Logo used on the website. The fish is called Arthur by the way." msgstr "" #. type: =item -#: ../src/guestfs.pod:2409 +#: ../src/guestfs.pod:2466 msgid "C<m4>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2411 +#: ../src/guestfs.pod:2468 msgid "M4 macros used by autoconf." msgstr "" #. type: =item -#: ../src/guestfs.pod:2413 +#: ../src/guestfs.pod:2470 msgid "C<po>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2415 +#: ../src/guestfs.pod:2472 msgid "Translations of simple gettext strings." msgstr "" #. type: =item -#: ../src/guestfs.pod:2417 +#: ../src/guestfs.pod:2474 msgid "C<po-docs>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2419 +#: ../src/guestfs.pod:2476 msgid "" "The build infrastructure and PO files for translations of manpages and POD " "files. Eventually this will be combined with the C<po> directory, but that " @@ -4692,141 +4802,141 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2423 +#: ../src/guestfs.pod:2480 msgid "C<regressions>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2425 +#: ../src/guestfs.pod:2482 msgid "Regression tests." msgstr "" #. type: =item -#: ../src/guestfs.pod:2427 +#: ../src/guestfs.pod:2484 msgid "C<rescue>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2429 +#: ../src/guestfs.pod:2486 msgid "L<virt-rescue(1)> command and documentation." msgstr "" #. type: =item -#: ../src/guestfs.pod:2431 +#: ../src/guestfs.pod:2488 msgid "C<src>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2433 +#: ../src/guestfs.pod:2490 msgid "Source code to the C library." msgstr "" #. type: =item -#: ../src/guestfs.pod:2435 +#: ../src/guestfs.pod:2492 msgid "C<tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2437 +#: ../src/guestfs.pod:2494 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)." msgstr "" #. type: =item -#: ../src/guestfs.pod:2439 +#: ../src/guestfs.pod:2496 msgid "C<test-tool>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2441 +#: ../src/guestfs.pod:2498 msgid "" "Test tool for end users to test if their qemu/kernel combination will work " "with libguestfs." msgstr "" #. type: =item -#: ../src/guestfs.pod:2444 +#: ../src/guestfs.pod:2501 msgid "C<csharp>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2446 +#: ../src/guestfs.pod:2503 msgid "C<haskell>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2448 +#: ../src/guestfs.pod:2505 msgid "C<java>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2450 +#: ../src/guestfs.pod:2507 msgid "C<ocaml>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2452 +#: ../src/guestfs.pod:2509 msgid "C<php>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2454 +#: ../src/guestfs.pod:2511 msgid "C<perl>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2456 +#: ../src/guestfs.pod:2513 msgid "C<python>" msgstr "" #. type: =item -#: ../src/guestfs.pod:2458 +#: ../src/guestfs.pod:2515 msgid "C<ruby>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2460 +#: ../src/guestfs.pod:2517 msgid "Language bindings." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2464 ../fish/guestfish.pod:991 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330 +#: ../src/guestfs.pod:2521 ../fish/guestfish.pod:996 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2468 ../fish/guestfish.pod:1017 +#: ../src/guestfs.pod:2525 ../fish/guestfish.pod:1022 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2470 ../fish/guestfish.pod:1019 +#: ../src/guestfs.pod:2527 ../fish/guestfish.pod:1024 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2472 ../fish/guestfish.pod:1021 +#: ../src/guestfs.pod:2529 ../fish/guestfish.pod:1026 msgid "LIBGUESTFS_DEBUG" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2474 +#: ../src/guestfs.pod:2531 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as calling C<guestfs_set_verbose (g, 1)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:2477 ../fish/guestfish.pod:1026 +#: ../src/guestfs.pod:2534 ../fish/guestfish.pod:1031 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2479 ../fish/guestfish.pod:1028 +#: ../src/guestfs.pod:2536 ../fish/guestfish.pod:1033 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2482 ../fish/guestfish.pod:1031 +#: ../src/guestfs.pod:2539 ../fish/guestfish.pod:1036 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -4834,60 +4944,60 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2484 ../fish/guestfish.pod:1033 +#: ../src/guestfs.pod:2541 ../fish/guestfish.pod:1038 msgid "LIBGUESTFS_PATH" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2486 +#: ../src/guestfs.pod:2543 msgid "" "Set the path that libguestfs uses to search for kernel and initrd.img. See " "the discussion of paths in section PATH above." msgstr "" #. type: =item -#: ../src/guestfs.pod:2489 ../fish/guestfish.pod:1038 +#: ../src/guestfs.pod:2546 ../fish/guestfish.pod:1043 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2491 ../fish/guestfish.pod:1040 +#: ../src/guestfs.pod:2548 ../fish/guestfish.pod:1045 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:2495 +#: ../src/guestfs.pod:2552 msgid "See also L</QEMU WRAPPERS> above." msgstr "" #. type: =item -#: ../src/guestfs.pod:2497 ../fish/guestfish.pod:1044 +#: ../src/guestfs.pod:2554 ../fish/guestfish.pod:1049 msgid "LIBGUESTFS_TRACE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2499 +#: ../src/guestfs.pod:2556 msgid "" "Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same " "effect as calling C<guestfs_set_trace (g, 1)>." msgstr "" #. type: =item -#: ../src/guestfs.pod:2502 ../fish/guestfish.pod:1053 +#: ../src/guestfs.pod:2559 ../fish/guestfish.pod:1058 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2504 ../fish/guestfish.pod:1055 +#: ../src/guestfs.pod:2561 ../fish/guestfish.pod:1060 msgid "" "Location of temporary directory, defaults to C</tmp> except for the cached " "supermin appliance which defaults to C</var/tmp>." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2507 ../fish/guestfish.pod:1058 +#: ../src/guestfs.pod:2564 ../fish/guestfish.pod:1063 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -4896,12 +5006,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2515 ../fish/guestfish.pod:1116 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:233 ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572 ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:257 +#: ../src/guestfs.pod:2572 ../fish/guestfish.pod:1121 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:238 ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572 ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:257 msgid "SEE ALSO" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2517 +#: ../src/guestfs.pod:2574 msgid "" "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, " "L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, " @@ -4914,86 +5024,86 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2544 +#: ../src/guestfs.pod:2601 msgid "" "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, " "L<lvm(8)>, L<disktype(1)>." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2551 ../tools/virt-win-reg.pl:587 ../tools/virt-make-fs.pl:548 +#: ../src/guestfs.pod:2608 ../tools/virt-win-reg.pl:587 ../tools/virt-make-fs.pl:548 msgid "BUGS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2553 +#: ../src/guestfs.pod:2610 msgid "To get a list of bugs against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2555 +#: ../src/guestfs.pod:2612 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2557 +#: ../src/guestfs.pod:2614 msgid "To report a new bug against libguestfs use this link:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2559 +#: ../src/guestfs.pod:2616 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2561 +#: ../src/guestfs.pod:2618 msgid "When reporting a bug, please check:" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2567 +#: ../src/guestfs.pod:2624 msgid "That the bug hasn't been reported already." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2571 +#: ../src/guestfs.pod:2628 msgid "That you are testing a recent version." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2575 +#: ../src/guestfs.pod:2632 msgid "Describe the bug accurately, and give a way to reproduce it." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2579 +#: ../src/guestfs.pod:2636 msgid "" "Run libguestfs-test-tool and paste the B<complete, unedited> output into the " "bug report." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2584 ../fish/guestfish.pod:1139 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:244 +#: ../src/guestfs.pod:2641 ../fish/guestfish.pod:1144 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:249 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2586 ../fish/guestfish.pod:1141 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:246 +#: ../src/guestfs.pod:2643 ../fish/guestfish.pod:1146 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:251 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2588 ../fish/guestfish.pod:1143 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:248 ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602 ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:563 ../tools/virt-list-partitions.pl:273 +#: ../src/guestfs.pod:2645 ../fish/guestfish.pod:1148 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:253 ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602 ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:563 ../tools/virt-list-partitions.pl:273 msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2590 ../fish/guestfish.pod:1145 ../fuse/guestmount.pod:250 +#: ../src/guestfs.pod:2647 ../fish/guestfish.pod:1150 ../fuse/guestmount.pod:255 msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2593 +#: ../src/guestfs.pod:2650 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 " @@ -5002,7 +5112,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2598 +#: ../src/guestfs.pod:2655 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 " @@ -5011,7 +5121,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2603 +#: ../src/guestfs.pod:2660 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, " @@ -5061,19 +5171,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:126 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:224 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:259 ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:408 ../src/guestfs-actions.pod:428 ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:487 ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:533 ../src/guestfs-actions.pod:600 ../src/guestfs-actions.pod:633 ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:662 ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:779 ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:968 ../src/guestfs-actions.pod:988 ../src/guestfs-actions.pod:1006 ../src/guestfs-actions.pod:1090 ../src/guestfs-actions.pod:1108 ../src/guestfs-actions.pod:1127 ../src/guestfs-actions.pod:1141 ../src/guestfs-actions.pod:1161 ../src/guestfs-actions.pod:1231 ../src/guestfs-actions.pod:1262 ../src/guestfs-actions.pod:1287 ../src/guestfs-actions.pod:1324 ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1464 ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:1791 ../src/guestfs-actions.pod:2243 ../src/guestfs-actions.pod:2387 ../src/guestfs-actions.pod:2448 ../src/guestfs-actions.pod:2483 ../src/guestfs-actions.pod:3318 ../src/guestfs-actions.pod:3333 ../src/guestfs-actions.pod:3353 ../src/guestfs-actions.pod:3508 ../src/guestfs-actions.pod:3522 ../src/guestfs-actions.pod:3535 ../src/guestfs-actions.pod:3549 ../src/guestfs-actions.pod:3564 ../src/guestfs-actions.pod:3600 ../src/guestfs-actions.pod:3672 ../src/guestfs-actions.pod:3692 ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3755 ../src/guestfs-actions.pod:3787 ../src/guestfs-actions.pod:3806 ../src/guestfs-actions.pod:3825 ../src/guestfs-actions.pod:3860 ../src/guestfs-actions.pod:3872 ../src/guestfs-actions.pod:3908 ../src/guestfs-actions.pod:3924 ../src/guestfs-actions.pod:3937 ../src/guestfs-actions.pod:3952 ../src/guestfs-actions.pod:3969 ../src/guestfs-actions.pod:4062 ../src/guestfs-actions.pod:4082 ../src/guestfs-actions.pod:4095 ../src/guestfs-actions.pod:4146 ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4182 ../src/guestfs-actions.pod:4198 ../src/guestfs-actions.pod:4212 ../src/guestfs-actions.pod:4226 ../src/guestfs-actions.pod:4243 ../src/guestfs-actions.pod:4258 ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4336 ../src/guestfs-actions.pod:4409 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4459 ../src/guestfs-actions.pod:4478 ../src/guestfs-actions.pod:4490 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:4520 ../src/guestfs-actions.pod:4535 ../src/guestfs-actions.pod:4550 ../src/guestfs-actions.pod:4585 ../src/guestfs-actions.pod:4600 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4634 ../src/guestfs-actions.pod:4651 ../src/guestfs-actions.pod:4700 ../src/guestfs-actions.pod:4737 ../src/guestfs-actions.pod:4751 ../src/guestfs-actions.pod:4779 ../src/guestfs-actions.pod:4796 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4948 ../src/guestfs-actions.pod:5005 ../src/guestfs-actions.pod:5027 ../src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5077 ../src/guestfs-actions.pod:5143 ../src/guestfs-actions.pod:5160 ../src/guestfs-actions.pod:5173 ../src/guestfs-actions.pod:5187 ../src/guestfs-actions.pod:5476 ../src/guestfs-actions.pod:5495 ../src/guestfs-actions.pod:5514 ../src/guestfs-actions.pod:5526 ../src/guestfs-actions.pod:5538 ../src/guestfs-actions.pod:5552 ../src/guestfs-actions.pod:5564 ../src/guestfs-actions.pod:5578 ../src/guestfs-actions.pod:5594 ../src/guestfs-actions.pod:5615 ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5653 ../src/guestfs-actions.pod:5671 ../src/guestfs-actions.pod:5694 ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5731 ../src/guestfs-actions.pod:5752 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5788 ../src/guestfs-actions.pod:5816 ../src/guestfs-actions.pod:5840 ../src/guestfs-actions.pod:5859 ../src/guestfs-actions.pod:5883 ../src/guestfs-actions.pod:5898 ../src/guestfs-actions.pod:5913 ../src/guestfs-actions.pod:5932 ../src/guestfs-actions.pod:5969 ../src/guestfs-actions.pod:5992 ../src/guestfs-actions.pod:6018 ../src/guestfs-actions.pod:6126 ../src/guestfs-actions.pod:6247 ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6272 ../src/guestfs-actions.pod:6285 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6333 ../src/guestfs-actions.pod:6346 ../src/guestfs-actions.pod:6361 ../src/guestfs-actions.pod:6420 ../src/guestfs-actions.pod:6437 ../src/guestfs-actions.pod:6453 ../src/guestfs-actions.pod:6469 ../src/guestfs-actions.pod:6486 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6519 ../src/guestfs-actions.pod:6555 ../src/guestfs-actions.pod:6569 ../src/guestfs-actions.pod:6610 ../src/guestfs-actions.pod:6623 ../src/guestfs-actions.pod:6641 ../src/guestfs-actions.pod:6675 ../src/guestfs-actions.pod:6711 ../src/guestfs-actions.pod:6830 ../src/guestfs-actions.pod:6848 ../src/guestfs-actions.pod:6862 ../src/guestfs-actions.pod:6917 ../src/guestfs-actions.pod:6930 ../src/guestfs-actions.pod:6975 ../src/guestfs-actions.pod:7008 ../src/guestfs-actions.pod:7062 ../src/guestfs-actions.pod:7088 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7173 ../src/guestfs-actions.pod:7202 +#: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134 ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232 ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301 ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:436 ../src/guestfs-actions.pod:450 ../src/guestfs-actions.pod:495 ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:541 ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:670 ../src/guestfs-actions.pod:769 ../src/guestfs-actions.pod:787 ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:815 ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:996 ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1098 ../src/guestfs-actions.pod:1116 ../src/guestfs-actions.pod:1135 ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1169 ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1270 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1332 ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1472 ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1712 ../src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:2261 ../src/guestfs-actions.pod:2405 ../src/guestfs-actions.pod:2466 ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:3336 ../src/guestfs-actions.pod:3351 ../src/guestfs-actions.pod:3371 ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3540 ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:3567 ../src/guestfs-actions.pod:3582 ../src/guestfs-actions.pod:3618 ../src/guestfs-actions.pod:3690 ../src/guestfs-actions.pod:3710 ../src/guestfs-actions.pod:3727 ../src/guestfs-actions.pod:3750 ../src/guestfs-actions.pod:3773 ../src/guestfs-actions.pod:3805 ../src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:3843 ../src/guestfs-actions.pod:3878 ../src/guestfs-actions.pod:3890 ../src/guestfs-actions.pod:3926 ../src/guestfs-actions.pod:3942 ../src/guestfs-actions.pod:3955 ../src/guestfs-actions.pod:3970 ../src/guestfs-actions.pod:3987 ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4113 ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4182 ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4216 ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4244 ../src/guestfs-actions.pod:4261 ../src/guestfs-actions.pod:4276 ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4458 ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:4496 ../src/guestfs-actions.pod:4508 ../src/guestfs-actions.pod:4525 ../src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:4553 ../src/guestfs-actions.pod:4568 ../src/guestfs-actions.pod:4603 ../src/guestfs-actions.pod:4618 ../src/guestfs-actions.pod:4638 ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4669 ../src/guestfs-actions.pod:4718 ../src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4769 ../src/guestfs-actions.pod:4797 ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4832 ../src/guestfs-actions.pod:4966 ../src/guestfs-actions.pod:5023 ../src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5063 ../src/guestfs-actions.pod:5095 ../src/guestfs-actions.pod:5161 ../src/guestfs-actions.pod:5178 ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5205 ../src/guestfs-actions.pod:5494 ../src/guestfs-actions.pod:5513 ../src/guestfs-actions.pod:5532 ../src/guestfs-actions.pod:5544 ../src/guestfs-actions.pod:5556 ../src/guestfs-actions.pod:5570 ../src/guestfs-actions.pod:5582 ../src/guestfs-actions.pod:5596 ../src/guestfs-actions.pod:5612 ../src/guestfs-actions.pod:5633 ../src/guestfs-actions.pod:5652 ../src/guestfs-actions.pod:5671 ../src/guestfs-actions.pod:5701 ../src/guestfs-actions.pod:5717 ../src/guestfs-actions.pod:5740 ../src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5777 ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5817 ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5862 ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:5905 ../src/guestfs-actions.pod:5929 ../src/guestfs-actions.pod:5944 ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:5978 ../src/guestfs-actions.pod:6015 ../src/guestfs-actions.pod:6038 ../src/guestfs-actions.pod:6064 ../src/guestfs-actions.pod:6172 ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6305 ../src/guestfs-actions.pod:6318 ../src/guestfs-actions.pod:6331 ../src/guestfs-actions.pod:6353 ../src/guestfs-actions.pod:6366 ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6392 ../src/guestfs-actions.pod:6407 ../src/guestfs-actions.pod:6466 ../src/guestfs-actions.pod:6483 ../src/guestfs-actions.pod:6499 ../src/guestfs-actions.pod:6515 ../src/guestfs-actions.pod:6532 ../src/guestfs-actions.pod:6545 ../src/guestfs-actions.pod:6565 ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:6615 ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:6669 ../src/guestfs-actions.pod:6687 ../src/guestfs-actions.pod:6721 ../src/guestfs-actions.pod:6757 ../src/guestfs-actions.pod:6876 ../src/guestfs-actions.pod:6894 ../src/guestfs-actions.pod:6908 ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:6976 ../src/guestfs-actions.pod:7021 ../src/guestfs-actions.pod:7054 ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7134 ../src/guestfs-actions.pod:7200 ../src/guestfs-actions.pod:7219 ../src/guestfs-actions.pod:7248 msgid "This function returns 0 on success or -1 on error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:240 ../src/guestfs-actions.pod:261 ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:151 ../fish/guestfish-actions.pod:165 +#: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248 ../src/guestfs-actions.pod:269 ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172 msgid "" "This function is deprecated. In new code, use the C<add_drive_opts> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:243 ../src/guestfs-actions.pod:264 ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1942 ../src/guestfs-actions.pod:4283 ../src/guestfs-actions.pod:7096 ../src/guestfs-actions.pod:7265 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:154 ../fish/guestfish-actions.pod:168 ../fish/guestfish-actions.pod:949 ../fish/guestfish-actions.pod:1306 ../fish/guestfish-actions.pod:1320 ../fish/guestfish-actions.pod:2895 ../fish/guestfish-actions.pod:4723 ../fish/guestfish-actions.pod:4820 +#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251 ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1443 ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:1960 ../src/guestfs-actions.pod:4301 ../src/guestfs-actions.pod:7142 ../src/guestfs-actions.pod:7311 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175 ../fish/guestfish-actions.pod:956 ../fish/guestfish-actions.pod:1319 ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:2908 ../fish/guestfish-actions.pod:4762 ../fish/guestfish-actions.pod:4859 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 " @@ -5081,7 +5191,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:128 ../src/guestfs-actions.pod:1092 ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:3320 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:4587 ../src/guestfs-actions.pod:5673 ../src/guestfs-actions.pod:5790 ../src/guestfs-actions.pod:5900 ../src/guestfs-actions.pod:6363 ../src/guestfs-actions.pod:6488 ../src/guestfs-actions.pod:7010 +#: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136 ../src/guestfs-actions.pod:1100 ../src/guestfs-actions.pod:1911 ../src/guestfs-actions.pod:2009 ../src/guestfs-actions.pod:2112 ../src/guestfs-actions.pod:3338 ../src/guestfs-actions.pod:3353 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:5719 ../src/guestfs-actions.pod:5836 ../src/guestfs-actions.pod:5946 ../src/guestfs-actions.pod:6409 ../src/guestfs-actions.pod:6534 ../src/guestfs-actions.pod:7056 msgid "(Added in 0.3)" msgstr "" @@ -5102,7 +5212,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:137 ../src/guestfs-actions.pod:4297 +#: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145 ../src/guestfs-actions.pod:4315 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 " @@ -5116,11 +5226,12 @@ msgid "" " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n" " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n" " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n" +" GUESTFS_ADD_DOMAIN_LIVE, int live,\n" "\n" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:57 +#: ../src/guestfs-actions.pod:58 msgid "" "This function adds the disk(s) attached to the named libvirt domain C<dom>. " "It works by connecting to libvirt, requesting the domain and domain XML from " @@ -5129,14 +5240,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:62 ../fish/guestfish-actions.pod:46 +#: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46 msgid "" "The number of disks added is returned. This operation is atomic: if an " "error is returned, then no disks are added." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:65 ../fish/guestfish-actions.pod:49 +#: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49 msgid "" "This function does some minimal checks to make sure the libvirt domain is " "not running (unless C<readonly> is true). In a future version we will try " @@ -5144,7 +5255,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:69 ../fish/guestfish-actions.pod:53 +#: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53 msgid "" "Disks must be accessible locally. This often means that adding disks from a " "remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail " @@ -5152,7 +5263,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:74 ../fish/guestfish-actions.pod:58 +#: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58 msgid "" "The optional C<libvirturi> parameter sets the libvirt URI (see " "L<http://libvirt.org/uri.html>). If this is not set then we connect to the " @@ -5161,29 +5272,39 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:80 +#: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64 +msgid "" +"The optional C<live> flag controls whether this call will try to connect to " +"a running virtual machine C<guestfsd> process if it sees a suitable " +"E<lt>channelE<gt> element in the libvirt XML definition. The default (if " +"the flag is omitted) is never to try. See L<guestfs(3)/ATTACHING TO RUNNING " +"DAEMONS> for more information." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:88 msgid "" "The other optional parameters are passed directly through to " "C<guestfs_add_drive_opts>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:83 ../src/guestfs-actions.pod:336 ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:679 ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:728 ../src/guestfs-actions.pod:747 ../src/guestfs-actions.pod:1307 ../src/guestfs-actions.pod:1661 ../src/guestfs-actions.pod:1864 ../src/guestfs-actions.pod:1963 ../src/guestfs-actions.pod:2003 ../src/guestfs-actions.pod:2058 ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:2701 ../src/guestfs-actions.pod:2722 ../src/guestfs-actions.pod:4723 ../src/guestfs-actions.pod:4851 ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:6596 ../src/guestfs-actions.pod:7021 ../src/guestfs-actions.pod:7034 ../src/guestfs-actions.pod:7047 +#: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344 ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:736 ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:1315 ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1872 ../src/guestfs-actions.pod:1981 ../src/guestfs-actions.pod:2021 ../src/guestfs-actions.pod:2076 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2719 ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:4741 ../src/guestfs-actions.pod:4869 ../src/guestfs-actions.pod:5275 ../src/guestfs-actions.pod:5301 ../src/guestfs-actions.pod:6642 ../src/guestfs-actions.pod:7067 ../src/guestfs-actions.pod:7080 ../src/guestfs-actions.pod:7093 msgid "On error this function returns -1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:85 +#: ../src/guestfs-actions.pod:93 msgid "(Added in 1.7.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:87 +#: ../src/guestfs-actions.pod:95 msgid "guestfs_add_domain_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:89 +#: ../src/guestfs-actions.pod:97 #, no-wrap msgid "" " int\n" @@ -5194,22 +5315,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:94 +#: ../src/guestfs-actions.pod:102 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:96 ../src/guestfs-actions.pod:107 ../src/guestfs-actions.pod:200 ../src/guestfs-actions.pod:211 ../src/guestfs-actions.pod:4350 ../src/guestfs-actions.pod:4362 +#: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115 ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219 ../src/guestfs-actions.pod:4368 ../src/guestfs-actions.pod:4380 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:98 +#: ../src/guestfs-actions.pod:106 msgid "guestfs_add_domain_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:100 +#: ../src/guestfs-actions.pod:108 #, no-wrap msgid "" " int\n" @@ -5220,17 +5341,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:105 +#: ../src/guestfs-actions.pod:113 msgid "This is the \"argv variant\" of L</guestfs_add_domain>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:109 +#: ../src/guestfs-actions.pod:117 msgid "guestfs_add_drive" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:111 +#: ../src/guestfs-actions.pod:119 #, no-wrap msgid "" " int\n" @@ -5240,7 +5361,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:115 +#: ../src/guestfs-actions.pod:123 msgid "" "This function is the equivalent of calling C<guestfs_add_drive_opts> with no " "optional parameters, so the disk is added writable, with the format being " @@ -5248,7 +5369,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:119 +#: ../src/guestfs-actions.pod:127 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -5258,12 +5379,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:130 +#: ../src/guestfs-actions.pod:138 msgid "guestfs_add_drive_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:132 +#: ../src/guestfs-actions.pod:140 #, no-wrap msgid "" " int\n" @@ -5274,7 +5395,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:142 +#: ../src/guestfs-actions.pod:150 #, no-wrap msgid "" " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n" @@ -5284,7 +5405,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:146 ../fish/guestfish-actions.pod:90 +#: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97 msgid "" "This function adds a virtual machine disk image C<filename> to libguestfs. " "The first time you call this function, the disk appears as C</dev/sda>, the " @@ -5292,7 +5413,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:151 ../fish/guestfish-actions.pod:95 +#: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102 msgid "" "You don't necessarily need to be root when using libguestfs. However you " "obviously do need sufficient permissions to access the filename for whatever " @@ -5301,22 +5422,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:157 ../fish/guestfish-actions.pod:101 +#: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108 msgid "This call checks that C<filename> exists." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:159 ../src/guestfs-actions.pod:4308 ../fish/guestfish-actions.pod:103 ../fish/guestfish-actions.pod:2906 +#: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4326 ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:2919 msgid "The optional arguments are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:163 ../fish/guestfish-actions.pod:107 +#: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114 msgid "C<readonly>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:109 +#: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116 msgid "" "If true then the image is treated as read-only. Writes are still allowed, " "but they are stored in a temporary snapshot overlay which is discarded at " @@ -5324,12 +5445,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:169 ../fish/guestfish-actions.pod:113 +#: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120 msgid "C<format>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:171 +#: ../src/guestfs-actions.pod:179 msgid "" "This forces the image format. If you omit this (or use C<guestfs_add_drive> " "or C<guestfs_add_drive_ro>) then the format is automatically detected. " @@ -5337,7 +5458,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:175 ../fish/guestfish-actions.pod:119 +#: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -5345,29 +5466,29 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:180 ../fish/guestfish-actions.pod:124 +#: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131 msgid "C<iface>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:182 +#: ../src/guestfs-actions.pod:190 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " "C<guestfs_add_drive_with_if> call (q.v.)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:189 +#: ../src/guestfs-actions.pod:197 msgid "(Added in 1.5.23)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:191 +#: ../src/guestfs-actions.pod:199 msgid "guestfs_add_drive_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:193 +#: ../src/guestfs-actions.pod:201 #, no-wrap msgid "" " int\n" @@ -5378,17 +5499,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:198 +#: ../src/guestfs-actions.pod:206 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:202 +#: ../src/guestfs-actions.pod:210 msgid "guestfs_add_drive_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:204 +#: ../src/guestfs-actions.pod:212 #, no-wrap msgid "" " int\n" @@ -5400,17 +5521,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:209 +#: ../src/guestfs-actions.pod:217 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:213 +#: ../src/guestfs-actions.pod:221 msgid "guestfs_add_drive_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:215 +#: ../src/guestfs-actions.pod:223 #, no-wrap msgid "" " int\n" @@ -5420,7 +5541,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:219 +#: ../src/guestfs-actions.pod:227 msgid "" "This function is the equivalent of calling C<guestfs_add_drive_opts> with " "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the " @@ -5428,17 +5549,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:226 +#: ../src/guestfs-actions.pod:234 msgid "(Added in 1.0.38)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:228 +#: ../src/guestfs-actions.pod:236 msgid "guestfs_add_drive_ro_with_if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:230 +#: ../src/guestfs-actions.pod:238 #, no-wrap msgid "" " int\n" @@ -5449,24 +5570,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:235 +#: ../src/guestfs-actions.pod:243 msgid "" "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the " "QEMU interface emulation to use at run time." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:268 ../src/guestfs-actions.pod:2333 +#: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276 ../src/guestfs-actions.pod:2351 msgid "(Added in 1.0.84)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:249 +#: ../src/guestfs-actions.pod:257 msgid "guestfs_add_drive_with_if" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:251 +#: ../src/guestfs-actions.pod:259 #, no-wrap msgid "" " int\n" @@ -5477,19 +5598,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:256 +#: ../src/guestfs-actions.pod:264 msgid "" "This is the same as C<guestfs_add_drive> but it allows you to specify the " "QEMU interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:270 +#: ../src/guestfs-actions.pod:278 msgid "guestfs_aug_clear" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:272 +#: ../src/guestfs-actions.pod:280 #, no-wrap msgid "" " int\n" @@ -5499,24 +5620,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:276 ../fish/guestfish-actions.pod:176 +#: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183 msgid "" "Set the value associated with C<path> to C<NULL>. This is the same as the " "L<augtool(1)> C<clear> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:281 ../src/guestfs-actions.pod:2083 +#: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2101 msgid "(Added in 1.3.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:283 +#: ../src/guestfs-actions.pod:291 msgid "guestfs_aug_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:285 +#: ../src/guestfs-actions.pod:293 #, no-wrap msgid "" " int\n" @@ -5525,7 +5646,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:288 +#: ../src/guestfs-actions.pod:296 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call C<guestfs_aug_init> again before you can use " @@ -5533,17 +5654,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:320 ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:410 ../src/guestfs-actions.pod:430 ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:475 ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:535 ../src/guestfs-actions.pod:5334 +#: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:438 ../src/guestfs-actions.pod:452 ../src/guestfs-actions.pod:483 ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:511 ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:543 ../src/guestfs-actions.pod:5352 msgid "(Added in 0.7)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:297 +#: ../src/guestfs-actions.pod:305 msgid "guestfs_aug_defnode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:299 +#: ../src/guestfs-actions.pod:307 #, no-wrap msgid "" " struct guestfs_int_bool *\n" @@ -5555,12 +5676,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:305 ../fish/guestfish-actions.pod:192 +#: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199 msgid "Defines a variable C<name> whose value is the result of evaluating C<expr>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:308 +#: ../src/guestfs-actions.pod:316 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " "calling C<guestfs_aug_set> C<expr>, C<value>. C<name> will be the nodeset " @@ -5568,26 +5689,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:312 ../fish/guestfish-actions.pod:199 +#: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206 msgid "" "On success this returns a pair containing the number of nodes in the " "nodeset, and a boolean flag if a node was created." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:316 +#: ../src/guestfs-actions.pod:324 msgid "" "This function returns a C<struct guestfs_int_bool *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_int_bool> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:322 +#: ../src/guestfs-actions.pod:330 msgid "guestfs_aug_defvar" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:324 +#: ../src/guestfs-actions.pod:332 #, no-wrap msgid "" " int\n" @@ -5598,26 +5719,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:329 ../fish/guestfish-actions.pod:207 +#: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214 msgid "" "Defines an Augeas variable C<name> whose value is the result of evaluating " "C<expr>. If C<expr> is NULL, then C<name> is undefined." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:333 ../fish/guestfish-actions.pod:211 +#: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218 msgid "" "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> " "evaluates to something which is not a nodeset." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:340 +#: ../src/guestfs-actions.pod:348 msgid "guestfs_aug_get" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:342 +#: ../src/guestfs-actions.pod:350 #, no-wrap msgid "" " char *\n" @@ -5627,26 +5748,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:346 ../fish/guestfish-actions.pod:218 +#: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225 msgid "" "Look up the value associated with C<path>. If C<path> matches exactly one " "node, the C<value> is returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:349 ../src/guestfs-actions.pod:849 ../src/guestfs-actions.pod:867 ../src/guestfs-actions.pod:927 ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1046 ../src/guestfs-actions.pod:1176 ../src/guestfs-actions.pod:1193 ../src/guestfs-actions.pod:1212 ../src/guestfs-actions.pod:1341 ../src/guestfs-actions.pod:1532 ../src/guestfs-actions.pod:1644 ../src/guestfs-actions.pod:1807 ../src/guestfs-actions.pod:1824 ../src/guestfs-actions.pod:1915 ../src/guestfs-actions.pod:1936 ../src/guestfs-actions.pod:2106 ../src/guestfs-actions.pod:2298 ../src/guestfs-actions.pod:2505 ../src/guestfs-actions.pod:2586 ../src/guestfs-actions.pod:2653 ../src/guestfs-actions.pod:2673 ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:2818 ../src/guestfs-actions.pod:2842 ../src/guestfs-actions.pod:2904 ../src/guestfs-actions.pod:2927 ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4124 ../src/guestfs-actions.pod:4869 ../src/guestfs-actions.pod:5062 ../src/guestfs-actions.pod:5232 ../src/guestfs-actions.pod:5410 ../src/guestfs-actions.pod:5459 ../src/guestfs-actions.pod:6039 ../src/guestfs-actions.pod:6055 ../src/guestfs-actions.pod:6072 ../src/guestfs-actions.pod:6096 ../src/guestfs-actions.pod:6770 ../src/guestfs-actions.pod:6789 ../src/guestfs-actions.pod:6807 ../src/guestfs-actions.pod:6987 ../src/guestfs-actions.pod:7259 +#: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:857 ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:935 ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1054 ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1349 ../src/guestfs-actions.pod:1540 ../src/guestfs-actions.pod:1652 ../src/guestfs-actions.pod:1815 ../src/guestfs-actions.pod:1832 ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1933 ../src/guestfs-actions.pod:1954 ../src/guestfs-actions.pod:2124 ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2523 ../src/guestfs-actions.pod:2604 ../src/guestfs-actions.pod:2671 ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2805 ../src/guestfs-actions.pod:2836 ../src/guestfs-actions.pod:2860 ../src/guestfs-actions.pod:2922 ../src/guestfs-actions.pod:2945 ../src/guestfs-actions.pod:3512 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4142 ../src/guestfs-actions.pod:4887 ../src/guestfs-actions.pod:5080 ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:5428 ../src/guestfs-actions.pod:5477 ../src/guestfs-actions.pod:6085 ../src/guestfs-actions.pod:6101 ../src/guestfs-actions.pod:6118 ../src/guestfs-actions.pod:6142 ../src/guestfs-actions.pod:6816 ../src/guestfs-actions.pod:6835 ../src/guestfs-actions.pod:6853 ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7305 msgid "" "This function returns a string, or NULL on error. I<The caller must free " "the returned string after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:354 +#: ../src/guestfs-actions.pod:362 msgid "guestfs_aug_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:356 +#: ../src/guestfs-actions.pod:364 #, no-wrap msgid "" " int\n" @@ -5657,7 +5778,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:361 ../fish/guestfish-actions.pod:225 +#: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232 msgid "" "Create a new Augeas handle for editing configuration files. If there was " "any previous Augeas handle associated with this guestfs session, then it is " @@ -5665,101 +5786,101 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:365 +#: ../src/guestfs-actions.pod:373 msgid "You must call this before using any other C<guestfs_aug_*> commands." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:368 ../fish/guestfish-actions.pod:232 +#: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239 msgid "C<root> is the filesystem root. C<root> must not be NULL, use C</> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:371 ../fish/guestfish-actions.pod:235 +#: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242 msgid "" "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the " "logical I<or> of the following integers:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:377 ../fish/guestfish-actions.pod:241 +#: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248 msgid "C<AUG_SAVE_BACKUP> = 1" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:243 +#: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250 msgid "Keep the original file with a C<.augsave> extension." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:381 ../fish/guestfish-actions.pod:245 +#: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252 msgid "C<AUG_SAVE_NEWFILE> = 2" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:383 ../fish/guestfish-actions.pod:247 +#: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254 msgid "" "Save changes into a file with extension C<.augnew>, and do not overwrite " "original. Overrides C<AUG_SAVE_BACKUP>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:386 ../fish/guestfish-actions.pod:250 +#: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257 msgid "C<AUG_TYPE_CHECK> = 4" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:388 ../fish/guestfish-actions.pod:252 +#: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259 msgid "Typecheck lenses (can be expensive)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:390 ../fish/guestfish-actions.pod:254 +#: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:261 msgid "C<AUG_NO_STDINC> = 8" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:392 ../fish/guestfish-actions.pod:256 +#: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:263 msgid "Do not use standard load path for modules." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:258 +#: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:265 msgid "C<AUG_SAVE_NOOP> = 16" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:260 +#: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:267 msgid "Make save a no-op, just record what would have been changed." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:262 +#: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:269 msgid "C<AUG_NO_LOAD> = 32" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:400 +#: ../src/guestfs-actions.pod:408 msgid "Do not load the tree in C<guestfs_aug_init>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:404 +#: ../src/guestfs-actions.pod:412 msgid "To close the handle, you can call C<guestfs_aug_close>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:270 +#: ../src/guestfs-actions.pod:414 ../fish/guestfish-actions.pod:277 msgid "To find out more about Augeas, see L<http://augeas.net/>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:412 +#: ../src/guestfs-actions.pod:420 msgid "guestfs_aug_insert" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:414 +#: ../src/guestfs-actions.pod:422 #, no-wrap msgid "" " int\n" @@ -5771,26 +5892,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:420 ../fish/guestfish-actions.pod:276 +#: ../src/guestfs-actions.pod:428 ../fish/guestfish-actions.pod:283 msgid "" "Create a new sibling C<label> for C<path>, inserting it into the tree before " "or after C<path> (depending on the boolean flag C<before>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:424 ../fish/guestfish-actions.pod:280 +#: ../src/guestfs-actions.pod:432 ../fish/guestfish-actions.pod:287 msgid "" "C<path> must match exactly one existing node in the tree, and C<label> must " "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:432 +#: ../src/guestfs-actions.pod:440 msgid "guestfs_aug_load" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:434 +#: ../src/guestfs-actions.pod:442 #, no-wrap msgid "" " int\n" @@ -5799,22 +5920,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:437 ../fish/guestfish-actions.pod:288 +#: ../src/guestfs-actions.pod:445 ../fish/guestfish-actions.pod:295 msgid "Load files into the tree." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:439 ../fish/guestfish-actions.pod:290 +#: ../src/guestfs-actions.pod:447 ../fish/guestfish-actions.pod:297 msgid "See C<aug_load> in the Augeas documentation for the full gory details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:446 +#: ../src/guestfs-actions.pod:454 msgid "guestfs_aug_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:448 +#: ../src/guestfs-actions.pod:456 #, no-wrap msgid "" " char **\n" @@ -5824,14 +5945,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:452 +#: ../src/guestfs-actions.pod:460 msgid "" "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and " "sorting the resulting nodes into alphabetical order." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:471 ../src/guestfs-actions.pod:617 ../src/guestfs-actions.pod:1065 ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1375 ../src/guestfs-actions.pod:1478 ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1746 ../src/guestfs-actions.pod:2178 ../src/guestfs-actions.pod:2194 ../src/guestfs-actions.pod:2213 ../src/guestfs-actions.pod:2256 ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:2351 ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:2861 ../src/guestfs-actions.pod:3129 ../src/guestfs-actions.pod:3414 ../src/guestfs-actions.pod:3476 ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3986 ../src/guestfs-actions.pod:4684 ../src/guestfs-actions.pod:5204 ../src/guestfs-actions.pod:5330 ../src/guestfs-actions.pod:5444 ../src/guestfs-actions.pod:6112 ../src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6374 ../src/guestfs-actions.pod:6398 ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6900 ../src/guestfs-actions.pod:6947 ../src/guestfs-actions.pod:7112 ../src/guestfs-actions.pod:7131 ../src/guestfs-actions.pod:7216 ../src/guestfs-actions.pod:7235 ../src/guestfs-actions.pod:7281 ../src/guestfs-actions.pod:7300 +#: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:479 ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:1073 ../src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:1383 ../src/guestfs-actions.pod:1486 ../src/guestfs-actions.pod:1505 ../src/guestfs-actions.pod:1754 ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2212 ../src/guestfs-actions.pod:2231 ../src/guestfs-actions.pod:2274 ../src/guestfs-actions.pod:2298 ../src/guestfs-actions.pod:2369 ../src/guestfs-actions.pod:2418 ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2879 ../src/guestfs-actions.pod:3147 ../src/guestfs-actions.pod:3432 ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3599 ../src/guestfs-actions.pod:4004 ../src/guestfs-actions.pod:4702 ../src/guestfs-actions.pod:5222 ../src/guestfs-actions.pod:5348 ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:6158 ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6420 ../src/guestfs-actions.pod:6444 ../src/guestfs-actions.pod:6926 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7158 ../src/guestfs-actions.pod:7177 ../src/guestfs-actions.pod:7262 ../src/guestfs-actions.pod:7281 ../src/guestfs-actions.pod:7327 ../src/guestfs-actions.pod:7346 msgid "" "This function returns a NULL-terminated array of strings (like " "L<environ(3)>), or NULL if there was an error. I<The caller must free the " @@ -5839,17 +5960,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:459 ../src/guestfs-actions.pod:990 ../src/guestfs-actions.pod:1008 ../src/guestfs-actions.pod:1413 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3827 ../src/guestfs-actions.pod:3877 ../src/guestfs-actions.pod:4064 ../src/guestfs-actions.pod:4097 ../src/guestfs-actions.pod:4260 ../src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:5145 ../src/guestfs-actions.pod:5540 ../src/guestfs-actions.pod:5554 ../src/guestfs-actions.pod:5566 ../src/guestfs-actions.pod:5974 ../src/guestfs-actions.pod:6612 ../src/guestfs-actions.pod:6625 ../src/guestfs-actions.pod:6864 ../src/guestfs-actions.pod:7100 +#: ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:998 ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1421 ../src/guestfs-actions.pod:3225 ../src/guestfs-actions.pod:3256 ../src/guestfs-actions.pod:3845 ../src/guestfs-actions.pod:3895 ../src/guestfs-actions.pod:4082 ../src/guestfs-actions.pod:4115 ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4706 ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5558 ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5584 ../src/guestfs-actions.pod:6020 ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6671 ../src/guestfs-actions.pod:6910 ../src/guestfs-actions.pod:7146 msgid "(Added in 0.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:461 +#: ../src/guestfs-actions.pod:469 msgid "guestfs_aug_match" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:463 +#: ../src/guestfs-actions.pod:471 #, no-wrap msgid "" " char **\n" @@ -5859,7 +5980,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:467 ../fish/guestfish-actions.pod:304 +#: ../src/guestfs-actions.pod:475 ../fish/guestfish-actions.pod:311 msgid "" "Returns a list of paths which match the path expression C<path>. The " "returned paths are sufficiently qualified so that they match exactly one " @@ -5867,12 +5988,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:477 +#: ../src/guestfs-actions.pod:485 msgid "guestfs_aug_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:479 +#: ../src/guestfs-actions.pod:487 #, no-wrap msgid "" " int\n" @@ -5883,19 +6004,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:484 ../fish/guestfish-actions.pod:312 +#: ../src/guestfs-actions.pod:492 ../fish/guestfish-actions.pod:319 msgid "" "Move the node C<src> to C<dest>. C<src> must match exactly one node. " "C<dest> is overwritten if it exists." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:491 +#: ../src/guestfs-actions.pod:499 msgid "guestfs_aug_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:493 +#: ../src/guestfs-actions.pod:501 #, no-wrap msgid "" " int\n" @@ -5905,22 +6026,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:497 ../fish/guestfish-actions.pod:319 +#: ../src/guestfs-actions.pod:505 ../fish/guestfish-actions.pod:326 msgid "Remove C<path> and all of its children." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:499 ../fish/guestfish-actions.pod:321 +#: ../src/guestfs-actions.pod:507 ../fish/guestfish-actions.pod:328 msgid "On success this returns the number of entries which were removed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:505 +#: ../src/guestfs-actions.pod:513 msgid "guestfs_aug_save" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:507 +#: ../src/guestfs-actions.pod:515 #, no-wrap msgid "" " int\n" @@ -5929,24 +6050,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:510 ../fish/guestfish-actions.pod:327 +#: ../src/guestfs-actions.pod:518 ../fish/guestfish-actions.pod:334 msgid "This writes all pending changes to disk." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:512 +#: ../src/guestfs-actions.pod:520 msgid "" "The flags which were passed to C<guestfs_aug_init> affect exactly how files " "are saved." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:519 +#: ../src/guestfs-actions.pod:527 msgid "guestfs_aug_set" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:521 +#: ../src/guestfs-actions.pod:529 #, no-wrap msgid "" " int\n" @@ -5957,12 +6078,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:526 ../fish/guestfish-actions.pod:336 +#: ../src/guestfs-actions.pod:534 ../fish/guestfish-actions.pod:343 msgid "Set the value associated with C<path> to C<val>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:528 +#: ../src/guestfs-actions.pod:536 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " @@ -5970,12 +6091,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:537 +#: ../src/guestfs-actions.pod:545 msgid "guestfs_available" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:539 +#: ../src/guestfs-actions.pod:547 #, no-wrap msgid "" " int\n" @@ -5985,7 +6106,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:543 ../fish/guestfish-actions.pod:347 +#: ../src/guestfs-actions.pod:551 ../fish/guestfish-actions.pod:354 msgid "" "This command is used to check the availability of some groups of " "functionality in the appliance, which not all builds of the libguestfs " @@ -5993,7 +6114,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:547 +#: ../src/guestfs-actions.pod:555 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " @@ -6001,7 +6122,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:552 ../fish/guestfish-actions.pod:356 +#: ../src/guestfs-actions.pod:560 ../fish/guestfish-actions.pod:363 msgid "" "The argument C<groups> is a list of group names, eg: C<[\"inotify\", " "\"augeas\"]> would check for the availability of the Linux inotify functions " @@ -6009,43 +6130,43 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:361 +#: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368 msgid "The command returns no error if I<all> requested groups are available." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:559 ../fish/guestfish-actions.pod:363 +#: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:370 msgid "" "It fails with an error if one or more of the requested groups is unavailable " "in the appliance." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:562 ../fish/guestfish-actions.pod:366 +#: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373 msgid "" "If an unknown group name is included in the list of groups then an error is " "always returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:369 +#: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:376 msgid "I<Notes:>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:571 +#: ../src/guestfs-actions.pod:579 msgid "You must call C<guestfs_launch> before calling this function." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:377 +#: ../src/guestfs-actions.pod:581 ../fish/guestfish-actions.pod:384 msgid "" "The reason is because we don't know what groups are supported by the " "appliance/daemon until it is running and can be queried." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:579 ../fish/guestfish-actions.pod:383 +#: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:390 msgid "" "If a group of functions is available, this does not necessarily mean that " "they will work. You still have to check for errors when calling individual " @@ -6053,7 +6174,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:586 ../fish/guestfish-actions.pod:390 +#: ../src/guestfs-actions.pod:594 ../fish/guestfish-actions.pod:397 msgid "" "It is usually the job of distro packagers to build complete functionality " "into the libguestfs appliance. Upstream libguestfs, if built from source " @@ -6061,7 +6182,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:593 +#: ../src/guestfs-actions.pod:601 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " @@ -6069,17 +6190,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:602 ../src/guestfs-actions.pod:1163 +#: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1171 msgid "(Added in 1.0.80)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:604 +#: ../src/guestfs-actions.pod:612 msgid "guestfs_available_all_groups" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:606 +#: ../src/guestfs-actions.pod:614 #, no-wrap msgid "" " char **\n" @@ -6088,7 +6209,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:609 +#: ../src/guestfs-actions.pod:617 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " @@ -6097,22 +6218,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:615 +#: ../src/guestfs-actions.pod:623 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:621 +#: ../src/guestfs-actions.pod:629 msgid "(Added in 1.3.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:623 +#: ../src/guestfs-actions.pod:631 msgid "guestfs_base64_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:625 +#: ../src/guestfs-actions.pod:633 #, no-wrap msgid "" " int\n" @@ -6123,22 +6244,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:630 ../fish/guestfish-actions.pod:420 +#: ../src/guestfs-actions.pod:638 ../fish/guestfish-actions.pod:427 msgid "This command uploads base64-encoded data from C<base64file> to C<filename>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:635 ../src/guestfs-actions.pod:649 +#: ../src/guestfs-actions.pod:643 ../src/guestfs-actions.pod:657 msgid "(Added in 1.3.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:637 +#: ../src/guestfs-actions.pod:645 msgid "guestfs_base64_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:639 +#: ../src/guestfs-actions.pod:647 #, no-wrap msgid "" " int\n" @@ -6149,19 +6270,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:644 ../fish/guestfish-actions.pod:429 +#: ../src/guestfs-actions.pod:652 ../fish/guestfish-actions.pod:436 msgid "" "This command downloads the contents of C<filename>, writing it out to local " "file C<base64file> encoded as base64." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:651 +#: ../src/guestfs-actions.pod:659 msgid "guestfs_blockdev_flushbufs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:653 +#: ../src/guestfs-actions.pod:661 #, no-wrap msgid "" " int\n" @@ -6171,27 +6292,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:657 ../fish/guestfish-actions.pod:438 +#: ../src/guestfs-actions.pod:665 ../fish/guestfish-actions.pod:445 msgid "This tells the kernel to flush internal buffers associated with C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:677 ../src/guestfs-actions.pod:692 ../src/guestfs-actions.pod:708 ../src/guestfs-actions.pod:726 ../src/guestfs-actions.pod:745 ../src/guestfs-actions.pod:759 ../src/guestfs-actions.pod:777 ../src/guestfs-actions.pod:791 ../src/guestfs-actions.pod:805 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:452 ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:471 ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:496 ../fish/guestfish-actions.pod:504 ../fish/guestfish-actions.pod:515 ../fish/guestfish-actions.pod:523 ../fish/guestfish-actions.pod:531 +#: ../src/guestfs-actions.pod:668 ../src/guestfs-actions.pod:685 ../src/guestfs-actions.pod:700 ../src/guestfs-actions.pod:716 ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:753 ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:785 ../src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:813 ../fish/guestfish-actions.pod:448 ../fish/guestfish-actions.pod:459 ../fish/guestfish-actions.pod:468 ../fish/guestfish-actions.pod:478 ../fish/guestfish-actions.pod:490 ../fish/guestfish-actions.pod:503 ../fish/guestfish-actions.pod:511 ../fish/guestfish-actions.pod:522 ../fish/guestfish-actions.pod:530 ../fish/guestfish-actions.pod:538 msgid "This uses the L<blockdev(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:664 ../src/guestfs-actions.pod:681 ../src/guestfs-actions.pod:696 ../src/guestfs-actions.pod:712 ../src/guestfs-actions.pod:730 ../src/guestfs-actions.pod:749 ../src/guestfs-actions.pod:763 ../src/guestfs-actions.pod:781 ../src/guestfs-actions.pod:795 ../src/guestfs-actions.pod:809 +#: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:689 ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:720 ../src/guestfs-actions.pod:738 ../src/guestfs-actions.pod:757 ../src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:789 ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:817 msgid "(Added in 0.9.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:666 +#: ../src/guestfs-actions.pod:674 msgid "guestfs_blockdev_getbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:668 +#: ../src/guestfs-actions.pod:676 #, no-wrap msgid "" " int\n" @@ -6201,24 +6322,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:672 ../fish/guestfish-actions.pod:447 +#: ../src/guestfs-actions.pod:680 ../fish/guestfish-actions.pod:454 msgid "This returns the block size of a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:774 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:512 +#: ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:782 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:519 msgid "" "(Note this is different from both I<size in blocks> and I<filesystem block " "size>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:683 +#: ../src/guestfs-actions.pod:691 msgid "guestfs_blockdev_getro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:685 +#: ../src/guestfs-actions.pod:693 #, no-wrap msgid "" " int\n" @@ -6228,24 +6349,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:689 ../fish/guestfish-actions.pod:458 +#: ../src/guestfs-actions.pod:697 ../fish/guestfish-actions.pod:465 msgid "" "Returns a boolean indicating if the block device is read-only (true if " "read-only, false if not)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:694 ../src/guestfs-actions.pod:1396 ../src/guestfs-actions.pod:1411 ../src/guestfs-actions.pod:1891 ../src/guestfs-actions.pod:1902 ../src/guestfs-actions.pod:1974 ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:2044 ../src/guestfs-actions.pod:2069 ../src/guestfs-actions.pod:2092 ../src/guestfs-actions.pod:2947 ../src/guestfs-actions.pod:2964 ../src/guestfs-actions.pod:2983 ../src/guestfs-actions.pod:3146 ../src/guestfs-actions.pod:3160 ../src/guestfs-actions.pod:3175 ../src/guestfs-actions.pod:3189 ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3220 ../src/guestfs-actions.pod:3236 ../src/guestfs-actions.pod:3250 ../src/guestfs-actions.pod:3263 ../src/guestfs-actions.pod:3277 ../src/guestfs-actions.pod:3292 ../src/guestfs-actions.pod:3307 ../src/guestfs-actions.pod:4833 +#: ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:1404 ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1909 ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:1992 ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2062 ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2110 ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:3001 ../src/guestfs-actions.pod:3164 ../src/guestfs-actions.pod:3178 ../src/guestfs-actions.pod:3193 ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3223 ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3254 ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3281 ../src/guestfs-actions.pod:3295 ../src/guestfs-actions.pod:3310 ../src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:4851 msgid "This function returns a C truth value on success or -1 on error." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:698 +#: ../src/guestfs-actions.pod:706 msgid "guestfs_blockdev_getsize64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:700 +#: ../src/guestfs-actions.pod:708 #, no-wrap msgid "" " int64_t\n" @@ -6255,22 +6376,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:704 ../fish/guestfish-actions.pod:467 +#: ../src/guestfs-actions.pod:712 ../fish/guestfish-actions.pod:474 msgid "This returns the size of the device in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:706 +#: ../src/guestfs-actions.pod:714 msgid "See also C<guestfs_blockdev_getsz>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:714 +#: ../src/guestfs-actions.pod:722 msgid "guestfs_blockdev_getss" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:716 +#: ../src/guestfs-actions.pod:724 #, no-wrap msgid "" " int\n" @@ -6280,26 +6401,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:720 ../fish/guestfish-actions.pod:477 +#: ../src/guestfs-actions.pod:728 ../fish/guestfish-actions.pod:484 msgid "" "This returns the size of sectors on a block device. Usually 512, but can be " "larger for modern devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:723 +#: ../src/guestfs-actions.pod:731 msgid "" "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for " "that)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:732 +#: ../src/guestfs-actions.pod:740 msgid "guestfs_blockdev_getsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:734 +#: ../src/guestfs-actions.pod:742 #, no-wrap msgid "" " int64_t\n" @@ -6309,26 +6430,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:738 ../fish/guestfish-actions.pod:489 +#: ../src/guestfs-actions.pod:746 ../fish/guestfish-actions.pod:496 msgid "" "This returns the size of the device in units of 512-byte sectors (even if " "the sectorsize isn't 512 bytes ... weird)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:741 +#: ../src/guestfs-actions.pod:749 msgid "" "See also C<guestfs_blockdev_getss> for the real sector size of the device, " "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:751 +#: ../src/guestfs-actions.pod:759 msgid "guestfs_blockdev_rereadpt" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:753 +#: ../src/guestfs-actions.pod:761 #, no-wrap msgid "" " int\n" @@ -6338,17 +6459,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:757 ../fish/guestfish-actions.pod:502 +#: ../src/guestfs-actions.pod:765 ../fish/guestfish-actions.pod:509 msgid "Reread the partition table on C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:765 +#: ../src/guestfs-actions.pod:773 msgid "guestfs_blockdev_setbsz" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:767 +#: ../src/guestfs-actions.pod:775 #, no-wrap msgid "" " int\n" @@ -6359,17 +6480,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:772 ../fish/guestfish-actions.pod:510 +#: ../src/guestfs-actions.pod:780 ../fish/guestfish-actions.pod:517 msgid "This sets the block size of a device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:783 +#: ../src/guestfs-actions.pod:791 msgid "guestfs_blockdev_setro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:785 +#: ../src/guestfs-actions.pod:793 #, no-wrap msgid "" " int\n" @@ -6379,17 +6500,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:789 ../fish/guestfish-actions.pod:521 +#: ../src/guestfs-actions.pod:797 ../fish/guestfish-actions.pod:528 msgid "Sets the block device named C<device> to read-only." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:797 +#: ../src/guestfs-actions.pod:805 msgid "guestfs_blockdev_setrw" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:799 +#: ../src/guestfs-actions.pod:807 #, no-wrap msgid "" " int\n" @@ -6399,17 +6520,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:803 ../fish/guestfish-actions.pod:529 +#: ../src/guestfs-actions.pod:811 ../fish/guestfish-actions.pod:536 msgid "Sets the block device named C<device> to read-write." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:811 +#: ../src/guestfs-actions.pod:819 msgid "guestfs_case_sensitive_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:813 +#: ../src/guestfs-actions.pod:821 #, no-wrap msgid "" " char *\n" @@ -6419,7 +6540,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:817 ../fish/guestfish-actions.pod:537 +#: ../src/guestfs-actions.pod:825 ../fish/guestfish-actions.pod:544 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 " @@ -6427,7 +6548,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:822 ../fish/guestfish-actions.pod:542 +#: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549 msgid "" "The command handles a peculiarity of the Linux ntfs-3g filesystem driver " "(and probably others), which is that although the underlying filesystem is " @@ -6436,7 +6557,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:827 ../fish/guestfish-actions.pod:547 +#: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554 msgid "" "One consequence of this is that special directories such as C<c:\\windows> " "may appear as C</WINDOWS> or C</windows> (or other things) depending on the " @@ -6445,21 +6566,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:833 ../fish/guestfish-actions.pod:553 +#: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:560 msgid "" "Bug or feature? You decide: " "L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:836 ../fish/guestfish-actions.pod:556 +#: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:563 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:839 +#: ../src/guestfs-actions.pod:847 msgid "" "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " @@ -6467,27 +6588,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:564 +#: ../src/guestfs-actions.pod:852 ../fish/guestfish-actions.pod:571 msgid "I<Note>: This function does not handle drive names, backslashes etc." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:847 +#: ../src/guestfs-actions.pod:855 msgid "See also C<guestfs_realpath>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:852 ../src/guestfs-actions.pod:6792 +#: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:6838 msgid "(Added in 1.0.75)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:854 +#: ../src/guestfs-actions.pod:862 msgid "guestfs_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:856 +#: ../src/guestfs-actions.pod:864 #, no-wrap msgid "" " char *\n" @@ -6497,12 +6618,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:5320 ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:3554 +#: ../src/guestfs-actions.pod:868 ../src/guestfs-actions.pod:5338 ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:3567 msgid "Return the contents of the file named C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:862 +#: ../src/guestfs-actions.pod:870 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -6511,24 +6632,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:870 ../src/guestfs-actions.pod:1049 ../src/guestfs-actions.pod:1069 ../src/guestfs-actions.pod:1360 ../src/guestfs-actions.pod:1379 ../src/guestfs-actions.pod:1482 ../src/guestfs-actions.pod:1501 ../src/guestfs-actions.pod:1750 ../src/guestfs-actions.pod:2198 ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2260 ../src/guestfs-actions.pod:2284 ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:5102 ../src/guestfs-actions.pod:5128 ../src/guestfs-actions.pod:5259 ../src/guestfs-actions.pod:5285 ../src/guestfs-actions.pod:5309 ../src/guestfs-actions.pod:6177 ../src/guestfs-actions.pod:6232 ../src/guestfs-actions.pod:6378 ../src/guestfs-actions.pod:6402 ../src/guestfs-actions.pod:7064 ../src/guestfs-actions.pod:7090 ../src/guestfs-actions.pod:7116 ../src/guestfs-actions.pod:7135 ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7239 ../src/guestfs-actions.pod:7285 ../src/guestfs-actions.pod:7304 ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:715 ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:913 ../fish/guestfish-actions.pod:980 ../fish/guestfish-actions.pod:990 ../fish/guestfish-actions.pod:1185 ../fish/guestfish-actions.pod:1480 ../fish/guestfish-actions.pod:1490 ../fish/guestfish-actions.pod:1518 ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:1543 ../fish/guestfish-actions.pod:1562 ../fish/guestfish-actions.pod:3424 ../fish/guestfish-actions.pod:3439 ../fish/guestfish-actions.pod:3515 ../fish/guestfish-actions.pod:3532 ../fish/guestfish-actions.pod:3547 ../fish/guestfish-actions.pod:4143 ../fish/guestfish-actions.pod:4189 ../fish/guestfish-actions.pod:4274 ../fish/guestfish-actions.pod:4289 ../fish/guestfish-actions.pod:4699 ../fish/guestfish-actions.pod:4717 ../fish/guestfish-actions.pod:4734 ../fish/guestfish-actions.pod:4744 ../fish/guestfish-actions.pod:4792 ../fish/guestfish-actions.pod:4802 ../fish/guestfish-actions.pod:4831 ../fish/guestfish-actions.pod:4841 +#: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:1057 ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1368 ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:1490 ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:1758 ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:2235 ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:2319 ../src/guestfs-actions.pod:2348 ../src/guestfs-actions.pod:5120 ../src/guestfs-actions.pod:5146 ../src/guestfs-actions.pod:5277 ../src/guestfs-actions.pod:5303 ../src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:6223 ../src/guestfs-actions.pod:6278 ../src/guestfs-actions.pod:6424 ../src/guestfs-actions.pod:6448 ../src/guestfs-actions.pod:7110 ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7162 ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7266 ../src/guestfs-actions.pod:7285 ../src/guestfs-actions.pod:7331 ../src/guestfs-actions.pod:7350 ../fish/guestfish-actions.pod:587 ../fish/guestfish-actions.pod:722 ../fish/guestfish-actions.pod:734 ../fish/guestfish-actions.pod:910 ../fish/guestfish-actions.pod:920 ../fish/guestfish-actions.pod:987 ../fish/guestfish-actions.pod:997 ../fish/guestfish-actions.pod:1192 ../fish/guestfish-actions.pod:1493 ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1531 ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:1556 ../fish/guestfish-actions.pod:1575 ../fish/guestfish-actions.pod:3437 ../fish/guestfish-actions.pod:3452 ../fish/guestfish-actions.pod:3528 ../fish/guestfish-actions.pod:3545 ../fish/guestfish-actions.pod:3560 ../fish/guestfish-actions.pod:4182 ../fish/guestfish-actions.pod:4228 ../fish/guestfish-actions.pod:4313 ../fish/guestfish-actions.pod:4328 ../fish/guestfish-actions.pod:4738 ../fish/guestfish-actions.pod:4756 ../fish/guestfish-actions.pod:4773 ../fish/guestfish-actions.pod:4783 ../fish/guestfish-actions.pod:4831 ../fish/guestfish-actions.pod:4841 ../fish/guestfish-actions.pod:4870 ../fish/guestfish-actions.pod:4880 msgid "" "Because of the message protocol, there is a transfer limit of somewhere " "between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3480 ../src/guestfs-actions.pod:3497 ../src/guestfs-actions.pod:3585 ../src/guestfs-actions.pod:3990 ../src/guestfs-actions.pod:4004 ../src/guestfs-actions.pod:5208 ../src/guestfs-actions.pod:5222 ../src/guestfs-actions.pod:6951 ../src/guestfs-actions.pod:6965 +#: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:3436 ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3515 ../src/guestfs-actions.pod:3603 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5240 ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7011 msgid "(Added in 0.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:875 +#: ../src/guestfs-actions.pod:883 msgid "guestfs_checksum" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:877 +#: ../src/guestfs-actions.pod:885 #, no-wrap msgid "" " char *\n" @@ -6539,116 +6660,116 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:882 ../fish/guestfish-actions.pod:587 +#: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:594 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:885 ../fish/guestfish-actions.pod:590 +#: ../src/guestfs-actions.pod:893 ../fish/guestfish-actions.pod:597 msgid "" "The type of checksum to compute is given by the C<csumtype> parameter which " "must have one of the following values:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:595 +#: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602 msgid "C<crc>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:892 ../fish/guestfish-actions.pod:597 +#: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:604 msgid "" "Compute the cyclic redundancy check (CRC) specified by POSIX for the " "C<cksum> command." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:600 +#: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607 msgid "C<md5>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:897 ../fish/guestfish-actions.pod:602 +#: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609 msgid "Compute the MD5 hash (using the C<md5sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:899 ../fish/guestfish-actions.pod:604 +#: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:611 msgid "C<sha1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:901 ../fish/guestfish-actions.pod:606 +#: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:613 msgid "Compute the SHA1 hash (using the C<sha1sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:608 +#: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:615 msgid "C<sha224>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:610 +#: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:617 msgid "Compute the SHA224 hash (using the C<sha224sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:612 +#: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:619 msgid "C<sha256>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:614 +#: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:621 msgid "Compute the SHA256 hash (using the C<sha256sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:616 +#: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:623 msgid "C<sha384>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:618 +#: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:625 msgid "Compute the SHA384 hash (using the C<sha384sum> program)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:620 +#: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:627 msgid "C<sha512>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:622 +#: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:629 msgid "Compute the SHA512 hash (using the C<sha512sum> program)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:626 +#: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:633 msgid "The checksum is returned as a printable string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:923 +#: ../src/guestfs-actions.pod:931 msgid "To get the checksum for a device, use C<guestfs_checksum_device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:925 +#: ../src/guestfs-actions.pod:933 msgid "To get the checksums for many files, use C<guestfs_checksums_out>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:930 ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:3162 ../src/guestfs-actions.pod:3191 ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3279 ../src/guestfs-actions.pod:6648 +#: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:1246 ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:6694 msgid "(Added in 1.0.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:932 +#: ../src/guestfs-actions.pod:940 msgid "guestfs_checksum_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:934 +#: ../src/guestfs-actions.pod:942 #, no-wrap msgid "" " char *\n" @@ -6659,7 +6780,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:939 +#: ../src/guestfs-actions.pod:947 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C<device>. For the types of checksums supported see the " @@ -6667,17 +6788,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:946 ../src/guestfs-actions.pod:4739 ../src/guestfs-actions.pod:4798 ../src/guestfs-actions.pod:4835 ../src/guestfs-actions.pod:4853 ../src/guestfs-actions.pod:5029 ../src/guestfs-actions.pod:6557 ../src/guestfs-actions.pod:6571 ../src/guestfs-actions.pod:6977 +#: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:4757 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4853 ../src/guestfs-actions.pod:4871 ../src/guestfs-actions.pod:5047 ../src/guestfs-actions.pod:6603 ../src/guestfs-actions.pod:6617 ../src/guestfs-actions.pod:7023 msgid "(Added in 1.3.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:948 +#: ../src/guestfs-actions.pod:956 msgid "guestfs_checksums_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:950 +#: ../src/guestfs-actions.pod:958 #, no-wrap msgid "" " int\n" @@ -6689,14 +6810,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:956 ../fish/guestfish-actions.pod:644 +#: ../src/guestfs-actions.pod:964 ../fish/guestfish-actions.pod:651 msgid "" "This command computes the checksums of all regular files in C<directory> and " "then emits a list of those checksums to the local output file C<sumsfile>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:960 ../fish/guestfish-actions.pod:648 +#: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:655 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 " @@ -6706,17 +6827,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:970 +#: ../src/guestfs-actions.pod:978 msgid "(Added in 1.3.7)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:972 +#: ../src/guestfs-actions.pod:980 msgid "guestfs_chmod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:974 +#: ../src/guestfs-actions.pod:982 #, no-wrap msgid "" " int\n" @@ -6727,14 +6848,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:979 ../fish/guestfish-actions.pod:662 +#: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:669 msgid "" "Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are " "supported." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:982 ../fish/guestfish-actions.pod:665 +#: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:672 msgid "" "I<Note>: When using this command from guestfish, C<mode> by default would be " "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not " @@ -6742,17 +6863,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:986 ../src/guestfs-actions.pod:4241 ../src/guestfs-actions.pod:4438 ../src/guestfs-actions.pod:4457 ../src/guestfs-actions.pod:4476 ../fish/guestfish-actions.pod:669 ../fish/guestfish-actions.pod:2870 ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3009 ../fish/guestfish-actions.pod:3019 +#: ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:4259 ../src/guestfs-actions.pod:4456 ../src/guestfs-actions.pod:4475 ../src/guestfs-actions.pod:4494 ../fish/guestfish-actions.pod:676 ../fish/guestfish-actions.pod:2883 ../fish/guestfish-actions.pod:3012 ../fish/guestfish-actions.pod:3022 ../fish/guestfish-actions.pod:3032 msgid "The mode actually set is affected by the umask." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:992 +#: ../src/guestfs-actions.pod:1000 msgid "guestfs_chown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:994 +#: ../src/guestfs-actions.pod:1002 #, no-wrap msgid "" " int\n" @@ -6764,12 +6885,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1000 ../fish/guestfish-actions.pod:675 +#: ../src/guestfs-actions.pod:1008 ../fish/guestfish-actions.pod:682 msgid "Change the file owner to C<owner> and group to C<group>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:3349 ../fish/guestfish-actions.pod:677 ../fish/guestfish-actions.pod:2328 +#: ../src/guestfs-actions.pod:1010 ../src/guestfs-actions.pod:3367 ../fish/guestfish-actions.pod:684 ../fish/guestfish-actions.pod:2341 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 " @@ -6777,12 +6898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1010 +#: ../src/guestfs-actions.pod:1018 msgid "guestfs_command" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1012 +#: ../src/guestfs-actions.pod:1020 #, no-wrap msgid "" " char *\n" @@ -6792,7 +6913,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1016 ../fish/guestfish-actions.pod:685 +#: ../src/guestfs-actions.pod:1024 ../fish/guestfish-actions.pod:692 msgid "" "This call runs a command from the guest filesystem. The filesystem must be " "mounted, and must contain a compatible operating system (ie. something " @@ -6800,7 +6921,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1021 +#: ../src/guestfs-actions.pod:1029 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 " @@ -6810,12 +6931,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1028 ../fish/guestfish-actions.pod:697 +#: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:704 msgid "The return value is anything printed to I<stdout> by the command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1031 ../fish/guestfish-actions.pod:700 +#: ../src/guestfs-actions.pod:1039 ../fish/guestfish-actions.pod:707 msgid "" "If the command returns a non-zero exit status, then this function returns an " "error message. The error message string is the content of I<stderr> from " @@ -6823,7 +6944,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1035 ../fish/guestfish-actions.pod:704 +#: ../src/guestfs-actions.pod:1043 ../fish/guestfish-actions.pod:711 msgid "" "The C<$PATH> environment variable will contain at least C</usr/bin> and " "C</bin>. If you require a program from another location, you should provide " @@ -6831,7 +6952,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1040 ../fish/guestfish-actions.pod:709 +#: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716 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 " @@ -6840,17 +6961,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1052 ../src/guestfs-actions.pod:1072 ../src/guestfs-actions.pod:1535 +#: ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1080 ../src/guestfs-actions.pod:1543 msgid "(Added in 0.9.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1054 +#: ../src/guestfs-actions.pod:1062 msgid "guestfs_command_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1056 +#: ../src/guestfs-actions.pod:1064 #, no-wrap msgid "" " char **\n" @@ -6860,24 +6981,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1060 +#: ../src/guestfs-actions.pod:1068 msgid "" "This is the same as C<guestfs_command>, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1063 +#: ../src/guestfs-actions.pod:1071 msgid "See also: C<guestfs_sh_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1074 +#: ../src/guestfs-actions.pod:1082 msgid "guestfs_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1076 +#: ../src/guestfs-actions.pod:1084 #, no-wrap msgid "" " int\n" @@ -6888,7 +7009,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1081 ../fish/guestfish-actions.pod:734 +#: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:741 msgid "" "This can be used to add arbitrary qemu command line parameters of the form " "C<-param value>. Actually it's not quite arbitrary - we prevent you from " @@ -6896,22 +7017,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1086 ../fish/guestfish-actions.pod:739 +#: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746 msgid "The first character of C<param> string must be a C<-> (dash)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1088 ../fish/guestfish-actions.pod:741 +#: ../src/guestfs-actions.pod:1096 ../fish/guestfish-actions.pod:748 msgid "C<value> can be NULL." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1094 +#: ../src/guestfs-actions.pod:1102 msgid "guestfs_copy_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1096 +#: ../src/guestfs-actions.pod:1104 #, no-wrap msgid "" " int\n" @@ -6923,21 +7044,21 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1102 ../fish/guestfish-actions.pod:747 +#: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:754 msgid "" "This command copies exactly C<size> bytes from one source device or file " "C<src> to another destination device or file C<dest>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1105 ../fish/guestfish-actions.pod:750 +#: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:757 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:1110 ../src/guestfs-actions.pod:1233 ../src/guestfs-actions.pod:1264 ../src/guestfs-actions.pod:1684 ../src/guestfs-actions.pod:1706 ../src/guestfs-actions.pod:6643 ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7175 +#: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:1272 ../src/guestfs-actions.pod:1692 ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:6689 ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:7202 ../src/guestfs-actions.pod:7221 msgid "" "This long-running command can generate progress notification messages so " "that the caller can display a progress bar or indicator. To receive these " @@ -6946,17 +7067,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:4017 ../src/guestfs-actions.pod:5235 ../src/guestfs-actions.pod:6884 ../src/guestfs-actions.pod:6904 ../src/guestfs-actions.pod:6990 +#: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:4035 ../src/guestfs-actions.pod:5253 ../src/guestfs-actions.pod:6930 ../src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:7036 msgid "(Added in 1.0.87)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1117 +#: ../src/guestfs-actions.pod:1125 msgid "guestfs_cp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1119 +#: ../src/guestfs-actions.pod:1127 #, no-wrap msgid "" " int\n" @@ -6967,24 +7088,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1124 ../fish/guestfish-actions.pod:757 +#: ../src/guestfs-actions.pod:1132 ../fish/guestfish-actions.pod:764 msgid "" "This copies a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1215 ../src/guestfs-actions.pod:1289 ../src/guestfs-actions.pod:1398 ../src/guestfs-actions.pod:4702 ../src/guestfs-actions.pod:5079 +#: ../src/guestfs-actions.pod:1137 ../src/guestfs-actions.pod:1151 ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1297 ../src/guestfs-actions.pod:1406 ../src/guestfs-actions.pod:4720 ../src/guestfs-actions.pod:5097 msgid "(Added in 1.0.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1131 +#: ../src/guestfs-actions.pod:1139 msgid "guestfs_cp_a" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1133 +#: ../src/guestfs-actions.pod:1141 #, no-wrap msgid "" " int\n" @@ -6995,19 +7116,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1138 ../fish/guestfish-actions.pod:764 +#: ../src/guestfs-actions.pod:1146 ../fish/guestfish-actions.pod:771 msgid "" "This copies a file or directory from C<src> to C<dest> recursively using the " "C<cp -a> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1145 +#: ../src/guestfs-actions.pod:1153 msgid "guestfs_dd" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1147 +#: ../src/guestfs-actions.pod:1155 #, no-wrap msgid "" " int\n" @@ -7018,7 +7139,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1152 ../fish/guestfish-actions.pod:771 +#: ../src/guestfs-actions.pod:1160 ../fish/guestfish-actions.pod:778 msgid "" "This command copies from one source device or file C<src> to another " "destination device or file C<dest>. Normally you would use this to copy to " @@ -7026,7 +7147,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1157 +#: ../src/guestfs-actions.pod:1165 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 " @@ -7034,12 +7155,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1165 +#: ../src/guestfs-actions.pod:1173 msgid "guestfs_df" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1167 +#: ../src/guestfs-actions.pod:1175 #, no-wrap msgid "" " char *\n" @@ -7048,12 +7169,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1170 ../fish/guestfish-actions.pod:784 +#: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:791 msgid "This command runs the C<df> command to report disk space used." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1172 ../src/guestfs-actions.pod:1189 +#: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1197 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use C<guestfs_statvfs> " @@ -7061,17 +7182,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1179 ../src/guestfs-actions.pod:1196 ../src/guestfs-actions.pod:1309 ../src/guestfs-actions.pod:2263 ../src/guestfs-actions.pod:2287 ../src/guestfs-actions.pod:2355 ../src/guestfs-actions.pod:4127 ../src/guestfs-actions.pod:4602 ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6405 ../src/guestfs-actions.pod:7023 ../src/guestfs-actions.pod:7036 ../src/guestfs-actions.pod:7049 +#: ../src/guestfs-actions.pod:1187 ../src/guestfs-actions.pod:1204 ../src/guestfs-actions.pod:1317 ../src/guestfs-actions.pod:2281 ../src/guestfs-actions.pod:2305 ../src/guestfs-actions.pod:2373 ../src/guestfs-actions.pod:4145 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:6427 ../src/guestfs-actions.pod:6451 ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7082 ../src/guestfs-actions.pod:7095 msgid "(Added in 1.0.54)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1181 +#: ../src/guestfs-actions.pod:1189 msgid "guestfs_df_h" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1183 +#: ../src/guestfs-actions.pod:1191 #, no-wrap msgid "" " char *\n" @@ -7080,19 +7201,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1186 ../fish/guestfish-actions.pod:794 +#: ../src/guestfs-actions.pod:1194 ../fish/guestfish-actions.pod:801 msgid "" "This command runs the C<df -h> command to report disk space used in " "human-readable format." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1198 +#: ../src/guestfs-actions.pod:1206 msgid "guestfs_dmesg" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1200 +#: ../src/guestfs-actions.pod:1208 #, no-wrap msgid "" " char *\n" @@ -7101,14 +7222,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1203 ../fish/guestfish-actions.pod:805 +#: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:812 msgid "" "This returns the kernel messages (C<dmesg> output) from the guest kernel. " "This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1207 +#: ../src/guestfs-actions.pod:1215 msgid "" "Another way to get the same information is to enable verbose messages with " "C<guestfs_set_verbose> or by setting the environment variable " @@ -7116,12 +7237,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1217 +#: ../src/guestfs-actions.pod:1225 msgid "guestfs_download" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1219 +#: ../src/guestfs-actions.pod:1227 #, no-wrap msgid "" " int\n" @@ -7132,29 +7253,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1224 ../src/guestfs-actions.pod:1249 ../fish/guestfish-actions.pod:818 ../fish/guestfish-actions.pod:831 +#: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:1257 ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:838 msgid "" "Download file C<remotefilename> and save it as C<filename> on the local " "machine." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1227 ../src/guestfs-actions.pod:6637 ../fish/guestfish-actions.pod:821 ../fish/guestfish-actions.pod:4447 +#: ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:6683 ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:4486 msgid "C<filename> can also be a named pipe." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1229 +#: ../src/guestfs-actions.pod:1237 msgid "See also C<guestfs_upload>, C<guestfs_cat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1240 +#: ../src/guestfs-actions.pod:1248 msgid "guestfs_download_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1242 +#: ../src/guestfs-actions.pod:1250 #, no-wrap msgid "" " int\n" @@ -7167,14 +7288,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1252 ../fish/guestfish-actions.pod:834 +#: ../src/guestfs-actions.pod:1260 ../fish/guestfish-actions.pod:841 msgid "" "C<remotefilename> is read for C<size> bytes starting at C<offset> (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1255 +#: ../src/guestfs-actions.pod:1263 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with C<guestfs_pread>, and this call always reads the " @@ -7182,22 +7303,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1260 +#: ../src/guestfs-actions.pod:1268 msgid "See also C<guestfs_download>, C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:6682 +#: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:6728 msgid "(Added in 1.5.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1271 +#: ../src/guestfs-actions.pod:1279 msgid "guestfs_drop_caches" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1273 +#: ../src/guestfs-actions.pod:1281 #, no-wrap msgid "" " int\n" @@ -7207,7 +7328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1277 ../fish/guestfish-actions.pod:850 +#: ../src/guestfs-actions.pod:1285 ../fish/guestfish-actions.pod:857 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C<whattodrop> tells the kernel what precisely " @@ -7215,24 +7336,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1282 ../fish/guestfish-actions.pod:855 +#: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862 msgid "Setting C<whattodrop> to 3 should drop everything." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1284 ../fish/guestfish-actions.pod:857 +#: ../src/guestfs-actions.pod:1292 ../fish/guestfish-actions.pod:864 msgid "" "This automatically calls L<sync(2)> before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1291 +#: ../src/guestfs-actions.pod:1299 msgid "guestfs_du" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1293 +#: ../src/guestfs-actions.pod:1301 #, no-wrap msgid "" " int64_t\n" @@ -7242,14 +7363,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1297 ../fish/guestfish-actions.pod:864 +#: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:871 msgid "" "This command runs the C<du -s> command to estimate file space usage for " "C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1300 ../fish/guestfish-actions.pod:867 +#: ../src/guestfs-actions.pod:1308 ../fish/guestfish-actions.pod:874 msgid "" "C<path> can be a file or a directory. If C<path> is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -7257,17 +7378,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1304 ../fish/guestfish-actions.pod:871 +#: ../src/guestfs-actions.pod:1312 ../fish/guestfish-actions.pod:878 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1311 +#: ../src/guestfs-actions.pod:1319 msgid "guestfs_e2fsck_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1313 +#: ../src/guestfs-actions.pod:1321 #, no-wrap msgid "" " int\n" @@ -7277,7 +7398,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1317 ../fish/guestfish-actions.pod:878 +#: ../src/guestfs-actions.pod:1325 ../fish/guestfish-actions.pod:885 msgid "" "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker " "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be " @@ -7285,24 +7406,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1321 +#: ../src/guestfs-actions.pod:1329 msgid "" "This command is only needed because of C<guestfs_resize2fs> (q.v.). " "Normally you should use C<guestfs_fsck>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1326 +#: ../src/guestfs-actions.pod:1334 msgid "(Added in 1.0.29)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1328 +#: ../src/guestfs-actions.pod:1336 msgid "guestfs_echo_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1330 +#: ../src/guestfs-actions.pod:1338 #, no-wrap msgid "" " char *\n" @@ -7312,34 +7433,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1334 ../fish/guestfish-actions.pod:889 +#: ../src/guestfs-actions.pod:1342 ../fish/guestfish-actions.pod:896 msgid "" "This command concatenates the list of C<words> passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1337 ../fish/guestfish-actions.pod:892 +#: ../src/guestfs-actions.pod:1345 ../fish/guestfish-actions.pod:899 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1339 +#: ../src/guestfs-actions.pod:1347 msgid "See also C<guestfs_ping_daemon>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1344 ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:5885 +#: ../src/guestfs-actions.pod:1352 ../src/guestfs-actions.pod:2089 ../src/guestfs-actions.pod:5931 msgid "(Added in 1.0.69)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1346 +#: ../src/guestfs-actions.pod:1354 msgid "guestfs_egrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1348 +#: ../src/guestfs-actions.pod:1356 #, no-wrap msgid "" " char **\n" @@ -7350,22 +7471,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1353 ../fish/guestfish-actions.pod:900 +#: ../src/guestfs-actions.pod:1361 ../fish/guestfish-actions.pod:907 msgid "This calls the external C<egrep> program and returns the matching lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1363 ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1439 ../src/guestfs-actions.pod:1485 ../src/guestfs-actions.pod:1504 ../src/guestfs-actions.pod:2201 ../src/guestfs-actions.pod:2220 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2389 ../src/guestfs-actions.pod:2404 ../src/guestfs-actions.pod:2450 ../src/guestfs-actions.pod:2472 ../src/guestfs-actions.pod:2485 ../src/guestfs-actions.pod:3510 ../src/guestfs-actions.pod:3524 ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3551 ../src/guestfs-actions.pod:4537 ../src/guestfs-actions.pod:5413 ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:6249 ../src/guestfs-actions.pod:6261 ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6287 ../src/guestfs-actions.pod:6309 ../src/guestfs-actions.pod:6322 ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:6348 ../src/guestfs-actions.pod:7119 ../src/guestfs-actions.pod:7138 ../src/guestfs-actions.pod:7223 ../src/guestfs-actions.pod:7242 ../src/guestfs-actions.pod:7288 ../src/guestfs-actions.pod:7307 +#: ../src/guestfs-actions.pod:1371 ../src/guestfs-actions.pod:1390 ../src/guestfs-actions.pod:1447 ../src/guestfs-actions.pod:1493 ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2394 ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:2422 ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2490 ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:3528 ../src/guestfs-actions.pod:3542 ../src/guestfs-actions.pod:3555 ../src/guestfs-actions.pod:3569 ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:5431 ../src/guestfs-actions.pod:5480 ../src/guestfs-actions.pod:6295 ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6333 ../src/guestfs-actions.pod:6355 ../src/guestfs-actions.pod:6368 ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6394 ../src/guestfs-actions.pod:7165 ../src/guestfs-actions.pod:7184 ../src/guestfs-actions.pod:7269 ../src/guestfs-actions.pod:7288 ../src/guestfs-actions.pod:7334 ../src/guestfs-actions.pod:7353 msgid "(Added in 1.0.66)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1365 +#: ../src/guestfs-actions.pod:1373 msgid "guestfs_egrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1367 +#: ../src/guestfs-actions.pod:1375 #, no-wrap msgid "" " char **\n" @@ -7376,17 +7497,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1372 ../fish/guestfish-actions.pod:910 +#: ../src/guestfs-actions.pod:1380 ../fish/guestfish-actions.pod:917 msgid "This calls the external C<egrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1384 +#: ../src/guestfs-actions.pod:1392 msgid "guestfs_equal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1386 +#: ../src/guestfs-actions.pod:1394 #, no-wrap msgid "" " int\n" @@ -7397,24 +7518,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1391 ../fish/guestfish-actions.pod:920 +#: ../src/guestfs-actions.pod:1399 ../fish/guestfish-actions.pod:927 msgid "" "This compares the two files C<file1> and C<file2> and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1394 ../fish/guestfish-actions.pod:923 +#: ../src/guestfs-actions.pod:1402 ../fish/guestfish-actions.pod:930 msgid "The external L<cmp(1)> program is used for the comparison." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1400 +#: ../src/guestfs-actions.pod:1408 msgid "guestfs_exists" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1402 +#: ../src/guestfs-actions.pod:1410 #, no-wrap msgid "" " int\n" @@ -7424,24 +7545,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1406 ../fish/guestfish-actions.pod:929 +#: ../src/guestfs-actions.pod:1414 ../fish/guestfish-actions.pod:936 msgid "" "This returns C<true> if and only if there is a file, directory (or anything) " "with the given C<path> name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1409 +#: ../src/guestfs-actions.pod:1417 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1415 +#: ../src/guestfs-actions.pod:1423 msgid "guestfs_fallocate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1417 +#: ../src/guestfs-actions.pod:1425 #, no-wrap msgid "" " int\n" @@ -7452,33 +7573,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:1448 ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:957 +#: ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1456 ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:964 msgid "" "This command preallocates a file (containing zero bytes) named C<path> of " "size C<len> bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1426 ../fish/guestfish-actions.pod:942 +#: ../src/guestfs-actions.pod:1434 ../fish/guestfish-actions.pod:949 msgid "" "Do not confuse this with the guestfish-specific C<alloc> command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1432 ../fish/guestfish-actions.pod:946 +#: ../src/guestfs-actions.pod:1440 ../fish/guestfish-actions.pod:953 msgid "" "This function is deprecated. In new code, use the C<fallocate64> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1441 +#: ../src/guestfs-actions.pod:1449 msgid "guestfs_fallocate64" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1443 +#: ../src/guestfs-actions.pod:1451 #, no-wrap msgid "" " int\n" @@ -7489,14 +7610,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1452 +#: ../src/guestfs-actions.pod:1460 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use C<guestfs_truncate_size> instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1455 +#: ../src/guestfs-actions.pod:1463 msgid "" "The deprecated call C<guestfs_fallocate> does the same, but owing to an " "oversight it only allowed 30 bit lengths to be specified, effectively " @@ -7504,24 +7625,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1460 ../fish/guestfish-actions.pod:969 +#: ../src/guestfs-actions.pod:1468 ../fish/guestfish-actions.pod:976 msgid "" "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> " "commands which create a file in the host and attach it as a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1466 +#: ../src/guestfs-actions.pod:1474 msgid "(Added in 1.3.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1468 +#: ../src/guestfs-actions.pod:1476 msgid "guestfs_fgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1470 +#: ../src/guestfs-actions.pod:1478 #, no-wrap msgid "" " char **\n" @@ -7532,17 +7653,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1475 ../fish/guestfish-actions.pod:977 +#: ../src/guestfs-actions.pod:1483 ../fish/guestfish-actions.pod:984 msgid "This calls the external C<fgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1487 +#: ../src/guestfs-actions.pod:1495 msgid "guestfs_fgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1489 +#: ../src/guestfs-actions.pod:1497 #, no-wrap msgid "" " char **\n" @@ -7553,17 +7674,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1494 ../fish/guestfish-actions.pod:987 +#: ../src/guestfs-actions.pod:1502 ../fish/guestfish-actions.pod:994 msgid "This calls the external C<fgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1506 +#: ../src/guestfs-actions.pod:1514 msgid "guestfs_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1508 +#: ../src/guestfs-actions.pod:1516 #, no-wrap msgid "" " char *\n" @@ -7573,28 +7694,28 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1512 ../fish/guestfish-actions.pod:997 +#: ../src/guestfs-actions.pod:1520 ../fish/guestfish-actions.pod:1004 msgid "" "This call uses the standard L<file(1)> command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1515 ../fish/guestfish-actions.pod:1000 +#: ../src/guestfs-actions.pod:1523 ../fish/guestfish-actions.pod:1007 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1518 ../fish/guestfish-actions.pod:1003 +#: ../src/guestfs-actions.pod:1526 ../fish/guestfish-actions.pod:1010 msgid "" "The exact command which runs is C<file -zb path>. Note in particular that " "the filename is not prepended to the output (the C<-b> option)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1522 +#: ../src/guestfs-actions.pod:1530 msgid "" "This command can also be used on C</dev/> devices (and partitions, LV " "names). You can for example use this to determine if a device contains a " @@ -7602,7 +7723,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1527 ../fish/guestfish-actions.pod:1012 +#: ../src/guestfs-actions.pod:1535 ../fish/guestfish-actions.pod:1019 msgid "" "If the C<path> does not begin with C</dev/> then this command only works for " "the content of regular files. For other file types (directory, symbolic " @@ -7610,12 +7731,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1537 +#: ../src/guestfs-actions.pod:1545 msgid "guestfs_file_architecture" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1539 +#: ../src/guestfs-actions.pod:1547 #, no-wrap msgid "" " char *\n" @@ -7625,166 +7746,166 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1543 ../fish/guestfish-actions.pod:1021 +#: ../src/guestfs-actions.pod:1551 ../fish/guestfish-actions.pod:1028 msgid "" "This detects the architecture of the binary C<filename>, and returns it if " "known." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1546 ../fish/guestfish-actions.pod:1024 +#: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1031 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1550 ../fish/guestfish-actions.pod:1028 +#: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1035 msgid "\"i386\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1552 ../fish/guestfish-actions.pod:1030 +#: ../src/guestfs-actions.pod:1560 ../fish/guestfish-actions.pod:1037 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:1555 ../fish/guestfish-actions.pod:1033 +#: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1040 msgid "\"x86_64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1557 ../fish/guestfish-actions.pod:1035 +#: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1042 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1037 +#: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1044 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1039 +#: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1046 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1041 +#: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1048 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1043 +#: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1050 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1045 +#: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1052 msgid "\"ia64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1047 +#: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1054 msgid "Intel Itanium." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1049 +#: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1056 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1051 +#: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1058 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1053 +#: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1060 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1055 +#: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1062 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1059 +#: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1066 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1061 +#: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1068 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1067 +#: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1074 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1071 +#: ../src/guestfs-actions.pod:1601 ../fish/guestfish-actions.pod:1078 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1075 +#: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1082 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1601 ../fish/guestfish-actions.pod:1079 +#: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1086 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1603 ../fish/guestfish-actions.pod:1081 +#: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1088 msgid "Win32 binaries and DLLs return C<i386>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1083 +#: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1090 msgid "Win64 binaries and DLLs return C<x86_64>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1087 +#: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1094 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1091 +#: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1098 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1095 +#: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1102 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1099 +#: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1106 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1627 ../fish/guestfish-actions.pod:1105 +#: ../src/guestfs-actions.pod:1635 ../fish/guestfish-actions.pod:1112 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1631 ../fish/guestfish-actions.pod:1109 +#: ../src/guestfs-actions.pod:1639 ../fish/guestfish-actions.pod:1116 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1635 ../fish/guestfish-actions.pod:1113 +#: ../src/guestfs-actions.pod:1643 ../fish/guestfish-actions.pod:1120 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1115 +#: ../src/guestfs-actions.pod:1645 ../fish/guestfish-actions.pod:1122 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 " @@ -7793,17 +7914,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1647 ../src/guestfs-actions.pod:1810 ../src/guestfs-actions.pod:1827 ../src/guestfs-actions.pod:2508 ../src/guestfs-actions.pod:2589 ../src/guestfs-actions.pod:2615 ../src/guestfs-actions.pod:2703 ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2761 ../src/guestfs-actions.pod:2845 ../src/guestfs-actions.pod:2907 ../src/guestfs-actions.pod:3133 ../src/guestfs-actions.pod:3265 +#: ../src/guestfs-actions.pod:1655 ../src/guestfs-actions.pod:1818 ../src/guestfs-actions.pod:1835 ../src/guestfs-actions.pod:2526 ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2633 ../src/guestfs-actions.pod:2721 ../src/guestfs-actions.pod:2742 ../src/guestfs-actions.pod:2779 ../src/guestfs-actions.pod:2863 ../src/guestfs-actions.pod:2925 ../src/guestfs-actions.pod:3151 ../src/guestfs-actions.pod:3283 msgid "(Added in 1.5.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1649 +#: ../src/guestfs-actions.pod:1657 msgid "guestfs_filesize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1651 +#: ../src/guestfs-actions.pod:1659 #, no-wrap msgid "" " int64_t\n" @@ -7813,12 +7934,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1655 ../fish/guestfish-actions.pod:1126 +#: ../src/guestfs-actions.pod:1663 ../fish/guestfish-actions.pod:1133 msgid "This command returns the size of C<file> in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1657 +#: ../src/guestfs-actions.pod:1665 msgid "" "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, " "C<guestfs_is_dir>, C<guestfs_is_file> etc. To get the size of block " @@ -7826,17 +7947,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1663 +#: ../src/guestfs-actions.pod:1671 msgid "(Added in 1.0.82)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1665 +#: ../src/guestfs-actions.pod:1673 msgid "guestfs_fill" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1667 +#: ../src/guestfs-actions.pod:1675 #, no-wrap msgid "" " int\n" @@ -7848,7 +7969,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1673 ../fish/guestfish-actions.pod:1136 +#: ../src/guestfs-actions.pod:1681 ../fish/guestfish-actions.pod:1143 msgid "" "This command creates a new file called C<path>. The initial content of the " "file is C<len> octets of C<c>, where C<c> must be a number in the range " @@ -7856,7 +7977,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1677 +#: ../src/guestfs-actions.pod:1685 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "C<guestfs_truncate_size>. To create a file with a pattern of repeating " @@ -7864,17 +7985,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1689 +#: ../src/guestfs-actions.pod:1697 msgid "(Added in 1.0.79)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1691 +#: ../src/guestfs-actions.pod:1699 msgid "guestfs_fill_pattern" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1693 +#: ../src/guestfs-actions.pod:1701 #, no-wrap msgid "" " int\n" @@ -7886,7 +8007,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1699 +#: ../src/guestfs-actions.pod:1707 msgid "" "This function is like C<guestfs_fill> except that it creates a new file of " "length C<len> containing the repeating pattern of bytes in C<pattern>. The " @@ -7895,17 +8016,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1711 +#: ../src/guestfs-actions.pod:1719 msgid "(Added in 1.3.12)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1713 +#: ../src/guestfs-actions.pod:1721 msgid "guestfs_find" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1715 +#: ../src/guestfs-actions.pod:1723 #, no-wrap msgid "" " char **\n" @@ -7915,7 +8036,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1719 ../fish/guestfish-actions.pod:1158 +#: ../src/guestfs-actions.pod:1727 ../fish/guestfish-actions.pod:1165 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>. It is essentially equivalent to running the shell command " @@ -7924,14 +8045,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1724 ../fish/guestfish-actions.pod:1163 +#: ../src/guestfs-actions.pod:1732 ../fish/guestfish-actions.pod:1170 msgid "" "This returns a list of strings I<without any prefix>. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1727 ../fish/guestfish-actions.pod:1166 +#: ../src/guestfs-actions.pod:1735 ../fish/guestfish-actions.pod:1173 #, no-wrap msgid "" " /tmp/a\n" @@ -7941,12 +8062,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1731 +#: ../src/guestfs-actions.pod:1739 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1734 ../fish/guestfish-actions.pod:1173 +#: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1180 #, no-wrap msgid "" " a\n" @@ -7957,32 +8078,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1739 ../fish/guestfish-actions.pod:1178 +#: ../src/guestfs-actions.pod:1747 ../fish/guestfish-actions.pod:1185 msgid "If C<directory> is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1181 +#: ../src/guestfs-actions.pod:1750 ../fish/guestfish-actions.pod:1188 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1744 +#: ../src/guestfs-actions.pod:1752 msgid "See also C<guestfs_find0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1753 ../src/guestfs-actions.pod:3954 ../src/guestfs-actions.pod:5497 +#: ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:3972 ../src/guestfs-actions.pod:5515 msgid "(Added in 1.0.27)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1755 +#: ../src/guestfs-actions.pod:1763 msgid "guestfs_find0" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1757 +#: ../src/guestfs-actions.pod:1765 #, no-wrap msgid "" " int\n" @@ -7993,7 +8114,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1762 ../fish/guestfish-actions.pod:1192 +#: ../src/guestfs-actions.pod:1770 ../fish/guestfish-actions.pod:1199 msgid "" "This command lists out all files and directories, recursively, starting at " "C<directory>, placing the resulting list in the external file called " @@ -8001,46 +8122,46 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1766 +#: ../src/guestfs-actions.pod:1774 msgid "" "This command works the same way as C<guestfs_find> with the following " "exceptions:" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1773 ../fish/guestfish-actions.pod:1203 +#: ../src/guestfs-actions.pod:1781 ../fish/guestfish-actions.pod:1210 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1777 ../fish/guestfish-actions.pod:1207 +#: ../src/guestfs-actions.pod:1785 ../fish/guestfish-actions.pod:1214 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L<find(1)> option I<-print0>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1782 ../fish/guestfish-actions.pod:1212 +#: ../src/guestfs-actions.pod:1790 ../fish/guestfish-actions.pod:1219 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1787 ../fish/guestfish-actions.pod:1217 +#: ../src/guestfs-actions.pod:1795 ../fish/guestfish-actions.pod:1224 msgid "The result list is not sorted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1793 +#: ../src/guestfs-actions.pod:1801 msgid "(Added in 1.0.74)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1795 +#: ../src/guestfs-actions.pod:1803 msgid "guestfs_findfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1797 +#: ../src/guestfs-actions.pod:1805 #, no-wrap msgid "" " char *\n" @@ -8050,24 +8171,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1801 ../fish/guestfish-actions.pod:1227 +#: ../src/guestfs-actions.pod:1809 ../fish/guestfish-actions.pod:1234 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:1805 +#: ../src/guestfs-actions.pod:1813 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1812 +#: ../src/guestfs-actions.pod:1820 msgid "guestfs_findfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1814 +#: ../src/guestfs-actions.pod:1822 #, no-wrap msgid "" " char *\n" @@ -8077,24 +8198,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1818 ../fish/guestfish-actions.pod:1237 +#: ../src/guestfs-actions.pod:1826 ../fish/guestfish-actions.pod:1244 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:1822 +#: ../src/guestfs-actions.pod:1830 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1829 +#: ../src/guestfs-actions.pod:1837 msgid "guestfs_fsck" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1831 +#: ../src/guestfs-actions.pod:1839 #, no-wrap msgid "" " int\n" @@ -8105,53 +8226,53 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1836 ../fish/guestfish-actions.pod:1247 +#: ../src/guestfs-actions.pod:1844 ../fish/guestfish-actions.pod:1254 msgid "" "This runs the filesystem checker (fsck) on C<device> which should have " "filesystem type C<fstype>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1839 ../fish/guestfish-actions.pod:1250 +#: ../src/guestfs-actions.pod:1847 ../fish/guestfish-actions.pod:1257 msgid "" "The returned integer is the status. See L<fsck(8)> for the list of status " "codes from C<fsck>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1848 ../fish/guestfish-actions.pod:1259 +#: ../src/guestfs-actions.pod:1856 ../fish/guestfish-actions.pod:1266 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1263 +#: ../src/guestfs-actions.pod:1860 ../fish/guestfish-actions.pod:1270 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:1857 ../fish/guestfish-actions.pod:1268 +#: ../src/guestfs-actions.pod:1865 ../fish/guestfish-actions.pod:1275 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1862 ../fish/guestfish-actions.pod:1273 +#: ../src/guestfs-actions.pod:1870 ../fish/guestfish-actions.pod:1280 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:7161 +#: ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:7207 msgid "(Added in 1.0.16)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1868 +#: ../src/guestfs-actions.pod:1876 msgid "guestfs_get_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1870 +#: ../src/guestfs-actions.pod:1878 #, no-wrap msgid "" " const char *\n" @@ -8160,19 +8281,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1873 ../fish/guestfish-actions.pod:1279 +#: ../src/guestfs-actions.pod:1881 ../fish/guestfish-actions.pod:1286 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1876 ../fish/guestfish-actions.pod:1282 +#: ../src/guestfs-actions.pod:1884 ../fish/guestfish-actions.pod:1289 msgid "If C<NULL> then no options are added." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1878 +#: ../src/guestfs-actions.pod:1886 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 " @@ -8180,17 +8301,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:5175 ../src/guestfs-actions.pod:5655 ../src/guestfs-actions.pod:6023 ../src/guestfs-actions.pod:6042 ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6075 ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6850 ../src/guestfs-actions.pod:7204 +#: ../src/guestfs-actions.pod:1890 ../src/guestfs-actions.pod:5193 ../src/guestfs-actions.pod:5673 ../src/guestfs-actions.pod:6069 ../src/guestfs-actions.pod:6088 ../src/guestfs-actions.pod:6104 ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6878 ../src/guestfs-actions.pod:6896 ../src/guestfs-actions.pod:7250 msgid "(Added in 1.0.26)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1884 +#: ../src/guestfs-actions.pod:1892 +msgid "guestfs_get_attach_method" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:1894 +#, no-wrap +msgid "" +" char *\n" +" guestfs_get_attach_method (guestfs_h *g);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:1897 +msgid "Return the current attach method. See C<guestfs_set_attach_method>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:1902 msgid "guestfs_get_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1886 +#: ../src/guestfs-actions.pod:1904 #, no-wrap msgid "" " int\n" @@ -8199,17 +8339,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1889 ../fish/guestfish-actions.pod:1288 +#: ../src/guestfs-actions.pod:1907 ../fish/guestfish-actions.pod:1301 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1895 +#: ../src/guestfs-actions.pod:1913 msgid "guestfs_get_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1897 +#: ../src/guestfs-actions.pod:1915 #, no-wrap msgid "" " int\n" @@ -8218,22 +8358,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1900 ../fish/guestfish-actions.pod:1294 +#: ../src/guestfs-actions.pod:1918 ../fish/guestfish-actions.pod:1307 msgid "Return the direct appliance mode flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:5696 +#: ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:5742 msgid "(Added in 1.0.72)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1906 +#: ../src/guestfs-actions.pod:1924 msgid "guestfs_get_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1908 +#: ../src/guestfs-actions.pod:1926 #, no-wrap msgid "" " char *\n" @@ -8243,29 +8383,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1912 ../fish/guestfish-actions.pod:1300 +#: ../src/guestfs-actions.pod:1930 ../fish/guestfish-actions.pod:1313 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1918 ../fish/guestfish-actions.pod:1303 +#: ../src/guestfs-actions.pod:1936 ../fish/guestfish-actions.pod:1316 msgid "" "This function is deprecated. In new code, use the C<vfs_label> call " "instead." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:5714 ../src/guestfs-actions.pod:5733 +#: ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:1964 ../src/guestfs-actions.pod:5760 ../src/guestfs-actions.pod:5779 msgid "(Added in 1.0.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1927 +#: ../src/guestfs-actions.pod:1945 msgid "guestfs_get_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1929 +#: ../src/guestfs-actions.pod:1947 #, no-wrap msgid "" " char *\n" @@ -8275,22 +8415,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1933 ../fish/guestfish-actions.pod:1314 +#: ../src/guestfs-actions.pod:1951 ../fish/guestfish-actions.pod:1327 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1939 ../fish/guestfish-actions.pod:1317 +#: ../src/guestfs-actions.pod:1957 ../fish/guestfish-actions.pod:1330 msgid "This function is deprecated. In new code, use the C<vfs_uuid> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1948 +#: ../src/guestfs-actions.pod:1966 msgid "guestfs_get_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1950 +#: ../src/guestfs-actions.pod:1968 #, no-wrap msgid "" " int\n" @@ -8299,12 +8439,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1953 ../fish/guestfish-actions.pod:1328 +#: ../src/guestfs-actions.pod:1971 ../fish/guestfish-actions.pod:1341 msgid "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1956 +#: ../src/guestfs-actions.pod:1974 msgid "" "If C<guestfs_set_memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -8312,22 +8452,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1960 ../src/guestfs-actions.pod:2041 ../src/guestfs-actions.pod:5749 ../src/guestfs-actions.pod:5856 ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:1386 ../fish/guestfish-actions.pod:3854 ../fish/guestfish-actions.pod:3941 +#: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:2059 ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:5902 ../fish/guestfish-actions.pod:1348 ../fish/guestfish-actions.pod:1399 ../fish/guestfish-actions.pod:3893 ../fish/guestfish-actions.pod:3980 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1965 ../src/guestfs-actions.pod:4245 ../src/guestfs-actions.pod:4442 ../src/guestfs-actions.pod:4461 ../src/guestfs-actions.pod:4480 ../src/guestfs-actions.pod:4492 ../src/guestfs-actions.pod:4509 ../src/guestfs-actions.pod:4522 ../src/guestfs-actions.pod:5400 ../src/guestfs-actions.pod:5754 ../src/guestfs-actions.pod:5997 ../src/guestfs-actions.pod:6598 +#: ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:4263 ../src/guestfs-actions.pod:4460 ../src/guestfs-actions.pod:4479 ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4510 ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4540 ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:5800 ../src/guestfs-actions.pod:6043 ../src/guestfs-actions.pod:6644 msgid "(Added in 1.0.55)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1967 +#: ../src/guestfs-actions.pod:1985 msgid "guestfs_get_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1969 +#: ../src/guestfs-actions.pod:1987 #, no-wrap msgid "" " int\n" @@ -8336,22 +8476,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1972 ../fish/guestfish-actions.pod:1342 +#: ../src/guestfs-actions.pod:1990 ../fish/guestfish-actions.pod:1355 msgid "This returns the enable network flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1976 ../src/guestfs-actions.pod:5773 +#: ../src/guestfs-actions.pod:1994 ../src/guestfs-actions.pod:5819 msgid "(Added in 1.5.4)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1978 +#: ../src/guestfs-actions.pod:1996 msgid "guestfs_get_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1980 +#: ../src/guestfs-actions.pod:1998 #, no-wrap msgid "" " const char *\n" @@ -8360,31 +8500,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1983 ../fish/guestfish-actions.pod:1348 +#: ../src/guestfs-actions.pod:2001 ../fish/guestfish-actions.pod:1361 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1985 ../fish/guestfish-actions.pod:1350 +#: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1363 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:1988 ../src/guestfs-actions.pod:2017 +#: ../src/guestfs-actions.pod:2006 ../src/guestfs-actions.pod:2035 msgid "" "This function returns a string, or NULL on error. The string is owned by " "the guest handle and must I<not> be freed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:1993 +#: ../src/guestfs-actions.pod:2011 msgid "guestfs_get_pid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:1995 +#: ../src/guestfs-actions.pod:2013 #, no-wrap msgid "" " int\n" @@ -8393,29 +8533,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:1998 ../fish/guestfish-actions.pod:1359 +#: ../src/guestfs-actions.pod:2016 ../fish/guestfish-actions.pod:1372 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:2001 ../fish/guestfish-actions.pod:1362 +#: ../src/guestfs-actions.pod:2019 ../fish/guestfish-actions.pod:1375 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2005 +#: ../src/guestfs-actions.pod:2023 msgid "(Added in 1.0.56)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2007 +#: ../src/guestfs-actions.pod:2025 msgid "guestfs_get_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2009 +#: ../src/guestfs-actions.pod:2027 #, no-wrap msgid "" " const char *\n" @@ -8424,29 +8564,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2012 ../fish/guestfish-actions.pod:1368 +#: ../src/guestfs-actions.pod:2030 ../fish/guestfish-actions.pod:1381 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2014 ../fish/guestfish-actions.pod:1370 +#: ../src/guestfs-actions.pod:2032 ../fish/guestfish-actions.pod:1383 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:2020 ../src/guestfs-actions.pod:5818 +#: ../src/guestfs-actions.pod:2038 ../src/guestfs-actions.pod:5864 msgid "(Added in 1.0.6)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2022 +#: ../src/guestfs-actions.pod:2040 msgid "guestfs_get_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2024 +#: ../src/guestfs-actions.pod:2042 #, no-wrap msgid "" " int\n" @@ -8455,22 +8595,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2027 ../fish/guestfish-actions.pod:1377 +#: ../src/guestfs-actions.pod:2045 ../fish/guestfish-actions.pod:1390 msgid "Return the recovery process enabled flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2031 ../src/guestfs-actions.pod:3355 ../src/guestfs-actions.pod:3652 ../src/guestfs-actions.pod:4052 ../src/guestfs-actions.pod:4084 ../src/guestfs-actions.pod:5105 ../src/guestfs-actions.pod:5448 ../src/guestfs-actions.pod:5842 ../src/guestfs-actions.pod:6501 ../src/guestfs-actions.pod:6521 ../src/guestfs-actions.pod:6713 +#: ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:3373 ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:4070 ../src/guestfs-actions.pod:4102 ../src/guestfs-actions.pod:5123 ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5888 ../src/guestfs-actions.pod:6547 ../src/guestfs-actions.pod:6567 ../src/guestfs-actions.pod:6759 msgid "(Added in 1.0.77)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2033 +#: ../src/guestfs-actions.pod:2051 msgid "guestfs_get_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2035 +#: ../src/guestfs-actions.pod:2053 #, no-wrap msgid "" " int\n" @@ -8479,24 +8619,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2038 +#: ../src/guestfs-actions.pod:2056 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See C<guestfs_set_selinux>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:2109 ../src/guestfs-actions.pod:5861 ../src/guestfs-actions.pod:5915 +#: ../src/guestfs-actions.pod:2064 ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:5907 ../src/guestfs-actions.pod:5961 msgid "(Added in 1.0.67)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2048 +#: ../src/guestfs-actions.pod:2066 msgid "guestfs_get_state" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2050 +#: ../src/guestfs-actions.pod:2068 #, no-wrap msgid "" " int\n" @@ -8505,24 +8645,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2053 ../fish/guestfish-actions.pod:1393 +#: ../src/guestfs-actions.pod:2071 ../fish/guestfish-actions.pod:1406 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:2056 ../src/guestfs-actions.pod:3158 ../src/guestfs-actions.pod:3187 ../src/guestfs-actions.pod:3248 ../src/guestfs-actions.pod:3275 ../fish/guestfish-actions.pod:1396 ../fish/guestfish-actions.pod:2210 ../fish/guestfish-actions.pod:2228 ../fish/guestfish-actions.pod:2266 ../fish/guestfish-actions.pod:2282 +#: ../src/guestfs-actions.pod:2074 ../src/guestfs-actions.pod:3176 ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3266 ../src/guestfs-actions.pod:3293 ../fish/guestfish-actions.pod:1409 ../fish/guestfish-actions.pod:2223 ../fish/guestfish-actions.pod:2241 ../fish/guestfish-actions.pod:2279 ../fish/guestfish-actions.pod:2295 msgid "For more information on states, see L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2062 +#: ../src/guestfs-actions.pod:2080 msgid "guestfs_get_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2064 +#: ../src/guestfs-actions.pod:2082 #, no-wrap msgid "" " int\n" @@ -8531,17 +8671,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2067 ../fish/guestfish-actions.pod:1402 +#: ../src/guestfs-actions.pod:2085 ../fish/guestfish-actions.pod:1415 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2073 +#: ../src/guestfs-actions.pod:2091 msgid "guestfs_get_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2075 +#: ../src/guestfs-actions.pod:2093 #, no-wrap msgid "" " int\n" @@ -8550,19 +8690,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2078 +#: ../src/guestfs-actions.pod:2096 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling C<guestfs_umask>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2085 +#: ../src/guestfs-actions.pod:2103 msgid "guestfs_get_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2087 +#: ../src/guestfs-actions.pod:2105 #, no-wrap msgid "" " int\n" @@ -8571,17 +8711,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2090 ../fish/guestfish-actions.pod:1415 +#: ../src/guestfs-actions.pod:2108 ../fish/guestfish-actions.pod:1428 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2096 +#: ../src/guestfs-actions.pod:2114 msgid "guestfs_getcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2098 +#: ../src/guestfs-actions.pod:2116 #, no-wrap msgid "" " char *\n" @@ -8590,22 +8730,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2101 ../fish/guestfish-actions.pod:1421 +#: ../src/guestfs-actions.pod:2119 ../fish/guestfish-actions.pod:1434 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2103 +#: ../src/guestfs-actions.pod:2121 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2111 +#: ../src/guestfs-actions.pod:2129 msgid "guestfs_getxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2113 +#: ../src/guestfs-actions.pod:2131 #, no-wrap msgid "" " char *\n" @@ -8617,7 +8757,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2119 +#: ../src/guestfs-actions.pod:2137 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -8625,7 +8765,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2123 ../src/guestfs-actions.pod:3369 +#: ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:3387 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling C<guestfs_getxattrs>. However some Linux filesystem " @@ -8635,19 +8775,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2130 ../src/guestfs-actions.pod:3376 ../fish/guestfish-actions.pod:1441 ../fish/guestfish-actions.pod:2347 +#: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3394 ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:2360 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C<name>, this returns an error." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2133 +#: ../src/guestfs-actions.pod:2151 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2135 ../src/guestfs-actions.pod:2326 ../src/guestfs-actions.pod:3381 ../src/guestfs-actions.pod:5098 ../src/guestfs-actions.pod:5124 ../src/guestfs-actions.pod:5305 +#: ../src/guestfs-actions.pod:2153 ../src/guestfs-actions.pod:2344 ../src/guestfs-actions.pod:3399 ../src/guestfs-actions.pod:5116 ../src/guestfs-actions.pod:5142 ../src/guestfs-actions.pod:5323 msgid "" "This function returns a buffer, or NULL on error. The size of the returned " "buffer is written to C<*size_r>. I<The caller must free the returned buffer " @@ -8655,17 +8795,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2139 ../src/guestfs-actions.pod:3385 +#: ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:3403 msgid "(Added in 1.7.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2141 +#: ../src/guestfs-actions.pod:2159 msgid "guestfs_getxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2143 +#: ../src/guestfs-actions.pod:2161 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -8675,41 +8815,41 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2147 ../fish/guestfish-actions.pod:1450 +#: ../src/guestfs-actions.pod:2165 ../fish/guestfish-actions.pod:1463 msgid "This call lists the extended attributes of the file or directory C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2150 ../fish/guestfish-actions.pod:1453 +#: ../src/guestfs-actions.pod:2168 ../fish/guestfish-actions.pod:1466 msgid "" "At the system call level, this is a combination of the L<listxattr(2)> and " "L<getxattr(2)> calls." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2153 +#: ../src/guestfs-actions.pod:2171 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:3397 ../src/guestfs-actions.pod:4048 +#: ../src/guestfs-actions.pod:2173 ../src/guestfs-actions.pod:3415 ../src/guestfs-actions.pod:4066 msgid "" "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_xattr_list> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2159 ../src/guestfs-actions.pod:3401 ../src/guestfs-actions.pod:3566 ../src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:5478 ../src/guestfs-actions.pod:5934 ../src/guestfs-actions.pod:7269 +#: ../src/guestfs-actions.pod:2177 ../src/guestfs-actions.pod:3419 ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3620 ../src/guestfs-actions.pod:5496 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:7315 msgid "(Added in 1.0.59)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2161 +#: ../src/guestfs-actions.pod:2179 msgid "guestfs_glob_expand" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2163 +#: ../src/guestfs-actions.pod:2181 #, no-wrap msgid "" " char **\n" @@ -8719,36 +8859,36 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2167 ../fish/guestfish-actions.pod:1462 +#: ../src/guestfs-actions.pod:2185 ../fish/guestfish-actions.pod:1475 msgid "" "This command searches for all the pathnames matching C<pattern> according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2171 ../fish/guestfish-actions.pod:1466 +#: ../src/guestfs-actions.pod:2189 ../fish/guestfish-actions.pod:1479 msgid "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2174 ../fish/guestfish-actions.pod:1469 +#: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1482 msgid "" "It is just a wrapper around the C L<glob(3)> function with flags " "C<GLOB_MARK|GLOB_BRACE>. See that manual page for more details." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2182 ../src/guestfs-actions.pod:6099 ../src/guestfs-actions.pod:6116 +#: ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:6145 ../src/guestfs-actions.pod:6162 msgid "(Added in 1.0.50)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2184 +#: ../src/guestfs-actions.pod:2202 msgid "guestfs_grep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2186 +#: ../src/guestfs-actions.pod:2204 #, no-wrap msgid "" " char **\n" @@ -8759,17 +8899,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2191 ../fish/guestfish-actions.pod:1477 +#: ../src/guestfs-actions.pod:2209 ../fish/guestfish-actions.pod:1490 msgid "This calls the external C<grep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2203 +#: ../src/guestfs-actions.pod:2221 msgid "guestfs_grepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2205 +#: ../src/guestfs-actions.pod:2223 #, no-wrap msgid "" " char **\n" @@ -8780,17 +8920,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2210 ../fish/guestfish-actions.pod:1487 +#: ../src/guestfs-actions.pod:2228 ../fish/guestfish-actions.pod:1500 msgid "This calls the external C<grep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2222 +#: ../src/guestfs-actions.pod:2240 msgid "guestfs_grub_install" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2224 +#: ../src/guestfs-actions.pod:2242 #, no-wrap msgid "" " int\n" @@ -8801,14 +8941,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2229 ../fish/guestfish-actions.pod:1497 +#: ../src/guestfs-actions.pod:2247 ../fish/guestfish-actions.pod:1510 msgid "" "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with " "the root directory being C<root>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2232 ../fish/guestfish-actions.pod:1500 +#: ../src/guestfs-actions.pod:2250 ../fish/guestfish-actions.pod:1513 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 " @@ -8818,7 +8958,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2239 ../fish/guestfish-actions.pod:1507 +#: ../src/guestfs-actions.pod:2257 ../fish/guestfish-actions.pod:1520 #, no-wrap msgid "" " (hd0) /dev/vda\n" @@ -8826,22 +8966,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2241 ../fish/guestfish-actions.pod:1509 +#: ../src/guestfs-actions.pod:2259 ../fish/guestfish-actions.pod:1522 msgid "replacing C</dev/vda> with the name of the installation device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2245 +#: ../src/guestfs-actions.pod:2263 msgid "(Added in 1.0.17)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2247 +#: ../src/guestfs-actions.pod:2265 msgid "guestfs_head" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2249 +#: ../src/guestfs-actions.pod:2267 #, no-wrap msgid "" " char **\n" @@ -8851,19 +8991,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2253 ../fish/guestfish-actions.pod:1515 +#: ../src/guestfs-actions.pod:2271 ../fish/guestfish-actions.pod:1528 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:2265 +#: ../src/guestfs-actions.pod:2283 msgid "guestfs_head_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2267 +#: ../src/guestfs-actions.pod:2285 #, no-wrap msgid "" " char **\n" @@ -8874,31 +9014,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2272 ../fish/guestfish-actions.pod:1525 +#: ../src/guestfs-actions.pod:2290 ../fish/guestfish-actions.pod:1538 msgid "" "If the parameter C<nrlines> is a positive number, this returns the first " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2275 ../fish/guestfish-actions.pod:1528 +#: ../src/guestfs-actions.pod:2293 ../fish/guestfish-actions.pod:1541 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, excluding the last C<nrlines> lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:6396 ../fish/guestfish-actions.pod:1531 ../fish/guestfish-actions.pod:4287 +#: ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:6442 ../fish/guestfish-actions.pod:1544 ../fish/guestfish-actions.pod:4326 msgid "If the parameter C<nrlines> is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2289 +#: ../src/guestfs-actions.pod:2307 msgid "guestfs_hexdump" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2291 +#: ../src/guestfs-actions.pod:2309 #, no-wrap msgid "" " char *\n" @@ -8908,24 +9048,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2295 ../fish/guestfish-actions.pod:1540 +#: ../src/guestfs-actions.pod:2313 ../fish/guestfish-actions.pod:1553 msgid "" "This runs C<hexdump -C> on the given C<path>. The result is the " "human-readable, canonical hex dump of the file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:6180 ../src/guestfs-actions.pod:6235 +#: ../src/guestfs-actions.pod:2322 ../src/guestfs-actions.pod:6226 ../src/guestfs-actions.pod:6281 msgid "(Added in 1.0.22)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2306 +#: ../src/guestfs-actions.pod:2324 msgid "guestfs_initrd_cat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2308 +#: ../src/guestfs-actions.pod:2326 #, no-wrap msgid "" " char *\n" @@ -8937,7 +9077,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2314 ../fish/guestfish-actions.pod:1550 +#: ../src/guestfs-actions.pod:2332 ../fish/guestfish-actions.pod:1563 msgid "" "This command unpacks the file C<filename> from the initrd file called " "C<initrdpath>. The filename must be given I<without> the initial C</> " @@ -8945,7 +9085,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2318 ../fish/guestfish-actions.pod:1554 +#: ../src/guestfs-actions.pod:2336 ../fish/guestfish-actions.pod:1567 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C</init>) contained in a Linux initrd or " @@ -8953,7 +9093,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2322 ../fish/guestfish-actions.pod:1558 +#: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1571 #, no-wrap msgid "" " initrd-cat /boot/initrd-<version>.img init\n" @@ -8961,17 +9101,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2324 +#: ../src/guestfs-actions.pod:2342 msgid "See also C<guestfs_initrd_list>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2335 +#: ../src/guestfs-actions.pod:2353 msgid "guestfs_initrd_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2337 +#: ../src/guestfs-actions.pod:2355 #, no-wrap msgid "" " char **\n" @@ -8981,12 +9121,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2341 ../fish/guestfish-actions.pod:1569 +#: ../src/guestfs-actions.pod:2359 ../fish/guestfish-actions.pod:1582 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2343 ../fish/guestfish-actions.pod:1571 +#: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1584 msgid "" "The files are listed without any initial C</> character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -8994,7 +9134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2347 ../fish/guestfish-actions.pod:1575 +#: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1588 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I<only> support the newer initramfs format (compressed cpio " @@ -9002,12 +9142,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2357 +#: ../src/guestfs-actions.pod:2375 msgid "guestfs_inotify_add_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2359 +#: ../src/guestfs-actions.pod:2377 #, no-wrap msgid "" " int64_t\n" @@ -9018,31 +9158,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2364 ../fish/guestfish-actions.pod:1583 +#: ../src/guestfs-actions.pod:2382 ../fish/guestfish-actions.pod:1596 msgid "Watch C<path> for the events listed in C<mask>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2366 ../fish/guestfish-actions.pod:1585 +#: ../src/guestfs-actions.pod:2384 ../fish/guestfish-actions.pod:1598 msgid "" "Note that if C<path> is a directory then events within that directory are " "watched, but this does I<not> happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2370 ../fish/guestfish-actions.pod:1589 +#: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1602 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2378 +#: ../src/guestfs-actions.pod:2396 msgid "guestfs_inotify_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2380 +#: ../src/guestfs-actions.pod:2398 #, no-wrap msgid "" " int\n" @@ -9051,7 +9191,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2383 ../fish/guestfish-actions.pod:1597 +#: ../src/guestfs-actions.pod:2401 ../fish/guestfish-actions.pod:1610 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 " @@ -9059,12 +9199,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2391 +#: ../src/guestfs-actions.pod:2409 msgid "guestfs_inotify_files" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2393 +#: ../src/guestfs-actions.pod:2411 #, no-wrap msgid "" " char **\n" @@ -9073,7 +9213,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2396 +#: ../src/guestfs-actions.pod:2414 msgid "" "This function is a helpful wrapper around C<guestfs_inotify_read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -9081,12 +9221,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2406 +#: ../src/guestfs-actions.pod:2424 msgid "guestfs_inotify_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2408 +#: ../src/guestfs-actions.pod:2426 #, no-wrap msgid "" " int\n" @@ -9096,14 +9236,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2412 ../fish/guestfish-actions.pod:1613 +#: ../src/guestfs-actions.pod:2430 ../fish/guestfish-actions.pod:1626 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:2416 +#: ../src/guestfs-actions.pod:2434 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>. If this is " @@ -9115,7 +9255,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2426 +#: ../src/guestfs-actions.pod:2444 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: C<guestfs_inotify_add_watch>, " @@ -9123,7 +9263,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2432 +#: ../src/guestfs-actions.pod:2450 msgid "" "Queued up events should be read periodically by calling " "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful " @@ -9132,14 +9272,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2439 +#: ../src/guestfs-actions.pod:2457 msgid "" "The handle should be closed after use by calling C<guestfs_inotify_close>. " "This also removes any watches automatically." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2443 ../fish/guestfish-actions.pod:1644 +#: ../src/guestfs-actions.pod:2461 ../fish/guestfish-actions.pod:1657 msgid "" "See also L<inotify(7)> for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -9147,12 +9287,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2452 +#: ../src/guestfs-actions.pod:2470 msgid "guestfs_inotify_read" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2454 +#: ../src/guestfs-actions.pod:2472 #, no-wrap msgid "" " struct guestfs_inotify_event_list *\n" @@ -9161,19 +9301,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2457 ../fish/guestfish-actions.pod:1653 +#: ../src/guestfs-actions.pod:2475 ../fish/guestfish-actions.pod:1666 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2460 ../fish/guestfish-actions.pod:1656 +#: ../src/guestfs-actions.pod:2478 ../fish/guestfish-actions.pod:1669 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2462 ../fish/guestfish-actions.pod:1658 +#: ../src/guestfs-actions.pod:2480 ../fish/guestfish-actions.pod:1671 msgid "" "I<Note>: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -9182,7 +9322,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2468 +#: ../src/guestfs-actions.pod:2486 msgid "" "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if " "there was an error. I<The caller must call " @@ -9190,12 +9330,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2474 +#: ../src/guestfs-actions.pod:2492 msgid "guestfs_inotify_rm_watch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2476 +#: ../src/guestfs-actions.pod:2494 #, no-wrap msgid "" " int\n" @@ -9205,19 +9345,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2480 +#: ../src/guestfs-actions.pod:2498 msgid "" "Remove a previously defined inotify watch. See " "C<guestfs_inotify_add_watch>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2487 +#: ../src/guestfs-actions.pod:2505 msgid "guestfs_inspect_get_arch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2489 +#: ../src/guestfs-actions.pod:2507 #, no-wrap msgid "" " char *\n" @@ -9227,38 +9367,38 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2493 ../src/guestfs-actions.pod:2516 ../src/guestfs-actions.pod:2597 ../src/guestfs-actions.pod:2623 ../src/guestfs-actions.pod:2662 ../src/guestfs-actions.pod:2684 ../src/guestfs-actions.pod:2711 ../src/guestfs-actions.pod:2732 ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:2798 ../src/guestfs-actions.pod:2829 ../src/guestfs-actions.pod:2873 ../src/guestfs-actions.pod:2915 ../src/guestfs-actions.pod:2938 ../src/guestfs-actions.pod:2955 ../src/guestfs-actions.pod:2972 ../src/guestfs-actions.pod:2991 +#: ../src/guestfs-actions.pod:2511 ../src/guestfs-actions.pod:2534 ../src/guestfs-actions.pod:2615 ../src/guestfs-actions.pod:2641 ../src/guestfs-actions.pod:2680 ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2729 ../src/guestfs-actions.pod:2750 ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2891 ../src/guestfs-actions.pod:2933 ../src/guestfs-actions.pod:2956 ../src/guestfs-actions.pod:2973 ../src/guestfs-actions.pod:2990 ../src/guestfs-actions.pod:3009 msgid "" "This function should only be called with a root device string as returned by " "C<guestfs_inspect_os>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2496 +#: ../src/guestfs-actions.pod:2514 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under C<guestfs_file_architecture>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2500 ../fish/guestfish-actions.pod:1682 +#: ../src/guestfs-actions.pod:2518 ../fish/guestfish-actions.pod:1695 msgid "" "If the architecture could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:2584 ../src/guestfs-actions.pod:2651 ../src/guestfs-actions.pod:2671 ../src/guestfs-actions.pod:2699 ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2840 ../src/guestfs-actions.pod:2859 ../src/guestfs-actions.pod:2902 ../src/guestfs-actions.pod:2925 ../src/guestfs-actions.pod:2945 ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:2981 ../src/guestfs-actions.pod:3084 ../src/guestfs-actions.pod:3125 ../fish/guestfish-actions.pod:1685 ../fish/guestfish-actions.pod:1759 ../fish/guestfish-actions.pod:1811 ../fish/guestfish-actions.pod:1826 ../fish/guestfish-actions.pod:1847 ../fish/guestfish-actions.pod:1911 ../fish/guestfish-actions.pod:1935 ../fish/guestfish-actions.pod:1952 ../fish/guestfish-actions.pod:1965 ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2016 ../fish/guestfish-actions.pod:2029 ../fish/guestfish-actions.pod:2042 ../fish/guestfish-actions.pod:2057 ../fish/guestfish-actions.pod:2156 ../fish/guestfish-actions.pod:2190 +#: ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2602 ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2689 ../src/guestfs-actions.pod:2717 ../src/guestfs-actions.pod:2803 ../src/guestfs-actions.pod:2834 ../src/guestfs-actions.pod:2858 ../src/guestfs-actions.pod:2877 ../src/guestfs-actions.pod:2920 ../src/guestfs-actions.pod:2943 ../src/guestfs-actions.pod:2963 ../src/guestfs-actions.pod:2980 ../src/guestfs-actions.pod:2999 ../src/guestfs-actions.pod:3102 ../src/guestfs-actions.pod:3143 ../fish/guestfish-actions.pod:1698 ../fish/guestfish-actions.pod:1772 ../fish/guestfish-actions.pod:1824 ../fish/guestfish-actions.pod:1839 ../fish/guestfish-actions.pod:1860 ../fish/guestfish-actions.pod:1924 ../fish/guestfish-actions.pod:1948 ../fish/guestfish-actions.pod:1965 ../fish/guestfish-actions.pod:1978 ../fish/guestfish-actions.pod:2013 ../fish/guestfish-actions.pod:2029 ../fish/guestfish-actions.pod:2042 ../fish/guestfish-actions.pod:2055 ../fish/guestfish-actions.pod:2070 ../fish/guestfish-actions.pod:2169 ../fish/guestfish-actions.pod:2203 msgid "Please read L<guestfs(3)/INSPECTION> for more details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2510 +#: ../src/guestfs-actions.pod:2528 msgid "guestfs_inspect_get_distro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2512 +#: ../src/guestfs-actions.pod:2530 #, no-wrap msgid "" " char *\n" @@ -9268,161 +9408,161 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2519 ../fish/guestfish-actions.pod:1694 +#: ../src/guestfs-actions.pod:2537 ../fish/guestfish-actions.pod:1707 msgid "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2522 ../fish/guestfish-actions.pod:1697 +#: ../src/guestfs-actions.pod:2540 ../fish/guestfish-actions.pod:1710 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2526 ../fish/guestfish-actions.pod:1701 +#: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1714 msgid "\"archlinux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2528 ../fish/guestfish-actions.pod:1703 +#: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1716 msgid "Arch Linux." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2530 ../fish/guestfish-actions.pod:1705 +#: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1718 msgid "\"debian\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2532 ../fish/guestfish-actions.pod:1707 +#: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1720 msgid "Debian." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2534 ../fish/guestfish-actions.pod:1709 +#: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1722 msgid "\"fedora\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2536 ../fish/guestfish-actions.pod:1711 +#: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1724 msgid "Fedora." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2538 ../fish/guestfish-actions.pod:1713 +#: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1726 msgid "\"gentoo\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2540 ../fish/guestfish-actions.pod:1715 +#: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1728 msgid "Gentoo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2542 ../fish/guestfish-actions.pod:1717 +#: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1730 msgid "\"linuxmint\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1719 +#: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1732 msgid "Linux Mint." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1721 +#: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1734 msgid "\"mandriva\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1723 +#: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1736 msgid "Mandriva." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1725 +#: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1738 msgid "\"meego\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1727 +#: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1740 msgid "MeeGo." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1729 +#: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1742 msgid "\"pardus\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1731 +#: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1744 msgid "Pardus." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1733 +#: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1746 msgid "\"redhat-based\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1735 +#: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1748 msgid "Some Red Hat-derived distro." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1737 +#: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1750 msgid "\"rhel\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1739 +#: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1752 msgid "Red Hat Enterprise Linux and some derivatives." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1741 +#: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1754 msgid "\"ubuntu\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1743 +#: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1756 msgid "Ubuntu." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2570 ../src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:2893 ../fish/guestfish-actions.pod:1745 ../fish/guestfish-actions.pod:1802 ../fish/guestfish-actions.pod:1991 +#: ../src/guestfs-actions.pod:2588 ../src/guestfs-actions.pod:2660 ../src/guestfs-actions.pod:2911 ../fish/guestfish-actions.pod:1758 ../fish/guestfish-actions.pod:1815 ../fish/guestfish-actions.pod:2004 msgid "\"unknown\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1747 +#: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1760 msgid "The distro could not be determined." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2574 ../src/guestfs-actions.pod:2885 ../fish/guestfish-actions.pod:1749 ../fish/guestfish-actions.pod:1983 +#: ../src/guestfs-actions.pod:2592 ../src/guestfs-actions.pod:2903 ../fish/guestfish-actions.pod:1762 ../fish/guestfish-actions.pod:1996 msgid "\"windows\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1751 +#: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1764 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2581 ../src/guestfs-actions.pod:2648 ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1756 ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1997 +#: ../src/guestfs-actions.pod:2599 ../src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:2917 ../fish/guestfish-actions.pod:1769 ../fish/guestfish-actions.pod:1821 ../fish/guestfish-actions.pod:2010 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:2591 +#: ../src/guestfs-actions.pod:2609 msgid "guestfs_inspect_get_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2593 +#: ../src/guestfs-actions.pod:2611 #, no-wrap msgid "" " char **\n" @@ -9432,7 +9572,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1768 +#: ../src/guestfs-actions.pod:2618 ../fish/guestfish-actions.pod:1781 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 " @@ -9440,26 +9580,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2605 ../fish/guestfish-actions.pod:1773 +#: ../src/guestfs-actions.pod:2623 ../fish/guestfish-actions.pod:1786 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:2608 +#: ../src/guestfs-actions.pod:2626 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_mountpoints>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2617 +#: ../src/guestfs-actions.pod:2635 msgid "guestfs_inspect_get_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2619 +#: ../src/guestfs-actions.pod:2637 #, no-wrap msgid "" " char *\n" @@ -9469,51 +9609,51 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2626 ../fish/guestfish-actions.pod:1786 +#: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1799 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:2629 ../fish/guestfish-actions.pod:1789 +#: ../src/guestfs-actions.pod:2647 ../fish/guestfish-actions.pod:1802 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2633 ../fish/guestfish-actions.pod:1793 +#: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1806 msgid "\"installed\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2635 ../fish/guestfish-actions.pod:1795 +#: ../src/guestfs-actions.pod:2653 ../fish/guestfish-actions.pod:1808 msgid "This is an installed operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2637 ../fish/guestfish-actions.pod:1797 +#: ../src/guestfs-actions.pod:2655 ../fish/guestfish-actions.pod:1810 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2639 ../fish/guestfish-actions.pod:1799 +#: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1812 msgid "" "The disk image being inspected is not an installed operating system, but a " "I<bootable> install disk, live CD, or similar." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1804 +#: ../src/guestfs-actions.pod:2662 ../fish/guestfish-actions.pod:1817 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2656 +#: ../src/guestfs-actions.pod:2674 msgid "guestfs_inspect_get_hostname" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2658 +#: ../src/guestfs-actions.pod:2676 #, no-wrap msgid "" " char *\n" @@ -9523,31 +9663,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2665 ../fish/guestfish-actions.pod:1820 +#: ../src/guestfs-actions.pod:2683 ../fish/guestfish-actions.pod:1833 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:2668 ../fish/guestfish-actions.pod:1823 +#: ../src/guestfs-actions.pod:2686 ../fish/guestfish-actions.pod:1836 msgid "" "If the hostname could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2676 +#: ../src/guestfs-actions.pod:2694 msgid "(Added in 1.7.9)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2678 +#: ../src/guestfs-actions.pod:2696 msgid "guestfs_inspect_get_major_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2680 +#: ../src/guestfs-actions.pod:2698 #, no-wrap msgid "" " int\n" @@ -9557,12 +9697,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2687 ../fish/guestfish-actions.pod:1835 +#: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1848 msgid "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2690 ../fish/guestfish-actions.pod:1838 +#: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1851 msgid "" "Windows uses a consistent versioning scheme which is I<not> reflected in the " "popular public names used by the operating system. Notably the operating " @@ -9572,17 +9712,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2697 ../src/guestfs-actions.pod:2717 ../fish/guestfish-actions.pod:1845 ../fish/guestfish-actions.pod:1859 +#: ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2735 ../fish/guestfish-actions.pod:1858 ../fish/guestfish-actions.pod:1872 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2705 +#: ../src/guestfs-actions.pod:2723 msgid "guestfs_inspect_get_minor_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2707 +#: ../src/guestfs-actions.pod:2725 #, no-wrap msgid "" " int\n" @@ -9592,24 +9732,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2714 ../fish/guestfish-actions.pod:1856 +#: ../src/guestfs-actions.pod:2732 ../fish/guestfish-actions.pod:1869 msgid "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2719 +#: ../src/guestfs-actions.pod:2737 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_major_version>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2726 +#: ../src/guestfs-actions.pod:2744 msgid "guestfs_inspect_get_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2728 +#: ../src/guestfs-actions.pod:2746 #, no-wrap msgid "" " char **\n" @@ -9619,7 +9759,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2735 ../fish/guestfish-actions.pod:1871 +#: ../src/guestfs-actions.pod:2753 ../fish/guestfish-actions.pod:1884 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 " @@ -9630,7 +9770,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2744 ../fish/guestfish-actions.pod:1880 +#: ../src/guestfs-actions.pod:2762 ../fish/guestfish-actions.pod:1893 msgid "" "Each element in the returned hashtable has a key which is the path of the " "mountpoint (eg. C</boot>) and a value which is the filesystem that would be " @@ -9638,19 +9778,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2749 ../fish/guestfish-actions.pod:1885 +#: ../src/guestfs-actions.pod:2767 ../fish/guestfish-actions.pod:1898 msgid "Non-mounted devices such as swap devices are I<not> returned in this list." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2752 +#: ../src/guestfs-actions.pod:2770 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "C<guestfs_inspect_get_filesystems>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:3454 ../src/guestfs-actions.pod:4664 ../src/guestfs-actions.pod:6537 +#: ../src/guestfs-actions.pod:2773 ../src/guestfs-actions.pod:3472 ../src/guestfs-actions.pod:4682 ../src/guestfs-actions.pod:6583 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 " @@ -9659,12 +9799,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2763 +#: ../src/guestfs-actions.pod:2781 msgid "guestfs_inspect_get_package_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2765 +#: ../src/guestfs-actions.pod:2783 #, no-wrap msgid "" " char *\n" @@ -9674,7 +9814,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2772 +#: ../src/guestfs-actions.pod:2790 msgid "" "This function and C<guestfs_inspect_get_package_management> return the " "package format and package management tool used by the inspected operating " @@ -9683,7 +9823,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2778 ../fish/guestfish-actions.pod:1904 +#: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1917 msgid "" "This returns the string C<unknown> if we could not determine the package " "format I<or> if the operating system does not have a real packaging system " @@ -9691,24 +9831,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2782 ../fish/guestfish-actions.pod:1908 +#: ../src/guestfs-actions.pod:2800 ../fish/guestfish-actions.pod:1921 msgid "" "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>. " "Future versions of libguestfs may return other strings." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2790 ../src/guestfs-actions.pod:2821 +#: ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2839 msgid "(Added in 1.7.5)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2792 +#: ../src/guestfs-actions.pod:2810 msgid "guestfs_inspect_get_package_management" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2794 +#: ../src/guestfs-actions.pod:2812 #, no-wrap msgid "" " char *\n" @@ -9718,7 +9858,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2801 +#: ../src/guestfs-actions.pod:2819 msgid "" "C<guestfs_inspect_get_package_format> and this function return the package " "format and package management tool used by the inspected operating system. " @@ -9727,7 +9867,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2807 ../fish/guestfish-actions.pod:1926 +#: ../src/guestfs-actions.pod:2825 ../fish/guestfish-actions.pod:1939 msgid "" "This returns the string C<unknown> if we could not determine the package " "management tool I<or> if the operating system does not have a real packaging " @@ -9735,7 +9875,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2811 ../fish/guestfish-actions.pod:1930 +#: ../src/guestfs-actions.pod:2829 ../fish/guestfish-actions.pod:1943 msgid "" "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian " "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>. Future versions of " @@ -9743,12 +9883,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2823 +#: ../src/guestfs-actions.pod:2841 msgid "guestfs_inspect_get_product_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2825 +#: ../src/guestfs-actions.pod:2843 #, no-wrap msgid "" " char *\n" @@ -9758,7 +9898,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2832 ../fish/guestfish-actions.pod:1944 +#: ../src/guestfs-actions.pod:2850 ../fish/guestfish-actions.pod:1957 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 " @@ -9766,19 +9906,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2837 ../fish/guestfish-actions.pod:1949 +#: ../src/guestfs-actions.pod:2855 ../fish/guestfish-actions.pod:1962 msgid "" "If the product name could not be determined, then the string C<unknown> is " "returned." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2847 +#: ../src/guestfs-actions.pod:2865 msgid "guestfs_inspect_get_roots" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2849 +#: ../src/guestfs-actions.pod:2867 #, no-wrap msgid "" " char **\n" @@ -9787,7 +9927,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2852 +#: ../src/guestfs-actions.pod:2870 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to C<guestfs_inspect_os>, but without redoing " @@ -9795,24 +9935,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2856 +#: ../src/guestfs-actions.pod:2874 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called C<guestfs_inspect_os>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2865 +#: ../src/guestfs-actions.pod:2883 msgid "(Added in 1.7.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2867 +#: ../src/guestfs-actions.pod:2885 msgid "guestfs_inspect_get_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2869 +#: ../src/guestfs-actions.pod:2887 #, no-wrap msgid "" " char *\n" @@ -9822,49 +9962,49 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2876 ../fish/guestfish-actions.pod:1974 +#: ../src/guestfs-actions.pod:2894 ../fish/guestfish-actions.pod:1987 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2881 ../fish/guestfish-actions.pod:1979 +#: ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1992 msgid "\"linux\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2883 ../fish/guestfish-actions.pod:1981 +#: ../src/guestfs-actions.pod:2901 ../fish/guestfish-actions.pod:1994 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2887 ../fish/guestfish-actions.pod:1985 +#: ../src/guestfs-actions.pod:2905 ../fish/guestfish-actions.pod:1998 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:2889 ../fish/guestfish-actions.pod:1987 +#: ../src/guestfs-actions.pod:2907 ../fish/guestfish-actions.pod:2000 msgid "\"freebsd\"" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2891 ../fish/guestfish-actions.pod:1989 +#: ../src/guestfs-actions.pod:2909 ../fish/guestfish-actions.pod:2002 msgid "FreeBSD." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2895 ../fish/guestfish-actions.pod:1993 +#: ../src/guestfs-actions.pod:2913 ../fish/guestfish-actions.pod:2006 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2909 +#: ../src/guestfs-actions.pod:2927 msgid "guestfs_inspect_get_windows_systemroot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2911 +#: ../src/guestfs-actions.pod:2929 #, no-wrap msgid "" " char *\n" @@ -9874,14 +10014,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2918 ../fish/guestfish-actions.pod:2009 +#: ../src/guestfs-actions.pod:2936 ../fish/guestfish-actions.pod:2022 msgid "" "This returns the Windows systemroot of the inspected guest. The systemroot " "is a directory path such as C</WINDOWS>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2921 ../fish/guestfish-actions.pod:2012 +#: ../src/guestfs-actions.pod:2939 ../fish/guestfish-actions.pod:2025 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 " @@ -9889,17 +10029,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2930 +#: ../src/guestfs-actions.pod:2948 msgid "(Added in 1.5.25)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2932 +#: ../src/guestfs-actions.pod:2950 msgid "guestfs_inspect_is_live" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2934 +#: ../src/guestfs-actions.pod:2952 #, no-wrap msgid "" " int\n" @@ -9909,19 +10049,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2941 +#: ../src/guestfs-actions.pod:2959 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2949 +#: ../src/guestfs-actions.pod:2967 msgid "guestfs_inspect_is_multipart" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2951 +#: ../src/guestfs-actions.pod:2969 #, no-wrap msgid "" " int\n" @@ -9931,19 +10071,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2958 +#: ../src/guestfs-actions.pod:2976 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2966 +#: ../src/guestfs-actions.pod:2984 msgid "guestfs_inspect_is_netinst" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2968 +#: ../src/guestfs-actions.pod:2986 #, no-wrap msgid "" " int\n" @@ -9953,7 +10093,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2975 +#: ../src/guestfs-actions.pod:2993 msgid "" "If C<guestfs_inspect_get_format> returns C<installer> (this is an install " "disk), then this returns true if the disk is a network installer, ie. not a " @@ -9962,12 +10102,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:2985 +#: ../src/guestfs-actions.pod:3003 msgid "guestfs_inspect_list_applications" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:2987 +#: ../src/guestfs-actions.pod:3005 #, no-wrap msgid "" " struct guestfs_application_list *\n" @@ -9977,12 +10117,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2994 ../fish/guestfish-actions.pod:2066 +#: ../src/guestfs-actions.pod:3012 ../fish/guestfish-actions.pod:2079 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:2996 +#: ../src/guestfs-actions.pod:3014 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call C<guestfs_inspect_os>, then " @@ -9995,91 +10135,91 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2078 +#: ../src/guestfs-actions.pod:3024 ../fish/guestfish-actions.pod:2091 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:3009 ../fish/guestfish-actions.pod:2081 +#: ../src/guestfs-actions.pod:3027 ../fish/guestfish-actions.pod:2094 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3013 ../fish/guestfish-actions.pod:2085 +#: ../src/guestfs-actions.pod:3031 ../fish/guestfish-actions.pod:2098 msgid "C<app_name>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3015 ../fish/guestfish-actions.pod:2087 +#: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2100 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:3018 ../fish/guestfish-actions.pod:2090 +#: ../src/guestfs-actions.pod:3036 ../fish/guestfish-actions.pod:2103 msgid "C<app_display_name>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3020 ../fish/guestfish-actions.pod:2092 +#: ../src/guestfs-actions.pod:3038 ../fish/guestfish-actions.pod:2105 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:3023 ../fish/guestfish-actions.pod:2095 +#: ../src/guestfs-actions.pod:3041 ../fish/guestfish-actions.pod:2108 msgid "" "If unavailable this is returned as an empty string C<\"\">. Callers needing " "to display something can use C<app_name> instead." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3026 ../fish/guestfish-actions.pod:2098 +#: ../src/guestfs-actions.pod:3044 ../fish/guestfish-actions.pod:2111 msgid "C<app_epoch>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3028 ../fish/guestfish-actions.pod:2100 +#: ../src/guestfs-actions.pod:3046 ../fish/guestfish-actions.pod:2113 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:3031 ../fish/guestfish-actions.pod:2103 +#: ../src/guestfs-actions.pod:3049 ../fish/guestfish-actions.pod:2116 msgid "C<app_version>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2105 +#: ../src/guestfs-actions.pod:3051 ../fish/guestfish-actions.pod:2118 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:3036 ../fish/guestfish-actions.pod:2108 +#: ../src/guestfs-actions.pod:3054 ../fish/guestfish-actions.pod:2121 msgid "C<app_release>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3038 ../fish/guestfish-actions.pod:2110 +#: ../src/guestfs-actions.pod:3056 ../fish/guestfish-actions.pod:2123 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:3042 ../fish/guestfish-actions.pod:2114 +#: ../src/guestfs-actions.pod:3060 ../fish/guestfish-actions.pod:2127 msgid "C<app_install_path>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3044 ../fish/guestfish-actions.pod:2116 +#: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2129 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 " @@ -10087,84 +10227,84 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3049 ../fish/guestfish-actions.pod:2121 +#: ../src/guestfs-actions.pod:3067 ../fish/guestfish-actions.pod:2134 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:3051 ../fish/guestfish-actions.pod:2123 +#: ../src/guestfs-actions.pod:3069 ../fish/guestfish-actions.pod:2136 msgid "C<app_trans_path>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3053 ../fish/guestfish-actions.pod:2125 +#: ../src/guestfs-actions.pod:3071 ../fish/guestfish-actions.pod:2138 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:3056 ../fish/guestfish-actions.pod:2128 +#: ../src/guestfs-actions.pod:3074 ../fish/guestfish-actions.pod:2141 msgid "C<app_publisher>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3058 ../fish/guestfish-actions.pod:2130 +#: ../src/guestfs-actions.pod:3076 ../fish/guestfish-actions.pod:2143 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:3062 ../fish/guestfish-actions.pod:2134 +#: ../src/guestfs-actions.pod:3080 ../fish/guestfish-actions.pod:2147 msgid "C<app_url>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3064 ../fish/guestfish-actions.pod:2136 +#: ../src/guestfs-actions.pod:3082 ../fish/guestfish-actions.pod:2149 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:3067 ../fish/guestfish-actions.pod:2139 +#: ../src/guestfs-actions.pod:3085 ../fish/guestfish-actions.pod:2152 msgid "C<app_source_package>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3069 ../fish/guestfish-actions.pod:2141 +#: ../src/guestfs-actions.pod:3087 ../fish/guestfish-actions.pod:2154 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:3072 ../fish/guestfish-actions.pod:2144 +#: ../src/guestfs-actions.pod:3090 ../fish/guestfish-actions.pod:2157 msgid "C<app_summary>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3074 ../fish/guestfish-actions.pod:2146 +#: ../src/guestfs-actions.pod:3092 ../fish/guestfish-actions.pod:2159 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:3077 ../fish/guestfish-actions.pod:2149 +#: ../src/guestfs-actions.pod:3095 ../fish/guestfish-actions.pod:2162 msgid "C<app_description>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3079 ../fish/guestfish-actions.pod:2151 +#: ../src/guestfs-actions.pod:3097 ../fish/guestfish-actions.pod:2164 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:3086 +#: ../src/guestfs-actions.pod:3104 msgid "" "This function returns a C<struct guestfs_application_list *>, or NULL if " "there was an error. I<The caller must call C<guestfs_free_application_list> " @@ -10172,17 +10312,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3090 +#: ../src/guestfs-actions.pod:3108 msgid "(Added in 1.7.8)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3092 +#: ../src/guestfs-actions.pod:3110 msgid "guestfs_inspect_os" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3094 +#: ../src/guestfs-actions.pod:3112 #, no-wrap msgid "" " char **\n" @@ -10191,7 +10331,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3097 ../fish/guestfish-actions.pod:2162 +#: ../src/guestfs-actions.pod:3115 ../fish/guestfish-actions.pod:2175 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -10199,12 +10339,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3101 ../fish/guestfish-actions.pod:2166 +#: ../src/guestfs-actions.pod:3119 ../fish/guestfish-actions.pod:2179 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3103 ../fish/guestfish-actions.pod:2168 +#: ../src/guestfs-actions.pod:3121 ../fish/guestfish-actions.pod:2181 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. " @@ -10214,7 +10354,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3110 +#: ../src/guestfs-actions.pod:3128 msgid "" "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> " "functions in order to query further information about each operating system, " @@ -10222,7 +10362,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3115 +#: ../src/guestfs-actions.pod:3133 msgid "" "This function uses other libguestfs features such as C<guestfs_mount_ro> and " "C<guestfs_umount_all> in order to mount and unmount filesystems and look at " @@ -10231,24 +10371,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3121 ../fish/guestfish-actions.pod:2186 +#: ../src/guestfs-actions.pod:3139 ../fish/guestfish-actions.pod:2199 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:3127 ../src/guestfs-actions.pod:3412 ../src/guestfs-actions.pod:3474 +#: ../src/guestfs-actions.pod:3145 ../src/guestfs-actions.pod:3430 ../src/guestfs-actions.pod:3492 msgid "See also C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3135 +#: ../src/guestfs-actions.pod:3153 msgid "guestfs_is_blockdev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3137 +#: ../src/guestfs-actions.pod:3155 #, no-wrap msgid "" " int\n" @@ -10258,29 +10398,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3141 ../fish/guestfish-actions.pod:2198 +#: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2211 msgid "" "This returns C<true> if and only if there is a block device with the given " "C<path> name." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3144 ../src/guestfs-actions.pod:3173 ../src/guestfs-actions.pod:3203 ../src/guestfs-actions.pod:3218 ../src/guestfs-actions.pod:3234 ../src/guestfs-actions.pod:3290 ../src/guestfs-actions.pod:3305 +#: ../src/guestfs-actions.pod:3162 ../src/guestfs-actions.pod:3191 ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:3236 ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3308 ../src/guestfs-actions.pod:3323 msgid "See also C<guestfs_stat>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3148 ../src/guestfs-actions.pod:3177 ../src/guestfs-actions.pod:3222 ../src/guestfs-actions.pod:3294 ../src/guestfs-actions.pod:3309 +#: ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3195 ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3312 ../src/guestfs-actions.pod:3327 msgid "(Added in 1.5.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3150 +#: ../src/guestfs-actions.pod:3168 msgid "guestfs_is_busy" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3152 +#: ../src/guestfs-actions.pod:3170 #, no-wrap msgid "" " int\n" @@ -10289,19 +10429,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3155 ../fish/guestfish-actions.pod:2207 +#: ../src/guestfs-actions.pod:3173 ../fish/guestfish-actions.pod:2220 msgid "" "This returns true iff this handle is busy processing a command (in the " "C<BUSY> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3164 +#: ../src/guestfs-actions.pod:3182 msgid "guestfs_is_chardev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3166 +#: ../src/guestfs-actions.pod:3184 #, no-wrap msgid "" " int\n" @@ -10311,19 +10451,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3170 ../fish/guestfish-actions.pod:2216 +#: ../src/guestfs-actions.pod:3188 ../fish/guestfish-actions.pod:2229 msgid "" "This returns C<true> if and only if there is a character device with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3179 +#: ../src/guestfs-actions.pod:3197 msgid "guestfs_is_config" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3181 +#: ../src/guestfs-actions.pod:3199 #, no-wrap msgid "" " int\n" @@ -10332,19 +10472,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3184 ../fish/guestfish-actions.pod:2225 +#: ../src/guestfs-actions.pod:3202 ../fish/guestfish-actions.pod:2238 msgid "" "This returns true iff this handle is being configured (in the C<CONFIG> " "state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3193 +#: ../src/guestfs-actions.pod:3211 msgid "guestfs_is_dir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3195 +#: ../src/guestfs-actions.pod:3213 #, no-wrap msgid "" " int\n" @@ -10354,19 +10494,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3199 ../fish/guestfish-actions.pod:2234 +#: ../src/guestfs-actions.pod:3217 ../fish/guestfish-actions.pod:2247 msgid "" "This returns C<true> if and only if there is a directory with the given " "C<path> name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3209 +#: ../src/guestfs-actions.pod:3227 msgid "guestfs_is_fifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3211 +#: ../src/guestfs-actions.pod:3229 #, no-wrap msgid "" " int\n" @@ -10376,19 +10516,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3215 ../fish/guestfish-actions.pod:2244 +#: ../src/guestfs-actions.pod:3233 ../fish/guestfish-actions.pod:2257 msgid "" "This returns C<true> if and only if there is a FIFO (named pipe) with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3224 +#: ../src/guestfs-actions.pod:3242 msgid "guestfs_is_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3226 +#: ../src/guestfs-actions.pod:3244 #, no-wrap msgid "" " int\n" @@ -10398,7 +10538,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3230 ../fish/guestfish-actions.pod:2253 +#: ../src/guestfs-actions.pod:3248 ../fish/guestfish-actions.pod:2266 msgid "" "This returns C<true> if and only if there is a regular file with the given " "C<path> name. Note that it returns false for other objects like " @@ -10406,12 +10546,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3240 +#: ../src/guestfs-actions.pod:3258 msgid "guestfs_is_launching" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3242 +#: ../src/guestfs-actions.pod:3260 #, no-wrap msgid "" " int\n" @@ -10420,19 +10560,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3245 ../fish/guestfish-actions.pod:2263 +#: ../src/guestfs-actions.pod:3263 ../fish/guestfish-actions.pod:2276 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C<LAUNCHING> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3254 +#: ../src/guestfs-actions.pod:3272 msgid "guestfs_is_lv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3256 +#: ../src/guestfs-actions.pod:3274 #, no-wrap msgid "" " int\n" @@ -10442,19 +10582,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3260 ../fish/guestfish-actions.pod:2272 +#: ../src/guestfs-actions.pod:3278 ../fish/guestfish-actions.pod:2285 msgid "" "This command tests whether C<device> is a logical volume, and returns true " "iff this is the case." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3267 +#: ../src/guestfs-actions.pod:3285 msgid "guestfs_is_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3269 +#: ../src/guestfs-actions.pod:3287 #, no-wrap msgid "" " int\n" @@ -10463,19 +10603,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3272 ../fish/guestfish-actions.pod:2279 +#: ../src/guestfs-actions.pod:3290 ../fish/guestfish-actions.pod:2292 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C<READY> state)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3281 +#: ../src/guestfs-actions.pod:3299 msgid "guestfs_is_socket" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3283 +#: ../src/guestfs-actions.pod:3301 #, no-wrap msgid "" " int\n" @@ -10485,19 +10625,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3287 ../fish/guestfish-actions.pod:2288 +#: ../src/guestfs-actions.pod:3305 ../fish/guestfish-actions.pod:2301 msgid "" "This returns C<true> if and only if there is a Unix domain socket with the " "given C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3296 +#: ../src/guestfs-actions.pod:3314 msgid "guestfs_is_symlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3298 +#: ../src/guestfs-actions.pod:3316 #, no-wrap msgid "" " int\n" @@ -10507,19 +10647,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3302 ../fish/guestfish-actions.pod:2297 +#: ../src/guestfs-actions.pod:3320 ../fish/guestfish-actions.pod:2310 msgid "" "This returns C<true> if and only if there is a symbolic link with the given " "C<path> name." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3311 +#: ../src/guestfs-actions.pod:3329 msgid "guestfs_kill_subprocess" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3313 +#: ../src/guestfs-actions.pod:3331 #, no-wrap msgid "" " int\n" @@ -10528,17 +10668,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3316 ../fish/guestfish-actions.pod:2306 +#: ../src/guestfs-actions.pod:3334 ../fish/guestfish-actions.pod:2319 msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3322 +#: ../src/guestfs-actions.pod:3340 msgid "guestfs_launch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3324 +#: ../src/guestfs-actions.pod:3342 #, no-wrap msgid "" " int\n" @@ -10547,26 +10687,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3327 ../fish/guestfish-actions.pod:2314 +#: ../src/guestfs-actions.pod:3345 ../fish/guestfish-actions.pod:2327 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L<qemu(1)>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3330 ../fish/guestfish-actions.pod:2317 +#: ../src/guestfs-actions.pod:3348 ../fish/guestfish-actions.pod:2330 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3337 +#: ../src/guestfs-actions.pod:3355 msgid "guestfs_lchown" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3339 +#: ../src/guestfs-actions.pod:3357 #, no-wrap msgid "" " int\n" @@ -10578,7 +10718,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3345 +#: ../src/guestfs-actions.pod:3363 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " "C<guestfs_chown> but if C<path> is a symlink then the link itself is " @@ -10586,12 +10726,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3357 +#: ../src/guestfs-actions.pod:3375 msgid "guestfs_lgetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3359 +#: ../src/guestfs-actions.pod:3377 #, no-wrap msgid "" " char *\n" @@ -10603,24 +10743,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3365 ../fish/guestfish-actions.pod:2336 +#: ../src/guestfs-actions.pod:3383 ../fish/guestfish-actions.pod:2349 msgid "" "Get a single extended attribute from file C<path> named C<name>. If C<path> " "is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3379 +#: ../src/guestfs-actions.pod:3397 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3387 +#: ../src/guestfs-actions.pod:3405 msgid "guestfs_lgetxattrs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3389 +#: ../src/guestfs-actions.pod:3407 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -10630,19 +10770,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3393 +#: ../src/guestfs-actions.pod:3411 msgid "" "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, " "then it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3403 +#: ../src/guestfs-actions.pod:3421 msgid "guestfs_list_devices" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3405 +#: ../src/guestfs-actions.pod:3423 #, no-wrap msgid "" " char **\n" @@ -10651,22 +10791,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3408 ../fish/guestfish-actions.pod:2364 +#: ../src/guestfs-actions.pod:3426 ../fish/guestfish-actions.pod:2377 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3410 ../fish/guestfish-actions.pod:2366 +#: ../src/guestfs-actions.pod:3428 ../fish/guestfish-actions.pod:2379 msgid "The full block device names are returned, eg. C</dev/sda>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3420 +#: ../src/guestfs-actions.pod:3438 msgid "guestfs_list_filesystems" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3422 +#: ../src/guestfs-actions.pod:3440 #, no-wrap msgid "" " char **\n" @@ -10675,7 +10815,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3425 ../fish/guestfish-actions.pod:2374 +#: ../src/guestfs-actions.pod:3443 ../fish/guestfish-actions.pod:2387 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -10683,14 +10823,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3429 ../fish/guestfish-actions.pod:2378 +#: ../src/guestfs-actions.pod:3447 ../fish/guestfish-actions.pod:2391 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:3433 ../fish/guestfish-actions.pod:2382 +#: ../src/guestfs-actions.pod:3451 ../fish/guestfish-actions.pod:2395 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -10701,14 +10841,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3438 ../fish/guestfish-actions.pod:2387 +#: ../src/guestfs-actions.pod:3456 ../fish/guestfish-actions.pod:2400 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:3442 +#: ../src/guestfs-actions.pod:3460 msgid "" "This command runs other libguestfs commands, which might include " "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this " @@ -10716,7 +10856,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3446 +#: ../src/guestfs-actions.pod:3464 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 " @@ -10727,17 +10867,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3460 ../src/guestfs-actions.pod:5065 +#: ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:5083 msgid "(Added in 1.5.15)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3462 +#: ../src/guestfs-actions.pod:3480 msgid "guestfs_list_partitions" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3464 +#: ../src/guestfs-actions.pod:3482 #, no-wrap msgid "" " char **\n" @@ -10746,29 +10886,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3467 ../fish/guestfish-actions.pod:2407 +#: ../src/guestfs-actions.pod:3485 ../fish/guestfish-actions.pod:2420 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3469 ../fish/guestfish-actions.pod:2409 +#: ../src/guestfs-actions.pod:3487 ../fish/guestfish-actions.pod:2422 msgid "The full partition device names are returned, eg. C</dev/sda1>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3471 +#: ../src/guestfs-actions.pod:3489 msgid "" "This does not return logical volumes. For that you will need to call " "C<guestfs_lvs>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3482 +#: ../src/guestfs-actions.pod:3500 msgid "guestfs_ll" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3484 +#: ../src/guestfs-actions.pod:3502 #, no-wrap msgid "" " char *\n" @@ -10778,26 +10918,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3488 ../fish/guestfish-actions.pod:2420 +#: ../src/guestfs-actions.pod:3506 ../fish/guestfish-actions.pod:2433 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd) in the format of 'ls -la'." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3491 ../fish/guestfish-actions.pod:2423 +#: ../src/guestfs-actions.pod:3509 ../fish/guestfish-actions.pod:2436 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3499 +#: ../src/guestfs-actions.pod:3517 msgid "guestfs_ln" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3501 +#: ../src/guestfs-actions.pod:3519 #, no-wrap msgid "" " int\n" @@ -10808,17 +10948,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3506 ../fish/guestfish-actions.pod:2430 +#: ../src/guestfs-actions.pod:3524 ../fish/guestfish-actions.pod:2443 msgid "This command creates a hard link using the C<ln> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3512 +#: ../src/guestfs-actions.pod:3530 msgid "guestfs_ln_f" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3514 +#: ../src/guestfs-actions.pod:3532 #, no-wrap msgid "" " int\n" @@ -10829,19 +10969,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3519 ../fish/guestfish-actions.pod:2436 +#: ../src/guestfs-actions.pod:3537 ../fish/guestfish-actions.pod:2449 msgid "" "This command creates a hard link using the C<ln -f> command. The C<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3526 +#: ../src/guestfs-actions.pod:3544 msgid "guestfs_ln_s" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3528 +#: ../src/guestfs-actions.pod:3546 #, no-wrap msgid "" " int\n" @@ -10852,17 +10992,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3533 ../fish/guestfish-actions.pod:2443 +#: ../src/guestfs-actions.pod:3551 ../fish/guestfish-actions.pod:2456 msgid "This command creates a symbolic link using the C<ln -s> command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3539 +#: ../src/guestfs-actions.pod:3557 msgid "guestfs_ln_sf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3541 +#: ../src/guestfs-actions.pod:3559 #, no-wrap msgid "" " int\n" @@ -10873,19 +11013,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3546 ../fish/guestfish-actions.pod:2449 +#: ../src/guestfs-actions.pod:3564 ../fish/guestfish-actions.pod:2462 msgid "" "This command creates a symbolic link using the C<ln -sf> command, The C<-f> " "option removes the link (C<linkname>) if it exists already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3553 +#: ../src/guestfs-actions.pod:3571 msgid "guestfs_lremovexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3555 +#: ../src/guestfs-actions.pod:3573 #, no-wrap msgid "" " int\n" @@ -10896,19 +11036,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3560 +#: ../src/guestfs-actions.pod:3578 msgid "" "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic " "link, then it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3568 +#: ../src/guestfs-actions.pod:3586 msgid "guestfs_ls" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3570 +#: ../src/guestfs-actions.pod:3588 #, no-wrap msgid "" " char **\n" @@ -10918,7 +11058,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3574 ../fish/guestfish-actions.pod:2464 +#: ../src/guestfs-actions.pod:3592 ../fish/guestfish-actions.pod:2477 msgid "" "List the files in C<directory> (relative to the root directory, there is no " "cwd). The '.' and '..' entries are not returned, but hidden files are " @@ -10926,19 +11066,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3578 +#: ../src/guestfs-actions.pod:3596 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use C<guestfs_readdir> instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3587 +#: ../src/guestfs-actions.pod:3605 msgid "guestfs_lsetxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3589 +#: ../src/guestfs-actions.pod:3607 #, no-wrap msgid "" " int\n" @@ -10951,19 +11091,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3596 +#: ../src/guestfs-actions.pod:3614 msgid "" "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, " "then it sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3604 +#: ../src/guestfs-actions.pod:3622 msgid "guestfs_lstat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3606 +#: ../src/guestfs-actions.pod:3624 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -10973,41 +11113,41 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:6136 ../fish/guestfish-actions.pod:2483 ../fish/guestfish-actions.pod:4122 +#: ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:6182 ../fish/guestfish-actions.pod:2496 ../fish/guestfish-actions.pod:4161 msgid "Returns file information for the given C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3612 +#: ../src/guestfs-actions.pod:3630 msgid "" "This is the same as C<guestfs_stat> except that if C<path> is a symbolic " "link, then the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3616 ../fish/guestfish-actions.pod:2489 +#: ../src/guestfs-actions.pod:3634 ../fish/guestfish-actions.pod:2502 msgid "This is the same as the C<lstat(2)> system call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3618 ../src/guestfs-actions.pod:6140 +#: ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:6186 msgid "" "This function returns a C<struct guestfs_stat *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_stat> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3622 ../src/guestfs-actions.pod:6144 ../src/guestfs-actions.pod:6162 ../src/guestfs-actions.pod:6543 +#: ../src/guestfs-actions.pod:3640 ../src/guestfs-actions.pod:6190 ../src/guestfs-actions.pod:6208 ../src/guestfs-actions.pod:6589 msgid "(Added in 0.9.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3624 +#: ../src/guestfs-actions.pod:3642 msgid "guestfs_lstatlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3626 +#: ../src/guestfs-actions.pod:3644 #, no-wrap msgid "" " struct guestfs_stat_list *\n" @@ -11018,7 +11158,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3631 +#: ../src/guestfs-actions.pod:3649 msgid "" "This call allows you to perform the C<guestfs_lstat> operation on multiple " "files, where all files are in the directory C<path>. C<names> is the list " @@ -11026,7 +11166,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3635 ../fish/guestfish-actions.pod:2499 +#: ../src/guestfs-actions.pod:3653 ../fish/guestfish-actions.pod:2512 msgid "" "On return you get a list of stat structs, with a one-to-one correspondence " "to the C<names> list. If any name did not exist or could not be lstat'd, " @@ -11034,7 +11174,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3640 +#: ../src/guestfs-actions.pod:3658 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lxattrlist> " @@ -11045,19 +11185,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3648 +#: ../src/guestfs-actions.pod:3666 msgid "" "This function returns a C<struct guestfs_stat_list *>, or NULL if there was " "an error. I<The caller must call C<guestfs_free_stat_list> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3654 +#: ../src/guestfs-actions.pod:3672 msgid "guestfs_luks_add_key" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3656 +#: ../src/guestfs-actions.pod:3674 #, no-wrap msgid "" " int\n" @@ -11070,7 +11210,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3663 ../fish/guestfish-actions.pod:2516 +#: ../src/guestfs-actions.pod:3681 ../fish/guestfish-actions.pod:2529 msgid "" "This command adds a new key on LUKS device C<device>. C<key> is any " "existing key, and is used to access the device. C<newkey> is the new key to " @@ -11078,14 +11218,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3668 +#: ../src/guestfs-actions.pod:3686 msgid "" "Note that if C<keyslot> already contains a key, then this command will " "fail. You have to use C<guestfs_luks_kill_slot> first to remove that key." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3674 ../src/guestfs-actions.pod:3714 ../src/guestfs-actions.pod:3737 ../src/guestfs-actions.pod:3757 ../src/guestfs-actions.pod:3789 ../src/guestfs-actions.pod:3808 +#: ../src/guestfs-actions.pod:3692 ../src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3755 ../src/guestfs-actions.pod:3775 ../src/guestfs-actions.pod:3807 ../src/guestfs-actions.pod:3826 msgid "" "This function takes a key or passphrase parameter which could contain " "sensitive material. Read the section L</KEYS AND PASSPHRASES> for more " @@ -11093,17 +11233,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3678 ../src/guestfs-actions.pod:3718 ../src/guestfs-actions.pod:3741 ../src/guestfs-actions.pod:3761 +#: ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:3779 msgid "(Added in 1.5.2)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3680 +#: ../src/guestfs-actions.pod:3698 msgid "guestfs_luks_close" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3682 +#: ../src/guestfs-actions.pod:3700 #, no-wrap msgid "" " int\n" @@ -11113,7 +11253,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3686 +#: ../src/guestfs-actions.pod:3704 msgid "" "This closes a LUKS device that was created earlier by C<guestfs_luks_open> " "or C<guestfs_luks_open_ro>. The C<device> parameter must be the name of the " @@ -11122,17 +11262,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:3793 ../src/guestfs-actions.pod:3812 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:3910 +#: ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3811 ../src/guestfs-actions.pod:3830 ../src/guestfs-actions.pod:3880 ../src/guestfs-actions.pod:3928 msgid "(Added in 1.5.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3696 +#: ../src/guestfs-actions.pod:3714 msgid "guestfs_luks_format" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3698 +#: ../src/guestfs-actions.pod:3716 #, no-wrap msgid "" " int\n" @@ -11144,7 +11284,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3704 ../fish/guestfish-actions.pod:2542 +#: ../src/guestfs-actions.pod:3722 ../fish/guestfish-actions.pod:2555 msgid "" "This command erases existing data on C<device> and formats the device as a " "LUKS encrypted device. C<key> is the initial key, which is added to key " @@ -11152,19 +11292,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3874 ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:5596 ../src/guestfs-actions.pod:5971 ../src/guestfs-actions.pod:5994 ../src/guestfs-actions.pod:6020 ../src/guestfs-actions.pod:7180 ../fish/guestfish-actions.pod:2550 ../fish/guestfish-actions.pod:2563 ../fish/guestfish-actions.pod:2647 ../fish/guestfish-actions.pod:3221 ../fish/guestfish-actions.pod:3741 ../fish/guestfish-actions.pod:4021 ../fish/guestfish-actions.pod:4037 ../fish/guestfish-actions.pod:4052 ../fish/guestfish-actions.pod:4767 +#: ../src/guestfs-actions.pod:3729 ../src/guestfs-actions.pod:3752 ../src/guestfs-actions.pod:3892 ../src/guestfs-actions.pod:4834 ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:6017 ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6066 ../src/guestfs-actions.pod:7226 ../fish/guestfish-actions.pod:2563 ../fish/guestfish-actions.pod:2576 ../fish/guestfish-actions.pod:2660 ../fish/guestfish-actions.pod:3234 ../fish/guestfish-actions.pod:3754 ../fish/guestfish-actions.pod:4060 ../fish/guestfish-actions.pod:4076 ../fish/guestfish-actions.pod:4091 ../fish/guestfish-actions.pod:4806 msgid "" "B<This command is dangerous. Without careful use you can easily destroy all " "your data>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3720 +#: ../src/guestfs-actions.pod:3738 msgid "guestfs_luks_format_cipher" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3722 +#: ../src/guestfs-actions.pod:3740 #, no-wrap msgid "" " int\n" @@ -11177,19 +11317,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3729 +#: ../src/guestfs-actions.pod:3747 msgid "" "This command is the same as C<guestfs_luks_format> but it also allows you to " "set the C<cipher> used." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3743 +#: ../src/guestfs-actions.pod:3761 msgid "guestfs_luks_kill_slot" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3745 +#: ../src/guestfs-actions.pod:3763 #, no-wrap msgid "" " int\n" @@ -11201,19 +11341,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3751 ../fish/guestfish-actions.pod:2570 +#: ../src/guestfs-actions.pod:3769 ../fish/guestfish-actions.pod:2583 msgid "" "This command deletes the key in key slot C<keyslot> from the encrypted LUKS " "device C<device>. C<key> must be one of the I<other> keys." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3763 +#: ../src/guestfs-actions.pod:3781 msgid "guestfs_luks_open" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3765 +#: ../src/guestfs-actions.pod:3783 #, no-wrap msgid "" " int\n" @@ -11225,26 +11365,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3771 ../fish/guestfish-actions.pod:2581 +#: ../src/guestfs-actions.pod:3789 ../fish/guestfish-actions.pod:2594 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:3774 ../fish/guestfish-actions.pod:2584 +#: ../src/guestfs-actions.pod:3792 ../fish/guestfish-actions.pod:2597 msgid "C<device> is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3776 ../fish/guestfish-actions.pod:2586 +#: ../src/guestfs-actions.pod:3794 ../fish/guestfish-actions.pod:2599 msgid "" "The caller must supply one of the keys associated with the LUKS block " "device, in the C<key> parameter." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3779 ../fish/guestfish-actions.pod:2589 +#: ../src/guestfs-actions.pod:3797 ../fish/guestfish-actions.pod:2602 msgid "" "This creates a new block device called C</dev/mapper/mapname>. Reads and " "writes to this block device are decrypted from and encrypted to the " @@ -11252,7 +11392,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3783 +#: ../src/guestfs-actions.pod:3801 msgid "" "If this block device contains LVM volume groups, then calling " "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them " @@ -11260,12 +11400,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3795 +#: ../src/guestfs-actions.pod:3813 msgid "guestfs_luks_open_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3797 +#: ../src/guestfs-actions.pod:3815 #, no-wrap msgid "" " int\n" @@ -11277,19 +11417,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3803 +#: ../src/guestfs-actions.pod:3821 msgid "" "This is the same as C<guestfs_luks_open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3814 +#: ../src/guestfs-actions.pod:3832 msgid "guestfs_lvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3816 +#: ../src/guestfs-actions.pod:3834 #, no-wrap msgid "" " int\n" @@ -11301,19 +11441,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3822 ../fish/guestfish-actions.pod:2614 +#: ../src/guestfs-actions.pod:3840 ../fish/guestfish-actions.pod:2627 msgid "" "This creates an LVM logical volume called C<logvol> on the volume group " "C<volgroup>, with C<size> megabytes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3829 +#: ../src/guestfs-actions.pod:3847 msgid "guestfs_lvm_canonical_lv_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3831 +#: ../src/guestfs-actions.pod:3849 #, no-wrap msgid "" " char *\n" @@ -11323,7 +11463,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3835 ../fish/guestfish-actions.pod:2621 +#: ../src/guestfs-actions.pod:3853 ../fish/guestfish-actions.pod:2634 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, C</dev/mapper/VG-LV> is converted to " @@ -11331,29 +11471,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3839 ../fish/guestfish-actions.pod:2625 +#: ../src/guestfs-actions.pod:3857 ../fish/guestfish-actions.pod:2638 msgid "" "This command returns an error if the C<lvname> parameter does not refer to a " "logical volume." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3842 +#: ../src/guestfs-actions.pod:3860 msgid "See also C<guestfs_is_lv>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3847 +#: ../src/guestfs-actions.pod:3865 msgid "(Added in 1.5.24)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3849 +#: ../src/guestfs-actions.pod:3867 msgid "guestfs_lvm_clear_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3851 +#: ../src/guestfs-actions.pod:3869 #, no-wrap msgid "" " int\n" @@ -11362,24 +11502,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3854 +#: ../src/guestfs-actions.pod:3872 msgid "" "This undoes the effect of C<guestfs_lvm_set_filter>. LVM will be able to " "see every block device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:3899 ../fish/guestfish-actions.pod:2637 ../fish/guestfish-actions.pod:2668 +#: ../src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3917 ../fish/guestfish-actions.pod:2650 ../fish/guestfish-actions.pod:2681 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3864 +#: ../src/guestfs-actions.pod:3882 msgid "guestfs_lvm_remove_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3866 +#: ../src/guestfs-actions.pod:3884 #, no-wrap msgid "" " int\n" @@ -11388,19 +11528,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3869 ../fish/guestfish-actions.pod:2644 +#: ../src/guestfs-actions.pod:3887 ../fish/guestfish-actions.pod:2657 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3879 +#: ../src/guestfs-actions.pod:3897 msgid "guestfs_lvm_set_filter" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3881 +#: ../src/guestfs-actions.pod:3899 #, no-wrap msgid "" " int\n" @@ -11410,7 +11550,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3885 ../fish/guestfish-actions.pod:2654 +#: ../src/guestfs-actions.pod:3903 ../fish/guestfish-actions.pod:2667 msgid "" "This sets the LVM device filter so that LVM will only be able to \"see\" the " "block devices in the list C<devices>, and will ignore all other attached " @@ -11418,7 +11558,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3889 ../fish/guestfish-actions.pod:2658 +#: ../src/guestfs-actions.pod:3907 ../fish/guestfish-actions.pod:2671 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 " @@ -11430,24 +11570,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3902 ../fish/guestfish-actions.pod:2671 +#: ../src/guestfs-actions.pod:3920 ../fish/guestfish-actions.pod:2684 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3904 ../fish/guestfish-actions.pod:2673 +#: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2686 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:3912 +#: ../src/guestfs-actions.pod:3930 msgid "guestfs_lvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3914 +#: ../src/guestfs-actions.pod:3932 #, no-wrap msgid "" " int\n" @@ -11457,31 +11597,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3918 ../fish/guestfish-actions.pod:2681 +#: ../src/guestfs-actions.pod:3936 ../fish/guestfish-actions.pod:2694 msgid "" "Remove an LVM logical volume C<device>, where C<device> is the path to the " "LV, such as C</dev/VG/LV>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3921 ../fish/guestfish-actions.pod:2684 +#: ../src/guestfs-actions.pod:3939 ../fish/guestfish-actions.pod:2697 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, " "C</dev/VG>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3926 ../src/guestfs-actions.pod:5162 ../src/guestfs-actions.pod:6919 +#: ../src/guestfs-actions.pod:3944 ../src/guestfs-actions.pod:5180 ../src/guestfs-actions.pod:6965 msgid "(Added in 1.0.13)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3928 +#: ../src/guestfs-actions.pod:3946 msgid "guestfs_lvrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3930 +#: ../src/guestfs-actions.pod:3948 #, no-wrap msgid "" " int\n" @@ -11492,22 +11632,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3935 ../fish/guestfish-actions.pod:2691 +#: ../src/guestfs-actions.pod:3953 ../fish/guestfish-actions.pod:2704 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3939 ../src/guestfs-actions.pod:6932 +#: ../src/guestfs-actions.pod:3957 ../src/guestfs-actions.pod:6978 msgid "(Added in 1.0.83)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3941 +#: ../src/guestfs-actions.pod:3959 msgid "guestfs_lvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3943 +#: ../src/guestfs-actions.pod:3961 #, no-wrap msgid "" " int\n" @@ -11518,19 +11658,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3948 ../fish/guestfish-actions.pod:2697 +#: ../src/guestfs-actions.pod:3966 ../fish/guestfish-actions.pod:2710 msgid "" "This resizes (expands or shrinks) an existing LVM logical volume to " "C<mbytes>. When reducing, data in the reduced part is lost." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3956 +#: ../src/guestfs-actions.pod:3974 msgid "guestfs_lvresize_free" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3958 +#: ../src/guestfs-actions.pod:3976 #, no-wrap msgid "" " int\n" @@ -11541,7 +11681,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3963 ../fish/guestfish-actions.pod:2705 +#: ../src/guestfs-actions.pod:3981 ../fish/guestfish-actions.pod:2718 msgid "" "This expands an existing logical volume C<lv> so that it fills C<pc>% of the " "remaining free space in the volume group. Commonly you would call this with " @@ -11550,17 +11690,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3971 +#: ../src/guestfs-actions.pod:3989 msgid "(Added in 1.3.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3973 +#: ../src/guestfs-actions.pod:3991 msgid "guestfs_lvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3975 +#: ../src/guestfs-actions.pod:3993 #, no-wrap msgid "" " char **\n" @@ -11569,31 +11709,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3978 ../fish/guestfish-actions.pod:2715 +#: ../src/guestfs-actions.pod:3996 ../fish/guestfish-actions.pod:2728 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3981 ../fish/guestfish-actions.pod:2718 +#: ../src/guestfs-actions.pod:3999 ../fish/guestfish-actions.pod:2731 msgid "" "This returns a list of the logical volume device names " "(eg. C</dev/VolGroup00/LogVol00>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3984 +#: ../src/guestfs-actions.pod:4002 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:3992 +#: ../src/guestfs-actions.pod:4010 msgid "guestfs_lvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:3994 +#: ../src/guestfs-actions.pod:4012 #, no-wrap msgid "" " struct guestfs_lvm_lv_list *\n" @@ -11602,14 +11742,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:2727 +#: ../src/guestfs-actions.pod:4015 ../fish/guestfish-actions.pod:2740 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L<lvs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4000 +#: ../src/guestfs-actions.pod:4018 msgid "" "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after " @@ -11617,12 +11757,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4006 +#: ../src/guestfs-actions.pod:4024 msgid "guestfs_lvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4008 +#: ../src/guestfs-actions.pod:4026 #, no-wrap msgid "" " char *\n" @@ -11632,17 +11772,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4012 ../fish/guestfish-actions.pod:2734 +#: ../src/guestfs-actions.pod:4030 ../fish/guestfish-actions.pod:2747 msgid "This command returns the UUID of the LVM LV C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4019 +#: ../src/guestfs-actions.pod:4037 msgid "guestfs_lxattrlist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4021 +#: ../src/guestfs-actions.pod:4039 #, no-wrap msgid "" " struct guestfs_xattr_list *\n" @@ -11653,7 +11793,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4026 ../fish/guestfish-actions.pod:2740 +#: ../src/guestfs-actions.pod:4044 ../fish/guestfish-actions.pod:2753 msgid "" "This call allows you to get the extended attributes of multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -11661,7 +11801,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4030 ../fish/guestfish-actions.pod:2744 +#: ../src/guestfs-actions.pod:4048 ../fish/guestfish-actions.pod:2757 msgid "" "On return you get a flat list of xattr structs which must be interpreted " "sequentially. The first xattr struct always has a zero-length C<attrname>. " @@ -11674,7 +11814,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4040 +#: ../src/guestfs-actions.pod:4058 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also C<guestfs_lstatlist> for " @@ -11685,12 +11825,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4054 +#: ../src/guestfs-actions.pod:4072 msgid "guestfs_mkdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4056 +#: ../src/guestfs-actions.pod:4074 #, no-wrap msgid "" " int\n" @@ -11700,17 +11840,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4060 ../fish/guestfish-actions.pod:2766 +#: ../src/guestfs-actions.pod:4078 ../fish/guestfish-actions.pod:2779 msgid "Create a directory named C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4066 +#: ../src/guestfs-actions.pod:4084 msgid "guestfs_mkdir_mode" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4068 +#: ../src/guestfs-actions.pod:4086 #, no-wrap msgid "" " int\n" @@ -11721,14 +11861,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4073 ../fish/guestfish-actions.pod:2772 +#: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2785 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C<mode>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4076 ../fish/guestfish-actions.pod:2775 +#: ../src/guestfs-actions.pod:4094 ../fish/guestfish-actions.pod:2788 msgid "" "For common Linux filesystems, the actual mode which is set will be C<mode & " "~umask & 01777>. Non-native-Linux filesystems may interpret the mode in " @@ -11736,17 +11876,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4080 +#: ../src/guestfs-actions.pod:4098 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4086 +#: ../src/guestfs-actions.pod:4104 msgid "guestfs_mkdir_p" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4088 +#: ../src/guestfs-actions.pod:4106 #, no-wrap msgid "" " int\n" @@ -11756,19 +11896,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4092 ../fish/guestfish-actions.pod:2785 +#: ../src/guestfs-actions.pod:4110 ../fish/guestfish-actions.pod:2798 msgid "" "Create a directory named C<path>, creating any parent directories as " "necessary. This is like the C<mkdir -p> shell command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4099 +#: ../src/guestfs-actions.pod:4117 msgid "guestfs_mkdtemp" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4101 +#: ../src/guestfs-actions.pod:4119 #, no-wrap msgid "" " char *\n" @@ -11778,7 +11918,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4105 ../fish/guestfish-actions.pod:2792 +#: ../src/guestfs-actions.pod:4123 ../fish/guestfish-actions.pod:2805 msgid "" "This command creates a temporary directory. The C<template> parameter " "should be a full pathname for the temporary directory name with the final " @@ -11786,41 +11926,41 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4110 ../fish/guestfish-actions.pod:2797 +#: ../src/guestfs-actions.pod:4128 ../fish/guestfish-actions.pod:2810 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4113 ../fish/guestfish-actions.pod:2800 +#: ../src/guestfs-actions.pod:4131 ../fish/guestfish-actions.pod:2813 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4116 ../fish/guestfish-actions.pod:2803 +#: ../src/guestfs-actions.pod:4134 ../fish/guestfish-actions.pod:2816 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4119 ../fish/guestfish-actions.pod:2806 +#: ../src/guestfs-actions.pod:4137 ../fish/guestfish-actions.pod:2819 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4122 ../fish/guestfish-actions.pod:2809 +#: ../src/guestfs-actions.pod:4140 ../fish/guestfish-actions.pod:2822 msgid "See also: L<mkdtemp(3)>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4129 +#: ../src/guestfs-actions.pod:4147 msgid "guestfs_mke2fs_J" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4131 +#: ../src/guestfs-actions.pod:4149 #, no-wrap msgid "" " int\n" @@ -11833,14 +11973,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4138 ../fish/guestfish-actions.pod:2815 +#: ../src/guestfs-actions.pod:4156 ../fish/guestfish-actions.pod:2828 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "C<journal>. It is equivalent to the command:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4142 ../fish/guestfish-actions.pod:2819 +#: ../src/guestfs-actions.pod:4160 ../fish/guestfish-actions.pod:2832 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n" @@ -11848,22 +11988,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4144 +#: ../src/guestfs-actions.pod:4162 msgid "See also C<guestfs_mke2journal>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4148 ../src/guestfs-actions.pod:4166 ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4214 ../src/guestfs-actions.pod:4228 ../src/guestfs-actions.pod:4287 ../src/guestfs-actions.pod:4552 +#: ../src/guestfs-actions.pod:4166 ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4202 ../src/guestfs-actions.pod:4218 ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:4246 ../src/guestfs-actions.pod:4305 ../src/guestfs-actions.pod:4570 msgid "(Added in 1.0.68)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4150 +#: ../src/guestfs-actions.pod:4168 msgid "guestfs_mke2fs_JL" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4152 +#: ../src/guestfs-actions.pod:4170 #, no-wrap msgid "" " int\n" @@ -11876,24 +12016,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4159 ../fish/guestfish-actions.pod:2827 +#: ../src/guestfs-actions.pod:4177 ../fish/guestfish-actions.pod:2840 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal labeled C<label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4162 +#: ../src/guestfs-actions.pod:4180 msgid "See also C<guestfs_mke2journal_L>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4168 +#: ../src/guestfs-actions.pod:4186 msgid "guestfs_mke2fs_JU" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4170 +#: ../src/guestfs-actions.pod:4188 #, no-wrap msgid "" " int\n" @@ -11906,24 +12046,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4177 ../fish/guestfish-actions.pod:2836 +#: ../src/guestfs-actions.pod:4195 ../fish/guestfish-actions.pod:2849 msgid "" "This creates an ext2/3/4 filesystem on C<device> with an external journal on " "the journal with UUID C<uuid>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4180 +#: ../src/guestfs-actions.pod:4198 msgid "See also C<guestfs_mke2journal_U>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4186 +#: ../src/guestfs-actions.pod:4204 msgid "guestfs_mke2journal" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4188 +#: ../src/guestfs-actions.pod:4206 #, no-wrap msgid "" " int\n" @@ -11934,14 +12074,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4193 ../fish/guestfish-actions.pod:2845 +#: ../src/guestfs-actions.pod:4211 ../fish/guestfish-actions.pod:2858 msgid "" "This creates an ext2 external journal on C<device>. It is equivalent to the " "command:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4196 ../fish/guestfish-actions.pod:2848 +#: ../src/guestfs-actions.pod:4214 ../fish/guestfish-actions.pod:2861 #, no-wrap msgid "" " mke2fs -O journal_dev -b blocksize device\n" @@ -11949,12 +12089,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4202 +#: ../src/guestfs-actions.pod:4220 msgid "guestfs_mke2journal_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4204 +#: ../src/guestfs-actions.pod:4222 #, no-wrap msgid "" " int\n" @@ -11966,17 +12106,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4210 ../fish/guestfish-actions.pod:2854 +#: ../src/guestfs-actions.pod:4228 ../fish/guestfish-actions.pod:2867 msgid "This creates an ext2 external journal on C<device> with label C<label>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4216 +#: ../src/guestfs-actions.pod:4234 msgid "guestfs_mke2journal_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4218 +#: ../src/guestfs-actions.pod:4236 #, no-wrap msgid "" " int\n" @@ -11988,17 +12128,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4224 ../fish/guestfish-actions.pod:2860 +#: ../src/guestfs-actions.pod:4242 ../fish/guestfish-actions.pod:2873 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4230 +#: ../src/guestfs-actions.pod:4248 msgid "guestfs_mkfifo" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4232 +#: ../src/guestfs-actions.pod:4250 #, no-wrap msgid "" " int\n" @@ -12009,19 +12149,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4237 +#: ../src/guestfs-actions.pod:4255 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around C<guestfs_mknod>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4247 +#: ../src/guestfs-actions.pod:4265 msgid "guestfs_mkfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4249 +#: ../src/guestfs-actions.pod:4267 #, no-wrap msgid "" " int\n" @@ -12032,19 +12172,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4254 ../fish/guestfish-actions.pod:2876 +#: ../src/guestfs-actions.pod:4272 ../fish/guestfish-actions.pod:2889 msgid "" "This creates a filesystem on C<device> (usually a partition or LVM logical " "volume). The filesystem type is C<fstype>, for example C<ext3>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4262 +#: ../src/guestfs-actions.pod:4280 msgid "guestfs_mkfs_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4264 +#: ../src/guestfs-actions.pod:4282 #, no-wrap msgid "" " int\n" @@ -12056,7 +12196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4270 +#: ../src/guestfs-actions.pod:4288 msgid "" "This call is similar to C<guestfs_mkfs>, but it allows you to control the " "block size of the resulting filesystem. Supported block sizes depend on the " @@ -12064,26 +12204,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4275 ../src/guestfs-actions.pod:4318 ../fish/guestfish-actions.pod:2889 ../fish/guestfish-actions.pod:2916 +#: ../src/guestfs-actions.pod:4293 ../src/guestfs-actions.pod:4336 ../fish/guestfish-actions.pod:2902 ../fish/guestfish-actions.pod:2929 msgid "" "For VFAT and NTFS the C<blocksize> parameter is treated as the requested " "cluster size." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4280 ../fish/guestfish-actions.pod:2892 +#: ../src/guestfs-actions.pod:4298 ../fish/guestfish-actions.pod:2905 msgid "" "This function is deprecated. In new code, use the C<mkfs_opts> call " "instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4289 +#: ../src/guestfs-actions.pod:4307 msgid "guestfs_mkfs_opts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4291 +#: ../src/guestfs-actions.pod:4309 #, no-wrap msgid "" " int\n" @@ -12095,7 +12235,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4302 +#: ../src/guestfs-actions.pod:4320 #, no-wrap msgid "" " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n" @@ -12104,19 +12244,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4305 ../fish/guestfish-actions.pod:2903 +#: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2916 msgid "" "This function creates a filesystem on C<device>. The filesystem type is " "C<fstype>, for example C<ext3>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4312 ../fish/guestfish-actions.pod:2910 +#: ../src/guestfs-actions.pod:4330 ../fish/guestfish-actions.pod:2923 msgid "C<blocksize>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4314 ../fish/guestfish-actions.pod:2912 +#: ../src/guestfs-actions.pod:4332 ../fish/guestfish-actions.pod:2925 msgid "" "The filesystem block size. Supported block sizes depend on the filesystem " "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 " @@ -12124,46 +12264,46 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4321 ../fish/guestfish-actions.pod:2919 +#: ../src/guestfs-actions.pod:4339 ../fish/guestfish-actions.pod:2932 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2921 +#: ../src/guestfs-actions.pod:4341 ../fish/guestfish-actions.pod:2934 msgid "C<features>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4325 ../fish/guestfish-actions.pod:2923 +#: ../src/guestfs-actions.pod:4343 ../fish/guestfish-actions.pod:2936 msgid "This passes the C<-O> parameter to the external mkfs program." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4327 ../fish/guestfish-actions.pod:2925 +#: ../src/guestfs-actions.pod:4345 ../fish/guestfish-actions.pod:2938 msgid "" "For certain filesystem types, this allows extra filesystem features to be " "selected. See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4331 ../fish/guestfish-actions.pod:2929 +#: ../src/guestfs-actions.pod:4349 ../fish/guestfish-actions.pod:2942 msgid "" "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem " "type." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4338 +#: ../src/guestfs-actions.pod:4356 msgid "(Added in 1.7.19)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4340 +#: ../src/guestfs-actions.pod:4358 msgid "guestfs_mkfs_opts_va" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4342 +#: ../src/guestfs-actions.pod:4360 #, no-wrap msgid "" " int\n" @@ -12175,17 +12315,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4348 +#: ../src/guestfs-actions.pod:4366 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4352 +#: ../src/guestfs-actions.pod:4370 msgid "guestfs_mkfs_opts_argv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4354 +#: ../src/guestfs-actions.pod:4372 #, no-wrap msgid "" " int\n" @@ -12197,17 +12337,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4360 +#: ../src/guestfs-actions.pod:4378 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4364 +#: ../src/guestfs-actions.pod:4382 msgid "guestfs_mkmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4366 +#: ../src/guestfs-actions.pod:4384 #, no-wrap msgid "" " int\n" @@ -12217,7 +12357,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4370 +#: ../src/guestfs-actions.pod:4388 msgid "" "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls " "that can be used to create extra mountpoints before mounting the first " @@ -12225,7 +12365,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4374 ../fish/guestfish-actions.pod:2944 +#: ../src/guestfs-actions.pod:4392 ../fish/guestfish-actions.pod:2957 msgid "" "These calls are I<only> necessary in some very limited circumstances, mainly " "the case where you want to mount a mix of unrelated and/or read-only " @@ -12233,7 +12373,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4378 ../fish/guestfish-actions.pod:2948 +#: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:2961 msgid "" "For example, live CDs often contain a \"Russian doll\" nest of filesystems, " "an ISO outer layer, with a squashfs image inside, with an ext2/3 image " @@ -12241,7 +12381,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4383 ../fish/guestfish-actions.pod:2953 +#: ../src/guestfs-actions.pod:4401 ../fish/guestfish-actions.pod:2966 #, no-wrap msgid "" " add-ro Fedora-11-i686-Live.iso\n" @@ -12256,12 +12396,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4392 ../fish/guestfish-actions.pod:2962 +#: ../src/guestfs-actions.pod:4410 ../fish/guestfish-actions.pod:2975 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4394 +#: ../src/guestfs-actions.pod:4412 msgid "" "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>. You " "may get unexpected errors if you try to mix these calls. It is safest to " @@ -12269,7 +12409,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4398 +#: ../src/guestfs-actions.pod:4416 msgid "" "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest " "first, so for this to work for manual mountpoints, you must ensure that the " @@ -12278,12 +12418,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4403 ../fish/guestfish-actions.pod:2973 +#: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:2986 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4405 +#: ../src/guestfs-actions.pod:4423 msgid "" "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] " "can cause C<guestfs_umount_all> to be called when the handle is closed which " @@ -12291,17 +12431,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4411 ../src/guestfs-actions.pod:4670 ../src/guestfs-actions.pod:5580 +#: ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4688 ../src/guestfs-actions.pod:5598 msgid "(Added in 1.0.62)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4413 +#: ../src/guestfs-actions.pod:4431 msgid "guestfs_mknod" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4415 +#: ../src/guestfs-actions.pod:4433 #, no-wrap msgid "" " int\n" @@ -12314,14 +12454,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4422 ../fish/guestfish-actions.pod:2983 +#: ../src/guestfs-actions.pod:4440 ../fish/guestfish-actions.pod:2996 msgid "" "This call creates block or character special devices, or named pipes " "(FIFOs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4425 ../fish/guestfish-actions.pod:2986 +#: ../src/guestfs-actions.pod:4443 ../fish/guestfish-actions.pod:2999 msgid "" "The C<mode> parameter should be the mode, using the standard constants. " "C<devmajor> and C<devminor> are the device major and minor numbers, only " @@ -12329,7 +12469,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4430 +#: ../src/guestfs-actions.pod:4448 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " @@ -12340,12 +12480,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4444 +#: ../src/guestfs-actions.pod:4462 msgid "guestfs_mknod_b" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4446 +#: ../src/guestfs-actions.pod:4464 #, no-wrap msgid "" " int\n" @@ -12358,7 +12498,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4453 +#: ../src/guestfs-actions.pod:4471 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -12366,12 +12506,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4463 +#: ../src/guestfs-actions.pod:4481 msgid "guestfs_mknod_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4465 +#: ../src/guestfs-actions.pod:4483 #, no-wrap msgid "" " int\n" @@ -12384,7 +12524,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4472 +#: ../src/guestfs-actions.pod:4490 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -12392,12 +12532,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4482 +#: ../src/guestfs-actions.pod:4500 msgid "guestfs_mkswap" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4484 +#: ../src/guestfs-actions.pod:4502 #, no-wrap msgid "" " int\n" @@ -12407,17 +12547,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4488 ../fish/guestfish-actions.pod:3025 +#: ../src/guestfs-actions.pod:4506 ../fish/guestfish-actions.pod:3038 msgid "Create a swap partition on C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4494 +#: ../src/guestfs-actions.pod:4512 msgid "guestfs_mkswap_L" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4496 +#: ../src/guestfs-actions.pod:4514 #, no-wrap msgid "" " int\n" @@ -12428,12 +12568,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4501 ../fish/guestfish-actions.pod:3031 +#: ../src/guestfs-actions.pod:4519 ../fish/guestfish-actions.pod:3044 msgid "Create a swap partition on C<device> with label C<label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4503 ../fish/guestfish-actions.pod:3033 +#: ../src/guestfs-actions.pod:4521 ../fish/guestfish-actions.pod:3046 msgid "" "Note that you cannot attach a swap label to a block device " "(eg. C</dev/sda>), just to a partition. This appears to be a limitation of " @@ -12441,12 +12581,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4511 +#: ../src/guestfs-actions.pod:4529 msgid "guestfs_mkswap_U" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4513 +#: ../src/guestfs-actions.pod:4531 #, no-wrap msgid "" " int\n" @@ -12457,17 +12597,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4518 ../fish/guestfish-actions.pod:3041 +#: ../src/guestfs-actions.pod:4536 ../fish/guestfish-actions.pod:3054 msgid "Create a swap partition on C<device> with UUID C<uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4524 +#: ../src/guestfs-actions.pod:4542 msgid "guestfs_mkswap_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4526 +#: ../src/guestfs-actions.pod:4544 #, no-wrap msgid "" " int\n" @@ -12477,24 +12617,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4530 ../fish/guestfish-actions.pod:3047 +#: ../src/guestfs-actions.pod:4548 ../fish/guestfish-actions.pod:3060 msgid "Create a swap file." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4532 +#: ../src/guestfs-actions.pod:4550 msgid "" "This command just writes a swap file signature to an existing file. To " "create the file itself, use something like C<guestfs_fallocate>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4539 +#: ../src/guestfs-actions.pod:4557 msgid "guestfs_modprobe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4541 +#: ../src/guestfs-actions.pod:4559 #, no-wrap msgid "" " int\n" @@ -12504,24 +12644,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4545 ../fish/guestfish-actions.pod:3056 +#: ../src/guestfs-actions.pod:4563 ../fish/guestfish-actions.pod:3069 msgid "This loads a kernel module in the appliance." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4547 ../fish/guestfish-actions.pod:3058 +#: ../src/guestfs-actions.pod:4565 ../fish/guestfish-actions.pod:3071 msgid "" "The kernel module must have been whitelisted when libguestfs was built (see " "C<appliance/kmod.whitelist.in> in the source)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4554 +#: ../src/guestfs-actions.pod:4572 msgid "guestfs_mount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4556 +#: ../src/guestfs-actions.pod:4574 #, no-wrap msgid "" " int\n" @@ -12532,7 +12672,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4561 ../fish/guestfish-actions.pod:3065 +#: ../src/guestfs-actions.pod:4579 ../fish/guestfish-actions.pod:3078 msgid "" "Mount a guest disk at a position in the filesystem. Block devices are named " "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest. If " @@ -12541,7 +12681,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4567 ../fish/guestfish-actions.pod:3071 +#: ../src/guestfs-actions.pod:4585 ../fish/guestfish-actions.pod:3084 msgid "" "The rules are the same as for L<mount(2)>: A filesystem must first be " "mounted on C</> before others can be mounted. Other filesystems can only be " @@ -12549,14 +12689,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4572 ../fish/guestfish-actions.pod:3076 +#: ../src/guestfs-actions.pod:4590 ../fish/guestfish-actions.pod:3089 msgid "" "The mounted filesystem is writable, if we have sufficient permissions on the " "underlying device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4575 +#: ../src/guestfs-actions.pod:4593 msgid "" "B<Important note:> When you use this call, the filesystem options C<sync> " "and C<noatime> are set implicitly. This was originally done because we " @@ -12568,12 +12708,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4589 +#: ../src/guestfs-actions.pod:4607 msgid "guestfs_mount_loop" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4591 +#: ../src/guestfs-actions.pod:4609 #, no-wrap msgid "" " int\n" @@ -12584,7 +12724,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4596 ../fish/guestfish-actions.pod:3093 +#: ../src/guestfs-actions.pod:4614 ../fish/guestfish-actions.pod:3106 msgid "" "This command lets you mount C<file> (a filesystem image in a file) on a " "mount point. It is entirely equivalent to the command C<mount -o loop file " @@ -12592,12 +12732,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4604 +#: ../src/guestfs-actions.pod:4622 msgid "guestfs_mount_options" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4606 +#: ../src/guestfs-actions.pod:4624 #, no-wrap msgid "" " int\n" @@ -12609,31 +12749,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4612 +#: ../src/guestfs-actions.pod:4630 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "the mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4616 ../fish/guestfish-actions.pod:3105 +#: ../src/guestfs-actions.pod:4634 ../fish/guestfish-actions.pod:3118 msgid "" "If the C<options> parameter is an empty string, then no options are passed " "(all options default to whatever the filesystem uses)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4622 ../src/guestfs-actions.pod:4636 ../src/guestfs-actions.pod:4653 +#: ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:4654 ../src/guestfs-actions.pod:4671 msgid "(Added in 1.0.10)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4624 +#: ../src/guestfs-actions.pod:4642 msgid "guestfs_mount_ro" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4626 +#: ../src/guestfs-actions.pod:4644 #, no-wrap msgid "" " int\n" @@ -12644,19 +12784,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4631 +#: ../src/guestfs-actions.pod:4649 msgid "" "This is the same as the C<guestfs_mount> command, but it mounts the " "filesystem with the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4638 +#: ../src/guestfs-actions.pod:4656 msgid "guestfs_mount_vfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4640 +#: ../src/guestfs-actions.pod:4658 #, no-wrap msgid "" " int\n" @@ -12669,7 +12809,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4647 +#: ../src/guestfs-actions.pod:4665 msgid "" "This is the same as the C<guestfs_mount> command, but it allows you to set " "both the mount options and the vfstype as for the L<mount(8)> I<-o> and " @@ -12677,12 +12817,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4655 +#: ../src/guestfs-actions.pod:4673 msgid "guestfs_mountpoints" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4657 +#: ../src/guestfs-actions.pod:4675 #, no-wrap msgid "" " char **\n" @@ -12691,7 +12831,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4660 +#: ../src/guestfs-actions.pod:4678 msgid "" "This call is similar to C<guestfs_mounts>. That call returns a list of " "devices. This one returns a hash table (map) of device name to directory " @@ -12699,12 +12839,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4672 +#: ../src/guestfs-actions.pod:4690 msgid "guestfs_mounts" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4674 +#: ../src/guestfs-actions.pod:4692 #, no-wrap msgid "" " char **\n" @@ -12713,29 +12853,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4677 ../fish/guestfish-actions.pod:3136 +#: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3149 msgid "" "This returns the list of currently mounted filesystems. It returns the list " "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4680 ../fish/guestfish-actions.pod:3139 +#: ../src/guestfs-actions.pod:4698 ../fish/guestfish-actions.pod:3152 msgid "Some internal mounts are not shown." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4682 +#: ../src/guestfs-actions.pod:4700 msgid "See also: C<guestfs_mountpoints>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4690 +#: ../src/guestfs-actions.pod:4708 msgid "guestfs_mv" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4692 +#: ../src/guestfs-actions.pod:4710 #, no-wrap msgid "" " int\n" @@ -12746,19 +12886,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4697 ../fish/guestfish-actions.pod:3147 +#: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3160 msgid "" "This moves a file from C<src> to C<dest> where C<dest> is either a " "destination filename or destination directory." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4704 +#: ../src/guestfs-actions.pod:4722 msgid "guestfs_ntfs_3g_probe" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4706 +#: ../src/guestfs-actions.pod:4724 #, no-wrap msgid "" " int\n" @@ -12769,7 +12909,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4711 ../fish/guestfish-actions.pod:3154 +#: ../src/guestfs-actions.pod:4729 ../fish/guestfish-actions.pod:3167 msgid "" "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS " "C<device> for mountability. (Not all NTFS volumes can be mounted " @@ -12777,7 +12917,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3158 +#: ../src/guestfs-actions.pod:4733 ../fish/guestfish-actions.pod:3171 msgid "" "C<rw> is a boolean flag. Set it to true if you want to test if the volume " "can be mounted read-write. Set it to false if you want to test if the " @@ -12785,24 +12925,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4719 ../fish/guestfish-actions.pod:3162 +#: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3175 msgid "" "The return value is an integer which C<0> if the operation would succeed, or " "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4725 +#: ../src/guestfs-actions.pod:4743 msgid "(Added in 1.0.43)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4727 +#: ../src/guestfs-actions.pod:4745 msgid "guestfs_ntfsresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4729 +#: ../src/guestfs-actions.pod:4747 #, no-wrap msgid "" " int\n" @@ -12812,19 +12952,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4733 ../fish/guestfish-actions.pod:3170 +#: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3183 msgid "" "This command resizes an NTFS filesystem, expanding or shrinking it to the " "size of the underlying device. See also L<ntfsresize(8)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4741 +#: ../src/guestfs-actions.pod:4759 msgid "guestfs_ntfsresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4743 +#: ../src/guestfs-actions.pod:4761 #, no-wrap msgid "" " int\n" @@ -12835,24 +12975,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4748 +#: ../src/guestfs-actions.pod:4766 msgid "" "This command is the same as C<guestfs_ntfsresize> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4753 ../src/guestfs-actions.pod:5189 ../src/guestfs-actions.pod:5262 ../src/guestfs-actions.pod:5528 ../src/guestfs-actions.pod:7067 +#: ../src/guestfs-actions.pod:4771 ../src/guestfs-actions.pod:5207 ../src/guestfs-actions.pod:5280 ../src/guestfs-actions.pod:5546 ../src/guestfs-actions.pod:7113 msgid "(Added in 1.3.14)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4755 +#: ../src/guestfs-actions.pod:4773 msgid "guestfs_part_add" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4757 +#: ../src/guestfs-actions.pod:4775 #, no-wrap msgid "" " int\n" @@ -12865,14 +13005,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4764 +#: ../src/guestfs-actions.pod:4782 msgid "" "This command adds a partition to C<device>. If there is no partition table " "on the device, call C<guestfs_part_init> first." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4767 ../fish/guestfish-actions.pod:3188 +#: ../src/guestfs-actions.pod:4785 ../fish/guestfish-actions.pod:3201 msgid "" "The C<prlogex> parameter is the type of partition. Normally you should pass " "C<p> or C<primary> here, but MBR partition tables also support C<l> (or " @@ -12880,7 +13020,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4772 ../fish/guestfish-actions.pod:3193 +#: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3206 msgid "" "C<startsect> and C<endsect> are the start and end of the partition in " "I<sectors>. C<endsect> may be negative, which means it counts backwards " @@ -12888,24 +13028,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4776 +#: ../src/guestfs-actions.pod:4794 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " "C<guestfs_part_disk> to do that." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4781 ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:4872 ../src/guestfs-actions.pod:4950 ../src/guestfs-actions.pod:4988 ../src/guestfs-actions.pod:5007 ../src/guestfs-actions.pod:5047 +#: ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4837 ../src/guestfs-actions.pod:4890 ../src/guestfs-actions.pod:4968 ../src/guestfs-actions.pod:5006 ../src/guestfs-actions.pod:5025 ../src/guestfs-actions.pod:5065 msgid "(Added in 1.0.78)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4783 +#: ../src/guestfs-actions.pod:4801 msgid "guestfs_part_del" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4785 +#: ../src/guestfs-actions.pod:4803 #, no-wrap msgid "" " int\n" @@ -12916,24 +13056,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3204 +#: ../src/guestfs-actions.pod:4808 ../fish/guestfish-actions.pod:3217 msgid "This command deletes the partition numbered C<partnum> on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4792 ../fish/guestfish-actions.pod:3206 +#: ../src/guestfs-actions.pod:4810 ../fish/guestfish-actions.pod:3219 msgid "" "Note that in the case of MBR partitioning, deleting an extended partition " "also deletes any logical partitions it contains." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4800 +#: ../src/guestfs-actions.pod:4818 msgid "guestfs_part_disk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4802 +#: ../src/guestfs-actions.pod:4820 #, no-wrap msgid "" " int\n" @@ -12944,7 +13084,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4807 +#: ../src/guestfs-actions.pod:4825 msgid "" "This command is simply a combination of C<guestfs_part_init> followed by " "C<guestfs_part_add> to create a single primary partition covering the whole " @@ -12952,19 +13092,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4811 +#: ../src/guestfs-actions.pod:4829 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " "possible values are described in C<guestfs_part_init>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4821 +#: ../src/guestfs-actions.pod:4839 msgid "guestfs_part_get_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4823 +#: ../src/guestfs-actions.pod:4841 #, no-wrap msgid "" " int\n" @@ -12975,24 +13115,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4828 ../fish/guestfish-actions.pod:3228 +#: ../src/guestfs-actions.pod:4846 ../fish/guestfish-actions.pod:3241 msgid "" "This command returns true if the partition C<partnum> on C<device> has the " "bootable flag set." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4831 +#: ../src/guestfs-actions.pod:4849 msgid "See also C<guestfs_part_set_bootable>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4837 +#: ../src/guestfs-actions.pod:4855 msgid "guestfs_part_get_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4839 +#: ../src/guestfs-actions.pod:4857 #, no-wrap msgid "" " int\n" @@ -13003,14 +13143,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4844 ../fish/guestfish-actions.pod:3237 +#: ../src/guestfs-actions.pod:4862 ../fish/guestfish-actions.pod:3250 msgid "" "Returns the MBR type byte (also known as the ID byte) from the numbered " "partition C<partnum>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4847 ../src/guestfs-actions.pod:5023 +#: ../src/guestfs-actions.pod:4865 ../src/guestfs-actions.pod:5041 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -13018,12 +13158,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4855 +#: ../src/guestfs-actions.pod:4873 msgid "guestfs_part_get_parttype" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4857 +#: ../src/guestfs-actions.pod:4875 #, no-wrap msgid "" " char *\n" @@ -13033,14 +13173,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3248 +#: ../src/guestfs-actions.pod:4879 ../fish/guestfish-actions.pod:3261 msgid "" "This command examines the partition table on C<device> and returns the " "partition table type (format) being used." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4864 +#: ../src/guestfs-actions.pod:4882 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " @@ -13048,12 +13188,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4874 +#: ../src/guestfs-actions.pod:4892 msgid "guestfs_part_init" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4876 +#: ../src/guestfs-actions.pod:4894 #, no-wrap msgid "" " int\n" @@ -13064,7 +13204,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4881 ../fish/guestfish-actions.pod:3260 +#: ../src/guestfs-actions.pod:4899 ../fish/guestfish-actions.pod:3273 msgid "" "This creates an empty partition table on C<device> of one of the partition " "types listed below. Usually C<parttype> should be either C<msdos> or C<gpt> " @@ -13072,29 +13212,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4885 +#: ../src/guestfs-actions.pod:4903 msgid "" "Initially there are no partitions. Following this, you should call " "C<guestfs_part_add> for each partition required." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3267 +#: ../src/guestfs-actions.pod:4906 ../fish/guestfish-actions.pod:3280 msgid "Possible values for C<parttype> are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4892 ../fish/guestfish-actions.pod:3271 +#: ../src/guestfs-actions.pod:4910 ../fish/guestfish-actions.pod:3284 msgid "B<efi> | B<gpt>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4894 ../fish/guestfish-actions.pod:3273 +#: ../src/guestfs-actions.pod:4912 ../fish/guestfish-actions.pod:3286 msgid "Intel EFI / GPT partition table." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4896 ../fish/guestfish-actions.pod:3275 +#: ../src/guestfs-actions.pod:4914 ../fish/guestfish-actions.pod:3288 msgid "" "This is recommended for >= 2 TB partitions that will be accessed from Linux " "and Intel-based Mac OS X. It also has limited backwards compatibility with " @@ -13102,12 +13242,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4900 ../fish/guestfish-actions.pod:3279 +#: ../src/guestfs-actions.pod:4918 ../fish/guestfish-actions.pod:3292 msgid "B<mbr> | B<msdos>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4902 ../fish/guestfish-actions.pod:3281 +#: ../src/guestfs-actions.pod:4920 ../fish/guestfish-actions.pod:3294 msgid "" "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and " "Windows. This partition type will B<only> work for device sizes up to 2 " @@ -13115,97 +13255,97 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4909 ../fish/guestfish-actions.pod:3288 +#: ../src/guestfs-actions.pod:4927 ../fish/guestfish-actions.pod:3301 msgid "Other partition table types that may work but are not supported include:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4914 ../fish/guestfish-actions.pod:3293 +#: ../src/guestfs-actions.pod:4932 ../fish/guestfish-actions.pod:3306 msgid "B<aix>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4916 ../fish/guestfish-actions.pod:3295 +#: ../src/guestfs-actions.pod:4934 ../fish/guestfish-actions.pod:3308 msgid "AIX disk labels." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4918 ../fish/guestfish-actions.pod:3297 +#: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3310 msgid "B<amiga> | B<rdb>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4920 ../fish/guestfish-actions.pod:3299 +#: ../src/guestfs-actions.pod:4938 ../fish/guestfish-actions.pod:3312 msgid "Amiga \"Rigid Disk Block\" format." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4922 ../fish/guestfish-actions.pod:3301 +#: ../src/guestfs-actions.pod:4940 ../fish/guestfish-actions.pod:3314 msgid "B<bsd>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4924 ../fish/guestfish-actions.pod:3303 +#: ../src/guestfs-actions.pod:4942 ../fish/guestfish-actions.pod:3316 msgid "BSD disk labels." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4926 ../fish/guestfish-actions.pod:3305 +#: ../src/guestfs-actions.pod:4944 ../fish/guestfish-actions.pod:3318 msgid "B<dasd>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4928 ../fish/guestfish-actions.pod:3307 +#: ../src/guestfs-actions.pod:4946 ../fish/guestfish-actions.pod:3320 msgid "DASD, used on IBM mainframes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4930 ../fish/guestfish-actions.pod:3309 +#: ../src/guestfs-actions.pod:4948 ../fish/guestfish-actions.pod:3322 msgid "B<dvh>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4932 ../fish/guestfish-actions.pod:3311 +#: ../src/guestfs-actions.pod:4950 ../fish/guestfish-actions.pod:3324 msgid "MIPS/SGI volumes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4934 ../fish/guestfish-actions.pod:3313 +#: ../src/guestfs-actions.pod:4952 ../fish/guestfish-actions.pod:3326 msgid "B<mac>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3315 +#: ../src/guestfs-actions.pod:4954 ../fish/guestfish-actions.pod:3328 msgid "Old Mac partition format. Modern Macs use C<gpt>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4938 ../fish/guestfish-actions.pod:3317 +#: ../src/guestfs-actions.pod:4956 ../fish/guestfish-actions.pod:3330 msgid "B<pc98>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4940 ../fish/guestfish-actions.pod:3319 +#: ../src/guestfs-actions.pod:4958 ../fish/guestfish-actions.pod:3332 msgid "NEC PC-98 format, common in Japan apparently." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4942 ../fish/guestfish-actions.pod:3321 +#: ../src/guestfs-actions.pod:4960 ../fish/guestfish-actions.pod:3334 msgid "B<sun>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4944 ../fish/guestfish-actions.pod:3323 +#: ../src/guestfs-actions.pod:4962 ../fish/guestfish-actions.pod:3336 msgid "Sun disk labels." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4952 +#: ../src/guestfs-actions.pod:4970 msgid "guestfs_part_list" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4954 +#: ../src/guestfs-actions.pod:4972 #, no-wrap msgid "" " struct guestfs_partition_list *\n" @@ -13215,61 +13355,61 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4958 ../fish/guestfish-actions.pod:3331 +#: ../src/guestfs-actions.pod:4976 ../fish/guestfish-actions.pod:3344 msgid "" "This command parses the partition table on C<device> and returns the list of " "partitions found." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4961 ../fish/guestfish-actions.pod:3334 +#: ../src/guestfs-actions.pod:4979 ../fish/guestfish-actions.pod:3347 msgid "The fields in the returned structure are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4965 ../fish/guestfish-actions.pod:3338 +#: ../src/guestfs-actions.pod:4983 ../fish/guestfish-actions.pod:3351 msgid "B<part_num>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4967 ../fish/guestfish-actions.pod:3340 +#: ../src/guestfs-actions.pod:4985 ../fish/guestfish-actions.pod:3353 msgid "Partition number, counting from 1." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4969 ../fish/guestfish-actions.pod:3342 +#: ../src/guestfs-actions.pod:4987 ../fish/guestfish-actions.pod:3355 msgid "B<part_start>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4971 +#: ../src/guestfs-actions.pod:4989 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " "the device's sector size, see C<guestfs_blockdev_getss>." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4974 ../fish/guestfish-actions.pod:3347 +#: ../src/guestfs-actions.pod:4992 ../fish/guestfish-actions.pod:3360 msgid "B<part_end>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4976 ../fish/guestfish-actions.pod:3349 +#: ../src/guestfs-actions.pod:4994 ../fish/guestfish-actions.pod:3362 msgid "End of the partition in bytes." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:4978 ../fish/guestfish-actions.pod:3351 +#: ../src/guestfs-actions.pod:4996 ../fish/guestfish-actions.pod:3364 msgid "B<part_size>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4980 ../fish/guestfish-actions.pod:3353 +#: ../src/guestfs-actions.pod:4998 ../fish/guestfish-actions.pod:3366 msgid "Size of the partition in bytes." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4984 +#: ../src/guestfs-actions.pod:5002 msgid "" "This function returns a C<struct guestfs_partition_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_partition_list> after " @@ -13277,12 +13417,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:4990 +#: ../src/guestfs-actions.pod:5008 msgid "guestfs_part_set_bootable" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:4992 +#: ../src/guestfs-actions.pod:5010 #, no-wrap msgid "" " int\n" @@ -13294,14 +13434,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:4998 ../fish/guestfish-actions.pod:3361 +#: ../src/guestfs-actions.pod:5016 ../fish/guestfish-actions.pod:3374 msgid "" "This sets the bootable flag on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5001 ../fish/guestfish-actions.pod:3364 +#: ../src/guestfs-actions.pod:5019 ../fish/guestfish-actions.pod:3377 msgid "" "The bootable flag is used by some operating systems (notably Windows) to " "determine which partition to boot from. It is by no means universally " @@ -13309,12 +13449,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5009 +#: ../src/guestfs-actions.pod:5027 msgid "guestfs_part_set_mbr_id" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5011 +#: ../src/guestfs-actions.pod:5029 #, no-wrap msgid "" " int\n" @@ -13326,7 +13466,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5017 ../fish/guestfish-actions.pod:3372 +#: ../src/guestfs-actions.pod:5035 ../fish/guestfish-actions.pod:3385 msgid "" "Sets the MBR type byte (also known as the ID byte) of the numbered partition " "C<partnum> to C<idbyte>. Note that the type bytes quoted in most " @@ -13335,12 +13475,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5031 +#: ../src/guestfs-actions.pod:5049 msgid "guestfs_part_set_name" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5033 +#: ../src/guestfs-actions.pod:5051 #, no-wrap msgid "" " int\n" @@ -13352,26 +13492,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5039 ../fish/guestfish-actions.pod:3386 +#: ../src/guestfs-actions.pod:5057 ../fish/guestfish-actions.pod:3399 msgid "" "This sets the partition name on partition numbered C<partnum> on device " "C<device>. Note that partitions are numbered from 1." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5042 ../fish/guestfish-actions.pod:3389 +#: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3402 msgid "" "The partition name can only be set on certain types of partition table. " "This works on C<gpt> but not on C<mbr> partitions." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5049 +#: ../src/guestfs-actions.pod:5067 msgid "guestfs_part_to_dev" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5051 +#: ../src/guestfs-actions.pod:5069 #, no-wrap msgid "" " char *\n" @@ -13381,26 +13521,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5055 ../fish/guestfish-actions.pod:3396 +#: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3409 msgid "" "This function takes a partition name (eg. \"/dev/sdb1\") and removes the " "partition number, returning the device name (eg. \"/dev/sdb\")." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5059 +#: ../src/guestfs-actions.pod:5077 msgid "" "The named partition must exist, for example as a string returned from " "C<guestfs_list_partitions>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5067 +#: ../src/guestfs-actions.pod:5085 msgid "guestfs_ping_daemon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5069 +#: ../src/guestfs-actions.pod:5087 #, no-wrap msgid "" " int\n" @@ -13409,7 +13549,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5072 ../fish/guestfish-actions.pod:3407 +#: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3420 msgid "" "This is a test probe into the guestfs daemon running inside the qemu " "subprocess. Calling this function checks that the daemon responds to the " @@ -13418,12 +13558,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5081 +#: ../src/guestfs-actions.pod:5099 msgid "guestfs_pread" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5083 +#: ../src/guestfs-actions.pod:5101 #, no-wrap msgid "" " char *\n" @@ -13436,31 +13576,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3416 +#: ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3429 msgid "" "This command lets you read part of a file. It reads C<count> bytes of the " "file, starting at C<offset>, from file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5093 ../src/guestfs-actions.pod:5119 ../fish/guestfish-actions.pod:3419 ../fish/guestfish-actions.pod:3434 +#: ../src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5137 ../fish/guestfish-actions.pod:3432 ../fish/guestfish-actions.pod:3447 msgid "" "This may read fewer bytes than requested. For further details see the " "L<pread(2)> system call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5096 +#: ../src/guestfs-actions.pod:5114 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5107 +#: ../src/guestfs-actions.pod:5125 msgid "guestfs_pread_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5109 +#: ../src/guestfs-actions.pod:5127 #, no-wrap msgid "" " char *\n" @@ -13473,29 +13613,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5116 ../fish/guestfish-actions.pod:3431 +#: ../src/guestfs-actions.pod:5134 ../fish/guestfish-actions.pod:3444 msgid "" "This command lets you read part of a file. It reads C<count> bytes of " "C<device>, starting at C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5122 +#: ../src/guestfs-actions.pod:5140 msgid "See also C<guestfs_pread>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5131 +#: ../src/guestfs-actions.pod:5149 msgid "(Added in 1.5.21)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5133 +#: ../src/guestfs-actions.pod:5151 msgid "guestfs_pvcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5135 +#: ../src/guestfs-actions.pod:5153 #, no-wrap msgid "" " int\n" @@ -13505,19 +13645,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:3446 +#: ../src/guestfs-actions.pod:5157 ../fish/guestfish-actions.pod:3459 msgid "" "This creates an LVM physical volume on the named C<device>, where C<device> " "should usually be a partition name such as C</dev/sda1>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5147 +#: ../src/guestfs-actions.pod:5165 msgid "guestfs_pvremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5149 +#: ../src/guestfs-actions.pod:5167 #, no-wrap msgid "" " int\n" @@ -13527,14 +13667,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5153 ../fish/guestfish-actions.pod:3454 +#: ../src/guestfs-actions.pod:5171 ../fish/guestfish-actions.pod:3467 msgid "" "This wipes a physical volume C<device> so that LVM will no longer recognise " "it." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5156 ../fish/guestfish-actions.pod:3457 +#: ../src/guestfs-actions.pod:5174 ../fish/guestfish-actions.pod:3470 msgid "" "The implementation uses the C<pvremove> command which refuses to wipe " "physical volumes that contain any volume groups, so you have to remove those " @@ -13542,12 +13682,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5164 +#: ../src/guestfs-actions.pod:5182 msgid "guestfs_pvresize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5166 +#: ../src/guestfs-actions.pod:5184 #, no-wrap msgid "" " int\n" @@ -13557,19 +13697,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5170 ../fish/guestfish-actions.pod:3465 +#: ../src/guestfs-actions.pod:5188 ../fish/guestfish-actions.pod:3478 msgid "" "This resizes (expands or shrinks) an existing LVM physical volume to match " "the new size of the underlying device." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5177 +#: ../src/guestfs-actions.pod:5195 msgid "guestfs_pvresize_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5179 +#: ../src/guestfs-actions.pod:5197 #, no-wrap msgid "" " int\n" @@ -13580,19 +13720,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5184 +#: ../src/guestfs-actions.pod:5202 msgid "" "This command is the same as C<guestfs_pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5191 +#: ../src/guestfs-actions.pod:5209 msgid "guestfs_pvs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5193 +#: ../src/guestfs-actions.pod:5211 #, no-wrap msgid "" " char **\n" @@ -13601,31 +13741,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5196 ../fish/guestfish-actions.pod:3479 +#: ../src/guestfs-actions.pod:5214 ../fish/guestfish-actions.pod:3492 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5199 ../fish/guestfish-actions.pod:3482 +#: ../src/guestfs-actions.pod:5217 ../fish/guestfish-actions.pod:3495 msgid "" "This returns a list of just the device names that contain PVs " "(eg. C</dev/sda2>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5202 +#: ../src/guestfs-actions.pod:5220 msgid "See also C<guestfs_pvs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5210 +#: ../src/guestfs-actions.pod:5228 msgid "guestfs_pvs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5212 +#: ../src/guestfs-actions.pod:5230 #, no-wrap msgid "" " struct guestfs_lvm_pv_list *\n" @@ -13634,14 +13774,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5215 ../fish/guestfish-actions.pod:3491 +#: ../src/guestfs-actions.pod:5233 ../fish/guestfish-actions.pod:3504 msgid "" "List all the physical volumes detected. This is the equivalent of the " "L<pvs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5218 +#: ../src/guestfs-actions.pod:5236 msgid "" "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after " @@ -13649,12 +13789,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5224 +#: ../src/guestfs-actions.pod:5242 msgid "guestfs_pvuuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5226 +#: ../src/guestfs-actions.pod:5244 #, no-wrap msgid "" " char *\n" @@ -13664,17 +13804,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5230 ../fish/guestfish-actions.pod:3498 +#: ../src/guestfs-actions.pod:5248 ../fish/guestfish-actions.pod:3511 msgid "This command returns the UUID of the LVM PV C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5237 +#: ../src/guestfs-actions.pod:5255 msgid "guestfs_pwrite" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5239 +#: ../src/guestfs-actions.pod:5257 #, no-wrap msgid "" " int\n" @@ -13687,14 +13827,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5246 ../fish/guestfish-actions.pod:3504 +#: ../src/guestfs-actions.pod:5264 ../fish/guestfish-actions.pod:3517 msgid "" "This command writes to part of a file. It writes the data buffer C<content> " "to the file C<path> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5249 ../fish/guestfish-actions.pod:3507 +#: ../src/guestfs-actions.pod:5267 ../fish/guestfish-actions.pod:3520 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested. The return value is the " @@ -13704,17 +13844,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5255 +#: ../src/guestfs-actions.pod:5273 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5264 +#: ../src/guestfs-actions.pod:5282 msgid "guestfs_pwrite_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5266 +#: ../src/guestfs-actions.pod:5284 #, no-wrap msgid "" " int\n" @@ -13727,14 +13867,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5273 ../fish/guestfish-actions.pod:3522 +#: ../src/guestfs-actions.pod:5291 ../fish/guestfish-actions.pod:3535 msgid "" "This command writes to part of a device. It writes the data buffer " "C<content> to C<device> starting at offset C<offset>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5276 ../fish/guestfish-actions.pod:3525 +#: ../src/guestfs-actions.pod:5294 ../fish/guestfish-actions.pod:3538 msgid "" "This command implements the L<pwrite(2)> system call, and like that system " "call it may not write the full data requested (although short writes to disk " @@ -13742,22 +13882,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5281 +#: ../src/guestfs-actions.pod:5299 msgid "See also C<guestfs_pwrite>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5288 +#: ../src/guestfs-actions.pod:5306 msgid "(Added in 1.5.20)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5290 +#: ../src/guestfs-actions.pod:5308 msgid "guestfs_read_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5292 +#: ../src/guestfs-actions.pod:5310 #, no-wrap msgid "" " char *\n" @@ -13768,12 +13908,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5297 ../fish/guestfish-actions.pod:3539 +#: ../src/guestfs-actions.pod:5315 ../fish/guestfish-actions.pod:3552 msgid "This calls returns the contents of the file C<path> as a buffer." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5300 +#: ../src/guestfs-actions.pod:5318 msgid "" "Unlike C<guestfs_cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike C<guestfs_download>, this " @@ -13781,17 +13921,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5312 +#: ../src/guestfs-actions.pod:5330 msgid "(Added in 1.0.63)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5314 +#: ../src/guestfs-actions.pod:5332 msgid "guestfs_read_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5316 +#: ../src/guestfs-actions.pod:5334 #, no-wrap msgid "" " char **\n" @@ -13801,14 +13941,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5322 ../fish/guestfish-actions.pod:3556 +#: ../src/guestfs-actions.pod:5340 ../fish/guestfish-actions.pod:3569 msgid "" "The file contents are returned as a list of lines. Trailing C<LF> and " "C<CRLF> character sequences are I<not> returned." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5325 +#: ../src/guestfs-actions.pod:5343 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -13817,12 +13957,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5336 +#: ../src/guestfs-actions.pod:5354 msgid "guestfs_readdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5338 +#: ../src/guestfs-actions.pod:5356 #, no-wrap msgid "" " struct guestfs_dirent_list *\n" @@ -13832,12 +13972,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5342 ../fish/guestfish-actions.pod:3568 +#: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:3581 msgid "This returns the list of directory entries in directory C<dir>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5344 ../fish/guestfish-actions.pod:3570 +#: ../src/guestfs-actions.pod:5362 ../fish/guestfish-actions.pod:3583 msgid "" "All entries in the directory are returned, including C<.> and C<..>. The " "entries are I<not> sorted, but returned in the same order as the underlying " @@ -13845,104 +13985,104 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5348 ../fish/guestfish-actions.pod:3574 +#: ../src/guestfs-actions.pod:5366 ../fish/guestfish-actions.pod:3587 msgid "" "Also this call returns basic file type information about each file. The " "C<ftyp> field will contain one of the following characters:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5353 ../fish/guestfish-actions.pod:3579 +#: ../src/guestfs-actions.pod:5371 ../fish/guestfish-actions.pod:3592 msgid "'b'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5355 ../fish/guestfish-actions.pod:3581 +#: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:3594 msgid "Block special" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5357 ../fish/guestfish-actions.pod:3583 +#: ../src/guestfs-actions.pod:5375 ../fish/guestfish-actions.pod:3596 msgid "'c'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5359 ../fish/guestfish-actions.pod:3585 +#: ../src/guestfs-actions.pod:5377 ../fish/guestfish-actions.pod:3598 msgid "Char special" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5361 ../fish/guestfish-actions.pod:3587 +#: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3600 msgid "'d'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5363 ../fish/guestfish-actions.pod:3589 +#: ../src/guestfs-actions.pod:5381 ../fish/guestfish-actions.pod:3602 msgid "Directory" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5365 ../fish/guestfish-actions.pod:3591 +#: ../src/guestfs-actions.pod:5383 ../fish/guestfish-actions.pod:3604 msgid "'f'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5367 ../fish/guestfish-actions.pod:3593 +#: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3606 msgid "FIFO (named pipe)" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5369 ../fish/guestfish-actions.pod:3595 +#: ../src/guestfs-actions.pod:5387 ../fish/guestfish-actions.pod:3608 msgid "'l'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5371 ../fish/guestfish-actions.pod:3597 +#: ../src/guestfs-actions.pod:5389 ../fish/guestfish-actions.pod:3610 msgid "Symbolic link" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:3599 +#: ../src/guestfs-actions.pod:5391 ../fish/guestfish-actions.pod:3612 msgid "'r'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5375 ../fish/guestfish-actions.pod:3601 +#: ../src/guestfs-actions.pod:5393 ../fish/guestfish-actions.pod:3614 msgid "Regular file" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5377 ../fish/guestfish-actions.pod:3603 +#: ../src/guestfs-actions.pod:5395 ../fish/guestfish-actions.pod:3616 msgid "'s'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3605 +#: ../src/guestfs-actions.pod:5397 ../fish/guestfish-actions.pod:3618 msgid "Socket" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5381 ../fish/guestfish-actions.pod:3607 +#: ../src/guestfs-actions.pod:5399 ../fish/guestfish-actions.pod:3620 msgid "'u'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5383 ../fish/guestfish-actions.pod:3609 +#: ../src/guestfs-actions.pod:5401 ../fish/guestfish-actions.pod:3622 msgid "Unknown file type" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3611 +#: ../src/guestfs-actions.pod:5403 ../fish/guestfish-actions.pod:3624 msgid "'?'" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5387 ../fish/guestfish-actions.pod:3613 +#: ../src/guestfs-actions.pod:5405 ../fish/guestfish-actions.pod:3626 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5392 +#: ../src/guestfs-actions.pod:5410 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use C<guestfs_ls>. To get a printable directory for human " @@ -13950,7 +14090,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5396 +#: ../src/guestfs-actions.pod:5414 msgid "" "This function returns a C<struct guestfs_dirent_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_dirent_list> after " @@ -13958,12 +14098,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5402 +#: ../src/guestfs-actions.pod:5420 msgid "guestfs_readlink" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5404 +#: ../src/guestfs-actions.pod:5422 #, no-wrap msgid "" " char *\n" @@ -13973,17 +14113,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5408 ../fish/guestfish-actions.pod:3626 +#: ../src/guestfs-actions.pod:5426 ../fish/guestfish-actions.pod:3639 msgid "This command reads the target of a symbolic link." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5415 +#: ../src/guestfs-actions.pod:5433 msgid "guestfs_readlinklist" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5417 +#: ../src/guestfs-actions.pod:5435 #, no-wrap msgid "" " char **\n" @@ -13994,7 +14134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5422 ../fish/guestfish-actions.pod:3632 +#: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3645 msgid "" "This call allows you to do a C<readlink> operation on multiple files, where " "all files are in the directory C<path>. C<names> is the list of files from " @@ -14002,14 +14142,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5426 ../fish/guestfish-actions.pod:3636 +#: ../src/guestfs-actions.pod:5444 ../fish/guestfish-actions.pod:3649 msgid "" "On return you get a list of strings, with a one-to-one correspondence to the " "C<names> list. Each string is the value of the symbolic link." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5430 ../fish/guestfish-actions.pod:3640 +#: ../src/guestfs-actions.pod:5448 ../fish/guestfish-actions.pod:3653 msgid "" "If the C<readlink(2)> operation fails on any name, then the corresponding " "result string is the empty string C<\"\">. However the whole operation is " @@ -14019,7 +14159,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5437 ../fish/guestfish-actions.pod:3647 +#: ../src/guestfs-actions.pod:5455 ../fish/guestfish-actions.pod:3660 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. Very long directory listings " @@ -14028,12 +14168,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5450 +#: ../src/guestfs-actions.pod:5468 msgid "guestfs_realpath" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5452 +#: ../src/guestfs-actions.pod:5470 #, no-wrap msgid "" " char *\n" @@ -14043,19 +14183,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5456 ../fish/guestfish-actions.pod:3658 +#: ../src/guestfs-actions.pod:5474 ../fish/guestfish-actions.pod:3671 msgid "" "Return the canonicalized absolute pathname of C<path>. The returned path " "has no C<.>, C<..> or symbolic link path elements." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5464 +#: ../src/guestfs-actions.pod:5482 msgid "guestfs_removexattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5466 +#: ../src/guestfs-actions.pod:5484 #, no-wrap msgid "" " int\n" @@ -14066,22 +14206,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5471 ../fish/guestfish-actions.pod:3665 +#: ../src/guestfs-actions.pod:5489 ../fish/guestfish-actions.pod:3678 msgid "This call removes the extended attribute named C<xattr> of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5474 +#: ../src/guestfs-actions.pod:5492 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5480 +#: ../src/guestfs-actions.pod:5498 msgid "guestfs_resize2fs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5482 +#: ../src/guestfs-actions.pod:5500 #, no-wrap msgid "" " int\n" @@ -14091,14 +14231,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5486 ../fish/guestfish-actions.pod:3674 +#: ../src/guestfs-actions.pod:5504 ../fish/guestfish-actions.pod:3687 msgid "" "This resizes an ext2, ext3 or ext4 filesystem to match the size of the " "underlying device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5489 +#: ../src/guestfs-actions.pod:5507 msgid "" "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the " "C<device> before calling this command. For unknown reasons C<resize2fs> " @@ -14107,12 +14247,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5499 +#: ../src/guestfs-actions.pod:5517 msgid "guestfs_resize2fs_M" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5501 +#: ../src/guestfs-actions.pod:5519 #, no-wrap msgid "" " int\n" @@ -14122,7 +14262,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5505 +#: ../src/guestfs-actions.pod:5523 msgid "" "This command is the same as C<guestfs_resize2fs>, but the filesystem is " "resized to its minimum size. This works like the C<-M> option to the " @@ -14130,7 +14270,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5509 +#: ../src/guestfs-actions.pod:5527 msgid "" "To get the resulting size of the filesystem you should call " "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. " @@ -14139,12 +14279,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5516 +#: ../src/guestfs-actions.pod:5534 msgid "guestfs_resize2fs_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5518 +#: ../src/guestfs-actions.pod:5536 #, no-wrap msgid "" " int\n" @@ -14155,19 +14295,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5523 +#: ../src/guestfs-actions.pod:5541 msgid "" "This command is the same as C<guestfs_resize2fs> except that it allows you " "to specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5530 +#: ../src/guestfs-actions.pod:5548 msgid "guestfs_rm" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5532 +#: ../src/guestfs-actions.pod:5550 #, no-wrap msgid "" " int\n" @@ -14177,17 +14317,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5536 ../fish/guestfish-actions.pod:3707 +#: ../src/guestfs-actions.pod:5554 ../fish/guestfish-actions.pod:3720 msgid "Remove the single file C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5542 +#: ../src/guestfs-actions.pod:5560 msgid "guestfs_rm_rf" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5544 +#: ../src/guestfs-actions.pod:5562 #, no-wrap msgid "" " int\n" @@ -14197,19 +14337,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5548 ../fish/guestfish-actions.pod:3713 +#: ../src/guestfs-actions.pod:5566 ../fish/guestfish-actions.pod:3726 msgid "" "Remove the file or directory C<path>, recursively removing the contents if " "its a directory. This is like the C<rm -rf> shell command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5556 +#: ../src/guestfs-actions.pod:5574 msgid "guestfs_rmdir" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5558 +#: ../src/guestfs-actions.pod:5576 #, no-wrap msgid "" " int\n" @@ -14219,17 +14359,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5562 ../fish/guestfish-actions.pod:3721 +#: ../src/guestfs-actions.pod:5580 ../fish/guestfish-actions.pod:3734 msgid "Remove the single directory C<path>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5568 +#: ../src/guestfs-actions.pod:5586 msgid "guestfs_rmmountpoint" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5570 +#: ../src/guestfs-actions.pod:5588 #, no-wrap msgid "" " int\n" @@ -14239,19 +14379,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5574 +#: ../src/guestfs-actions.pod:5592 msgid "" "This calls removes a mountpoint that was previously created with " "C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5582 +#: ../src/guestfs-actions.pod:5600 msgid "guestfs_scrub_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5584 +#: ../src/guestfs-actions.pod:5602 #, no-wrap msgid "" " int\n" @@ -14261,31 +14401,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5588 ../fish/guestfish-actions.pod:3735 +#: ../src/guestfs-actions.pod:5606 ../fish/guestfish-actions.pod:3748 msgid "" "This command writes patterns over C<device> to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5591 ../src/guestfs-actions.pod:5612 ../src/guestfs-actions.pod:5631 ../fish/guestfish-actions.pod:3738 ../fish/guestfish-actions.pod:3753 ../fish/guestfish-actions.pod:3766 +#: ../src/guestfs-actions.pod:5609 ../src/guestfs-actions.pod:5630 ../src/guestfs-actions.pod:5649 ../fish/guestfish-actions.pod:3751 ../fish/guestfish-actions.pod:3766 ../fish/guestfish-actions.pod:3779 msgid "" "It is an interface to the L<scrub(1)> program. See that manual page for " "more details." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5617 ../src/guestfs-actions.pod:5636 +#: ../src/guestfs-actions.pod:5617 ../src/guestfs-actions.pod:5635 ../src/guestfs-actions.pod:5654 msgid "(Added in 1.0.52)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5601 +#: ../src/guestfs-actions.pod:5619 msgid "guestfs_scrub_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5603 +#: ../src/guestfs-actions.pod:5621 #, no-wrap msgid "" " int\n" @@ -14295,24 +14435,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5607 ../fish/guestfish-actions.pod:3748 +#: ../src/guestfs-actions.pod:5625 ../fish/guestfish-actions.pod:3761 msgid "" "This command writes patterns over a file to make data retrieval more " "difficult." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5610 ../fish/guestfish-actions.pod:3751 +#: ../src/guestfs-actions.pod:5628 ../fish/guestfish-actions.pod:3764 msgid "The file is I<removed> after scrubbing." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5619 +#: ../src/guestfs-actions.pod:5637 msgid "guestfs_scrub_freespace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5621 +#: ../src/guestfs-actions.pod:5639 #, no-wrap msgid "" " int\n" @@ -14322,7 +14462,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5625 +#: ../src/guestfs-actions.pod:5643 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, " @@ -14331,12 +14471,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5638 +#: ../src/guestfs-actions.pod:5656 msgid "guestfs_set_append" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5640 +#: ../src/guestfs-actions.pod:5658 #, no-wrap msgid "" " int\n" @@ -14346,33 +14486,80 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5644 ../fish/guestfish-actions.pod:3775 +#: ../src/guestfs-actions.pod:5662 ../fish/guestfish-actions.pod:3788 msgid "" "This function is used to add additional options to the guest kernel command " "line." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5647 ../fish/guestfish-actions.pod:3778 +#: ../src/guestfs-actions.pod:5665 ../fish/guestfish-actions.pod:3791 msgid "" "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> " "environment variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5650 ../fish/guestfish-actions.pod:3781 +#: ../src/guestfs-actions.pod:5668 ../fish/guestfish-actions.pod:3794 msgid "" "Setting C<append> to C<NULL> means I<no> additional options are passed " "(libguestfs always adds a few of its own)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5657 +#: ../src/guestfs-actions.pod:5675 +msgid "guestfs_set_attach_method" +msgstr "" + +#. type: verbatim +#: ../src/guestfs-actions.pod:5677 +#, no-wrap +msgid "" +" int\n" +" guestfs_set_attach_method (guestfs_h *g,\n" +" const char *attachmethod);\n" +"\n" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5681 ../fish/guestfish-actions.pod:3803 +msgid "" +"Set the method that libguestfs uses to connect to the back end guestfsd " +"daemon. Possible methods are:" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5688 ../fish/guestfish-actions.pod:3810 +msgid "" +"Launch an appliance and connect to it. This is the ordinary method and the " +"default." +msgstr "" + +#. type: =item +#: ../src/guestfs-actions.pod:5691 ../fish/guestfish-actions.pod:3813 +msgid "C<unix:I<path>>" +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5693 ../fish/guestfish-actions.pod:3815 +msgid "Connect to the Unix domain socket I<path>." +msgstr "" + +#. type: textblock +#: ../src/guestfs-actions.pod:5695 ../fish/guestfish-actions.pod:3817 +msgid "" +"This method lets you connect to an existing daemon or (using virtio-serial) " +"to a live guest. For more information, see L<guestfs(3)/ATTACHING TO " +"RUNNING DAEMONS>." +msgstr "" + +#. type: =head2 +#: ../src/guestfs-actions.pod:5703 msgid "guestfs_set_autosync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5659 +#: ../src/guestfs-actions.pod:5705 #, no-wrap msgid "" " int\n" @@ -14382,7 +14569,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5663 ../fish/guestfish-actions.pod:3790 +#: ../src/guestfs-actions.pod:5709 ../fish/guestfish-actions.pod:3829 msgid "" "If C<autosync> is true, this enables autosync. Libguestfs will make a best " "effort attempt to make filesystems consistent and synchronized when the " @@ -14390,19 +14577,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5668 ../fish/guestfish-actions.pod:3795 +#: ../src/guestfs-actions.pod:5714 ../fish/guestfish-actions.pod:3834 msgid "" "This is enabled by default (since libguestfs 1.5.24, previously it was " "disabled by default)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5675 +#: ../src/guestfs-actions.pod:5721 msgid "guestfs_set_direct" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5677 +#: ../src/guestfs-actions.pod:5723 #, no-wrap msgid "" " int\n" @@ -14412,14 +14599,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5681 ../fish/guestfish-actions.pod:3804 +#: ../src/guestfs-actions.pod:5727 ../fish/guestfish-actions.pod:3843 msgid "" "If the direct appliance mode flag is enabled, then stdin and stdout are " "passed directly through to the appliance once it is launched." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5685 +#: ../src/guestfs-actions.pod:5731 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by C<guestfs_set_log_message_callback>, but go straight to " @@ -14427,22 +14614,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5689 ../fish/guestfish-actions.pod:3812 +#: ../src/guestfs-actions.pod:5735 ../fish/guestfish-actions.pod:3851 msgid "You probably don't want to use this unless you know what you are doing." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5692 ../fish/guestfish-actions.pod:3815 +#: ../src/guestfs-actions.pod:5738 ../fish/guestfish-actions.pod:3854 msgid "The default is disabled." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5698 +#: ../src/guestfs-actions.pod:5744 msgid "guestfs_set_e2label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5700 +#: ../src/guestfs-actions.pod:5746 #, no-wrap msgid "" " int\n" @@ -14453,26 +14640,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5705 ../fish/guestfish-actions.pod:3821 +#: ../src/guestfs-actions.pod:5751 ../fish/guestfish-actions.pod:3860 msgid "" "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to " "C<label>. Filesystem labels are limited to 16 characters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5709 +#: ../src/guestfs-actions.pod:5755 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return " "the existing label on a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5716 +#: ../src/guestfs-actions.pod:5762 msgid "guestfs_set_e2uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5718 +#: ../src/guestfs-actions.pod:5764 #, no-wrap msgid "" " int\n" @@ -14483,7 +14670,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5723 ../fish/guestfish-actions.pod:3832 +#: ../src/guestfs-actions.pod:5769 ../fish/guestfish-actions.pod:3871 msgid "" "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to " "C<uuid>. The format of the UUID and alternatives such as C<clear>, " @@ -14491,19 +14678,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5728 +#: ../src/guestfs-actions.pod:5774 msgid "" "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return " "the existing UUID of a filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5735 +#: ../src/guestfs-actions.pod:5781 msgid "guestfs_set_memsize" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5737 +#: ../src/guestfs-actions.pod:5783 #, no-wrap msgid "" " int\n" @@ -14513,26 +14700,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5741 +#: ../src/guestfs-actions.pod:5787 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before C<guestfs_launch>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5745 ../fish/guestfish-actions.pod:3850 +#: ../src/guestfs-actions.pod:5791 ../fish/guestfish-actions.pod:3889 msgid "" "You can also change this by setting the environment variable " "C<LIBGUESTFS_MEMSIZE> before the handle is created." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5756 +#: ../src/guestfs-actions.pod:5802 msgid "guestfs_set_network" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5758 +#: ../src/guestfs-actions.pod:5804 #, no-wrap msgid "" " int\n" @@ -14542,33 +14729,33 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5762 ../fish/guestfish-actions.pod:3863 +#: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3902 msgid "" "If C<network> is true, then the network is enabled in the libguestfs " "appliance. The default is false." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5765 ../fish/guestfish-actions.pod:3866 +#: ../src/guestfs-actions.pod:5811 ../fish/guestfish-actions.pod:3905 msgid "" "This affects whether commands are able to access the network (see " "L<guestfs(3)/RUNNING COMMANDS>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5768 +#: ../src/guestfs-actions.pod:5814 msgid "" "You must call this before calling C<guestfs_launch>, otherwise it has no " "effect." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5775 +#: ../src/guestfs-actions.pod:5821 msgid "guestfs_set_path" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5777 +#: ../src/guestfs-actions.pod:5823 #, no-wrap msgid "" " int\n" @@ -14578,29 +14765,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5781 ../fish/guestfish-actions.pod:3878 +#: ../src/guestfs-actions.pod:5827 ../fish/guestfish-actions.pod:3917 msgid "Set the path that libguestfs searches for kernel and initrd.img." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5783 ../fish/guestfish-actions.pod:3880 +#: ../src/guestfs-actions.pod:5829 ../fish/guestfish-actions.pod:3919 msgid "" "The default is C<$libdir/guestfs> unless overridden by setting " "C<LIBGUESTFS_PATH> environment variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5786 ../fish/guestfish-actions.pod:3883 +#: ../src/guestfs-actions.pod:5832 ../fish/guestfish-actions.pod:3922 msgid "Setting C<path> to C<NULL> restores the default path." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5792 +#: ../src/guestfs-actions.pod:5838 msgid "guestfs_set_qemu" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5794 +#: ../src/guestfs-actions.pod:5840 #, no-wrap msgid "" " int\n" @@ -14610,29 +14797,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5798 ../fish/guestfish-actions.pod:3891 +#: ../src/guestfs-actions.pod:5844 ../fish/guestfish-actions.pod:3930 msgid "Set the qemu binary that we will use." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5800 ../fish/guestfish-actions.pod:3893 +#: ../src/guestfs-actions.pod:5846 ../fish/guestfish-actions.pod:3932 msgid "The default is chosen when the library was compiled by the configure script." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5803 ../fish/guestfish-actions.pod:3896 +#: ../src/guestfs-actions.pod:5849 ../fish/guestfish-actions.pod:3935 msgid "" "You can also override this by setting the C<LIBGUESTFS_QEMU> environment " "variable." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5806 ../fish/guestfish-actions.pod:3899 +#: ../src/guestfs-actions.pod:5852 ../fish/guestfish-actions.pod:3938 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3901 +#: ../src/guestfs-actions.pod:5854 ../fish/guestfish-actions.pod:3940 msgid "" "Note that you should call this function as early as possible after creating " "the handle. This is because some pre-launch operations depend on testing " @@ -14643,12 +14830,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5820 +#: ../src/guestfs-actions.pod:5866 msgid "guestfs_set_recovery_proc" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5822 +#: ../src/guestfs-actions.pod:5868 #, no-wrap msgid "" " int\n" @@ -14658,7 +14845,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5826 +#: ../src/guestfs-actions.pod:5872 msgid "" "If this is called with the parameter C<false> then C<guestfs_launch> does " "not create a recovery process. The purpose of the recovery process is to " @@ -14667,14 +14854,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5831 +#: ../src/guestfs-actions.pod:5877 msgid "" "This only has any effect if called before C<guestfs_launch>, and the default " "is true." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5834 ../fish/guestfish-actions.pod:3923 +#: ../src/guestfs-actions.pod:5880 ../fish/guestfish-actions.pod:3962 msgid "" "About the only time when you would want to disable this is if the main " "process will fork itself into the background (\"daemonize\" itself). In " @@ -14683,12 +14870,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5844 +#: ../src/guestfs-actions.pod:5890 msgid "guestfs_set_selinux" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5846 +#: ../src/guestfs-actions.pod:5892 #, no-wrap msgid "" " int\n" @@ -14698,26 +14885,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5850 ../fish/guestfish-actions.pod:3935 +#: ../src/guestfs-actions.pod:5896 ../fish/guestfish-actions.pod:3974 msgid "" "This sets the selinux flag that is passed to the appliance at boot time. " "The default is C<selinux=0> (disabled)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5853 ../fish/guestfish-actions.pod:3938 +#: ../src/guestfs-actions.pod:5899 ../fish/guestfish-actions.pod:3977 msgid "" "Note that if SELinux is enabled, it is always in Permissive mode " "(C<enforcing=0>)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5863 +#: ../src/guestfs-actions.pod:5909 msgid "guestfs_set_trace" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5865 +#: ../src/guestfs-actions.pod:5911 #, no-wrap msgid "" " int\n" @@ -14727,7 +14914,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5869 ../fish/guestfish-actions.pod:3950 +#: ../src/guestfs-actions.pod:5915 ../fish/guestfish-actions.pod:3989 msgid "" "If the command trace flag is set to 1, then commands are printed on stderr " "before they are executed in a format which is very similar to the one used " @@ -14737,26 +14924,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5876 ../fish/guestfish-actions.pod:3957 +#: ../src/guestfs-actions.pod:5922 ../fish/guestfish-actions.pod:3996 msgid "" "If you want to trace C API calls into libguestfs (and other libraries) then " "possibly a better way is to use the external ltrace(1) command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5880 ../fish/guestfish-actions.pod:3961 +#: ../src/guestfs-actions.pod:5926 ../fish/guestfish-actions.pod:4000 msgid "" "Command traces are disabled unless the environment variable " "C<LIBGUESTFS_TRACE> is defined and set to C<1>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5887 +#: ../src/guestfs-actions.pod:5933 msgid "guestfs_set_verbose" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5889 +#: ../src/guestfs-actions.pod:5935 #, no-wrap msgid "" " int\n" @@ -14766,24 +14953,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5893 ../fish/guestfish-actions.pod:3970 +#: ../src/guestfs-actions.pod:5939 ../fish/guestfish-actions.pod:4009 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5895 ../fish/guestfish-actions.pod:3972 +#: ../src/guestfs-actions.pod:5941 ../fish/guestfish-actions.pod:4011 msgid "" "Verbose messages are disabled unless the environment variable " "C<LIBGUESTFS_DEBUG> is defined and set to C<1>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5902 +#: ../src/guestfs-actions.pod:5948 msgid "guestfs_setcon" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5904 +#: ../src/guestfs-actions.pod:5950 #, no-wrap msgid "" " int\n" @@ -14793,24 +14980,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5908 ../fish/guestfish-actions.pod:3979 +#: ../src/guestfs-actions.pod:5954 ../fish/guestfish-actions.pod:4018 msgid "" "This sets the SELinux security context of the daemon to the string " "C<context>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5911 ../fish/guestfish-actions.pod:3982 +#: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4021 msgid "See the documentation about SELINUX in L<guestfs(3)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5917 +#: ../src/guestfs-actions.pod:5963 msgid "guestfs_setxattr" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5919 +#: ../src/guestfs-actions.pod:5965 #, no-wrap msgid "" " int\n" @@ -14823,24 +15010,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5926 ../fish/guestfish-actions.pod:3988 +#: ../src/guestfs-actions.pod:5972 ../fish/guestfish-actions.pod:4027 msgid "" "This call sets the extended attribute named C<xattr> of the file C<path> to " "the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5930 +#: ../src/guestfs-actions.pod:5976 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5936 +#: ../src/guestfs-actions.pod:5982 msgid "guestfs_sfdisk" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5938 +#: ../src/guestfs-actions.pod:5984 #, no-wrap msgid "" " int\n" @@ -14854,19 +15041,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5946 ../fish/guestfish-actions.pod:3998 +#: ../src/guestfs-actions.pod:5992 ../fish/guestfish-actions.pod:4037 msgid "" "This is a direct interface to the L<sfdisk(8)> program for creating " "partitions on block devices." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5949 ../fish/guestfish-actions.pod:4001 +#: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4040 msgid "C<device> should be a block device, for example C</dev/sda>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5951 ../fish/guestfish-actions.pod:4003 +#: ../src/guestfs-actions.pod:5997 ../fish/guestfish-actions.pod:4042 msgid "" "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and " "sectors on the device, which are passed directly to sfdisk as the I<-C>, " @@ -14877,14 +15064,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5959 ../fish/guestfish-actions.pod:4011 +#: ../src/guestfs-actions.pod:6005 ../fish/guestfish-actions.pod:4050 msgid "" "C<lines> is a list of lines that we feed to C<sfdisk>. For more information " "refer to the L<sfdisk(8)> manpage." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5962 ../fish/guestfish-actions.pod:4014 +#: ../src/guestfs-actions.pod:6008 ../fish/guestfish-actions.pod:4053 msgid "" "To create a single partition occupying the whole disk, you would pass " "C<lines> as a single element list, when the single element being the string " @@ -14892,17 +15079,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5966 +#: ../src/guestfs-actions.pod:6012 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5976 +#: ../src/guestfs-actions.pod:6022 msgid "guestfs_sfdiskM" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:5978 +#: ../src/guestfs-actions.pod:6024 #, no-wrap msgid "" " int\n" @@ -14913,7 +15100,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5983 +#: ../src/guestfs-actions.pod:6029 msgid "" "This is a simplified interface to the C<guestfs_sfdisk> command, where " "partition sizes are specified in megabytes only (rounded to the nearest " @@ -14922,19 +15109,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:5989 +#: ../src/guestfs-actions.pod:6035 msgid "" "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and " "C<guestfs_part_disk>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:5999 +#: ../src/guestfs-actions.pod:6045 msgid "guestfs_sfdisk_N" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6001 +#: ../src/guestfs-actions.pod:6047 #, no-wrap msgid "" " int\n" @@ -14949,31 +15136,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6010 ../fish/guestfish-actions.pod:4044 +#: ../src/guestfs-actions.pod:6056 ../fish/guestfish-actions.pod:4083 msgid "" "This runs L<sfdisk(8)> option to modify just the single partition C<n> " "(note: C<n> counts from 1)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6013 +#: ../src/guestfs-actions.pod:6059 msgid "" "For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> " "for the cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6016 +#: ../src/guestfs-actions.pod:6062 msgid "See also: C<guestfs_part_add>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6025 +#: ../src/guestfs-actions.pod:6071 msgid "guestfs_sfdisk_disk_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6027 +#: ../src/guestfs-actions.pod:6073 #, no-wrap msgid "" " char *\n" @@ -14983,7 +15170,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6031 +#: ../src/guestfs-actions.pod:6077 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -14992,17 +15179,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6036 ../src/guestfs-actions.pod:6052 ../fish/guestfish-actions.pod:4064 ../fish/guestfish-actions.pod:4073 +#: ../src/guestfs-actions.pod:6082 ../src/guestfs-actions.pod:6098 ../fish/guestfish-actions.pod:4103 ../fish/guestfish-actions.pod:4112 msgid "The result is in human-readable format, and not designed to be parsed." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6044 +#: ../src/guestfs-actions.pod:6090 msgid "guestfs_sfdisk_kernel_geometry" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6046 +#: ../src/guestfs-actions.pod:6092 #, no-wrap msgid "" " char *\n" @@ -15012,17 +15199,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6050 ../fish/guestfish-actions.pod:4071 +#: ../src/guestfs-actions.pod:6096 ../fish/guestfish-actions.pod:4110 msgid "This displays the kernel's idea of the geometry of C<device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6060 +#: ../src/guestfs-actions.pod:6106 msgid "guestfs_sfdisk_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6062 +#: ../src/guestfs-actions.pod:6108 #, no-wrap msgid "" " char *\n" @@ -15032,24 +15219,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6066 ../fish/guestfish-actions.pod:4080 +#: ../src/guestfs-actions.pod:6112 ../fish/guestfish-actions.pod:4119 msgid "" "This displays the partition table on C<device>, in the human-readable output " "of the L<sfdisk(8)> command. It is not intended to be parsed." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6070 +#: ../src/guestfs-actions.pod:6116 msgid "See also: C<guestfs_part_list>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6077 +#: ../src/guestfs-actions.pod:6123 msgid "guestfs_sh" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6079 +#: ../src/guestfs-actions.pod:6125 #, no-wrap msgid "" " char *\n" @@ -15059,19 +15246,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6083 ../fish/guestfish-actions.pod:4090 +#: ../src/guestfs-actions.pod:6129 ../fish/guestfish-actions.pod:4129 msgid "" "This call runs a command from the guest filesystem via the guest's " "C</bin/sh>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6086 +#: ../src/guestfs-actions.pod:6132 msgid "This is like C<guestfs_command>, but passes the command to:" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6088 ../fish/guestfish-actions.pod:4095 +#: ../src/guestfs-actions.pod:6134 ../fish/guestfish-actions.pod:4134 #, no-wrap msgid "" " /bin/sh -c \"command\"\n" @@ -15079,24 +15266,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6090 ../fish/guestfish-actions.pod:4097 +#: ../src/guestfs-actions.pod:6136 ../fish/guestfish-actions.pod:4136 msgid "" "Depending on the guest's shell, this usually results in wildcards being " "expanded, shell expressions being interpolated and so on." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6094 +#: ../src/guestfs-actions.pod:6140 msgid "All the provisos about C<guestfs_command> apply to this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6101 +#: ../src/guestfs-actions.pod:6147 msgid "guestfs_sh_lines" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6103 +#: ../src/guestfs-actions.pod:6149 #, no-wrap msgid "" " char **\n" @@ -15106,24 +15293,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6107 +#: ../src/guestfs-actions.pod:6153 msgid "" "This is the same as C<guestfs_sh>, but splits the result into a list of " "lines." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6110 +#: ../src/guestfs-actions.pod:6156 msgid "See also: C<guestfs_command_lines>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6118 +#: ../src/guestfs-actions.pod:6164 msgid "guestfs_sleep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6120 +#: ../src/guestfs-actions.pod:6166 #, no-wrap msgid "" " int\n" @@ -15133,22 +15320,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6124 ../fish/guestfish-actions.pod:4116 +#: ../src/guestfs-actions.pod:6170 ../fish/guestfish-actions.pod:4155 msgid "Sleep for C<secs> seconds." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6128 +#: ../src/guestfs-actions.pod:6174 msgid "(Added in 1.0.41)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6130 ../src/guestfs-structs.pod:109 +#: ../src/guestfs-actions.pod:6176 ../src/guestfs-structs.pod:109 msgid "guestfs_stat" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6132 +#: ../src/guestfs-actions.pod:6178 #, no-wrap msgid "" " struct guestfs_stat *\n" @@ -15158,17 +15345,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6138 ../fish/guestfish-actions.pod:4124 +#: ../src/guestfs-actions.pod:6184 ../fish/guestfish-actions.pod:4163 msgid "This is the same as the C<stat(2)> system call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6146 ../src/guestfs-structs.pod:135 +#: ../src/guestfs-actions.pod:6192 ../src/guestfs-structs.pod:135 msgid "guestfs_statvfs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6148 +#: ../src/guestfs-actions.pod:6194 #, no-wrap msgid "" " struct guestfs_statvfs *\n" @@ -15178,7 +15365,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6152 ../fish/guestfish-actions.pod:4130 +#: ../src/guestfs-actions.pod:6198 ../fish/guestfish-actions.pod:4169 msgid "" "Returns file system statistics for any mounted file system. C<path> should " "be a file or directory in the mounted file system (typically it is the mount " @@ -15186,24 +15373,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6156 ../fish/guestfish-actions.pod:4134 +#: ../src/guestfs-actions.pod:6202 ../fish/guestfish-actions.pod:4173 msgid "This is the same as the C<statvfs(2)> system call." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6158 +#: ../src/guestfs-actions.pod:6204 msgid "" "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_statvfs> after use>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6164 +#: ../src/guestfs-actions.pod:6210 msgid "guestfs_strings" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6166 +#: ../src/guestfs-actions.pod:6212 #, no-wrap msgid "" " char **\n" @@ -15213,19 +15400,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6170 ../fish/guestfish-actions.pod:4140 +#: ../src/guestfs-actions.pod:6216 ../fish/guestfish-actions.pod:4179 msgid "" "This runs the L<strings(1)> command on a file and returns the list of " "printable strings found." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6182 +#: ../src/guestfs-actions.pod:6228 msgid "guestfs_strings_e" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6184 +#: ../src/guestfs-actions.pod:6230 #, no-wrap msgid "" " char **\n" @@ -15236,93 +15423,93 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6189 +#: ../src/guestfs-actions.pod:6235 msgid "" "This is like the C<guestfs_strings> command, but allows you to specify the " "encoding of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6193 ../fish/guestfish-actions.pod:4154 +#: ../src/guestfs-actions.pod:6239 ../fish/guestfish-actions.pod:4193 msgid "Allowed encodings are:" msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6197 ../fish/guestfish-actions.pod:4158 +#: ../src/guestfs-actions.pod:6243 ../fish/guestfish-actions.pod:4197 msgid "s" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6199 +#: ../src/guestfs-actions.pod:6245 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what C<guestfs_strings> uses)." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6202 ../fish/guestfish-actions.pod:4163 +#: ../src/guestfs-actions.pod:6248 ../fish/guestfish-actions.pod:4202 msgid "S" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6204 ../fish/guestfish-actions.pod:4165 +#: ../src/guestfs-actions.pod:6250 ../fish/guestfish-actions.pod:4204 msgid "Single 8-bit-byte characters." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6206 ../fish/guestfish-actions.pod:4167 +#: ../src/guestfs-actions.pod:6252 ../fish/guestfish-actions.pod:4206 msgid "b" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6208 ../fish/guestfish-actions.pod:4169 +#: ../src/guestfs-actions.pod:6254 ../fish/guestfish-actions.pod:4208 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6211 ../fish/guestfish-actions.pod:4172 +#: ../src/guestfs-actions.pod:6257 ../fish/guestfish-actions.pod:4211 msgid "l (lower case letter L)" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6213 ../fish/guestfish-actions.pod:4174 +#: ../src/guestfs-actions.pod:6259 ../fish/guestfish-actions.pod:4213 msgid "" "16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for " "examining binaries in Windows guests." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6216 ../fish/guestfish-actions.pod:4177 +#: ../src/guestfs-actions.pod:6262 ../fish/guestfish-actions.pod:4216 msgid "B" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6218 ../fish/guestfish-actions.pod:4179 +#: ../src/guestfs-actions.pod:6264 ../fish/guestfish-actions.pod:4218 msgid "32-bit big endian such as UCS-4BE." msgstr "" #. type: =item -#: ../src/guestfs-actions.pod:6220 ../fish/guestfish-actions.pod:4181 +#: ../src/guestfs-actions.pod:6266 ../fish/guestfish-actions.pod:4220 msgid "L" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6222 ../fish/guestfish-actions.pod:4183 +#: ../src/guestfs-actions.pod:6268 ../fish/guestfish-actions.pod:4222 msgid "32-bit little endian such as UCS-4LE." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6226 ../fish/guestfish-actions.pod:4187 +#: ../src/guestfs-actions.pod:6272 ../fish/guestfish-actions.pod:4226 msgid "The returned strings are transcoded to UTF-8." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6237 +#: ../src/guestfs-actions.pod:6283 msgid "guestfs_swapoff_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6239 +#: ../src/guestfs-actions.pod:6285 #, no-wrap msgid "" " int\n" @@ -15332,19 +15519,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6243 +#: ../src/guestfs-actions.pod:6289 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See C<guestfs_swapon_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6251 +#: ../src/guestfs-actions.pod:6297 msgid "guestfs_swapoff_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6253 +#: ../src/guestfs-actions.pod:6299 #, no-wrap msgid "" " int\n" @@ -15354,17 +15541,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6257 ../fish/guestfish-actions.pod:4204 +#: ../src/guestfs-actions.pod:6303 ../fish/guestfish-actions.pod:4243 msgid "This command disables the libguestfs appliance swap on file." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6263 +#: ../src/guestfs-actions.pod:6309 msgid "guestfs_swapoff_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6265 +#: ../src/guestfs-actions.pod:6311 #, no-wrap msgid "" " int\n" @@ -15374,19 +15561,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6269 ../fish/guestfish-actions.pod:4210 +#: ../src/guestfs-actions.pod:6315 ../fish/guestfish-actions.pod:4249 msgid "" "This command disables the libguestfs appliance swap on labeled swap " "partition." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6276 +#: ../src/guestfs-actions.pod:6322 msgid "guestfs_swapoff_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6278 +#: ../src/guestfs-actions.pod:6324 #, no-wrap msgid "" " int\n" @@ -15396,19 +15583,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6282 ../fish/guestfish-actions.pod:4217 +#: ../src/guestfs-actions.pod:6328 ../fish/guestfish-actions.pod:4256 msgid "" "This command disables the libguestfs appliance swap partition with the given " "UUID." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6289 +#: ../src/guestfs-actions.pod:6335 msgid "guestfs_swapon_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6291 +#: ../src/guestfs-actions.pod:6337 #, no-wrap msgid "" " int\n" @@ -15418,7 +15605,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6295 +#: ../src/guestfs-actions.pod:6341 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -15426,7 +15613,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6300 ../fish/guestfish-actions.pod:4229 +#: ../src/guestfs-actions.pod:6346 ../fish/guestfish-actions.pod:4268 msgid "" "Note that you should not swap to existing guest swap partitions unless you " "know what you are doing. They may contain hibernation information, or other " @@ -15436,12 +15623,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6311 +#: ../src/guestfs-actions.pod:6357 msgid "guestfs_swapon_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6313 +#: ../src/guestfs-actions.pod:6359 #, no-wrap msgid "" " int\n" @@ -15451,19 +15638,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6317 +#: ../src/guestfs-actions.pod:6363 msgid "" "This command enables swap to a file. See C<guestfs_swapon_device> for other " "notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6324 +#: ../src/guestfs-actions.pod:6370 msgid "guestfs_swapon_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6326 +#: ../src/guestfs-actions.pod:6372 #, no-wrap msgid "" " int\n" @@ -15473,19 +15660,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6330 +#: ../src/guestfs-actions.pod:6376 msgid "" "This command enables swap to a labeled swap partition. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6337 +#: ../src/guestfs-actions.pod:6383 msgid "guestfs_swapon_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6339 +#: ../src/guestfs-actions.pod:6385 #, no-wrap msgid "" " int\n" @@ -15495,19 +15682,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6343 +#: ../src/guestfs-actions.pod:6389 msgid "" "This command enables swap to a swap partition with the given UUID. See " "C<guestfs_swapon_device> for other notes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6350 +#: ../src/guestfs-actions.pod:6396 msgid "guestfs_sync" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6352 +#: ../src/guestfs-actions.pod:6398 #, no-wrap msgid "" " int\n" @@ -15516,26 +15703,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6355 ../fish/guestfish-actions.pod:4261 +#: ../src/guestfs-actions.pod:6401 ../fish/guestfish-actions.pod:4300 msgid "" "This syncs the disk, so that any writes are flushed through to the " "underlying disk image." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6358 ../fish/guestfish-actions.pod:4264 +#: ../src/guestfs-actions.pod:6404 ../fish/guestfish-actions.pod:4303 msgid "" "You should always call this if you have modified a disk image, before " "closing the handle." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6365 +#: ../src/guestfs-actions.pod:6411 msgid "guestfs_tail" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6367 +#: ../src/guestfs-actions.pod:6413 #, no-wrap msgid "" " char **\n" @@ -15545,17 +15732,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6371 ../fish/guestfish-actions.pod:4271 +#: ../src/guestfs-actions.pod:6417 ../fish/guestfish-actions.pod:4310 msgid "This command returns up to the last 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6383 +#: ../src/guestfs-actions.pod:6429 msgid "guestfs_tail_n" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6385 +#: ../src/guestfs-actions.pod:6431 #, no-wrap msgid "" " char **\n" @@ -15566,26 +15753,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6390 ../fish/guestfish-actions.pod:4281 +#: ../src/guestfs-actions.pod:6436 ../fish/guestfish-actions.pod:4320 msgid "" "If the parameter C<nrlines> is a positive number, this returns the last " "C<nrlines> lines of the file C<path>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6393 ../fish/guestfish-actions.pod:4284 +#: ../src/guestfs-actions.pod:6439 ../fish/guestfish-actions.pod:4323 msgid "" "If the parameter C<nrlines> is a negative number, this returns lines from " "the file C<path>, starting with the C<-nrlines>th line." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6407 +#: ../src/guestfs-actions.pod:6453 msgid "guestfs_tar_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6409 +#: ../src/guestfs-actions.pod:6455 #, no-wrap msgid "" " int\n" @@ -15596,29 +15783,29 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6414 ../fish/guestfish-actions.pod:4296 +#: ../src/guestfs-actions.pod:6460 ../fish/guestfish-actions.pod:4335 msgid "" "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6417 +#: ../src/guestfs-actions.pod:6463 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6422 ../src/guestfs-actions.pod:6439 ../src/guestfs-actions.pod:6455 ../src/guestfs-actions.pod:6471 +#: ../src/guestfs-actions.pod:6468 ../src/guestfs-actions.pod:6485 ../src/guestfs-actions.pod:6501 ../src/guestfs-actions.pod:6517 msgid "(Added in 1.0.3)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6424 +#: ../src/guestfs-actions.pod:6470 msgid "guestfs_tar_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6426 +#: ../src/guestfs-actions.pod:6472 #, no-wrap msgid "" " int\n" @@ -15629,26 +15816,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6431 ../fish/guestfish-actions.pod:4308 +#: ../src/guestfs-actions.pod:6477 ../fish/guestfish-actions.pod:4347 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarfile>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6434 +#: ../src/guestfs-actions.pod:6480 msgid "" "To download a compressed tarball, use C<guestfs_tgz_out> or " "C<guestfs_txz_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6441 +#: ../src/guestfs-actions.pod:6487 msgid "guestfs_tgz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6443 +#: ../src/guestfs-actions.pod:6489 #, no-wrap msgid "" " int\n" @@ -15659,24 +15846,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6448 ../fish/guestfish-actions.pod:4320 +#: ../src/guestfs-actions.pod:6494 ../fish/guestfish-actions.pod:4359 msgid "" "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> " "tar file) into C<directory>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6451 +#: ../src/guestfs-actions.pod:6497 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6457 +#: ../src/guestfs-actions.pod:6503 msgid "guestfs_tgz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6459 +#: ../src/guestfs-actions.pod:6505 #, no-wrap msgid "" " int\n" @@ -15687,24 +15874,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6464 ../fish/guestfish-actions.pod:4331 +#: ../src/guestfs-actions.pod:6510 ../fish/guestfish-actions.pod:4370 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6467 +#: ../src/guestfs-actions.pod:6513 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6473 +#: ../src/guestfs-actions.pod:6519 msgid "guestfs_touch" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6475 +#: ../src/guestfs-actions.pod:6521 #, no-wrap msgid "" " int\n" @@ -15714,7 +15901,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6479 ../fish/guestfish-actions.pod:4342 +#: ../src/guestfs-actions.pod:6525 ../fish/guestfish-actions.pod:4381 msgid "" "Touch acts like the L<touch(1)> command. It can be used to update the " "timestamps on a file, or, if the file does not exist, to create a new " @@ -15722,19 +15909,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6483 ../fish/guestfish-actions.pod:4346 +#: ../src/guestfs-actions.pod:6529 ../fish/guestfish-actions.pod:4385 msgid "" "This command only works on regular files, and will fail on other file types " "such as directories, symbolic links, block special etc." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6490 +#: ../src/guestfs-actions.pod:6536 msgid "guestfs_truncate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6492 +#: ../src/guestfs-actions.pod:6538 #, no-wrap msgid "" " int\n" @@ -15744,19 +15931,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6496 ../fish/guestfish-actions.pod:4353 +#: ../src/guestfs-actions.pod:6542 ../fish/guestfish-actions.pod:4392 msgid "" "This command truncates C<path> to a zero-length file. The file must exist " "already." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6503 +#: ../src/guestfs-actions.pod:6549 msgid "guestfs_truncate_size" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6505 +#: ../src/guestfs-actions.pod:6551 #, no-wrap msgid "" " int\n" @@ -15767,14 +15954,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6510 ../fish/guestfish-actions.pod:4360 +#: ../src/guestfs-actions.pod:6556 ../fish/guestfish-actions.pod:4399 msgid "" "This command truncates C<path> to size C<size> bytes. The file must exist " "already." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6513 +#: ../src/guestfs-actions.pod:6559 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -15783,12 +15970,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6523 +#: ../src/guestfs-actions.pod:6569 msgid "guestfs_tune2fs_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6525 +#: ../src/guestfs-actions.pod:6571 #, no-wrap msgid "" " char **\n" @@ -15798,14 +15985,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6529 ../fish/guestfish-actions.pod:4373 +#: ../src/guestfs-actions.pod:6575 ../fish/guestfish-actions.pod:4412 msgid "" "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on " "C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6532 ../fish/guestfish-actions.pod:4376 +#: ../src/guestfs-actions.pod:6578 ../fish/guestfish-actions.pod:4415 msgid "" "It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage " "for more details. The list of fields returned isn't clearly defined, and " @@ -15814,12 +16001,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6545 +#: ../src/guestfs-actions.pod:6591 msgid "guestfs_txz_in" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6547 +#: ../src/guestfs-actions.pod:6593 #, no-wrap msgid "" " int\n" @@ -15830,19 +16017,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6552 ../fish/guestfish-actions.pod:4385 +#: ../src/guestfs-actions.pod:6598 ../fish/guestfish-actions.pod:4424 msgid "" "This command uploads and unpacks local file C<tarball> (an I<xz compressed> " "tar file) into C<directory>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6559 +#: ../src/guestfs-actions.pod:6605 msgid "guestfs_txz_out" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6561 +#: ../src/guestfs-actions.pod:6607 #, no-wrap msgid "" " int\n" @@ -15853,19 +16040,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6566 ../fish/guestfish-actions.pod:4394 +#: ../src/guestfs-actions.pod:6612 ../fish/guestfish-actions.pod:4433 msgid "" "This command packs the contents of C<directory> and downloads it to local " "file C<tarball> (as an xz compressed tar archive)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6573 +#: ../src/guestfs-actions.pod:6619 msgid "guestfs_umask" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6575 +#: ../src/guestfs-actions.pod:6621 #, no-wrap msgid "" " int\n" @@ -15875,14 +16062,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6579 ../fish/guestfish-actions.pod:4403 +#: ../src/guestfs-actions.pod:6625 ../fish/guestfish-actions.pod:4442 msgid "" "This function sets the mask used for creating new files and device nodes to " "C<mask & 0777>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6582 ../fish/guestfish-actions.pod:4406 +#: ../src/guestfs-actions.pod:6628 ../fish/guestfish-actions.pod:4445 msgid "" "Typical umask values would be C<022> which creates new files with " "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates " @@ -15890,7 +16077,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6587 ../fish/guestfish-actions.pod:4411 +#: ../src/guestfs-actions.pod:6633 ../fish/guestfish-actions.pod:4450 msgid "" "The default umask is C<022>. This is important because it means that " "directories and device nodes will be created with C<0644> or C<0755> mode " @@ -15898,24 +16085,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6591 +#: ../src/guestfs-actions.pod:6637 msgid "" "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, " "C<guestfs_mkdir>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6594 ../fish/guestfish-actions.pod:4418 +#: ../src/guestfs-actions.pod:6640 ../fish/guestfish-actions.pod:4457 msgid "This call returns the previous umask." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6600 +#: ../src/guestfs-actions.pod:6646 msgid "guestfs_umount" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6602 +#: ../src/guestfs-actions.pod:6648 #, no-wrap msgid "" " int\n" @@ -15925,19 +16112,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6606 ../fish/guestfish-actions.pod:4426 +#: ../src/guestfs-actions.pod:6652 ../fish/guestfish-actions.pod:4465 msgid "" "This unmounts the given filesystem. The filesystem may be specified either " "by its mountpoint (path) or the device which contains the filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6614 +#: ../src/guestfs-actions.pod:6660 msgid "guestfs_umount_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6616 +#: ../src/guestfs-actions.pod:6662 #, no-wrap msgid "" " int\n" @@ -15946,22 +16133,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6619 ../fish/guestfish-actions.pod:4436 +#: ../src/guestfs-actions.pod:6665 ../fish/guestfish-actions.pod:4475 msgid "This unmounts all mounted filesystems." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6621 ../fish/guestfish-actions.pod:4438 +#: ../src/guestfs-actions.pod:6667 ../fish/guestfish-actions.pod:4477 msgid "Some internal mounts are not unmounted by this call." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6627 +#: ../src/guestfs-actions.pod:6673 msgid "guestfs_upload" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6629 +#: ../src/guestfs-actions.pod:6675 #, no-wrap msgid "" " int\n" @@ -15972,22 +16159,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6634 ../src/guestfs-actions.pod:6658 ../fish/guestfish-actions.pod:4444 ../fish/guestfish-actions.pod:4457 +#: ../src/guestfs-actions.pod:6680 ../src/guestfs-actions.pod:6704 ../fish/guestfish-actions.pod:4483 ../fish/guestfish-actions.pod:4496 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6639 +#: ../src/guestfs-actions.pod:6685 msgid "See also C<guestfs_download>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6650 +#: ../src/guestfs-actions.pod:6696 msgid "guestfs_upload_offset" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6652 +#: ../src/guestfs-actions.pod:6698 #, no-wrap msgid "" " int\n" @@ -15999,7 +16186,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6661 ../fish/guestfish-actions.pod:4460 +#: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4499 msgid "" "C<remotefilename> is overwritten starting at the byte C<offset> specified. " "The intention is to overwrite parts of existing files or devices, although " @@ -16009,7 +16196,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6668 +#: ../src/guestfs-actions.pod:6714 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with C<guestfs_pwrite>, and this call always writes the " @@ -16017,17 +16204,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6673 +#: ../src/guestfs-actions.pod:6719 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6684 +#: ../src/guestfs-actions.pod:6730 msgid "guestfs_utimens" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6686 +#: ../src/guestfs-actions.pod:6732 #, no-wrap msgid "" " int\n" @@ -16041,26 +16228,26 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6694 ../fish/guestfish-actions.pod:4480 +#: ../src/guestfs-actions.pod:6740 ../fish/guestfish-actions.pod:4519 msgid "This command sets the timestamps of a file with nanosecond precision." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6697 ../fish/guestfish-actions.pod:4483 +#: ../src/guestfs-actions.pod:6743 ../fish/guestfish-actions.pod:4522 msgid "" "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds " "from the epoch." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6700 ../fish/guestfish-actions.pod:4486 +#: ../src/guestfs-actions.pod:6746 ../fish/guestfish-actions.pod:4525 msgid "" "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and " "nanoseconds from the epoch." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6703 ../fish/guestfish-actions.pod:4489 +#: ../src/guestfs-actions.pod:6749 ../fish/guestfish-actions.pod:4528 msgid "" "If the C<*nsecs> field contains the special value C<-1> then the " "corresponding timestamp is set to the current time. (The C<*secs> field is " @@ -16068,7 +16255,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4493 +#: ../src/guestfs-actions.pod:6753 ../fish/guestfish-actions.pod:4532 msgid "" "If the C<*nsecs> field contains the special value C<-2> then the " "corresponding timestamp is left unchanged. (The C<*secs> field is ignored " @@ -16076,12 +16263,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6715 ../src/guestfs-structs.pod:175 +#: ../src/guestfs-actions.pod:6761 ../src/guestfs-structs.pod:175 msgid "guestfs_version" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6717 +#: ../src/guestfs-actions.pod:6763 #, no-wrap msgid "" " struct guestfs_version *\n" @@ -16090,12 +16277,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6720 ../fish/guestfish-actions.pod:4501 +#: ../src/guestfs-actions.pod:6766 ../fish/guestfish-actions.pod:4540 msgid "Return the libguestfs version number that the program is linked against." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6723 ../fish/guestfish-actions.pod:4504 +#: ../src/guestfs-actions.pod:6769 ../fish/guestfish-actions.pod:4543 msgid "" "Note that because of dynamic linking this is not necessarily the version of " "libguestfs that you compiled against. You can compile the program, and then " @@ -16104,7 +16291,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6728 ../fish/guestfish-actions.pod:4509 +#: ../src/guestfs-actions.pod:6774 ../fish/guestfish-actions.pod:4548 msgid "" "This call was added in version C<1.0.58>. In previous versions of " "libguestfs there was no way to get the version number. From C code you can " @@ -16113,7 +16300,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6734 ../fish/guestfish-actions.pod:4515 +#: ../src/guestfs-actions.pod:6780 ../fish/guestfish-actions.pod:4554 msgid "" "The call returns a structure with four elements. The first three (C<major>, " "C<minor> and C<release>) are numbers and correspond to the usual version " @@ -16122,17 +16309,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6740 ../fish/guestfish-actions.pod:4521 +#: ../src/guestfs-actions.pod:6786 ../fish/guestfish-actions.pod:4560 msgid "To construct the original version string: C<$major.$minor.$release$extra>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6743 ../fish/guestfish-actions.pod:4524 +#: ../src/guestfs-actions.pod:6789 ../fish/guestfish-actions.pod:4563 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6745 +#: ../src/guestfs-actions.pod:6791 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -16141,24 +16328,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6751 +#: ../src/guestfs-actions.pod:6797 msgid "" "This function returns a C<struct guestfs_version *>, or NULL if there was an " "error. I<The caller must call C<guestfs_free_version> after use>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6755 +#: ../src/guestfs-actions.pod:6801 msgid "(Added in 1.0.58)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6757 +#: ../src/guestfs-actions.pod:6803 msgid "guestfs_vfs_label" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6759 +#: ../src/guestfs-actions.pod:6805 #, no-wrap msgid "" " char *\n" @@ -16168,32 +16355,32 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6763 ../fish/guestfish-actions.pod:4536 +#: ../src/guestfs-actions.pod:6809 ../fish/guestfish-actions.pod:4575 msgid "This returns the filesystem label of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6766 ../fish/guestfish-actions.pod:4539 +#: ../src/guestfs-actions.pod:6812 ../fish/guestfish-actions.pod:4578 msgid "If the filesystem is unlabeled, this returns the empty string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6768 +#: ../src/guestfs-actions.pod:6814 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6773 ../src/guestfs-actions.pod:6810 +#: ../src/guestfs-actions.pod:6819 ../src/guestfs-actions.pod:6856 msgid "(Added in 1.3.18)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6775 +#: ../src/guestfs-actions.pod:6821 msgid "guestfs_vfs_type" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6777 +#: ../src/guestfs-actions.pod:6823 #, no-wrap msgid "" " char *\n" @@ -16203,14 +16390,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6781 ../fish/guestfish-actions.pod:4547 +#: ../src/guestfs-actions.pod:6827 ../fish/guestfish-actions.pod:4586 msgid "" "This command gets the filesystem type corresponding to the filesystem on " "C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6784 ../fish/guestfish-actions.pod:4550 +#: ../src/guestfs-actions.pod:6830 ../fish/guestfish-actions.pod:4589 msgid "" "For most filesystems, the result is the name of the Linux VFS module which " "would be used to mount this filesystem if you mounted it without specifying " @@ -16218,12 +16405,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6794 +#: ../src/guestfs-actions.pod:6840 msgid "guestfs_vfs_uuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6796 +#: ../src/guestfs-actions.pod:6842 #, no-wrap msgid "" " char *\n" @@ -16233,27 +16420,27 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6800 ../fish/guestfish-actions.pod:4559 +#: ../src/guestfs-actions.pod:6846 ../fish/guestfish-actions.pod:4598 msgid "This returns the filesystem UUID of the filesystem on C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6803 ../fish/guestfish-actions.pod:4562 +#: ../src/guestfs-actions.pod:6849 ../fish/guestfish-actions.pod:4601 msgid "If the filesystem does not have a UUID, this returns the empty string." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6805 +#: ../src/guestfs-actions.pod:6851 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6812 +#: ../src/guestfs-actions.pod:6858 msgid "guestfs_vg_activate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6814 +#: ../src/guestfs-actions.pod:6860 #, no-wrap msgid "" " int\n" @@ -16264,7 +16451,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6819 ../fish/guestfish-actions.pod:4570 +#: ../src/guestfs-actions.pod:6865 ../fish/guestfish-actions.pod:4609 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in the listed volume groups C<volgroups>. If activated, then they " @@ -16273,24 +16460,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6825 ../fish/guestfish-actions.pod:4576 +#: ../src/guestfs-actions.pod:6871 ../fish/guestfish-actions.pod:4615 msgid "This command is the same as running C<vgchange -a y|n volgroups...>" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6827 ../fish/guestfish-actions.pod:4578 +#: ../src/guestfs-actions.pod:6873 ../fish/guestfish-actions.pod:4617 msgid "" "Note that if C<volgroups> is an empty list then B<all> volume groups are " "activated or deactivated." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6834 +#: ../src/guestfs-actions.pod:6880 msgid "guestfs_vg_activate_all" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6836 +#: ../src/guestfs-actions.pod:6882 #, no-wrap msgid "" " int\n" @@ -16300,7 +16487,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6840 ../fish/guestfish-actions.pod:4585 +#: ../src/guestfs-actions.pod:6886 ../fish/guestfish-actions.pod:4624 msgid "" "This command activates or (if C<activate> is false) deactivates all logical " "volumes in all volume groups. If activated, then they are made known to the " @@ -16309,17 +16496,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6846 ../fish/guestfish-actions.pod:4591 +#: ../src/guestfs-actions.pod:6892 ../fish/guestfish-actions.pod:4630 msgid "This command is the same as running C<vgchange -a y|n>" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6852 +#: ../src/guestfs-actions.pod:6898 msgid "guestfs_vgcreate" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6854 +#: ../src/guestfs-actions.pod:6900 #, no-wrap msgid "" " int\n" @@ -16330,19 +16517,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6859 ../fish/guestfish-actions.pod:4597 +#: ../src/guestfs-actions.pod:6905 ../fish/guestfish-actions.pod:4636 msgid "" "This creates an LVM volume group called C<volgroup> from the non-empty list " "of physical volumes C<physvols>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6866 +#: ../src/guestfs-actions.pod:6912 msgid "guestfs_vglvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6868 +#: ../src/guestfs-actions.pod:6914 #, no-wrap msgid "" " char **\n" @@ -16352,31 +16539,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6872 ../fish/guestfish-actions.pod:4604 +#: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4643 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the logical " "volumes created in this volume group." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6875 +#: ../src/guestfs-actions.pod:6921 msgid "" "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to " "associate logical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6878 +#: ../src/guestfs-actions.pod:6924 msgid "See also C<guestfs_vgpvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6886 +#: ../src/guestfs-actions.pod:6932 msgid "guestfs_vgpvuuids" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6888 +#: ../src/guestfs-actions.pod:6934 #, no-wrap msgid "" " char **\n" @@ -16386,31 +16573,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6892 ../fish/guestfish-actions.pod:4616 +#: ../src/guestfs-actions.pod:6938 ../fish/guestfish-actions.pod:4655 msgid "" "Given a VG called C<vgname>, this returns the UUIDs of all the physical " "volumes that this volume group resides on." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6895 +#: ../src/guestfs-actions.pod:6941 msgid "" "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to " "associate physical volumes and volume groups." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6898 +#: ../src/guestfs-actions.pod:6944 msgid "See also C<guestfs_vglvuuids>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6906 +#: ../src/guestfs-actions.pod:6952 msgid "guestfs_vgremove" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6908 +#: ../src/guestfs-actions.pod:6954 #, no-wrap msgid "" " int\n" @@ -16420,22 +16607,22 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6912 ../fish/guestfish-actions.pod:4628 +#: ../src/guestfs-actions.pod:6958 ../fish/guestfish-actions.pod:4667 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6914 ../fish/guestfish-actions.pod:4630 +#: ../src/guestfs-actions.pod:6960 ../fish/guestfish-actions.pod:4669 msgid "This also forcibly removes all logical volumes in the volume group (if any)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6921 +#: ../src/guestfs-actions.pod:6967 msgid "guestfs_vgrename" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6923 +#: ../src/guestfs-actions.pod:6969 #, no-wrap msgid "" " int\n" @@ -16446,17 +16633,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6928 ../fish/guestfish-actions.pod:4637 +#: ../src/guestfs-actions.pod:6974 ../fish/guestfish-actions.pod:4676 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6934 +#: ../src/guestfs-actions.pod:6980 msgid "guestfs_vgs" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6936 +#: ../src/guestfs-actions.pod:6982 #, no-wrap msgid "" " char **\n" @@ -16465,31 +16652,31 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6939 ../fish/guestfish-actions.pod:4643 +#: ../src/guestfs-actions.pod:6985 ../fish/guestfish-actions.pod:4682 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6942 ../fish/guestfish-actions.pod:4646 +#: ../src/guestfs-actions.pod:6988 ../fish/guestfish-actions.pod:4685 msgid "" "This returns a list of just the volume group names that were detected " "(eg. C<VolGroup00>)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6945 +#: ../src/guestfs-actions.pod:6991 msgid "See also C<guestfs_vgs_full>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6953 +#: ../src/guestfs-actions.pod:6999 msgid "guestfs_vgs_full" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6955 +#: ../src/guestfs-actions.pod:7001 #, no-wrap msgid "" " struct guestfs_lvm_vg_list *\n" @@ -16498,14 +16685,14 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6958 ../fish/guestfish-actions.pod:4655 +#: ../src/guestfs-actions.pod:7004 ../fish/guestfish-actions.pod:4694 msgid "" "List all the volumes groups detected. This is the equivalent of the " "L<vgs(8)> command. The \"full\" version includes all fields." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6961 +#: ../src/guestfs-actions.pod:7007 msgid "" "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there " "was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after " @@ -16513,12 +16700,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6967 +#: ../src/guestfs-actions.pod:7013 msgid "guestfs_vgscan" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6969 +#: ../src/guestfs-actions.pod:7015 #, no-wrap msgid "" " int\n" @@ -16527,19 +16714,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6972 ../fish/guestfish-actions.pod:4662 +#: ../src/guestfs-actions.pod:7018 ../fish/guestfish-actions.pod:4701 msgid "" "This rescans all block devices and rebuilds the list of LVM physical " "volumes, volume groups and logical volumes." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6979 +#: ../src/guestfs-actions.pod:7025 msgid "guestfs_vguuid" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6981 +#: ../src/guestfs-actions.pod:7027 #, no-wrap msgid "" " char *\n" @@ -16549,17 +16736,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6985 ../fish/guestfish-actions.pod:4669 +#: ../src/guestfs-actions.pod:7031 ../fish/guestfish-actions.pod:4708 msgid "This command returns the UUID of the LVM VG named C<vgname>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:6992 +#: ../src/guestfs-actions.pod:7038 msgid "guestfs_wait_ready" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:6994 +#: ../src/guestfs-actions.pod:7040 #, no-wrap msgid "" " int\n" @@ -16568,12 +16755,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6997 +#: ../src/guestfs-actions.pod:7043 msgid "This function is a no op." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:6999 +#: ../src/guestfs-actions.pod:7045 msgid "" "In versions of the API E<lt> 1.0.71 you had to call this function just after " "calling C<guestfs_launch> to wait for the launch to complete. However this " @@ -16581,19 +16768,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7004 +#: ../src/guestfs-actions.pod:7050 msgid "" "If you see any calls to this function in code then you can just remove them, " "unless you want to retain compatibility with older versions of the API." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7012 +#: ../src/guestfs-actions.pod:7058 msgid "guestfs_wc_c" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7014 +#: ../src/guestfs-actions.pod:7060 #, no-wrap msgid "" " int\n" @@ -16603,19 +16790,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7018 ../fish/guestfish-actions.pod:4675 +#: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4714 msgid "" "This command counts the characters in a file, using the C<wc -c> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7025 +#: ../src/guestfs-actions.pod:7071 msgid "guestfs_wc_l" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7027 +#: ../src/guestfs-actions.pod:7073 #, no-wrap msgid "" " int\n" @@ -16625,19 +16812,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7031 ../fish/guestfish-actions.pod:4682 +#: ../src/guestfs-actions.pod:7077 ../fish/guestfish-actions.pod:4721 msgid "" "This command counts the lines in a file, using the C<wc -l> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7038 +#: ../src/guestfs-actions.pod:7084 msgid "guestfs_wc_w" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7040 +#: ../src/guestfs-actions.pod:7086 #, no-wrap msgid "" " int\n" @@ -16647,19 +16834,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7044 ../fish/guestfish-actions.pod:4689 +#: ../src/guestfs-actions.pod:7090 ../fish/guestfish-actions.pod:4728 msgid "" "This command counts the words in a file, using the C<wc -w> external " "command." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7051 +#: ../src/guestfs-actions.pod:7097 msgid "guestfs_write" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7053 +#: ../src/guestfs-actions.pod:7099 #, no-wrap msgid "" " int\n" @@ -16671,19 +16858,19 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7059 ../fish/guestfish-actions.pod:4696 +#: ../src/guestfs-actions.pod:7105 ../fish/guestfish-actions.pod:4735 msgid "" "This call creates a file called C<path>. The content of the file is the " "string C<content> (which can contain any 8 bit data)." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7069 +#: ../src/guestfs-actions.pod:7115 msgid "guestfs_write_file" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7071 +#: ../src/guestfs-actions.pod:7117 #, no-wrap msgid "" " int\n" @@ -16695,38 +16882,38 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7077 ../fish/guestfish-actions.pod:4706 +#: ../src/guestfs-actions.pod:7123 ../fish/guestfish-actions.pod:4745 msgid "" "This call creates a file called C<path>. The contents of the file is the " "string C<content> (which can contain any 8 bit data), with length C<size>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7081 ../fish/guestfish-actions.pod:4710 +#: ../src/guestfs-actions.pod:7127 ../fish/guestfish-actions.pod:4749 msgid "" "As a special case, if C<size> is C<0> then the length is calculated using " "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7085 ../fish/guestfish-actions.pod:4714 +#: ../src/guestfs-actions.pod:7131 ../fish/guestfish-actions.pod:4753 msgid "" "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does " "I<not> work, even if the length is specified." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7093 ../fish/guestfish-actions.pod:4720 +#: ../src/guestfs-actions.pod:7139 ../fish/guestfish-actions.pod:4759 msgid "This function is deprecated. In new code, use the C<write> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7102 +#: ../src/guestfs-actions.pod:7148 msgid "guestfs_zegrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7104 +#: ../src/guestfs-actions.pod:7150 #, no-wrap msgid "" " char **\n" @@ -16737,17 +16924,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7109 ../fish/guestfish-actions.pod:4731 +#: ../src/guestfs-actions.pod:7155 ../fish/guestfish-actions.pod:4770 msgid "This calls the external C<zegrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7121 +#: ../src/guestfs-actions.pod:7167 msgid "guestfs_zegrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7123 +#: ../src/guestfs-actions.pod:7169 #, no-wrap msgid "" " char **\n" @@ -16758,17 +16945,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7128 ../fish/guestfish-actions.pod:4741 +#: ../src/guestfs-actions.pod:7174 ../fish/guestfish-actions.pod:4780 msgid "This calls the external C<zegrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7140 +#: ../src/guestfs-actions.pod:7186 msgid "guestfs_zero" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7142 +#: ../src/guestfs-actions.pod:7188 #, no-wrap msgid "" " int\n" @@ -16778,12 +16965,12 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7146 ../fish/guestfish-actions.pod:4751 +#: ../src/guestfs-actions.pod:7192 ../fish/guestfish-actions.pod:4790 msgid "This command writes zeroes over the first few blocks of C<device>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7148 ../fish/guestfish-actions.pod:4753 +#: ../src/guestfs-actions.pod:7194 ../fish/guestfish-actions.pod:4792 msgid "" "How many blocks are zeroed isn't specified (but it's I<not> enough to " "securely wipe the device). It should be sufficient to remove any partition " @@ -16791,17 +16978,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7152 +#: ../src/guestfs-actions.pod:7198 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7163 +#: ../src/guestfs-actions.pod:7209 msgid "guestfs_zero_device" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7165 +#: ../src/guestfs-actions.pod:7211 #, no-wrap msgid "" " int\n" @@ -16811,24 +16998,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7169 +#: ../src/guestfs-actions.pod:7215 msgid "" "This command writes zeroes over the entire C<device>. Compare with " "C<guestfs_zero> which just zeroes the first few blocks of a device." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7183 +#: ../src/guestfs-actions.pod:7229 msgid "(Added in 1.3.1)" msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7185 +#: ../src/guestfs-actions.pod:7231 msgid "guestfs_zerofree" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7187 +#: ../src/guestfs-actions.pod:7233 #, no-wrap msgid "" " int\n" @@ -16838,7 +17025,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7191 ../fish/guestfish-actions.pod:4774 +#: ../src/guestfs-actions.pod:7237 ../fish/guestfish-actions.pod:4813 msgid "" "This runs the I<zerofree> program on C<device>. This program claims to zero " "unused inodes and disk blocks on an ext2/3 filesystem, thus making it " @@ -16846,24 +17033,24 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7196 ../fish/guestfish-actions.pod:4779 +#: ../src/guestfs-actions.pod:7242 ../fish/guestfish-actions.pod:4818 msgid "You should B<not> run this program if the filesystem is mounted." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7199 ../fish/guestfish-actions.pod:4782 +#: ../src/guestfs-actions.pod:7245 ../fish/guestfish-actions.pod:4821 msgid "" "It is possible that using this program can damage the filesystem or data on " "the filesystem." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7206 +#: ../src/guestfs-actions.pod:7252 msgid "guestfs_zfgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7208 +#: ../src/guestfs-actions.pod:7254 #, no-wrap msgid "" " char **\n" @@ -16874,17 +17061,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7213 ../fish/guestfish-actions.pod:4789 +#: ../src/guestfs-actions.pod:7259 ../fish/guestfish-actions.pod:4828 msgid "This calls the external C<zfgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7225 +#: ../src/guestfs-actions.pod:7271 msgid "guestfs_zfgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7227 +#: ../src/guestfs-actions.pod:7273 #, no-wrap msgid "" " char **\n" @@ -16895,17 +17082,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7232 ../fish/guestfish-actions.pod:4799 +#: ../src/guestfs-actions.pod:7278 ../fish/guestfish-actions.pod:4838 msgid "This calls the external C<zfgrep -i> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7244 +#: ../src/guestfs-actions.pod:7290 msgid "guestfs_zfile" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7246 +#: ../src/guestfs-actions.pod:7292 #, no-wrap msgid "" " char *\n" @@ -16916,34 +17103,34 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7251 ../fish/guestfish-actions.pod:4809 +#: ../src/guestfs-actions.pod:7297 ../fish/guestfish-actions.pod:4848 msgid "This command runs C<file> after first decompressing C<path> using C<method>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7254 ../fish/guestfish-actions.pod:4812 +#: ../src/guestfs-actions.pod:7300 ../fish/guestfish-actions.pod:4851 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7256 +#: ../src/guestfs-actions.pod:7302 msgid "" "Since 1.0.63, use C<guestfs_file> instead which can now process compressed " "files." msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7262 ../fish/guestfish-actions.pod:4817 +#: ../src/guestfs-actions.pod:7308 ../fish/guestfish-actions.pod:4856 msgid "This function is deprecated. In new code, use the C<file> call instead." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7271 +#: ../src/guestfs-actions.pod:7317 msgid "guestfs_zgrep" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7273 +#: ../src/guestfs-actions.pod:7319 #, no-wrap msgid "" " char **\n" @@ -16954,17 +17141,17 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7278 ../fish/guestfish-actions.pod:4828 +#: ../src/guestfs-actions.pod:7324 ../fish/guestfish-actions.pod:4867 msgid "This calls the external C<zgrep> program and returns the matching lines." msgstr "" #. type: =head2 -#: ../src/guestfs-actions.pod:7290 +#: ../src/guestfs-actions.pod:7336 msgid "guestfs_zgrepi" msgstr "" #. type: verbatim -#: ../src/guestfs-actions.pod:7292 +#: ../src/guestfs-actions.pod:7338 #, no-wrap msgid "" " char **\n" @@ -16975,7 +17162,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs-actions.pod:7297 ../fish/guestfish-actions.pod:4838 +#: ../src/guestfs-actions.pod:7343 ../fish/guestfish-actions.pod:4877 msgid "This calls the external C<zgrep -i> program and returns the matching lines." msgstr "" @@ -17760,7 +17947,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:923 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50 +#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:928 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50 msgid "EXAMPLES" msgstr "" @@ -17995,7 +18182,7 @@ msgid "To list what is available do:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:914 +#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:919 #, no-wrap msgid "" " guestfish -N help | less\n" @@ -18371,39 +18558,51 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:297 +#: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:146 +msgid "B<--live>" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:148 +msgid "" +"Connect to a live virtual machine. (Experimental, see " +"L<guestfs(3)/ATTACHING TO RUNNING DAEMONS>)." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:302 msgid "B<-m dev[:mountpoint]>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:299 +#: ../fish/guestfish.pod:304 msgid "B<--mount dev[:mountpoint]>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:301 +#: ../fish/guestfish.pod:306 msgid "Mount the named partition or logical volume on the given mountpoint." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:303 +#: ../fish/guestfish.pod:308 msgid "If the mountpoint is omitted, it defaults to C</>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:305 +#: ../fish/guestfish.pod:310 msgid "You have to mount something on C</> before most commands will work." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:307 +#: ../fish/guestfish.pod:312 msgid "" "If any I<-m> or I<--mount> options are given, the guest is automatically " "launched." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:310 +#: ../fish/guestfish.pod:315 msgid "" "If you don't know what filesystems a disk image contains, you can either run " "guestfish without this option, then list the partitions, filesystems and LVs " @@ -18412,46 +18611,46 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:316 +#: ../fish/guestfish.pod:321 msgid "" "Using this flag is mostly equivalent to using the C<mount-options> command " "or the C<mount-ro> command if the I<--ro> flag was given." msgstr "" #. type: =item -#: ../fish/guestfish.pod:319 +#: ../fish/guestfish.pod:324 msgid "B<-n>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:321 +#: ../fish/guestfish.pod:326 msgid "B<--no-sync>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:323 +#: ../fish/guestfish.pod:328 msgid "" "Disable autosync. This is enabled by default. See the discussion of " "autosync in the L<guestfs(3)> manpage." msgstr "" #. type: =item -#: ../fish/guestfish.pod:326 +#: ../fish/guestfish.pod:331 msgid "B<-N type>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:328 +#: ../fish/guestfish.pod:333 msgid "B<--new type>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:330 +#: ../fish/guestfish.pod:335 msgid "B<-N help>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:332 +#: ../fish/guestfish.pod:337 msgid "" "Prepare a fresh disk image formatted as \"type\". This is an alternative to " "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a " @@ -18460,63 +18659,63 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish.pod:337 +#: ../fish/guestfish.pod:342 msgid "B<--progress-bars>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:339 +#: ../fish/guestfish.pod:344 msgid "Enable progress bars, even when guestfish is used non-interactively." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:341 +#: ../fish/guestfish.pod:346 msgid "" "Progress bars are enabled by default when guestfish is used as an " "interactive shell." msgstr "" #. type: =item -#: ../fish/guestfish.pod:344 +#: ../fish/guestfish.pod:349 msgid "B<--no-progress-bars>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:346 +#: ../fish/guestfish.pod:351 msgid "Disable progress bars." msgstr "" #. type: =item -#: ../fish/guestfish.pod:348 +#: ../fish/guestfish.pod:353 msgid "B<--remote[=pid]>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:350 +#: ../fish/guestfish.pod:355 msgid "" "Send remote commands to C<$GUESTFISH_PID> or C<pid>. See section L</REMOTE " "CONTROL GUESTFISH OVER A SOCKET> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:353 +#: ../fish/guestfish.pod:358 msgid "B<-r>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:355 +#: ../fish/guestfish.pod:360 msgid "B<--ro>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:357 +#: ../fish/guestfish.pod:362 msgid "" "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and " "mounts are done read-only." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:360 +#: ../fish/guestfish.pod:365 msgid "" "The option must always be used if the disk image or virtual machine might be " "running, and is generally recommended in cases where you don't need write " @@ -18524,7 +18723,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:364 +#: ../fish/guestfish.pod:369 msgid "" "Note that prepared disk images created with I<-N> are not affected by this " "option. Also commands like C<add> are not affected - you have to specify " @@ -18532,98 +18731,98 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:368 +#: ../fish/guestfish.pod:373 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:370 ../fuse/guestmount.pod:208 +#: ../fish/guestfish.pod:375 ../fuse/guestmount.pod:213 msgid "B<--selinux>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:372 +#: ../fish/guestfish.pod:377 msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:374 +#: ../fish/guestfish.pod:379 msgid "B<-v>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:376 +#: ../fish/guestfish.pod:381 msgid "B<--verbose>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:378 +#: ../fish/guestfish.pod:383 msgid "" "Enable very verbose messages. This is particularly useful if you find a " "bug." msgstr "" #. type: =item -#: ../fish/guestfish.pod:381 +#: ../fish/guestfish.pod:386 msgid "B<-V>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:383 ../tools/virt-edit.pl:88 ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70 +#: ../fish/guestfish.pod:388 ../tools/virt-edit.pl:88 ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70 msgid "B<--version>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:385 +#: ../fish/guestfish.pod:390 msgid "Display the guestfish / libguestfs version number and exit." msgstr "" #. type: =item -#: ../fish/guestfish.pod:387 +#: ../fish/guestfish.pod:392 msgid "B<-w>" msgstr "" #. type: =item -#: ../fish/guestfish.pod:389 +#: ../fish/guestfish.pod:394 msgid "B<--rw>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:391 +#: ../fish/guestfish.pod:396 msgid "" "This option does nothing at the moment. See L</OPENING DISKS FOR READ AND " "WRITE> below." msgstr "" #. type: =item -#: ../fish/guestfish.pod:394 +#: ../fish/guestfish.pod:399 msgid "B<-x>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:396 +#: ../fish/guestfish.pod:401 msgid "Echo each command before executing it." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:400 +#: ../fish/guestfish.pod:405 msgid "COMMANDS ON COMMAND LINE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:402 +#: ../fish/guestfish.pod:407 msgid "Any additional (non-option) arguments are treated as commands to execute." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:405 +#: ../fish/guestfish.pod:410 msgid "" "Commands to execute should be separated by a colon (C<:>), where the colon " "is a separate parameter. Thus:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:408 +#: ../fish/guestfish.pod:413 #, no-wrap msgid "" " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n" @@ -18631,7 +18830,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:410 +#: ../fish/guestfish.pod:415 msgid "" "If there are no additional arguments, then we enter a shell, either an " "interactive shell with a prompt (if the input is a terminal) or a " @@ -18639,7 +18838,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:414 +#: ../fish/guestfish.pod:419 msgid "" "In either command line mode or non-interactive shell, the first command that " "gives an error causes the whole shell to exit. In interactive mode (with a " @@ -18647,12 +18846,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:419 +#: ../fish/guestfish.pod:424 msgid "USING launch (OR run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:421 +#: ../fish/guestfish.pod:426 msgid "" "As with L<guestfs(3)>, you must first configure your guest by adding disks, " "then launch it, then mount any disks you need, and finally issue " @@ -18660,34 +18859,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:429 +#: ../fish/guestfish.pod:434 msgid "add or -a/--add" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:433 +#: ../fish/guestfish.pod:438 msgid "launch (aka run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:437 +#: ../fish/guestfish.pod:442 msgid "mount or -m/--mount" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:441 +#: ../fish/guestfish.pod:446 msgid "any other commands" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:445 +#: ../fish/guestfish.pod:450 msgid "" "C<run> is a synonym for C<launch>. You must C<launch> (or C<run>) your " "guest before mounting or performing any other commands." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:448 +#: ../fish/guestfish.pod:453 msgid "" "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or " "I<--new> options were given then C<run> is done automatically, simply " @@ -18695,12 +18894,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:453 +#: ../fish/guestfish.pod:458 msgid "OPENING DISKS FOR READ AND WRITE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:455 +#: ../fish/guestfish.pod:460 msgid "" "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect " "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> " @@ -18708,7 +18907,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:459 +#: ../fish/guestfish.pod:464 msgid "" "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening " "disk images supplied on the command line for write. To open a disk image " @@ -18716,14 +18915,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:463 +#: ../fish/guestfish.pod:468 msgid "" "This matters: If you accidentally open a live VM disk image writable then " "you will cause irreversible disk corruption." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:466 +#: ../fish/guestfish.pod:471 msgid "" "By libguestfs 1.10 we intend to change the default the other way. Disk " "images will be opened read-only. You will have to either specify " @@ -18732,7 +18931,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:471 +#: ../fish/guestfish.pod:476 msgid "" "This version of guestfish has a I<--rw> option which does nothing (it is " "already the default). However it is highly recommended that you use this " @@ -18741,26 +18940,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:477 +#: ../fish/guestfish.pod:482 msgid "" "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any " "other libguestfs program apart from guestfish and guestmount." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:480 +#: ../fish/guestfish.pod:485 msgid "QUOTING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:482 +#: ../fish/guestfish.pod:487 msgid "" "You can quote ordinary parameters using either single or double quotes. For " "example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:485 +#: ../fish/guestfish.pod:490 #, no-wrap msgid "" " add \"file with a space.img\"\n" @@ -18768,7 +18967,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:487 +#: ../fish/guestfish.pod:492 #, no-wrap msgid "" " rm '/file name'\n" @@ -18776,7 +18975,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:489 +#: ../fish/guestfish.pod:494 #, no-wrap msgid "" " rm '/\"'\n" @@ -18784,7 +18983,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:491 +#: ../fish/guestfish.pod:496 msgid "" "A few commands require a list of strings to be passed. For these, use a " "whitespace-separated list, enclosed in quotes. Strings containing " @@ -18793,7 +18992,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:496 +#: ../fish/guestfish.pod:501 #, no-wrap msgid "" " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n" @@ -18803,19 +19002,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:500 +#: ../fish/guestfish.pod:505 msgid "OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:502 +#: ../fish/guestfish.pod:507 msgid "" "Some commands take optional arguments. These arguments appear in this " "documentation as C<[argname:..]>. You can use them as in these examples:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:506 +#: ../fish/guestfish.pod:511 #, no-wrap msgid "" " add-drive-opts filename\n" @@ -18823,7 +19022,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:508 +#: ../fish/guestfish.pod:513 #, no-wrap msgid "" " add-drive-opts filename readonly:true\n" @@ -18831,7 +19030,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:510 +#: ../fish/guestfish.pod:515 #, no-wrap msgid "" " add-drive-opts filename format:qcow2 readonly:false\n" @@ -18839,196 +19038,196 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:512 +#: ../fish/guestfish.pod:517 msgid "" "Each optional argument can appear at most once. All optional arguments must " "appear after the required ones." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:515 +#: ../fish/guestfish.pod:520 msgid "NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:517 +#: ../fish/guestfish.pod:522 msgid "This section applies to all commands which can take integers as parameters." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:520 +#: ../fish/guestfish.pod:525 msgid "SIZE SUFFIX" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:522 +#: ../fish/guestfish.pod:527 msgid "" "When the command takes a parameter measured in bytes, you can use one of the " "following suffixes to specify kilobytes, megabytes and larger sizes:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:528 +#: ../fish/guestfish.pod:533 msgid "B<k> or B<K> or B<KiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:530 +#: ../fish/guestfish.pod:535 msgid "The size in kilobytes (multiplied by 1024)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:532 +#: ../fish/guestfish.pod:537 msgid "B<KB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:534 +#: ../fish/guestfish.pod:539 msgid "The size in SI 1000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:536 +#: ../fish/guestfish.pod:541 msgid "B<M> or B<MiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:538 +#: ../fish/guestfish.pod:543 msgid "The size in megabytes (multiplied by 1048576)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:540 +#: ../fish/guestfish.pod:545 msgid "B<MB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:542 +#: ../fish/guestfish.pod:547 msgid "The size in SI 1000000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:544 +#: ../fish/guestfish.pod:549 msgid "B<G> or B<GiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:546 +#: ../fish/guestfish.pod:551 msgid "The size in gigabytes (multiplied by 2**30)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:548 +#: ../fish/guestfish.pod:553 msgid "B<GB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:550 +#: ../fish/guestfish.pod:555 msgid "The size in SI 10**9 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:552 +#: ../fish/guestfish.pod:557 msgid "B<T> or B<TiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:554 +#: ../fish/guestfish.pod:559 msgid "The size in terabytes (multiplied by 2**40)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:556 +#: ../fish/guestfish.pod:561 msgid "B<TB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:558 +#: ../fish/guestfish.pod:563 msgid "The size in SI 10**12 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:560 +#: ../fish/guestfish.pod:565 msgid "B<P> or B<PiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:562 +#: ../fish/guestfish.pod:567 msgid "The size in petabytes (multiplied by 2**50)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:564 +#: ../fish/guestfish.pod:569 msgid "B<PB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:566 +#: ../fish/guestfish.pod:571 msgid "The size in SI 10**15 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:568 +#: ../fish/guestfish.pod:573 msgid "B<E> or B<EiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:570 +#: ../fish/guestfish.pod:575 msgid "The size in exabytes (multiplied by 2**60)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:572 +#: ../fish/guestfish.pod:577 msgid "B<EB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:574 +#: ../fish/guestfish.pod:579 msgid "The size in SI 10**18 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:576 +#: ../fish/guestfish.pod:581 msgid "B<Z> or B<ZiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:578 +#: ../fish/guestfish.pod:583 msgid "The size in zettabytes (multiplied by 2**70)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:580 +#: ../fish/guestfish.pod:585 msgid "B<ZB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:582 +#: ../fish/guestfish.pod:587 msgid "The size in SI 10**21 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:584 +#: ../fish/guestfish.pod:589 msgid "B<Y> or B<YiB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:586 +#: ../fish/guestfish.pod:591 msgid "The size in yottabytes (multiplied by 2**80)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:588 +#: ../fish/guestfish.pod:593 msgid "B<YB>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:590 +#: ../fish/guestfish.pod:595 msgid "The size in SI 10**24 byte units." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:596 +#: ../fish/guestfish.pod:601 #, no-wrap msgid "" " truncate-size /file 1G\n" @@ -19036,12 +19235,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:598 +#: ../fish/guestfish.pod:603 msgid "would truncate the file to 1 gigabyte." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:600 +#: ../fish/guestfish.pod:605 msgid "" "Be careful because a few commands take sizes in kilobytes or megabytes " "(eg. the parameter to L</memsize> is specified in megabytes already). " @@ -19049,19 +19248,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:604 +#: ../fish/guestfish.pod:609 msgid "OCTAL AND HEXADECIMAL NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:606 +#: ../fish/guestfish.pod:611 msgid "" "For specifying the radix (base) use the C convention: C<0> to prefix an " "octal number or C<0x> to prefix a hexadecimal number. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:609 +#: ../fish/guestfish.pod:614 #, no-wrap msgid "" " 1234 decimal number 1234\n" @@ -19071,7 +19270,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:613 +#: ../fish/guestfish.pod:618 msgid "" "When using the C<chmod> command, you almost always want to specify an octal " "number for the mode, and you must prefix it with C<0> (unlike the Unix " @@ -19079,7 +19278,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:617 +#: ../fish/guestfish.pod:622 #, no-wrap msgid "" " chmod 0777 /public # OK\n" @@ -19088,7 +19287,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:620 +#: ../fish/guestfish.pod:625 msgid "" "Commands that return numbers usually print them in decimal, but some " "commands print numbers in other radices (eg. C<umask> prints the mode in " @@ -19096,12 +19295,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:624 +#: ../fish/guestfish.pod:629 msgid "WILDCARDS AND GLOBBING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:626 +#: ../fish/guestfish.pod:631 msgid "" "Neither guestfish nor the underlying guestfs API performs wildcard expansion " "(globbing) by default. So for example the following will not do what you " @@ -19109,7 +19308,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:630 +#: ../fish/guestfish.pod:635 #, no-wrap msgid "" " rm-rf /home/*\n" @@ -19117,19 +19316,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:632 +#: ../fish/guestfish.pod:637 msgid "" "Assuming you don't have a directory called literally C</home/*> then the " "above command will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:635 +#: ../fish/guestfish.pod:640 msgid "To perform wildcard expansion, use the C<glob> command." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:637 +#: ../fish/guestfish.pod:642 #, no-wrap msgid "" " glob rm-rf /home/*\n" @@ -19137,14 +19336,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:639 +#: ../fish/guestfish.pod:644 msgid "" "runs C<rm-rf> on each path that matches (ie. potentially running the command " "many times), equivalent to:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:642 +#: ../fish/guestfish.pod:647 #, no-wrap msgid "" " rm-rf /home/jim\n" @@ -19154,24 +19353,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:646 +#: ../fish/guestfish.pod:651 msgid "C<glob> only works on simple guest paths and not on device names." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:648 +#: ../fish/guestfish.pod:653 msgid "" "If you have several parameters, each containing a wildcard, then glob will " "perform a Cartesian product." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:651 +#: ../fish/guestfish.pod:656 msgid "COMMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:653 +#: ../fish/guestfish.pod:658 msgid "" "Any line which starts with a I<#> character is treated as a comment and " "ignored. The I<#> can optionally be preceeded by whitespace, but B<not> by " @@ -19179,7 +19378,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:657 +#: ../fish/guestfish.pod:662 #, no-wrap msgid "" " # this is a comment\n" @@ -19189,24 +19388,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:661 +#: ../fish/guestfish.pod:666 msgid "Blank lines are also ignored." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:663 +#: ../fish/guestfish.pod:668 msgid "RUNNING COMMANDS LOCALLY" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:665 +#: ../fish/guestfish.pod:670 msgid "" "Any line which starts with a I<!> character is treated as a command sent to " "the local shell (C</bin/sh> or whatever L<system(3)> uses). For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:669 +#: ../fish/guestfish.pod:674 #, no-wrap msgid "" " !mkdir local\n" @@ -19215,7 +19414,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:672 +#: ../fish/guestfish.pod:677 msgid "" "will create a directory C<local> on the host, and then export the contents " "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>. " @@ -19223,19 +19422,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:676 +#: ../fish/guestfish.pod:681 msgid "" "To change the local directory, use the C<lcd> command. C<!cd> will have no " "effect, due to the way that subprocesses work in Unix." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:679 +#: ../fish/guestfish.pod:684 msgid "LOCAL COMMANDS WITH INLINE EXECUTION" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:681 +#: ../fish/guestfish.pod:686 msgid "" "If a line starts with I<E<lt>!> then the shell command is executed (as for " "I<!>), but subsequently any output (stdout) of the shell command is parsed " @@ -19243,14 +19442,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:685 +#: ../fish/guestfish.pod:690 msgid "" "Thus you can use shell script to construct arbitrary guestfish commands " "which are then parsed by guestfish." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:688 +#: ../fish/guestfish.pod:693 msgid "" "For example it is tedious to create a sequence of files (eg. C</foo.1> " "through C</foo.100>) using guestfish commands alone. However this is simple " @@ -19258,7 +19457,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:693 +#: ../fish/guestfish.pod:698 #, no-wrap msgid "" " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n" @@ -19266,12 +19465,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:695 +#: ../fish/guestfish.pod:700 msgid "or with names like C</foo.001>:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:697 +#: ../fish/guestfish.pod:702 #, no-wrap msgid "" " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n" @@ -19279,7 +19478,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:699 +#: ../fish/guestfish.pod:704 msgid "" "When using guestfish interactively it can be helpful to just run the shell " "script first (ie. remove the initial C<E<lt>> character so it is just an " @@ -19289,12 +19488,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:705 +#: ../fish/guestfish.pod:710 msgid "PIPES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:707 +#: ../fish/guestfish.pod:712 msgid "" "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first " "command (a guestfish command) to the second command (any host command). For " @@ -19302,7 +19501,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:711 +#: ../fish/guestfish.pod:716 #, no-wrap msgid "" " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n" @@ -19310,7 +19509,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:713 +#: ../fish/guestfish.pod:718 msgid "" "(where C<cat> is the guestfish cat command, but C<awk> is the host awk " "program). The above command would list all accounts in the guest filesystem " @@ -19318,7 +19517,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:718 +#: ../fish/guestfish.pod:723 #, no-wrap msgid "" " hexdump /bin/ls | head\n" @@ -19328,7 +19527,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:722 +#: ../fish/guestfish.pod:727 msgid "" "The space before the pipe symbol is required, any space after the pipe " "symbol is optional. Everything after the pipe symbol is just passed " @@ -19337,14 +19536,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:727 +#: ../fish/guestfish.pod:732 msgid "" "To use a literal argument which begins with a pipe symbol, you have to quote " "it, eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:730 +#: ../fish/guestfish.pod:735 #, no-wrap msgid "" " echo \"|\"\n" @@ -19352,12 +19551,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:732 +#: ../fish/guestfish.pod:737 msgid "HOME DIRECTORIES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:734 +#: ../fish/guestfish.pod:739 msgid "" "If a parameter starts with the character C<~> then the tilde may be expanded " "as a home directory path (either C<~> for the current user's home directory, " @@ -19365,21 +19564,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:738 +#: ../fish/guestfish.pod:743 msgid "" "Note that home directory expansion happens for users known I<on the host>, " "not in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:741 +#: ../fish/guestfish.pod:746 msgid "" "To use a literal argument which begins with a tilde, you have to quote it, " "eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:744 +#: ../fish/guestfish.pod:749 #, no-wrap msgid "" " echo \"~\"\n" @@ -19387,7 +19586,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:748 +#: ../fish/guestfish.pod:753 msgid "" "Libguestfs has some support for Linux guests encrypted according to the " "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole " @@ -19396,12 +19595,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:753 +#: ../fish/guestfish.pod:758 msgid "Identify encrypted block devices and partitions using L</vfs-type>:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:755 +#: ../fish/guestfish.pod:760 #, no-wrap msgid "" " ><fs> vfs-type /dev/sda2\n" @@ -19410,14 +19609,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:758 +#: ../fish/guestfish.pod:763 msgid "" "Then open those devices using L</luks-open>. This creates a device-mapper " "device called C</dev/mapper/luksdev>." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:761 +#: ../fish/guestfish.pod:766 #, no-wrap msgid "" " ><fs> luks-open /dev/sda2 luksdev\n" @@ -19426,14 +19625,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:764 +#: ../fish/guestfish.pod:769 msgid "" "Finally you have to tell LVM to scan for volume groups on the newly created " "mapper device:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:767 +#: ../fish/guestfish.pod:772 #, no-wrap msgid "" " vgscan\n" @@ -19442,12 +19641,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:770 +#: ../fish/guestfish.pod:775 msgid "The logical volume(s) can now be mounted in the usual way." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:772 +#: ../fish/guestfish.pod:777 msgid "" "Before closing a LUKS device you must unmount any logical volumes on it and " "deactivate the volume groups by calling C<vg-activate false VG> on each " @@ -19455,7 +19654,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:776 +#: ../fish/guestfish.pod:781 #, no-wrap msgid "" " vg-activate false /dev/VG\n" @@ -19464,19 +19663,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:779 +#: ../fish/guestfish.pod:784 msgid "WINDOWS PATHS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:781 +#: ../fish/guestfish.pod:786 msgid "" "If a path is prefixed with C<win:> then you can use Windows-style paths " "(with some limitations). The following commands are equivalent:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:784 +#: ../fish/guestfish.pod:789 #, no-wrap msgid "" " file /WINDOWS/system32/config/system.LOG\n" @@ -19484,7 +19683,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:786 +#: ../fish/guestfish.pod:791 #, no-wrap msgid "" " file win:/windows/system32/config/system.log\n" @@ -19492,7 +19691,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:788 +#: ../fish/guestfish.pod:793 #, no-wrap msgid "" " file win:\\windows\\system32\\config\\system.log\n" @@ -19500,7 +19699,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:790 +#: ../fish/guestfish.pod:795 #, no-wrap msgid "" " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n" @@ -19508,7 +19707,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:792 +#: ../fish/guestfish.pod:797 msgid "" "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also " "handles case insensitivity like Windows would. This only works in argument " @@ -19516,12 +19715,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:796 +#: ../fish/guestfish.pod:801 msgid "UPLOADING AND DOWNLOADING FILES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:798 +#: ../fish/guestfish.pod:803 msgid "" "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and " "others which upload from or download to a local file, you can use the " @@ -19529,7 +19728,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:802 +#: ../fish/guestfish.pod:807 #, no-wrap msgid "" " upload - /foo\n" @@ -19537,12 +19736,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:804 +#: ../fish/guestfish.pod:809 msgid "reads stdin and creates from that a file C</foo> in the disk image, and:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:807 +#: ../fish/guestfish.pod:812 #, no-wrap msgid "" " tar-out /etc - | tar tf -\n" @@ -19550,14 +19749,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:809 +#: ../fish/guestfish.pod:814 msgid "" "writes the tarball to stdout and then pipes that into the external \"tar\" " "command (see L</PIPES>)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:812 +#: ../fish/guestfish.pod:817 msgid "" "When using C<-> to read from stdin, the input is read up to the end of " "stdin. You can also use a special \"heredoc\"-like syntax to read up to " @@ -19565,7 +19764,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:816 +#: ../fish/guestfish.pod:821 #, no-wrap msgid "" " upload -<<END /foo\n" @@ -19577,7 +19776,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:822 +#: ../fish/guestfish.pod:827 msgid "" "Any string of characters can be used instead of C<END>. The end marker must " "appear on a line of its own, without any preceeding or following characters " @@ -19585,19 +19784,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:826 +#: ../fish/guestfish.pod:831 msgid "" "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to " "upload local files (so-called \"FileIn\" parameters in the generator)." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:829 +#: ../fish/guestfish.pod:834 msgid "EXIT ON ERROR BEHAVIOUR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:831 +#: ../fish/guestfish.pod:836 msgid "" "By default, guestfish will ignore any errors when in interactive mode " "(ie. taking commands from a human over a tty), and will exit on the first " @@ -19605,19 +19804,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:836 +#: ../fish/guestfish.pod:841 msgid "" "If you prefix a command with a I<-> character, then that command will not " "cause guestfish to exit, even if that (one) command returns an error." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:840 +#: ../fish/guestfish.pod:845 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:842 +#: ../fish/guestfish.pod:847 msgid "" "Guestfish can be remote-controlled over a socket. This is useful " "particularly in shell scripts where you want to make several different " @@ -19626,12 +19825,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:847 +#: ../fish/guestfish.pod:852 msgid "Start a guestfish server process using:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:849 +#: ../fish/guestfish.pod:854 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -19639,12 +19838,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:851 +#: ../fish/guestfish.pod:856 msgid "and then send it commands by doing:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:853 +#: ../fish/guestfish.pod:858 #, no-wrap msgid "" " guestfish --remote cmd [...]\n" @@ -19652,12 +19851,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:855 +#: ../fish/guestfish.pod:860 msgid "To cause the server to exit, send it the exit command:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:857 +#: ../fish/guestfish.pod:862 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -19665,7 +19864,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:859 +#: ../fish/guestfish.pod:864 msgid "" "Note that the server will normally exit if there is an error in a command. " "You can change this in the usual way. See section L</EXIT ON ERROR " @@ -19673,12 +19872,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:863 +#: ../fish/guestfish.pod:868 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:865 +#: ../fish/guestfish.pod:870 msgid "" "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which " "is how the I<--remote> option knows where to send the commands. You can " @@ -19686,7 +19885,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:869 +#: ../fish/guestfish.pod:874 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -19700,19 +19899,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:877 +#: ../fish/guestfish.pod:882 msgid "REMOTE CONTROL AND CSH" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:879 +#: ../fish/guestfish.pod:884 msgid "" "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> " "option:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:882 +#: ../fish/guestfish.pod:887 #, no-wrap msgid "" " eval \"`guestfish --listen --csh`\"\n" @@ -19720,12 +19919,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:884 +#: ../fish/guestfish.pod:889 msgid "REMOTE CONTROL DETAILS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:886 +#: ../fish/guestfish.pod:891 msgid "" "Remote control happens over a Unix domain socket called " "C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID " @@ -19733,17 +19932,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:890 +#: ../fish/guestfish.pod:895 msgid "Guestfish client and server versions must match exactly." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:892 +#: ../fish/guestfish.pod:897 msgid "PREPARED DISK IMAGES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:894 +#: ../fish/guestfish.pod:899 msgid "" "Use the I<-N type> or I<--new type> parameter to select one of a set of " "preformatted disk images that guestfish can make for you to save typing. " @@ -19753,7 +19952,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:900 +#: ../fish/guestfish.pod:905 msgid "" "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for " "the second and so on. Existing files in the current directory are " @@ -19761,7 +19960,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:904 +#: ../fish/guestfish.pod:909 msgid "" "The type briefly describes how the disk should be sized, partitioned, how " "filesystem(s) should be created, and how content should be added. " @@ -19773,31 +19972,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:912 +#: ../fish/guestfish.pod:917 msgid "To list the available types and any extra parameters they take, run:" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:916 +#: ../fish/guestfish.pod:921 msgid "" "Note that the prepared filesystem is not mounted. You would usually have to " "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:920 +#: ../fish/guestfish.pod:925 msgid "" "If any I<-N> or I<--new> options are given, the guest is automatically " "launched." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:925 +#: ../fish/guestfish.pod:930 msgid "Create a 100MB disk with an ext4-formatted partition:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:927 +#: ../fish/guestfish.pod:932 #, no-wrap msgid "" " guestfish -N fs:ext4\n" @@ -19805,12 +20004,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:929 +#: ../fish/guestfish.pod:934 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:931 +#: ../fish/guestfish.pod:936 #, no-wrap msgid "" " guestfish -N fs:vfat:32M -m /dev/sda1\n" @@ -19818,12 +20017,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:933 +#: ../fish/guestfish.pod:938 msgid "Create a blank 200MB disk:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:935 +#: ../fish/guestfish.pod:940 #, no-wrap msgid "" " guestfish -N disk:200M\n" @@ -19831,19 +20030,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:937 +#: ../fish/guestfish.pod:942 msgid "PROGRESS BARS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:939 +#: ../fish/guestfish.pod:944 msgid "" "Some (not all) long-running commands send progress notification messages as " "they are running. Guestfish turns these messages into progress bars." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:943 +#: ../fish/guestfish.pod:948 msgid "" "When a command that supports progress bars takes longer than two seconds to " "run, and if progress bars are enabled, then you will see one appearing below " @@ -19851,7 +20050,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:947 +#: ../fish/guestfish.pod:952 #, no-wrap msgid "" " ><fs> copy-size /large-file /another-file 2048M\n" @@ -19860,7 +20059,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:950 +#: ../fish/guestfish.pod:955 msgid "" "The spinner on the left hand side moves round once for every progress " "notification received from the backend. This is a (reasonably) golden " @@ -19871,7 +20070,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:957 +#: ../fish/guestfish.pod:962 msgid "" "Progress bars are enabled by default when guestfish is used interactively. " "You can enable them even for non-interactive modes using I<--progress-bars>, " @@ -19879,24 +20078,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:962 +#: ../fish/guestfish.pod:967 msgid "GUESTFISH COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:964 +#: ../fish/guestfish.pod:969 msgid "" "The commands in this section are guestfish convenience commands, in other " "words, they are not part of the L<guestfs(3)> API." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:967 +#: ../fish/guestfish.pod:972 msgid "help" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:969 +#: ../fish/guestfish.pod:974 #, no-wrap msgid "" " help\n" @@ -19905,155 +20104,155 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:972 +#: ../fish/guestfish.pod:977 msgid "Without any parameter, this provides general help." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:974 +#: ../fish/guestfish.pod:979 msgid "With a C<cmd> parameter, this displays detailed help for that command." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:976 +#: ../fish/guestfish.pod:981 msgid "quit | exit" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:978 +#: ../fish/guestfish.pod:983 msgid "This exits guestfish. You can also use C<^D> key." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:980 +#: ../fish/guestfish.pod:985 msgid "@FISH_COMMANDS@" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:982 +#: ../fish/guestfish.pod:987 msgid "COMMANDS" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:986 ../test-tool/libguestfs-test-tool.pod:83 +#: ../fish/guestfish.pod:991 ../test-tool/libguestfs-test-tool.pod:83 msgid "EXIT CODE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:988 +#: ../fish/guestfish.pod:993 msgid "" "guestfish returns 0 if the commands completed without error, or 1 if there " "was an error." msgstr "" #. type: =item -#: ../fish/guestfish.pod:995 +#: ../fish/guestfish.pod:1000 msgid "EDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:997 +#: ../fish/guestfish.pod:1002 msgid "" "The C<edit> command uses C<$EDITOR> as the editor. If not set, it uses " "C<vi>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1000 +#: ../fish/guestfish.pod:1005 msgid "GUESTFISH_PID" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1002 +#: ../fish/guestfish.pod:1007 msgid "" "Used with the I<--remote> option to specify the remote guestfish process to " "control. See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1006 +#: ../fish/guestfish.pod:1011 msgid "HEXEDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1008 +#: ../fish/guestfish.pod:1013 msgid "" "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor. If " "not specified, the external L<hexedit(1)> program is used." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1012 +#: ../fish/guestfish.pod:1017 msgid "HOME" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1014 +#: ../fish/guestfish.pod:1019 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L</FILES>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1023 +#: ../fish/guestfish.pod:1028 msgid "" "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1035 +#: ../fish/guestfish.pod:1040 msgid "" "Set the path that guestfish uses to search for kernel and initrd.img. See " "the discussion of paths in L<guestfs(3)>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1046 +#: ../fish/guestfish.pod:1051 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1048 +#: ../fish/guestfish.pod:1053 msgid "PAGER" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1050 +#: ../fish/guestfish.pod:1055 msgid "" "The C<more> command uses C<$PAGER> as the pager. If not set, it uses " "C<more>." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1066 ../test-tool/libguestfs-test-tool.pod:88 +#: ../fish/guestfish.pod:1071 ../test-tool/libguestfs-test-tool.pod:88 msgid "FILES" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1070 +#: ../fish/guestfish.pod:1075 msgid "$HOME/.guestfish" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1072 +#: ../fish/guestfish.pod:1077 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1075 +#: ../fish/guestfish.pod:1080 msgid "$HOME/.inputrc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1077 +#: ../fish/guestfish.pod:1082 msgid "/etc/inputrc" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1079 +#: ../fish/guestfish.pod:1084 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -20061,12 +20260,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1083 +#: ../fish/guestfish.pod:1088 msgid "To write rules which only apply to guestfish, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1085 +#: ../fish/guestfish.pod:1090 #, no-wrap msgid "" " $if guestfish\n" @@ -20076,26 +20275,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1089 +#: ../fish/guestfish.pod:1094 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1094 +#: ../fish/guestfish.pod:1099 msgid "completion-ignore-case (default: on)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1096 +#: ../fish/guestfish.pod:1101 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1099 +#: ../fish/guestfish.pod:1104 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -20103,22 +20302,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1101 +#: ../fish/guestfish.pod:1106 msgid "to make guestfish case sensitive." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1105 +#: ../fish/guestfish.pod:1110 msgid "test1.img" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1107 +#: ../fish/guestfish.pod:1112 msgid "test2.img (etc)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1109 +#: ../fish/guestfish.pod:1114 msgid "" "When using the C<-N> or C<--new> option, the prepared disk or filesystem " "will be created in the file C<test1.img> in the current directory. The " @@ -20127,7 +20326,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1118 +#: ../fish/guestfish.pod:1123 msgid "" "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, " "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, " @@ -20138,7 +20337,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1148 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:253 ../tools/virt-edit.pl:372 ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:567 ../tools/virt-list-partitions.pl:277 +#: ../fish/guestfish.pod:1153 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:372 ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:567 ../tools/virt-list-partitions.pl:277 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " @@ -20147,7 +20346,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1153 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:377 ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:282 +#: ../fish/guestfish.pod:1158 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:377 ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:282 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -20156,7 +20355,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1158 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:382 ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:287 +#: ../fish/guestfish.pod:1163 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:268 ../tools/virt-edit.pl:382 ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:287 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, write to the Free Software Foundation, Inc., 675 Mass " @@ -20207,7 +20406,7 @@ msgstr "" #: ../fish/guestfish-actions.pod:39 #, no-wrap msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..]\n" +" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n" "\n" msgstr "" @@ -20220,26 +20419,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:64 +#: ../fish/guestfish-actions.pod:71 msgid "" "The other optional parameters are passed directly through to " "L</add-drive-opts>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:67 ../fish/guestfish-actions.pod:131 ../fish/guestfish-actions.pod:2934 +#: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138 ../fish/guestfish-actions.pod:2947 msgid "" "This command has one or more optional arguments. See L</OPTIONAL " "ARGUMENTS>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:69 +#: ../fish/guestfish-actions.pod:76 msgid "add-drive" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:71 +#: ../fish/guestfish-actions.pod:78 #, no-wrap msgid "" " add-drive filename\n" @@ -20247,7 +20446,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:73 +#: ../fish/guestfish-actions.pod:80 msgid "" "This function is the equivalent of calling L</add-drive-opts> with no " "optional parameters, so the disk is added writable, with the format being " @@ -20255,7 +20454,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:77 +#: ../fish/guestfish-actions.pod:84 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -20265,17 +20464,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:84 +#: ../fish/guestfish-actions.pod:91 msgid "add-drive-opts" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:86 +#: ../fish/guestfish-actions.pod:93 msgid "add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:88 +#: ../fish/guestfish-actions.pod:95 #, no-wrap msgid "" " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" @@ -20283,7 +20482,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:115 +#: ../fish/guestfish-actions.pod:122 msgid "" "This forces the image format. If you omit this (or use L</add-drive> or " "L</add-drive-ro>) then the format is automatically detected. Possible " @@ -20291,24 +20490,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:126 +#: ../fish/guestfish-actions.pod:133 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated " "L</add-drive-with-if> call (q.v.)" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:133 +#: ../fish/guestfish-actions.pod:140 msgid "add-drive-ro" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:135 +#: ../fish/guestfish-actions.pod:142 msgid "add-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:137 +#: ../fish/guestfish-actions.pod:144 #, no-wrap msgid "" " add-drive-ro filename\n" @@ -20316,7 +20515,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:139 +#: ../fish/guestfish-actions.pod:146 msgid "" "This function is the equivalent of calling L</add-drive-opts> with the " "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk " @@ -20324,12 +20523,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:144 +#: ../fish/guestfish-actions.pod:151 msgid "add-drive-ro-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:146 +#: ../fish/guestfish-actions.pod:153 #, no-wrap msgid "" " add-drive-ro-with-if filename iface\n" @@ -20337,19 +20536,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:148 +#: ../fish/guestfish-actions.pod:155 msgid "" "This is the same as L</add-drive-ro> but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:158 +#: ../fish/guestfish-actions.pod:165 msgid "add-drive-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:160 +#: ../fish/guestfish-actions.pod:167 #, no-wrap msgid "" " add-drive-with-if filename iface\n" @@ -20357,19 +20556,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:162 +#: ../fish/guestfish-actions.pod:169 msgid "" "This is the same as L</add-drive> but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:172 +#: ../fish/guestfish-actions.pod:179 msgid "aug-clear" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:174 +#: ../fish/guestfish-actions.pod:181 #, no-wrap msgid "" " aug-clear augpath\n" @@ -20377,12 +20576,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:179 +#: ../fish/guestfish-actions.pod:186 msgid "aug-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:181 +#: ../fish/guestfish-actions.pod:188 #, no-wrap msgid "" " aug-close\n" @@ -20390,7 +20589,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:183 +#: ../fish/guestfish-actions.pod:190 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call L</aug-init> again before you can use any " @@ -20398,12 +20597,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:188 +#: ../fish/guestfish-actions.pod:195 msgid "aug-defnode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:190 +#: ../fish/guestfish-actions.pod:197 #, no-wrap msgid "" " aug-defnode name expr val\n" @@ -20411,7 +20610,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:195 +#: ../fish/guestfish-actions.pod:202 msgid "" "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to " "calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset " @@ -20419,12 +20618,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:203 +#: ../fish/guestfish-actions.pod:210 msgid "aug-defvar" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:205 +#: ../fish/guestfish-actions.pod:212 #, no-wrap msgid "" " aug-defvar name expr\n" @@ -20432,12 +20631,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:214 +#: ../fish/guestfish-actions.pod:221 msgid "aug-get" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:216 +#: ../fish/guestfish-actions.pod:223 #, no-wrap msgid "" " aug-get augpath\n" @@ -20445,12 +20644,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:221 +#: ../fish/guestfish-actions.pod:228 msgid "aug-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:223 +#: ../fish/guestfish-actions.pod:230 #, no-wrap msgid "" " aug-init root flags\n" @@ -20458,27 +20657,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:229 +#: ../fish/guestfish-actions.pod:236 msgid "You must call this before using any other L</aug-*> commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:264 +#: ../fish/guestfish-actions.pod:271 msgid "Do not load the tree in L</aug-init>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:268 +#: ../fish/guestfish-actions.pod:275 msgid "To close the handle, you can call L</aug-close>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:272 +#: ../fish/guestfish-actions.pod:279 msgid "aug-insert" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:274 +#: ../fish/guestfish-actions.pod:281 #, no-wrap msgid "" " aug-insert augpath label true|false\n" @@ -20486,12 +20685,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:284 +#: ../fish/guestfish-actions.pod:291 msgid "aug-load" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:286 +#: ../fish/guestfish-actions.pod:293 #, no-wrap msgid "" " aug-load\n" @@ -20499,12 +20698,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:293 +#: ../fish/guestfish-actions.pod:300 msgid "aug-ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:295 +#: ../fish/guestfish-actions.pod:302 #, no-wrap msgid "" " aug-ls augpath\n" @@ -20512,19 +20711,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:297 +#: ../fish/guestfish-actions.pod:304 msgid "" "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the " "resulting nodes into alphabetical order." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:300 +#: ../fish/guestfish-actions.pod:307 msgid "aug-match" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:302 +#: ../fish/guestfish-actions.pod:309 #, no-wrap msgid "" " aug-match augpath\n" @@ -20532,12 +20731,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:308 +#: ../fish/guestfish-actions.pod:315 msgid "aug-mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:310 +#: ../fish/guestfish-actions.pod:317 #, no-wrap msgid "" " aug-mv src dest\n" @@ -20545,12 +20744,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:315 +#: ../fish/guestfish-actions.pod:322 msgid "aug-rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:317 +#: ../fish/guestfish-actions.pod:324 #, no-wrap msgid "" " aug-rm augpath\n" @@ -20558,12 +20757,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:323 +#: ../fish/guestfish-actions.pod:330 msgid "aug-save" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:325 +#: ../fish/guestfish-actions.pod:332 #, no-wrap msgid "" " aug-save\n" @@ -20571,19 +20770,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:329 +#: ../fish/guestfish-actions.pod:336 msgid "" "The flags which were passed to L</aug-init> affect exactly how files are " "saved." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:332 +#: ../fish/guestfish-actions.pod:339 msgid "aug-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:334 +#: ../fish/guestfish-actions.pod:341 #, no-wrap msgid "" " aug-set augpath val\n" @@ -20591,7 +20790,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:338 +#: ../fish/guestfish-actions.pod:345 msgid "" "In the Augeas API, it is possible to clear a node by setting the value to " "NULL. Due to an oversight in the libguestfs API you cannot do that with " @@ -20599,12 +20798,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:343 +#: ../fish/guestfish-actions.pod:350 msgid "available" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:345 +#: ../fish/guestfish-actions.pod:352 #, no-wrap msgid "" " available 'groups ...'\n" @@ -20612,7 +20811,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:351 +#: ../fish/guestfish-actions.pod:358 msgid "" "The libguestfs groups, and the functions that those groups correspond to, " "are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at " @@ -20620,12 +20819,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:375 +#: ../fish/guestfish-actions.pod:382 msgid "You must call L</launch> before calling this function." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:397 +#: ../fish/guestfish-actions.pod:404 msgid "" "This call was added in version C<1.0.80>. In previous versions of " "libguestfs all you could do would be to speculatively execute a command to " @@ -20633,12 +20832,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:404 +#: ../fish/guestfish-actions.pod:411 msgid "available-all-groups" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:406 +#: ../fish/guestfish-actions.pod:413 #, no-wrap msgid "" " available-all-groups\n" @@ -20646,7 +20845,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:408 +#: ../fish/guestfish-actions.pod:415 msgid "" "This command returns a list of all optional groups that this daemon knows " "about. Note this returns both supported and unsupported groups. To find " @@ -20655,17 +20854,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:414 +#: ../fish/guestfish-actions.pod:421 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:416 +#: ../fish/guestfish-actions.pod:423 msgid "base64-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:418 +#: ../fish/guestfish-actions.pod:425 #, no-wrap msgid "" " base64-in (base64file|-) filename\n" @@ -20673,17 +20872,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:423 ../fish/guestfish-actions.pod:432 ../fish/guestfish-actions.pod:656 ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:844 ../fish/guestfish-actions.pod:1221 ../fish/guestfish-actions.pod:4302 ../fish/guestfish-actions.pod:4314 ../fish/guestfish-actions.pod:4325 ../fish/guestfish-actions.pod:4336 ../fish/guestfish-actions.pod:4388 ../fish/guestfish-actions.pod:4397 ../fish/guestfish-actions.pod:4451 ../fish/guestfish-actions.pod:4474 +#: ../fish/guestfish-actions.pod:430 ../fish/guestfish-actions.pod:439 ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:832 ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1228 ../fish/guestfish-actions.pod:4341 ../fish/guestfish-actions.pod:4353 ../fish/guestfish-actions.pod:4364 ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4427 ../fish/guestfish-actions.pod:4436 ../fish/guestfish-actions.pod:4490 ../fish/guestfish-actions.pod:4513 msgid "Use C<-> instead of a filename to read/write from stdin/stdout." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:425 +#: ../fish/guestfish-actions.pod:432 msgid "base64-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:427 +#: ../fish/guestfish-actions.pod:434 #, no-wrap msgid "" " base64-out filename (base64file|-)\n" @@ -20691,12 +20890,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:434 +#: ../fish/guestfish-actions.pod:441 msgid "blockdev-flushbufs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:436 +#: ../fish/guestfish-actions.pod:443 #, no-wrap msgid "" " blockdev-flushbufs device\n" @@ -20704,12 +20903,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:443 +#: ../fish/guestfish-actions.pod:450 msgid "blockdev-getbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:445 +#: ../fish/guestfish-actions.pod:452 #, no-wrap msgid "" " blockdev-getbsz device\n" @@ -20717,12 +20916,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:454 +#: ../fish/guestfish-actions.pod:461 msgid "blockdev-getro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:456 +#: ../fish/guestfish-actions.pod:463 #, no-wrap msgid "" " blockdev-getro device\n" @@ -20730,12 +20929,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:463 +#: ../fish/guestfish-actions.pod:470 msgid "blockdev-getsize64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:465 +#: ../fish/guestfish-actions.pod:472 #, no-wrap msgid "" " blockdev-getsize64 device\n" @@ -20743,17 +20942,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:469 +#: ../fish/guestfish-actions.pod:476 msgid "See also L</blockdev-getsz>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:473 +#: ../fish/guestfish-actions.pod:480 msgid "blockdev-getss" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:475 +#: ../fish/guestfish-actions.pod:482 #, no-wrap msgid "" " blockdev-getss device\n" @@ -20761,17 +20960,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:480 +#: ../fish/guestfish-actions.pod:487 msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:485 +#: ../fish/guestfish-actions.pod:492 msgid "blockdev-getsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:487 +#: ../fish/guestfish-actions.pod:494 #, no-wrap msgid "" " blockdev-getsz device\n" @@ -20779,19 +20978,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:492 +#: ../fish/guestfish-actions.pod:499 msgid "" "See also L</blockdev-getss> for the real sector size of the device, and " "L</blockdev-getsize64> for the more useful I<size in bytes>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:498 +#: ../fish/guestfish-actions.pod:505 msgid "blockdev-rereadpt" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:500 +#: ../fish/guestfish-actions.pod:507 #, no-wrap msgid "" " blockdev-rereadpt device\n" @@ -20799,12 +20998,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:506 +#: ../fish/guestfish-actions.pod:513 msgid "blockdev-setbsz" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:508 +#: ../fish/guestfish-actions.pod:515 #, no-wrap msgid "" " blockdev-setbsz device blocksize\n" @@ -20812,12 +21011,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:517 +#: ../fish/guestfish-actions.pod:524 msgid "blockdev-setro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:519 +#: ../fish/guestfish-actions.pod:526 #, no-wrap msgid "" " blockdev-setro device\n" @@ -20825,12 +21024,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:525 +#: ../fish/guestfish-actions.pod:532 msgid "blockdev-setrw" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:527 +#: ../fish/guestfish-actions.pod:534 #, no-wrap msgid "" " blockdev-setrw device\n" @@ -20838,12 +21037,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:533 +#: ../fish/guestfish-actions.pod:540 msgid "case-sensitive-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:535 +#: ../fish/guestfish-actions.pod:542 #, no-wrap msgid "" " case-sensitive-path path\n" @@ -20851,7 +21050,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:559 +#: ../fish/guestfish-actions.pod:566 msgid "" "Thus L</case-sensitive-path> (\"/Windows/System32\") might return " "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of " @@ -20859,17 +21058,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:567 +#: ../fish/guestfish-actions.pod:574 msgid "See also L</realpath>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:569 +#: ../fish/guestfish-actions.pod:576 msgid "cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:571 +#: ../fish/guestfish-actions.pod:578 #, no-wrap msgid "" " cat path\n" @@ -20877,7 +21076,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:575 +#: ../fish/guestfish-actions.pod:582 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of string). For " @@ -20886,12 +21085,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:583 +#: ../fish/guestfish-actions.pod:590 msgid "checksum" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:585 +#: ../fish/guestfish-actions.pod:592 #, no-wrap msgid "" " checksum csumtype path\n" @@ -20899,22 +21098,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:628 +#: ../fish/guestfish-actions.pod:635 msgid "To get the checksum for a device, use L</checksum-device>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:630 +#: ../fish/guestfish-actions.pod:637 msgid "To get the checksums for many files, use L</checksums-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:632 +#: ../fish/guestfish-actions.pod:639 msgid "checksum-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:634 +#: ../fish/guestfish-actions.pod:641 #, no-wrap msgid "" " checksum-device csumtype device\n" @@ -20922,7 +21121,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:636 +#: ../fish/guestfish-actions.pod:643 msgid "" "This call computes the MD5, SHAx or CRC checksum of the contents of the " "device named C<device>. For the types of checksums supported see the " @@ -20930,12 +21129,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:640 +#: ../fish/guestfish-actions.pod:647 msgid "checksums-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:642 +#: ../fish/guestfish-actions.pod:649 #, no-wrap msgid "" " checksums-out csumtype directory (sumsfile|-)\n" @@ -20943,12 +21142,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:658 +#: ../fish/guestfish-actions.pod:665 msgid "chmod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:660 +#: ../fish/guestfish-actions.pod:667 #, no-wrap msgid "" " chmod mode path\n" @@ -20956,12 +21155,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:671 +#: ../fish/guestfish-actions.pod:678 msgid "chown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:673 +#: ../fish/guestfish-actions.pod:680 #, no-wrap msgid "" " chown owner group path\n" @@ -20969,12 +21168,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:681 +#: ../fish/guestfish-actions.pod:688 msgid "command" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:683 +#: ../fish/guestfish-actions.pod:690 #, no-wrap msgid "" " command 'arguments ...'\n" @@ -20982,7 +21181,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:690 +#: ../fish/guestfish-actions.pod:697 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 " @@ -20991,12 +21190,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:718 +#: ../fish/guestfish-actions.pod:725 msgid "command-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:720 +#: ../fish/guestfish-actions.pod:727 #, no-wrap msgid "" " command-lines 'arguments ...'\n" @@ -21004,22 +21203,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:722 +#: ../fish/guestfish-actions.pod:729 msgid "This is the same as L</command>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:725 +#: ../fish/guestfish-actions.pod:732 msgid "See also: L</sh-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:730 +#: ../fish/guestfish-actions.pod:737 msgid "config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:732 +#: ../fish/guestfish-actions.pod:739 #, no-wrap msgid "" " config qemuparam qemuvalue\n" @@ -21027,12 +21226,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:743 +#: ../fish/guestfish-actions.pod:750 msgid "copy-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:745 +#: ../fish/guestfish-actions.pod:752 #, no-wrap msgid "" " copy-size src dest size\n" @@ -21040,12 +21239,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:753 +#: ../fish/guestfish-actions.pod:760 msgid "cp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:755 +#: ../fish/guestfish-actions.pod:762 #, no-wrap msgid "" " cp src dest\n" @@ -21053,12 +21252,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:760 +#: ../fish/guestfish-actions.pod:767 msgid "cp-a" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:762 +#: ../fish/guestfish-actions.pod:769 #, no-wrap msgid "" " cp-a src dest\n" @@ -21066,12 +21265,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:767 +#: ../fish/guestfish-actions.pod:774 msgid "dd" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:769 +#: ../fish/guestfish-actions.pod:776 #, no-wrap msgid "" " dd src dest\n" @@ -21079,7 +21278,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:776 +#: ../fish/guestfish-actions.pod:783 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 " @@ -21087,12 +21286,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:780 +#: ../fish/guestfish-actions.pod:787 msgid "df" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:782 +#: ../fish/guestfish-actions.pod:789 #, no-wrap msgid "" " df\n" @@ -21100,7 +21299,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:786 ../fish/guestfish-actions.pod:797 +#: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:804 msgid "" "This command is mostly useful for interactive sessions. It is I<not> " "intended that you try to parse the output string. Use L</statvfs> from " @@ -21108,12 +21307,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:790 +#: ../fish/guestfish-actions.pod:797 msgid "df-h" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:792 +#: ../fish/guestfish-actions.pod:799 #, no-wrap msgid "" " df-h\n" @@ -21121,12 +21320,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:801 +#: ../fish/guestfish-actions.pod:808 msgid "dmesg" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:803 +#: ../fish/guestfish-actions.pod:810 #, no-wrap msgid "" " dmesg\n" @@ -21134,7 +21333,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:809 +#: ../fish/guestfish-actions.pod:816 msgid "" "Another way to get the same information is to enable verbose messages with " "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> " @@ -21142,12 +21341,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:814 +#: ../fish/guestfish-actions.pod:821 msgid "download" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:816 +#: ../fish/guestfish-actions.pod:823 #, no-wrap msgid "" " download remotefilename (filename|-)\n" @@ -21155,17 +21354,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:823 +#: ../fish/guestfish-actions.pod:830 msgid "See also L</upload>, L</cat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:827 +#: ../fish/guestfish-actions.pod:834 msgid "download-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:829 +#: ../fish/guestfish-actions.pod:836 #, no-wrap msgid "" " download-offset remotefilename (filename|-) offset size\n" @@ -21173,7 +21372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:837 +#: ../fish/guestfish-actions.pod:844 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with L</pread>, and this call always reads the full " @@ -21181,17 +21380,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:842 +#: ../fish/guestfish-actions.pod:849 msgid "See also L</download>, L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:846 +#: ../fish/guestfish-actions.pod:853 msgid "drop-caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:848 +#: ../fish/guestfish-actions.pod:855 #, no-wrap msgid "" " drop-caches whattodrop\n" @@ -21199,12 +21398,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:860 +#: ../fish/guestfish-actions.pod:867 msgid "du" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:862 +#: ../fish/guestfish-actions.pod:869 #, no-wrap msgid "" " du path\n" @@ -21212,12 +21411,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:874 +#: ../fish/guestfish-actions.pod:881 msgid "e2fsck-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:876 +#: ../fish/guestfish-actions.pod:883 #, no-wrap msgid "" " e2fsck-f device\n" @@ -21225,19 +21424,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:882 +#: ../fish/guestfish-actions.pod:889 msgid "" "This command is only needed because of L</resize2fs> (q.v.). Normally you " "should use L</fsck>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:885 +#: ../fish/guestfish-actions.pod:892 msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:887 +#: ../fish/guestfish-actions.pod:894 #, no-wrap msgid "" " echo-daemon 'words ...'\n" @@ -21245,17 +21444,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:894 +#: ../fish/guestfish-actions.pod:901 msgid "See also L</ping-daemon>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:896 +#: ../fish/guestfish-actions.pod:903 msgid "egrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:898 +#: ../fish/guestfish-actions.pod:905 #, no-wrap msgid "" " egrep regex path\n" @@ -21263,12 +21462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:906 +#: ../fish/guestfish-actions.pod:913 msgid "egrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:908 +#: ../fish/guestfish-actions.pod:915 #, no-wrap msgid "" " egrepi regex path\n" @@ -21276,12 +21475,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:916 +#: ../fish/guestfish-actions.pod:923 msgid "equal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:918 +#: ../fish/guestfish-actions.pod:925 #, no-wrap msgid "" " equal file1 file2\n" @@ -21289,12 +21488,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:925 +#: ../fish/guestfish-actions.pod:932 msgid "exists" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:927 +#: ../fish/guestfish-actions.pod:934 #, no-wrap msgid "" " exists path\n" @@ -21302,17 +21501,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:932 +#: ../fish/guestfish-actions.pod:939 msgid "See also L</is-file>, L</is-dir>, L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:934 +#: ../fish/guestfish-actions.pod:941 msgid "fallocate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:936 +#: ../fish/guestfish-actions.pod:943 #, no-wrap msgid "" " fallocate path len\n" @@ -21320,12 +21519,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:953 +#: ../fish/guestfish-actions.pod:960 msgid "fallocate64" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:955 +#: ../fish/guestfish-actions.pod:962 #, no-wrap msgid "" " fallocate64 path len\n" @@ -21333,14 +21532,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:961 +#: ../fish/guestfish-actions.pod:968 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use L</truncate-size> instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:964 +#: ../fish/guestfish-actions.pod:971 msgid "" "The deprecated call L</fallocate> does the same, but owing to an oversight " "it only allowed 30 bit lengths to be specified, effectively limiting the " @@ -21348,12 +21547,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:973 +#: ../fish/guestfish-actions.pod:980 msgid "fgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:975 +#: ../fish/guestfish-actions.pod:982 #, no-wrap msgid "" " fgrep pattern path\n" @@ -21361,12 +21560,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:983 +#: ../fish/guestfish-actions.pod:990 msgid "fgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:985 +#: ../fish/guestfish-actions.pod:992 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -21374,12 +21573,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:993 +#: ../fish/guestfish-actions.pod:1000 msgid "file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:995 +#: ../fish/guestfish-actions.pod:1002 #, no-wrap msgid "" " file path\n" @@ -21387,7 +21586,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1007 +#: ../fish/guestfish-actions.pod:1014 msgid "" "This command can also be used on C</dev/> devices (and partitions, LV " "names). You can for example use this to determine if a device contains a " @@ -21395,12 +21594,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1017 +#: ../fish/guestfish-actions.pod:1024 msgid "file-architecture" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1019 +#: ../fish/guestfish-actions.pod:1026 #, no-wrap msgid "" " file-architecture filename\n" @@ -21408,12 +21607,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1122 +#: ../fish/guestfish-actions.pod:1129 msgid "filesize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1124 +#: ../fish/guestfish-actions.pod:1131 #, no-wrap msgid "" " filesize file\n" @@ -21421,7 +21620,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1128 +#: ../fish/guestfish-actions.pod:1135 msgid "" "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, " "L</is-file> etc. To get the size of block devices, use " @@ -21429,12 +21628,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1132 +#: ../fish/guestfish-actions.pod:1139 msgid "fill" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1134 +#: ../fish/guestfish-actions.pod:1141 #, no-wrap msgid "" " fill c len path\n" @@ -21442,7 +21641,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1140 +#: ../fish/guestfish-actions.pod:1147 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "L</truncate-size>. To create a file with a pattern of repeating bytes use " @@ -21450,12 +21649,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1145 +#: ../fish/guestfish-actions.pod:1152 msgid "fill-pattern" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1147 +#: ../fish/guestfish-actions.pod:1154 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -21463,7 +21662,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1149 +#: ../fish/guestfish-actions.pod:1156 msgid "" "This function is like L</fill> except that it creates a new file of length " "C<len> containing the repeating pattern of bytes in C<pattern>. The pattern " @@ -21472,12 +21671,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1154 +#: ../fish/guestfish-actions.pod:1161 msgid "find" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1156 +#: ../fish/guestfish-actions.pod:1163 #, no-wrap msgid "" " find directory\n" @@ -21485,22 +21684,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1170 +#: ../fish/guestfish-actions.pod:1177 msgid "then the returned list from L</find> C</tmp> would be 4 elements:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1183 +#: ../fish/guestfish-actions.pod:1190 msgid "See also L</find0>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1188 +#: ../fish/guestfish-actions.pod:1195 msgid "find0" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1190 +#: ../fish/guestfish-actions.pod:1197 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -21508,17 +21707,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1196 +#: ../fish/guestfish-actions.pod:1203 msgid "This command works the same way as L</find> with the following exceptions:" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1223 +#: ../fish/guestfish-actions.pod:1230 msgid "findfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1225 +#: ../fish/guestfish-actions.pod:1232 #, no-wrap msgid "" " findfs-label label\n" @@ -21526,17 +21725,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1231 +#: ../fish/guestfish-actions.pod:1238 msgid "To find the label of a filesystem, use L</vfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1233 +#: ../fish/guestfish-actions.pod:1240 msgid "findfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1235 +#: ../fish/guestfish-actions.pod:1242 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -21544,17 +21743,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1241 +#: ../fish/guestfish-actions.pod:1248 msgid "To find the UUID of a filesystem, use L</vfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1243 +#: ../fish/guestfish-actions.pod:1250 msgid "fsck" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1245 +#: ../fish/guestfish-actions.pod:1252 #, no-wrap msgid "" " fsck fstype device\n" @@ -21562,12 +21761,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1275 +#: ../fish/guestfish-actions.pod:1282 msgid "get-append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1277 +#: ../fish/guestfish-actions.pod:1284 #, no-wrap msgid "" " get-append\n" @@ -21575,12 +21774,30 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1284 +#: ../fish/guestfish-actions.pod:1291 +msgid "get-attach-method" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1293 +#, no-wrap +msgid "" +" get-attach-method\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1295 +msgid "Return the current attach method. See L</set-attach-method>." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1297 msgid "get-autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1286 +#: ../fish/guestfish-actions.pod:1299 #, no-wrap msgid "" " get-autosync\n" @@ -21588,12 +21805,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1290 +#: ../fish/guestfish-actions.pod:1303 msgid "get-direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1292 +#: ../fish/guestfish-actions.pod:1305 #, no-wrap msgid "" " get-direct\n" @@ -21601,12 +21818,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1296 +#: ../fish/guestfish-actions.pod:1309 msgid "get-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1298 +#: ../fish/guestfish-actions.pod:1311 #, no-wrap msgid "" " get-e2label device\n" @@ -21614,12 +21831,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1310 +#: ../fish/guestfish-actions.pod:1323 msgid "get-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1312 +#: ../fish/guestfish-actions.pod:1325 #, no-wrap msgid "" " get-e2uuid device\n" @@ -21627,12 +21844,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1324 +#: ../fish/guestfish-actions.pod:1337 msgid "get-memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1326 +#: ../fish/guestfish-actions.pod:1339 #, no-wrap msgid "" " get-memsize\n" @@ -21640,7 +21857,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1331 +#: ../fish/guestfish-actions.pod:1344 msgid "" "If L</set-memsize> was not called on this handle, and if " "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default " @@ -21648,12 +21865,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1338 +#: ../fish/guestfish-actions.pod:1351 msgid "get-network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1340 +#: ../fish/guestfish-actions.pod:1353 #, no-wrap msgid "" " get-network\n" @@ -21661,12 +21878,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1344 +#: ../fish/guestfish-actions.pod:1357 msgid "get-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1346 +#: ../fish/guestfish-actions.pod:1359 #, no-wrap msgid "" " get-path\n" @@ -21674,17 +21891,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1353 +#: ../fish/guestfish-actions.pod:1366 msgid "get-pid" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1355 +#: ../fish/guestfish-actions.pod:1368 msgid "pid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1357 +#: ../fish/guestfish-actions.pod:1370 #, no-wrap msgid "" " get-pid\n" @@ -21692,12 +21909,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1364 +#: ../fish/guestfish-actions.pod:1377 msgid "get-qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1366 +#: ../fish/guestfish-actions.pod:1379 #, no-wrap msgid "" " get-qemu\n" @@ -21705,12 +21922,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1373 +#: ../fish/guestfish-actions.pod:1386 msgid "get-recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1375 +#: ../fish/guestfish-actions.pod:1388 #, no-wrap msgid "" " get-recovery-proc\n" @@ -21718,12 +21935,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1379 +#: ../fish/guestfish-actions.pod:1392 msgid "get-selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1381 +#: ../fish/guestfish-actions.pod:1394 #, no-wrap msgid "" " get-selinux\n" @@ -21731,19 +21948,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1383 +#: ../fish/guestfish-actions.pod:1396 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See L</set-selinux>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1389 +#: ../fish/guestfish-actions.pod:1402 msgid "get-state" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1391 +#: ../fish/guestfish-actions.pod:1404 #, no-wrap msgid "" " get-state\n" @@ -21751,12 +21968,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1398 +#: ../fish/guestfish-actions.pod:1411 msgid "get-trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1400 +#: ../fish/guestfish-actions.pod:1413 #, no-wrap msgid "" " get-trace\n" @@ -21764,12 +21981,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1404 +#: ../fish/guestfish-actions.pod:1417 msgid "get-umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1406 +#: ../fish/guestfish-actions.pod:1419 #, no-wrap msgid "" " get-umask\n" @@ -21777,19 +21994,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1408 +#: ../fish/guestfish-actions.pod:1421 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling L</umask>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1411 +#: ../fish/guestfish-actions.pod:1424 msgid "get-verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1413 +#: ../fish/guestfish-actions.pod:1426 #, no-wrap msgid "" " get-verbose\n" @@ -21797,12 +22014,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1417 +#: ../fish/guestfish-actions.pod:1430 msgid "getcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1419 +#: ../fish/guestfish-actions.pod:1432 #, no-wrap msgid "" " getcon\n" @@ -21810,17 +22027,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1423 +#: ../fish/guestfish-actions.pod:1436 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1426 +#: ../fish/guestfish-actions.pod:1439 msgid "getxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1428 +#: ../fish/guestfish-actions.pod:1441 #, no-wrap msgid "" " getxattr path name\n" @@ -21828,7 +22045,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1430 +#: ../fish/guestfish-actions.pod:1443 msgid "" "Get a single extended attribute from file C<path> named C<name>. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -21836,7 +22053,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1434 ../fish/guestfish-actions.pod:2340 +#: ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:2353 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling L</getxattrs>. However some Linux filesystem implementations are " @@ -21846,17 +22063,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1444 +#: ../fish/guestfish-actions.pod:1457 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1446 +#: ../fish/guestfish-actions.pod:1459 msgid "getxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1448 +#: ../fish/guestfish-actions.pod:1461 #, no-wrap msgid "" " getxattrs path\n" @@ -21864,17 +22081,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1456 +#: ../fish/guestfish-actions.pod:1469 msgid "See also: L</lgetxattrs>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1458 +#: ../fish/guestfish-actions.pod:1471 msgid "glob-expand" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1460 +#: ../fish/guestfish-actions.pod:1473 #, no-wrap msgid "" " glob-expand pattern\n" @@ -21882,12 +22099,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1473 +#: ../fish/guestfish-actions.pod:1486 msgid "grep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1475 +#: ../fish/guestfish-actions.pod:1488 #, no-wrap msgid "" " grep regex path\n" @@ -21895,12 +22112,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1483 +#: ../fish/guestfish-actions.pod:1496 msgid "grepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1485 +#: ../fish/guestfish-actions.pod:1498 #, no-wrap msgid "" " grepi regex path\n" @@ -21908,12 +22125,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1493 +#: ../fish/guestfish-actions.pod:1506 msgid "grub-install" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1495 +#: ../fish/guestfish-actions.pod:1508 #, no-wrap msgid "" " grub-install root device\n" @@ -21921,12 +22138,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1511 +#: ../fish/guestfish-actions.pod:1524 msgid "head" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1513 +#: ../fish/guestfish-actions.pod:1526 #, no-wrap msgid "" " head path\n" @@ -21934,12 +22151,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1521 +#: ../fish/guestfish-actions.pod:1534 msgid "head-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1523 +#: ../fish/guestfish-actions.pod:1536 #, no-wrap msgid "" " head-n nrlines path\n" @@ -21947,12 +22164,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1536 +#: ../fish/guestfish-actions.pod:1549 msgid "hexdump" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1538 +#: ../fish/guestfish-actions.pod:1551 #, no-wrap msgid "" " hexdump path\n" @@ -21960,12 +22177,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1546 +#: ../fish/guestfish-actions.pod:1559 msgid "initrd-cat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1548 +#: ../fish/guestfish-actions.pod:1561 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -21973,17 +22190,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1560 +#: ../fish/guestfish-actions.pod:1573 msgid "See also L</initrd-list>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1565 +#: ../fish/guestfish-actions.pod:1578 msgid "initrd-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1567 +#: ../fish/guestfish-actions.pod:1580 #, no-wrap msgid "" " initrd-list path\n" @@ -21991,12 +22208,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1579 +#: ../fish/guestfish-actions.pod:1592 msgid "inotify-add-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1581 +#: ../fish/guestfish-actions.pod:1594 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -22004,12 +22221,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1593 +#: ../fish/guestfish-actions.pod:1606 msgid "inotify-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1595 +#: ../fish/guestfish-actions.pod:1608 #, no-wrap msgid "" " inotify-close\n" @@ -22017,12 +22234,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1601 +#: ../fish/guestfish-actions.pod:1614 msgid "inotify-files" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1603 +#: ../fish/guestfish-actions.pod:1616 #, no-wrap msgid "" " inotify-files\n" @@ -22030,7 +22247,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1605 +#: ../fish/guestfish-actions.pod:1618 msgid "" "This function is a helpful wrapper around L</inotify-read> which just " "returns a list of pathnames of objects that were touched. The returned " @@ -22038,12 +22255,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1609 +#: ../fish/guestfish-actions.pod:1622 msgid "inotify-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1611 +#: ../fish/guestfish-actions.pod:1624 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -22051,7 +22268,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1617 +#: ../fish/guestfish-actions.pod:1630 msgid "" "C<maxevents> is the maximum number of events which will be queued up between " "calls to L</inotify-read> or L</inotify-files>. If this is passed as C<0>, " @@ -22062,7 +22279,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1627 +#: ../fish/guestfish-actions.pod:1640 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and " @@ -22070,7 +22287,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1633 +#: ../fish/guestfish-actions.pod:1646 msgid "" "Queued up events should be read periodically by calling L</inotify-read> (or " "L</inotify-files> which is just a helpful wrapper around L</inotify-read>). " @@ -22079,19 +22296,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1640 +#: ../fish/guestfish-actions.pod:1653 msgid "" "The handle should be closed after use by calling L</inotify-close>. This " "also removes any watches automatically." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1649 +#: ../fish/guestfish-actions.pod:1662 msgid "inotify-read" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1651 +#: ../fish/guestfish-actions.pod:1664 #, no-wrap msgid "" " inotify-read\n" @@ -22099,12 +22316,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1664 +#: ../fish/guestfish-actions.pod:1677 msgid "inotify-rm-watch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1666 +#: ../fish/guestfish-actions.pod:1679 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -22112,17 +22329,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1668 +#: ../fish/guestfish-actions.pod:1681 msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1671 +#: ../fish/guestfish-actions.pod:1684 msgid "inspect-get-arch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1673 +#: ../fish/guestfish-actions.pod:1686 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -22130,26 +22347,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1675 ../fish/guestfish-actions.pod:1691 ../fish/guestfish-actions.pod:1765 ../fish/guestfish-actions.pod:1783 ../fish/guestfish-actions.pod:1817 ../fish/guestfish-actions.pod:1832 ../fish/guestfish-actions.pod:1853 ../fish/guestfish-actions.pod:1868 ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1917 ../fish/guestfish-actions.pod:1941 ../fish/guestfish-actions.pod:1971 ../fish/guestfish-actions.pod:2006 ../fish/guestfish-actions.pod:2022 ../fish/guestfish-actions.pod:2035 ../fish/guestfish-actions.pod:2048 ../fish/guestfish-actions.pod:2063 +#: ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1704 ../fish/guestfish-actions.pod:1778 ../fish/guestfish-actions.pod:1796 ../fish/guestfish-actions.pod:1830 ../fish/guestfish-actions.pod:1845 ../fish/guestfish-actions.pod:1866 ../fish/guestfish-actions.pod:1881 ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1930 ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1984 ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2035 ../fish/guestfish-actions.pod:2048 ../fish/guestfish-actions.pod:2061 ../fish/guestfish-actions.pod:2076 msgid "" "This function should only be called with a root device string as returned by " "L</inspect-os>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1678 +#: ../fish/guestfish-actions.pod:1691 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under L</file-architecture>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1687 +#: ../fish/guestfish-actions.pod:1700 msgid "inspect-get-distro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1689 +#: ../fish/guestfish-actions.pod:1702 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -22157,12 +22374,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1761 +#: ../fish/guestfish-actions.pod:1774 msgid "inspect-get-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1763 +#: ../fish/guestfish-actions.pod:1776 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -22170,19 +22387,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1776 +#: ../fish/guestfish-actions.pod:1789 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-mountpoints>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1779 +#: ../fish/guestfish-actions.pod:1792 msgid "inspect-get-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1781 +#: ../fish/guestfish-actions.pod:1794 #, no-wrap msgid "" " inspect-get-format root\n" @@ -22190,12 +22407,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1813 +#: ../fish/guestfish-actions.pod:1826 msgid "inspect-get-hostname" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1815 +#: ../fish/guestfish-actions.pod:1828 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -22203,12 +22420,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1828 +#: ../fish/guestfish-actions.pod:1841 msgid "inspect-get-major-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1830 +#: ../fish/guestfish-actions.pod:1843 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -22216,12 +22433,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1849 +#: ../fish/guestfish-actions.pod:1862 msgid "inspect-get-minor-version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1851 +#: ../fish/guestfish-actions.pod:1864 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -22229,19 +22446,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1861 +#: ../fish/guestfish-actions.pod:1874 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-major-version>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1864 +#: ../fish/guestfish-actions.pod:1877 msgid "inspect-get-mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1866 +#: ../fish/guestfish-actions.pod:1879 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -22249,19 +22466,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1888 +#: ../fish/guestfish-actions.pod:1901 msgid "" "Please read L<guestfs(3)/INSPECTION> for more details. See also " "L</inspect-get-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1891 +#: ../fish/guestfish-actions.pod:1904 msgid "inspect-get-package-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1893 +#: ../fish/guestfish-actions.pod:1906 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -22269,7 +22486,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1898 +#: ../fish/guestfish-actions.pod:1911 msgid "" "This function and L</inspect-get-package-management> return the package " "format and package management tool used by the inspected operating system. " @@ -22278,12 +22495,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1913 +#: ../fish/guestfish-actions.pod:1926 msgid "inspect-get-package-management" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1915 +#: ../fish/guestfish-actions.pod:1928 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -22291,7 +22508,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1920 +#: ../fish/guestfish-actions.pod:1933 msgid "" "L</inspect-get-package-format> and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -22300,12 +22517,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1937 +#: ../fish/guestfish-actions.pod:1950 msgid "inspect-get-product-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1939 +#: ../fish/guestfish-actions.pod:1952 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -22313,12 +22530,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1954 +#: ../fish/guestfish-actions.pod:1967 msgid "inspect-get-roots" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1956 +#: ../fish/guestfish-actions.pod:1969 #, no-wrap msgid "" " inspect-get-roots\n" @@ -22326,7 +22543,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1958 +#: ../fish/guestfish-actions.pod:1971 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to L</inspect-os>, but without redoing the " @@ -22334,19 +22551,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1962 +#: ../fish/guestfish-actions.pod:1975 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called L</inspect-os>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1967 +#: ../fish/guestfish-actions.pod:1980 msgid "inspect-get-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1969 +#: ../fish/guestfish-actions.pod:1982 #, no-wrap msgid "" " inspect-get-type root\n" @@ -22354,12 +22571,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2002 +#: ../fish/guestfish-actions.pod:2015 msgid "inspect-get-windows-systemroot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2004 +#: ../fish/guestfish-actions.pod:2017 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -22367,12 +22584,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2018 +#: ../fish/guestfish-actions.pod:2031 msgid "inspect-is-live" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2020 +#: ../fish/guestfish-actions.pod:2033 #, no-wrap msgid "" " inspect-is-live root\n" @@ -22380,19 +22597,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2025 +#: ../fish/guestfish-actions.pod:2038 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2031 +#: ../fish/guestfish-actions.pod:2044 msgid "inspect-is-multipart" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2033 +#: ../fish/guestfish-actions.pod:2046 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -22400,19 +22617,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2038 +#: ../fish/guestfish-actions.pod:2051 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2044 +#: ../fish/guestfish-actions.pod:2057 msgid "inspect-is-netinst" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2046 +#: ../fish/guestfish-actions.pod:2059 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -22420,7 +22637,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2051 +#: ../fish/guestfish-actions.pod:2064 msgid "" "If L</inspect-get-format> returns C<installer> (this is an install disk), " "then this returns true if the disk is a network installer, ie. not a " @@ -22429,12 +22646,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2059 +#: ../fish/guestfish-actions.pod:2072 msgid "inspect-list-applications" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2061 +#: ../fish/guestfish-actions.pod:2074 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -22442,7 +22659,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2068 +#: ../fish/guestfish-actions.pod:2081 msgid "" "I<Note:> This call works differently from other parts of the inspection " "API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, " @@ -22454,12 +22671,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2158 +#: ../fish/guestfish-actions.pod:2171 msgid "inspect-os" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2160 +#: ../fish/guestfish-actions.pod:2173 #, no-wrap msgid "" " inspect-os\n" @@ -22467,7 +22684,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2175 +#: ../fish/guestfish-actions.pod:2188 msgid "" "You can pass the root string(s) returned to other L</inspect-get-*> " "functions in order to query further information about each operating system, " @@ -22475,7 +22692,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2180 +#: ../fish/guestfish-actions.pod:2193 msgid "" "This function uses other libguestfs features such as L</mount-ro> and " "L</umount-all> in order to mount and unmount filesystems and look at the " @@ -22484,17 +22701,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2192 ../fish/guestfish-actions.pod:2368 ../fish/guestfish-actions.pod:2414 +#: ../fish/guestfish-actions.pod:2205 ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2427 msgid "See also L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2194 +#: ../fish/guestfish-actions.pod:2207 msgid "is-blockdev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2196 +#: ../fish/guestfish-actions.pod:2209 #, no-wrap msgid "" " is-blockdev path\n" @@ -22502,17 +22719,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2201 ../fish/guestfish-actions.pod:2219 ../fish/guestfish-actions.pod:2238 ../fish/guestfish-actions.pod:2247 ../fish/guestfish-actions.pod:2257 ../fish/guestfish-actions.pod:2291 ../fish/guestfish-actions.pod:2300 +#: ../fish/guestfish-actions.pod:2214 ../fish/guestfish-actions.pod:2232 ../fish/guestfish-actions.pod:2251 ../fish/guestfish-actions.pod:2260 ../fish/guestfish-actions.pod:2270 ../fish/guestfish-actions.pod:2304 ../fish/guestfish-actions.pod:2313 msgid "See also L</stat>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2203 +#: ../fish/guestfish-actions.pod:2216 msgid "is-busy" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2205 +#: ../fish/guestfish-actions.pod:2218 #, no-wrap msgid "" " is-busy\n" @@ -22520,12 +22737,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2212 +#: ../fish/guestfish-actions.pod:2225 msgid "is-chardev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2214 +#: ../fish/guestfish-actions.pod:2227 #, no-wrap msgid "" " is-chardev path\n" @@ -22533,12 +22750,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2221 +#: ../fish/guestfish-actions.pod:2234 msgid "is-config" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2223 +#: ../fish/guestfish-actions.pod:2236 #, no-wrap msgid "" " is-config\n" @@ -22546,12 +22763,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2230 +#: ../fish/guestfish-actions.pod:2243 msgid "is-dir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2232 +#: ../fish/guestfish-actions.pod:2245 #, no-wrap msgid "" " is-dir path\n" @@ -22559,12 +22776,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2240 +#: ../fish/guestfish-actions.pod:2253 msgid "is-fifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2242 +#: ../fish/guestfish-actions.pod:2255 #, no-wrap msgid "" " is-fifo path\n" @@ -22572,12 +22789,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2249 +#: ../fish/guestfish-actions.pod:2262 msgid "is-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2251 +#: ../fish/guestfish-actions.pod:2264 #, no-wrap msgid "" " is-file path\n" @@ -22585,12 +22802,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2259 +#: ../fish/guestfish-actions.pod:2272 msgid "is-launching" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2261 +#: ../fish/guestfish-actions.pod:2274 #, no-wrap msgid "" " is-launching\n" @@ -22598,12 +22815,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2268 +#: ../fish/guestfish-actions.pod:2281 msgid "is-lv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2270 +#: ../fish/guestfish-actions.pod:2283 #, no-wrap msgid "" " is-lv device\n" @@ -22611,12 +22828,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2275 +#: ../fish/guestfish-actions.pod:2288 msgid "is-ready" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2277 +#: ../fish/guestfish-actions.pod:2290 #, no-wrap msgid "" " is-ready\n" @@ -22624,12 +22841,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2284 +#: ../fish/guestfish-actions.pod:2297 msgid "is-socket" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2286 +#: ../fish/guestfish-actions.pod:2299 #, no-wrap msgid "" " is-socket path\n" @@ -22637,12 +22854,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2293 +#: ../fish/guestfish-actions.pod:2306 msgid "is-symlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2295 +#: ../fish/guestfish-actions.pod:2308 #, no-wrap msgid "" " is-symlink path\n" @@ -22650,12 +22867,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2302 +#: ../fish/guestfish-actions.pod:2315 msgid "kill-subprocess" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2304 +#: ../fish/guestfish-actions.pod:2317 #, no-wrap msgid "" " kill-subprocess\n" @@ -22663,17 +22880,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2308 +#: ../fish/guestfish-actions.pod:2321 msgid "launch" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2310 +#: ../fish/guestfish-actions.pod:2323 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2312 +#: ../fish/guestfish-actions.pod:2325 #, no-wrap msgid "" " launch\n" @@ -22681,12 +22898,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2320 +#: ../fish/guestfish-actions.pod:2333 msgid "lchown" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2322 +#: ../fish/guestfish-actions.pod:2335 #, no-wrap msgid "" " lchown owner group path\n" @@ -22694,7 +22911,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2324 +#: ../fish/guestfish-actions.pod:2337 msgid "" "Change the file owner to C<owner> and group to C<group>. This is like " "L</chown> but if C<path> is a symlink then the link itself is changed, not " @@ -22702,12 +22919,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2332 +#: ../fish/guestfish-actions.pod:2345 msgid "lgetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2334 +#: ../fish/guestfish-actions.pod:2347 #, no-wrap msgid "" " lgetxattr path name\n" @@ -22715,17 +22932,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2350 +#: ../fish/guestfish-actions.pod:2363 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2352 +#: ../fish/guestfish-actions.pod:2365 msgid "lgetxattrs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2354 +#: ../fish/guestfish-actions.pod:2367 #, no-wrap msgid "" " lgetxattrs path\n" @@ -22733,19 +22950,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2356 +#: ../fish/guestfish-actions.pod:2369 msgid "" "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then " "it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2360 +#: ../fish/guestfish-actions.pod:2373 msgid "list-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2362 +#: ../fish/guestfish-actions.pod:2375 #, no-wrap msgid "" " list-devices\n" @@ -22753,12 +22970,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2370 +#: ../fish/guestfish-actions.pod:2383 msgid "list-filesystems" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2372 +#: ../fish/guestfish-actions.pod:2385 #, no-wrap msgid "" " list-filesystems\n" @@ -22766,7 +22983,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2391 +#: ../fish/guestfish-actions.pod:2404 msgid "" "This command runs other libguestfs commands, which might include L</mount> " "and L</umount>, and therefore you should use this soon after launch and only " @@ -22774,7 +22991,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2395 +#: ../fish/guestfish-actions.pod:2408 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 " @@ -22784,12 +23001,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2403 +#: ../fish/guestfish-actions.pod:2416 msgid "list-partitions" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2405 +#: ../fish/guestfish-actions.pod:2418 #, no-wrap msgid "" " list-partitions\n" @@ -22797,19 +23014,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2411 +#: ../fish/guestfish-actions.pod:2424 msgid "" "This does not return logical volumes. For that you will need to call " "L</lvs>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2416 +#: ../fish/guestfish-actions.pod:2429 msgid "ll" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2418 +#: ../fish/guestfish-actions.pod:2431 #, no-wrap msgid "" " ll directory\n" @@ -22817,12 +23034,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2426 +#: ../fish/guestfish-actions.pod:2439 msgid "ln" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2428 +#: ../fish/guestfish-actions.pod:2441 #, no-wrap msgid "" " ln target linkname\n" @@ -22830,12 +23047,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2432 +#: ../fish/guestfish-actions.pod:2445 msgid "ln-f" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2434 +#: ../fish/guestfish-actions.pod:2447 #, no-wrap msgid "" " ln-f target linkname\n" @@ -22843,12 +23060,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2439 +#: ../fish/guestfish-actions.pod:2452 msgid "ln-s" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2441 +#: ../fish/guestfish-actions.pod:2454 #, no-wrap msgid "" " ln-s target linkname\n" @@ -22856,12 +23073,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2445 +#: ../fish/guestfish-actions.pod:2458 msgid "ln-sf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2447 +#: ../fish/guestfish-actions.pod:2460 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -22869,12 +23086,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2452 +#: ../fish/guestfish-actions.pod:2465 msgid "lremovexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2454 +#: ../fish/guestfish-actions.pod:2467 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -22882,19 +23099,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2456 +#: ../fish/guestfish-actions.pod:2469 msgid "" "This is the same as L</removexattr>, but if C<path> is a symbolic link, then " "it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2460 +#: ../fish/guestfish-actions.pod:2473 msgid "ls" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2462 +#: ../fish/guestfish-actions.pod:2475 #, no-wrap msgid "" " ls directory\n" @@ -22902,19 +23119,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2468 +#: ../fish/guestfish-actions.pod:2481 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L</readdir> instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2471 +#: ../fish/guestfish-actions.pod:2484 msgid "lsetxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2473 +#: ../fish/guestfish-actions.pod:2486 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -22922,19 +23139,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2475 +#: ../fish/guestfish-actions.pod:2488 msgid "" "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it " "sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2479 +#: ../fish/guestfish-actions.pod:2492 msgid "lstat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2481 +#: ../fish/guestfish-actions.pod:2494 #, no-wrap msgid "" " lstat path\n" @@ -22942,19 +23159,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2485 +#: ../fish/guestfish-actions.pod:2498 msgid "" "This is the same as L</stat> except that if C<path> is a symbolic link, then " "the link is stat-ed, not the file it refers to." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2491 +#: ../fish/guestfish-actions.pod:2504 msgid "lstatlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2493 +#: ../fish/guestfish-actions.pod:2506 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -22962,7 +23179,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2495 +#: ../fish/guestfish-actions.pod:2508 msgid "" "This call allows you to perform the L</lstat> operation on multiple files, " "where all files are in the directory C<path>. C<names> is the list of files " @@ -22970,7 +23187,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2504 +#: ../fish/guestfish-actions.pod:2517 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L</lxattrlist> for a " @@ -22981,12 +23198,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2512 +#: ../fish/guestfish-actions.pod:2525 msgid "luks-add-key" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2514 +#: ../fish/guestfish-actions.pod:2527 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -22994,26 +23211,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2521 +#: ../fish/guestfish-actions.pod:2534 msgid "" "Note that if C<keyslot> already contains a key, then this command will " "fail. You have to use L</luks-kill-slot> first to remove that key." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2525 ../fish/guestfish-actions.pod:2547 ../fish/guestfish-actions.pod:2560 ../fish/guestfish-actions.pod:2574 ../fish/guestfish-actions.pod:2597 ../fish/guestfish-actions.pod:2607 +#: ../fish/guestfish-actions.pod:2538 ../fish/guestfish-actions.pod:2560 ../fish/guestfish-actions.pod:2573 ../fish/guestfish-actions.pod:2587 ../fish/guestfish-actions.pod:2610 ../fish/guestfish-actions.pod:2620 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2528 +#: ../fish/guestfish-actions.pod:2541 msgid "luks-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2530 +#: ../fish/guestfish-actions.pod:2543 #, no-wrap msgid "" " luks-close device\n" @@ -23021,7 +23238,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2532 +#: ../fish/guestfish-actions.pod:2545 msgid "" "This closes a LUKS device that was created earlier by L</luks-open> or " "L</luks-open-ro>. The C<device> parameter must be the name of the LUKS " @@ -23030,12 +23247,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2538 +#: ../fish/guestfish-actions.pod:2551 msgid "luks-format" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2540 +#: ../fish/guestfish-actions.pod:2553 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -23043,12 +23260,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2553 +#: ../fish/guestfish-actions.pod:2566 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2555 +#: ../fish/guestfish-actions.pod:2568 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -23056,19 +23273,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2557 +#: ../fish/guestfish-actions.pod:2570 msgid "" "This command is the same as L</luks-format> but it also allows you to set " "the C<cipher> used." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2566 +#: ../fish/guestfish-actions.pod:2579 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2568 +#: ../fish/guestfish-actions.pod:2581 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -23076,12 +23293,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2577 +#: ../fish/guestfish-actions.pod:2590 msgid "luks-open" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2579 +#: ../fish/guestfish-actions.pod:2592 #, no-wrap msgid "" " luks-open device mapname\n" @@ -23089,19 +23306,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2593 +#: ../fish/guestfish-actions.pod:2606 msgid "" "If this block device contains LVM volume groups, then calling L</vgscan> " "followed by L</vg-activate-all> will make them visible." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2600 +#: ../fish/guestfish-actions.pod:2613 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2602 +#: ../fish/guestfish-actions.pod:2615 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -23109,19 +23326,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2604 +#: ../fish/guestfish-actions.pod:2617 msgid "" "This is the same as L</luks-open> except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2610 +#: ../fish/guestfish-actions.pod:2623 msgid "lvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2612 +#: ../fish/guestfish-actions.pod:2625 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -23129,12 +23346,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2617 +#: ../fish/guestfish-actions.pod:2630 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2619 +#: ../fish/guestfish-actions.pod:2632 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -23142,17 +23359,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2628 +#: ../fish/guestfish-actions.pod:2641 msgid "See also L</is-lv>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2630 +#: ../fish/guestfish-actions.pod:2643 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2632 +#: ../fish/guestfish-actions.pod:2645 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -23160,19 +23377,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2634 +#: ../fish/guestfish-actions.pod:2647 msgid "" "This undoes the effect of L</lvm-set-filter>. LVM will be able to see every " "block device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2640 +#: ../fish/guestfish-actions.pod:2653 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2642 +#: ../fish/guestfish-actions.pod:2655 #, no-wrap msgid "" " lvm-remove-all\n" @@ -23180,12 +23397,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2650 +#: ../fish/guestfish-actions.pod:2663 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2652 +#: ../fish/guestfish-actions.pod:2665 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -23193,12 +23410,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2677 +#: ../fish/guestfish-actions.pod:2690 msgid "lvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2679 +#: ../fish/guestfish-actions.pod:2692 #, no-wrap msgid "" " lvremove device\n" @@ -23206,12 +23423,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2687 +#: ../fish/guestfish-actions.pod:2700 msgid "lvrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2689 +#: ../fish/guestfish-actions.pod:2702 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -23219,12 +23436,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2693 +#: ../fish/guestfish-actions.pod:2706 msgid "lvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2695 +#: ../fish/guestfish-actions.pod:2708 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -23232,12 +23449,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2701 +#: ../fish/guestfish-actions.pod:2714 msgid "lvresize-free" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2703 +#: ../fish/guestfish-actions.pod:2716 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -23245,12 +23462,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2711 +#: ../fish/guestfish-actions.pod:2724 msgid "lvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2713 +#: ../fish/guestfish-actions.pod:2726 #, no-wrap msgid "" " lvs\n" @@ -23258,17 +23475,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2721 +#: ../fish/guestfish-actions.pod:2734 msgid "See also L</lvs-full>, L</list-filesystems>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2723 +#: ../fish/guestfish-actions.pod:2736 msgid "lvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2725 +#: ../fish/guestfish-actions.pod:2738 #, no-wrap msgid "" " lvs-full\n" @@ -23276,12 +23493,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2730 +#: ../fish/guestfish-actions.pod:2743 msgid "lvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2732 +#: ../fish/guestfish-actions.pod:2745 #, no-wrap msgid "" " lvuuid device\n" @@ -23289,12 +23506,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2736 +#: ../fish/guestfish-actions.pod:2749 msgid "lxattrlist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2738 +#: ../fish/guestfish-actions.pod:2751 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -23302,7 +23519,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2754 +#: ../fish/guestfish-actions.pod:2767 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L</lstatlist> for a " @@ -23313,12 +23530,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2762 +#: ../fish/guestfish-actions.pod:2775 msgid "mkdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2764 +#: ../fish/guestfish-actions.pod:2777 #, no-wrap msgid "" " mkdir path\n" @@ -23326,12 +23543,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2768 +#: ../fish/guestfish-actions.pod:2781 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2770 +#: ../fish/guestfish-actions.pod:2783 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -23339,17 +23556,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2779 +#: ../fish/guestfish-actions.pod:2792 msgid "See also L</mkdir>, L</umask>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2781 +#: ../fish/guestfish-actions.pod:2794 msgid "mkdir-p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2783 +#: ../fish/guestfish-actions.pod:2796 #, no-wrap msgid "" " mkdir-p path\n" @@ -23357,12 +23574,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2788 +#: ../fish/guestfish-actions.pod:2801 msgid "mkdtemp" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2790 +#: ../fish/guestfish-actions.pod:2803 #, no-wrap msgid "" " mkdtemp template\n" @@ -23370,12 +23587,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2811 +#: ../fish/guestfish-actions.pod:2824 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2813 +#: ../fish/guestfish-actions.pod:2826 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -23383,17 +23600,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2821 +#: ../fish/guestfish-actions.pod:2834 msgid "See also L</mke2journal>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2823 +#: ../fish/guestfish-actions.pod:2836 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2825 +#: ../fish/guestfish-actions.pod:2838 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -23401,17 +23618,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2830 +#: ../fish/guestfish-actions.pod:2843 msgid "See also L</mke2journal-L>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2832 +#: ../fish/guestfish-actions.pod:2845 msgid "mke2fs-JU" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2834 +#: ../fish/guestfish-actions.pod:2847 #, no-wrap msgid "" " mke2fs-JU fstype blocksize device uuid\n" @@ -23419,17 +23636,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2839 +#: ../fish/guestfish-actions.pod:2852 msgid "See also L</mke2journal-U>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2841 +#: ../fish/guestfish-actions.pod:2854 msgid "mke2journal" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2843 +#: ../fish/guestfish-actions.pod:2856 #, no-wrap msgid "" " mke2journal blocksize device\n" @@ -23437,12 +23654,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2850 +#: ../fish/guestfish-actions.pod:2863 msgid "mke2journal-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2852 +#: ../fish/guestfish-actions.pod:2865 #, no-wrap msgid "" " mke2journal-L blocksize label device\n" @@ -23450,12 +23667,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2856 +#: ../fish/guestfish-actions.pod:2869 msgid "mke2journal-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2858 +#: ../fish/guestfish-actions.pod:2871 #, no-wrap msgid "" " mke2journal-U blocksize uuid device\n" @@ -23463,12 +23680,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2862 +#: ../fish/guestfish-actions.pod:2875 msgid "mkfifo" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2864 +#: ../fish/guestfish-actions.pod:2877 #, no-wrap msgid "" " mkfifo mode path\n" @@ -23476,19 +23693,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2866 +#: ../fish/guestfish-actions.pod:2879 msgid "" "This call creates a FIFO (named pipe) called C<path> with mode C<mode>. It " "is just a convenient wrapper around L</mknod>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2872 +#: ../fish/guestfish-actions.pod:2885 msgid "mkfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2874 +#: ../fish/guestfish-actions.pod:2887 #, no-wrap msgid "" " mkfs fstype device\n" @@ -23496,12 +23713,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2880 +#: ../fish/guestfish-actions.pod:2893 msgid "mkfs-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2882 +#: ../fish/guestfish-actions.pod:2895 #, no-wrap msgid "" " mkfs-b fstype blocksize device\n" @@ -23509,7 +23726,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2884 +#: ../fish/guestfish-actions.pod:2897 msgid "" "This call is similar to L</mkfs>, but it allows you to control the block " "size of the resulting filesystem. Supported block sizes depend on the " @@ -23517,12 +23734,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2899 +#: ../fish/guestfish-actions.pod:2912 msgid "mkfs-opts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2901 +#: ../fish/guestfish-actions.pod:2914 #, no-wrap msgid "" " mkfs-opts fstype device [blocksize:..] [features:..]\n" @@ -23530,12 +23747,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2936 +#: ../fish/guestfish-actions.pod:2949 msgid "mkmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2938 +#: ../fish/guestfish-actions.pod:2951 #, no-wrap msgid "" " mkmountpoint exemptpath\n" @@ -23543,14 +23760,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2940 +#: ../fish/guestfish-actions.pod:2953 msgid "" "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used " "to create extra mountpoints before mounting the first filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2964 +#: ../fish/guestfish-actions.pod:2977 msgid "" "L</mkmountpoint> is not compatible with L</umount-all>. You may get " "unexpected errors if you try to mix these calls. It is safest to manually " @@ -23558,7 +23775,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2968 +#: ../fish/guestfish-actions.pod:2981 msgid "" "L</umount-all> unmounts filesystems by sorting the paths longest first, so " "for this to work for manual mountpoints, you must ensure that the innermost " @@ -23566,7 +23783,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2975 +#: ../fish/guestfish-actions.pod:2988 msgid "" "Autosync [see L</set-autosync>, this is set by default on handles] can cause " "L</umount-all> to be called when the handle is closed which can also trigger " @@ -23574,12 +23791,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2979 +#: ../fish/guestfish-actions.pod:2992 msgid "mknod" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2981 +#: ../fish/guestfish-actions.pod:2994 #, no-wrap msgid "" " mknod mode devmajor devminor path\n" @@ -23587,7 +23804,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2991 +#: ../fish/guestfish-actions.pod:3004 msgid "" "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with " "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a " @@ -23598,12 +23815,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3001 +#: ../fish/guestfish-actions.pod:3014 msgid "mknod-b" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3003 +#: ../fish/guestfish-actions.pod:3016 #, no-wrap msgid "" " mknod-b mode devmajor devminor path\n" @@ -23611,7 +23828,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3005 +#: ../fish/guestfish-actions.pod:3018 msgid "" "This call creates a block device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -23619,12 +23836,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3011 +#: ../fish/guestfish-actions.pod:3024 msgid "mknod-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3013 +#: ../fish/guestfish-actions.pod:3026 #, no-wrap msgid "" " mknod-c mode devmajor devminor path\n" @@ -23632,7 +23849,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3015 +#: ../fish/guestfish-actions.pod:3028 msgid "" "This call creates a char device node called C<path> with mode C<mode> and " "device major/minor C<devmajor> and C<devminor>. It is just a convenient " @@ -23640,12 +23857,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3021 +#: ../fish/guestfish-actions.pod:3034 msgid "mkswap" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3023 +#: ../fish/guestfish-actions.pod:3036 #, no-wrap msgid "" " mkswap device\n" @@ -23653,12 +23870,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3027 +#: ../fish/guestfish-actions.pod:3040 msgid "mkswap-L" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3029 +#: ../fish/guestfish-actions.pod:3042 #, no-wrap msgid "" " mkswap-L label device\n" @@ -23666,12 +23883,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3037 +#: ../fish/guestfish-actions.pod:3050 msgid "mkswap-U" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3039 +#: ../fish/guestfish-actions.pod:3052 #, no-wrap msgid "" " mkswap-U uuid device\n" @@ -23679,12 +23896,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3043 +#: ../fish/guestfish-actions.pod:3056 msgid "mkswap-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3045 +#: ../fish/guestfish-actions.pod:3058 #, no-wrap msgid "" " mkswap-file path\n" @@ -23692,19 +23909,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3049 +#: ../fish/guestfish-actions.pod:3062 msgid "" "This command just writes a swap file signature to an existing file. To " "create the file itself, use something like L</fallocate>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3052 +#: ../fish/guestfish-actions.pod:3065 msgid "modprobe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3054 +#: ../fish/guestfish-actions.pod:3067 #, no-wrap msgid "" " modprobe modulename\n" @@ -23712,12 +23929,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3061 +#: ../fish/guestfish-actions.pod:3074 msgid "mount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3063 +#: ../fish/guestfish-actions.pod:3076 #, no-wrap msgid "" " mount device mountpoint\n" @@ -23725,7 +23942,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3079 +#: ../fish/guestfish-actions.pod:3092 msgid "" "B<Important note:> When you use this call, the filesystem options C<sync> " "and C<noatime> are set implicitly. This was originally done because we " @@ -23737,12 +23954,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3089 +#: ../fish/guestfish-actions.pod:3102 msgid "mount-loop" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3091 +#: ../fish/guestfish-actions.pod:3104 #, no-wrap msgid "" " mount-loop file mountpoint\n" @@ -23750,12 +23967,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3097 +#: ../fish/guestfish-actions.pod:3110 msgid "mount-options" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3099 +#: ../fish/guestfish-actions.pod:3112 #, no-wrap msgid "" " mount-options options device mountpoint\n" @@ -23763,19 +23980,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3101 +#: ../fish/guestfish-actions.pod:3114 msgid "" "This is the same as the L</mount> command, but it allows you to set the " "mount options as for the L<mount(8)> I<-o> flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3109 +#: ../fish/guestfish-actions.pod:3122 msgid "mount-ro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3111 +#: ../fish/guestfish-actions.pod:3124 #, no-wrap msgid "" " mount-ro device mountpoint\n" @@ -23783,19 +24000,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3113 +#: ../fish/guestfish-actions.pod:3126 msgid "" "This is the same as the L</mount> command, but it mounts the filesystem with " "the read-only (I<-o ro>) flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3116 +#: ../fish/guestfish-actions.pod:3129 msgid "mount-vfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3118 +#: ../fish/guestfish-actions.pod:3131 #, no-wrap msgid "" " mount-vfs options vfstype device mountpoint\n" @@ -23803,19 +24020,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3120 +#: ../fish/guestfish-actions.pod:3133 msgid "" "This is the same as the L</mount> command, but it allows you to set both the " "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3124 +#: ../fish/guestfish-actions.pod:3137 msgid "mountpoints" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3126 +#: ../fish/guestfish-actions.pod:3139 #, no-wrap msgid "" " mountpoints\n" @@ -23823,7 +24040,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3128 +#: ../fish/guestfish-actions.pod:3141 msgid "" "This call is similar to L</mounts>. That call returns a list of devices. " "This one returns a hash table (map) of device name to directory where the " @@ -23831,12 +24048,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3132 +#: ../fish/guestfish-actions.pod:3145 msgid "mounts" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3134 +#: ../fish/guestfish-actions.pod:3147 #, no-wrap msgid "" " mounts\n" @@ -23844,17 +24061,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3141 +#: ../fish/guestfish-actions.pod:3154 msgid "See also: L</mountpoints>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3143 +#: ../fish/guestfish-actions.pod:3156 msgid "mv" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3145 +#: ../fish/guestfish-actions.pod:3158 #, no-wrap msgid "" " mv src dest\n" @@ -23862,12 +24079,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3150 +#: ../fish/guestfish-actions.pod:3163 msgid "ntfs-3g-probe" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3152 +#: ../fish/guestfish-actions.pod:3165 #, no-wrap msgid "" " ntfs-3g-probe true|false device\n" @@ -23875,12 +24092,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3166 +#: ../fish/guestfish-actions.pod:3179 msgid "ntfsresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3168 +#: ../fish/guestfish-actions.pod:3181 #, no-wrap msgid "" " ntfsresize device\n" @@ -23888,12 +24105,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3174 +#: ../fish/guestfish-actions.pod:3187 msgid "ntfsresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3176 +#: ../fish/guestfish-actions.pod:3189 #, no-wrap msgid "" " ntfsresize-size device size\n" @@ -23901,19 +24118,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3178 +#: ../fish/guestfish-actions.pod:3191 msgid "" "This command is the same as L</ntfsresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3181 +#: ../fish/guestfish-actions.pod:3194 msgid "part-add" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3183 +#: ../fish/guestfish-actions.pod:3196 #, no-wrap msgid "" " part-add device prlogex startsect endsect\n" @@ -23921,26 +24138,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3185 +#: ../fish/guestfish-actions.pod:3198 msgid "" "This command adds a partition to C<device>. If there is no partition table " "on the device, call L</part-init> first." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3197 +#: ../fish/guestfish-actions.pod:3210 msgid "" "Creating a partition which covers the whole disk is not so easy. Use " "L</part-disk> to do that." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3200 +#: ../fish/guestfish-actions.pod:3213 msgid "part-del" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3202 +#: ../fish/guestfish-actions.pod:3215 #, no-wrap msgid "" " part-del device partnum\n" @@ -23948,12 +24165,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3210 +#: ../fish/guestfish-actions.pod:3223 msgid "part-disk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3212 +#: ../fish/guestfish-actions.pod:3225 #, no-wrap msgid "" " part-disk device parttype\n" @@ -23961,26 +24178,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3214 +#: ../fish/guestfish-actions.pod:3227 msgid "" "This command is simply a combination of L</part-init> followed by " "L</part-add> to create a single primary partition covering the whole disk." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3218 +#: ../fish/guestfish-actions.pod:3231 msgid "" "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other " "possible values are described in L</part-init>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3224 +#: ../fish/guestfish-actions.pod:3237 msgid "part-get-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3226 +#: ../fish/guestfish-actions.pod:3239 #, no-wrap msgid "" " part-get-bootable device partnum\n" @@ -23988,17 +24205,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3231 +#: ../fish/guestfish-actions.pod:3244 msgid "See also L</part-set-bootable>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3233 +#: ../fish/guestfish-actions.pod:3246 msgid "part-get-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3235 +#: ../fish/guestfish-actions.pod:3248 #, no-wrap msgid "" " part-get-mbr-id device partnum\n" @@ -24006,7 +24223,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3240 ../fish/guestfish-actions.pod:3378 +#: ../fish/guestfish-actions.pod:3253 ../fish/guestfish-actions.pod:3391 msgid "" "Note that only MBR (old DOS-style) partitions have type bytes. You will get " "undefined results for other partition table types (see " @@ -24014,12 +24231,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3244 +#: ../fish/guestfish-actions.pod:3257 msgid "part-get-parttype" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3246 +#: ../fish/guestfish-actions.pod:3259 #, no-wrap msgid "" " part-get-parttype device\n" @@ -24027,7 +24244,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3251 +#: ../fish/guestfish-actions.pod:3264 msgid "" "Common return values include: C<msdos> (a DOS/Windows style MBR partition " "table), C<gpt> (a GPT/EFI-style partition table). Other values are " @@ -24035,12 +24252,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3256 +#: ../fish/guestfish-actions.pod:3269 msgid "part-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3258 +#: ../fish/guestfish-actions.pod:3271 #, no-wrap msgid "" " part-init device parttype\n" @@ -24048,19 +24265,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3264 +#: ../fish/guestfish-actions.pod:3277 msgid "" "Initially there are no partitions. Following this, you should call " "L</part-add> for each partition required." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3327 +#: ../fish/guestfish-actions.pod:3340 msgid "part-list" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3329 +#: ../fish/guestfish-actions.pod:3342 #, no-wrap msgid "" " part-list device\n" @@ -24068,19 +24285,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3344 +#: ../fish/guestfish-actions.pod:3357 msgid "" "Start of the partition I<in bytes>. To get sectors you have to divide by " "the device's sector size, see L</blockdev-getss>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3357 +#: ../fish/guestfish-actions.pod:3370 msgid "part-set-bootable" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3359 +#: ../fish/guestfish-actions.pod:3372 #, no-wrap msgid "" " part-set-bootable device partnum true|false\n" @@ -24088,12 +24305,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3368 +#: ../fish/guestfish-actions.pod:3381 msgid "part-set-mbr-id" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3370 +#: ../fish/guestfish-actions.pod:3383 #, no-wrap msgid "" " part-set-mbr-id device partnum idbyte\n" @@ -24101,12 +24318,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3382 +#: ../fish/guestfish-actions.pod:3395 msgid "part-set-name" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3384 +#: ../fish/guestfish-actions.pod:3397 #, no-wrap msgid "" " part-set-name device partnum name\n" @@ -24114,12 +24331,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3392 +#: ../fish/guestfish-actions.pod:3405 msgid "part-to-dev" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3394 +#: ../fish/guestfish-actions.pod:3407 #, no-wrap msgid "" " part-to-dev partition\n" @@ -24127,19 +24344,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3400 +#: ../fish/guestfish-actions.pod:3413 msgid "" "The named partition must exist, for example as a string returned from " "L</list-partitions>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3403 +#: ../fish/guestfish-actions.pod:3416 msgid "ping-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3405 +#: ../fish/guestfish-actions.pod:3418 #, no-wrap msgid "" " ping-daemon\n" @@ -24147,12 +24364,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3412 +#: ../fish/guestfish-actions.pod:3425 msgid "pread" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3414 +#: ../fish/guestfish-actions.pod:3427 #, no-wrap msgid "" " pread path count offset\n" @@ -24160,17 +24377,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3422 +#: ../fish/guestfish-actions.pod:3435 msgid "See also L</pwrite>, L</pread-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3427 +#: ../fish/guestfish-actions.pod:3440 msgid "pread-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3429 +#: ../fish/guestfish-actions.pod:3442 #, no-wrap msgid "" " pread-device device count offset\n" @@ -24178,17 +24395,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3437 +#: ../fish/guestfish-actions.pod:3450 msgid "See also L</pread>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3442 +#: ../fish/guestfish-actions.pod:3455 msgid "pvcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3444 +#: ../fish/guestfish-actions.pod:3457 #, no-wrap msgid "" " pvcreate device\n" @@ -24196,12 +24413,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3450 +#: ../fish/guestfish-actions.pod:3463 msgid "pvremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3452 +#: ../fish/guestfish-actions.pod:3465 #, no-wrap msgid "" " pvremove device\n" @@ -24209,12 +24426,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3461 +#: ../fish/guestfish-actions.pod:3474 msgid "pvresize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3463 +#: ../fish/guestfish-actions.pod:3476 #, no-wrap msgid "" " pvresize device\n" @@ -24222,12 +24439,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3468 +#: ../fish/guestfish-actions.pod:3481 msgid "pvresize-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3470 +#: ../fish/guestfish-actions.pod:3483 #, no-wrap msgid "" " pvresize-size device size\n" @@ -24235,19 +24452,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3472 +#: ../fish/guestfish-actions.pod:3485 msgid "" "This command is the same as L</pvresize> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3475 +#: ../fish/guestfish-actions.pod:3488 msgid "pvs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3477 +#: ../fish/guestfish-actions.pod:3490 #, no-wrap msgid "" " pvs\n" @@ -24255,17 +24472,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3485 +#: ../fish/guestfish-actions.pod:3498 msgid "See also L</pvs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3487 +#: ../fish/guestfish-actions.pod:3500 msgid "pvs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3489 +#: ../fish/guestfish-actions.pod:3502 #, no-wrap msgid "" " pvs-full\n" @@ -24273,12 +24490,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3494 +#: ../fish/guestfish-actions.pod:3507 msgid "pvuuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3496 +#: ../fish/guestfish-actions.pod:3509 #, no-wrap msgid "" " pvuuid device\n" @@ -24286,12 +24503,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3500 +#: ../fish/guestfish-actions.pod:3513 msgid "pwrite" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3502 +#: ../fish/guestfish-actions.pod:3515 #, no-wrap msgid "" " pwrite path content offset\n" @@ -24299,17 +24516,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3513 +#: ../fish/guestfish-actions.pod:3526 msgid "See also L</pread>, L</pwrite-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3518 +#: ../fish/guestfish-actions.pod:3531 msgid "pwrite-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3520 +#: ../fish/guestfish-actions.pod:3533 #, no-wrap msgid "" " pwrite-device device content offset\n" @@ -24317,17 +24534,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3530 +#: ../fish/guestfish-actions.pod:3543 msgid "See also L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3535 +#: ../fish/guestfish-actions.pod:3548 msgid "read-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3537 +#: ../fish/guestfish-actions.pod:3550 #, no-wrap msgid "" " read-file path\n" @@ -24335,7 +24552,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3542 +#: ../fish/guestfish-actions.pod:3555 msgid "" "Unlike L</cat>, this function can correctly handle files that contain " "embedded ASCII NUL characters. However unlike L</download>, this function " @@ -24343,12 +24560,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3550 +#: ../fish/guestfish-actions.pod:3563 msgid "read-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3552 +#: ../fish/guestfish-actions.pod:3565 #, no-wrap msgid "" " read-lines path\n" @@ -24356,7 +24573,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3559 +#: ../fish/guestfish-actions.pod:3572 msgid "" "Note that this function cannot correctly handle binary files (specifically, " "files containing C<\\0> character which is treated as end of line). For " @@ -24365,12 +24582,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3564 +#: ../fish/guestfish-actions.pod:3577 msgid "readdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3566 +#: ../fish/guestfish-actions.pod:3579 #, no-wrap msgid "" " readdir dir\n" @@ -24378,7 +24595,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3618 +#: ../fish/guestfish-actions.pod:3631 msgid "" "This function is primarily intended for use by programs. To get a simple " "list of names, use L</ls>. To get a printable directory for human " @@ -24386,12 +24603,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3622 +#: ../fish/guestfish-actions.pod:3635 msgid "readlink" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3624 +#: ../fish/guestfish-actions.pod:3637 #, no-wrap msgid "" " readlink path\n" @@ -24399,12 +24616,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3628 +#: ../fish/guestfish-actions.pod:3641 msgid "readlinklist" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3630 +#: ../fish/guestfish-actions.pod:3643 #, no-wrap msgid "" " readlinklist path 'names ...'\n" @@ -24412,12 +24629,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3654 +#: ../fish/guestfish-actions.pod:3667 msgid "realpath" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3656 +#: ../fish/guestfish-actions.pod:3669 #, no-wrap msgid "" " realpath path\n" @@ -24425,12 +24642,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3661 +#: ../fish/guestfish-actions.pod:3674 msgid "removexattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3663 +#: ../fish/guestfish-actions.pod:3676 #, no-wrap msgid "" " removexattr xattr path\n" @@ -24438,17 +24655,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3668 +#: ../fish/guestfish-actions.pod:3681 msgid "See also: L</lremovexattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3670 +#: ../fish/guestfish-actions.pod:3683 msgid "resize2fs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3672 +#: ../fish/guestfish-actions.pod:3685 #, no-wrap msgid "" " resize2fs device\n" @@ -24456,7 +24673,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3677 +#: ../fish/guestfish-actions.pod:3690 msgid "" "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> " "before calling this command. For unknown reasons C<resize2fs> sometimes " @@ -24465,12 +24682,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3683 +#: ../fish/guestfish-actions.pod:3696 msgid "resize2fs-M" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3685 +#: ../fish/guestfish-actions.pod:3698 #, no-wrap msgid "" " resize2fs-M device\n" @@ -24478,7 +24695,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3687 +#: ../fish/guestfish-actions.pod:3700 msgid "" "This command is the same as L</resize2fs>, but the filesystem is resized to " "its minimum size. This works like the C<-M> option to the C<resize2fs> " @@ -24486,7 +24703,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3691 +#: ../fish/guestfish-actions.pod:3704 msgid "" "To get the resulting size of the filesystem you should call L</tune2fs-l> " "and read the C<Block size> and C<Block count> values. These two numbers, " @@ -24495,12 +24712,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3696 +#: ../fish/guestfish-actions.pod:3709 msgid "resize2fs-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3698 +#: ../fish/guestfish-actions.pod:3711 #, no-wrap msgid "" " resize2fs-size device size\n" @@ -24508,19 +24725,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3700 +#: ../fish/guestfish-actions.pod:3713 msgid "" "This command is the same as L</resize2fs> except that it allows you to " "specify the new size (in bytes) explicitly." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3716 msgid "rm" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3705 +#: ../fish/guestfish-actions.pod:3718 #, no-wrap msgid "" " rm path\n" @@ -24528,12 +24745,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3709 +#: ../fish/guestfish-actions.pod:3722 msgid "rm-rf" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3711 +#: ../fish/guestfish-actions.pod:3724 #, no-wrap msgid "" " rm-rf path\n" @@ -24541,12 +24758,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3717 +#: ../fish/guestfish-actions.pod:3730 msgid "rmdir" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3719 +#: ../fish/guestfish-actions.pod:3732 #, no-wrap msgid "" " rmdir path\n" @@ -24554,12 +24771,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3723 +#: ../fish/guestfish-actions.pod:3736 msgid "rmmountpoint" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3725 +#: ../fish/guestfish-actions.pod:3738 #, no-wrap msgid "" " rmmountpoint exemptpath\n" @@ -24567,19 +24784,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3727 +#: ../fish/guestfish-actions.pod:3740 msgid "" "This calls removes a mountpoint that was previously created with " "L</mkmountpoint>. See L</mkmountpoint> for full details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3731 +#: ../fish/guestfish-actions.pod:3744 msgid "scrub-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3733 +#: ../fish/guestfish-actions.pod:3746 #, no-wrap msgid "" " scrub-device device\n" @@ -24587,12 +24804,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3744 +#: ../fish/guestfish-actions.pod:3757 msgid "scrub-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3746 +#: ../fish/guestfish-actions.pod:3759 #, no-wrap msgid "" " scrub-file file\n" @@ -24600,12 +24817,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3756 +#: ../fish/guestfish-actions.pod:3769 msgid "scrub-freespace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3758 +#: ../fish/guestfish-actions.pod:3771 #, no-wrap msgid "" " scrub-freespace dir\n" @@ -24613,7 +24830,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3760 +#: ../fish/guestfish-actions.pod:3773 msgid "" "This command creates the directory C<dir> and then fills it with files until " "the filesystem is full, and scrubs the files as for L</scrub-file>, and " @@ -24622,17 +24839,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3769 +#: ../fish/guestfish-actions.pod:3782 msgid "set-append" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3771 +#: ../fish/guestfish-actions.pod:3784 msgid "append" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3773 +#: ../fish/guestfish-actions.pod:3786 #, no-wrap msgid "" " set-append append\n" @@ -24640,17 +24857,35 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3784 +#: ../fish/guestfish-actions.pod:3797 +msgid "set-attach-method" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3799 +msgid "attach-method" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3801 +#, no-wrap +msgid "" +" set-attach-method attachmethod\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3823 msgid "set-autosync" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3786 +#: ../fish/guestfish-actions.pod:3825 msgid "autosync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3788 +#: ../fish/guestfish-actions.pod:3827 #, no-wrap msgid "" " set-autosync true|false\n" @@ -24658,17 +24893,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3798 +#: ../fish/guestfish-actions.pod:3837 msgid "set-direct" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3800 +#: ../fish/guestfish-actions.pod:3839 msgid "direct" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3802 +#: ../fish/guestfish-actions.pod:3841 #, no-wrap msgid "" " set-direct true|false\n" @@ -24676,19 +24911,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3808 +#: ../fish/guestfish-actions.pod:3847 msgid "" "One consequence of this is that log messages aren't caught by the library " "and handled by L</set-log-message-callback>, but go straight to stdout." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3817 +#: ../fish/guestfish-actions.pod:3856 msgid "set-e2label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3819 +#: ../fish/guestfish-actions.pod:3858 #, no-wrap msgid "" " set-e2label device label\n" @@ -24696,19 +24931,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3825 +#: ../fish/guestfish-actions.pod:3864 msgid "" "You can use either L</tune2fs-l> or L</get-e2label> to return the existing " "label on a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3828 +#: ../fish/guestfish-actions.pod:3867 msgid "set-e2uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3830 +#: ../fish/guestfish-actions.pod:3869 #, no-wrap msgid "" " set-e2uuid device uuid\n" @@ -24716,24 +24951,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3837 +#: ../fish/guestfish-actions.pod:3876 msgid "" "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing " "UUID of a filesystem." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3840 +#: ../fish/guestfish-actions.pod:3879 msgid "set-memsize" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3842 +#: ../fish/guestfish-actions.pod:3881 msgid "memsize" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3844 +#: ../fish/guestfish-actions.pod:3883 #, no-wrap msgid "" " set-memsize memsize\n" @@ -24741,24 +24976,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3846 +#: ../fish/guestfish-actions.pod:3885 msgid "" "This sets the memory size in megabytes allocated to the qemu subprocess. " "This only has any effect if called before L</launch>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3857 +#: ../fish/guestfish-actions.pod:3896 msgid "set-network" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3859 +#: ../fish/guestfish-actions.pod:3898 msgid "network" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3861 +#: ../fish/guestfish-actions.pod:3900 #, no-wrap msgid "" " set-network true|false\n" @@ -24766,22 +25001,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3869 +#: ../fish/guestfish-actions.pod:3908 msgid "You must call this before calling L</launch>, otherwise it has no effect." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3872 +#: ../fish/guestfish-actions.pod:3911 msgid "set-path" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3874 +#: ../fish/guestfish-actions.pod:3913 msgid "path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3876 +#: ../fish/guestfish-actions.pod:3915 #, no-wrap msgid "" " set-path searchpath\n" @@ -24789,17 +25024,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3885 +#: ../fish/guestfish-actions.pod:3924 msgid "set-qemu" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3887 +#: ../fish/guestfish-actions.pod:3926 msgid "qemu" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3889 +#: ../fish/guestfish-actions.pod:3928 #, no-wrap msgid "" " set-qemu qemu\n" @@ -24807,17 +25042,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3909 +#: ../fish/guestfish-actions.pod:3948 msgid "set-recovery-proc" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3911 +#: ../fish/guestfish-actions.pod:3950 msgid "recovery-proc" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3913 +#: ../fish/guestfish-actions.pod:3952 #, no-wrap msgid "" " set-recovery-proc true|false\n" @@ -24825,7 +25060,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3915 +#: ../fish/guestfish-actions.pod:3954 msgid "" "If this is called with the parameter C<false> then L</launch> does not " "create a recovery process. The purpose of the recovery process is to stop " @@ -24833,24 +25068,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3920 +#: ../fish/guestfish-actions.pod:3959 msgid "" "This only has any effect if called before L</launch>, and the default is " "true." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3929 +#: ../fish/guestfish-actions.pod:3968 msgid "set-selinux" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3931 +#: ../fish/guestfish-actions.pod:3970 msgid "selinux" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3933 +#: ../fish/guestfish-actions.pod:3972 #, no-wrap msgid "" " set-selinux true|false\n" @@ -24858,17 +25093,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3944 +#: ../fish/guestfish-actions.pod:3983 msgid "set-trace" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3946 +#: ../fish/guestfish-actions.pod:3985 msgid "trace" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3948 +#: ../fish/guestfish-actions.pod:3987 #, no-wrap msgid "" " set-trace true|false\n" @@ -24876,17 +25111,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3964 +#: ../fish/guestfish-actions.pod:4003 msgid "set-verbose" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3966 +#: ../fish/guestfish-actions.pod:4005 msgid "verbose" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3968 +#: ../fish/guestfish-actions.pod:4007 #, no-wrap msgid "" " set-verbose true|false\n" @@ -24894,12 +25129,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3975 +#: ../fish/guestfish-actions.pod:4014 msgid "setcon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3977 +#: ../fish/guestfish-actions.pod:4016 #, no-wrap msgid "" " setcon context\n" @@ -24907,12 +25142,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3984 +#: ../fish/guestfish-actions.pod:4023 msgid "setxattr" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3986 +#: ../fish/guestfish-actions.pod:4025 #, no-wrap msgid "" " setxattr xattr val vallen path\n" @@ -24920,17 +25155,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3992 +#: ../fish/guestfish-actions.pod:4031 msgid "See also: L</lsetxattr>, L<attr(5)>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3994 +#: ../fish/guestfish-actions.pod:4033 msgid "sfdisk" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3996 +#: ../fish/guestfish-actions.pod:4035 #, no-wrap msgid "" " sfdisk device cyls heads sectors 'lines ...'\n" @@ -24938,17 +25173,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4018 +#: ../fish/guestfish-actions.pod:4057 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4024 +#: ../fish/guestfish-actions.pod:4063 msgid "sfdiskM" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4026 +#: ../fish/guestfish-actions.pod:4065 #, no-wrap msgid "" " sfdiskM device 'lines ...'\n" @@ -24956,7 +25191,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4028 +#: ../fish/guestfish-actions.pod:4067 msgid "" "This is a simplified interface to the L</sfdisk> command, where partition " "sizes are specified in megabytes only (rounded to the nearest cylinder) and " @@ -24965,17 +25200,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4034 +#: ../fish/guestfish-actions.pod:4073 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4040 +#: ../fish/guestfish-actions.pod:4079 msgid "sfdisk-N" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4042 +#: ../fish/guestfish-actions.pod:4081 #, no-wrap msgid "" " sfdisk-N device partnum cyls heads sectors line\n" @@ -24983,24 +25218,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4047 +#: ../fish/guestfish-actions.pod:4086 msgid "" "For other parameters, see L</sfdisk>. You should usually pass C<0> for the " "cyls/heads/sectors parameters." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4050 +#: ../fish/guestfish-actions.pod:4089 msgid "See also: L</part-add>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4055 +#: ../fish/guestfish-actions.pod:4094 msgid "sfdisk-disk-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4057 +#: ../fish/guestfish-actions.pod:4096 #, no-wrap msgid "" " sfdisk-disk-geometry device\n" @@ -25008,7 +25243,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4059 +#: ../fish/guestfish-actions.pod:4098 msgid "" "This displays the disk geometry of C<device> read from the partition table. " "Especially in the case where the underlying block device has been resized, " @@ -25017,12 +25252,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4067 +#: ../fish/guestfish-actions.pod:4106 msgid "sfdisk-kernel-geometry" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4069 +#: ../fish/guestfish-actions.pod:4108 #, no-wrap msgid "" " sfdisk-kernel-geometry device\n" @@ -25030,12 +25265,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4076 +#: ../fish/guestfish-actions.pod:4115 msgid "sfdisk-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4078 +#: ../fish/guestfish-actions.pod:4117 #, no-wrap msgid "" " sfdisk-l device\n" @@ -25043,17 +25278,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4084 +#: ../fish/guestfish-actions.pod:4123 msgid "See also: L</part-list>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4086 +#: ../fish/guestfish-actions.pod:4125 msgid "sh" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4088 +#: ../fish/guestfish-actions.pod:4127 #, no-wrap msgid "" " sh command\n" @@ -25061,22 +25296,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4093 +#: ../fish/guestfish-actions.pod:4132 msgid "This is like L</command>, but passes the command to:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4101 +#: ../fish/guestfish-actions.pod:4140 msgid "All the provisos about L</command> apply to this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4103 +#: ../fish/guestfish-actions.pod:4142 msgid "sh-lines" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4105 +#: ../fish/guestfish-actions.pod:4144 #, no-wrap msgid "" " sh-lines command\n" @@ -25084,22 +25319,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4107 +#: ../fish/guestfish-actions.pod:4146 msgid "This is the same as L</sh>, but splits the result into a list of lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4110 +#: ../fish/guestfish-actions.pod:4149 msgid "See also: L</command-lines>" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4112 +#: ../fish/guestfish-actions.pod:4151 msgid "sleep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4114 +#: ../fish/guestfish-actions.pod:4153 #, no-wrap msgid "" " sleep secs\n" @@ -25107,12 +25342,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4118 +#: ../fish/guestfish-actions.pod:4157 msgid "stat" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4120 +#: ../fish/guestfish-actions.pod:4159 #, no-wrap msgid "" " stat path\n" @@ -25120,12 +25355,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4126 +#: ../fish/guestfish-actions.pod:4165 msgid "statvfs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4128 +#: ../fish/guestfish-actions.pod:4167 #, no-wrap msgid "" " statvfs path\n" @@ -25133,12 +25368,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4136 +#: ../fish/guestfish-actions.pod:4175 msgid "strings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4138 +#: ../fish/guestfish-actions.pod:4177 #, no-wrap msgid "" " strings path\n" @@ -25146,12 +25381,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4146 +#: ../fish/guestfish-actions.pod:4185 msgid "strings-e" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4148 +#: ../fish/guestfish-actions.pod:4187 #, no-wrap msgid "" " strings-e encoding path\n" @@ -25159,26 +25394,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4150 +#: ../fish/guestfish-actions.pod:4189 msgid "" "This is like the L</strings> command, but allows you to specify the encoding " "of strings that are looked for in the source file C<path>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4160 +#: ../fish/guestfish-actions.pod:4199 msgid "" "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of " "ISO-8859-X (this is what L</strings> uses)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4192 +#: ../fish/guestfish-actions.pod:4231 msgid "swapoff-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4194 +#: ../fish/guestfish-actions.pod:4233 #, no-wrap msgid "" " swapoff-device device\n" @@ -25186,19 +25421,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4196 +#: ../fish/guestfish-actions.pod:4235 msgid "" "This command disables the libguestfs appliance swap device or partition " "named C<device>. See L</swapon-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4200 +#: ../fish/guestfish-actions.pod:4239 msgid "swapoff-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4202 +#: ../fish/guestfish-actions.pod:4241 #, no-wrap msgid "" " swapoff-file file\n" @@ -25206,12 +25441,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4206 +#: ../fish/guestfish-actions.pod:4245 msgid "swapoff-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4208 +#: ../fish/guestfish-actions.pod:4247 #, no-wrap msgid "" " swapoff-label label\n" @@ -25219,12 +25454,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4213 +#: ../fish/guestfish-actions.pod:4252 msgid "swapoff-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4215 +#: ../fish/guestfish-actions.pod:4254 #, no-wrap msgid "" " swapoff-uuid uuid\n" @@ -25232,12 +25467,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4220 +#: ../fish/guestfish-actions.pod:4259 msgid "swapon-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4222 +#: ../fish/guestfish-actions.pod:4261 #, no-wrap msgid "" " swapon-device device\n" @@ -25245,7 +25480,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4224 +#: ../fish/guestfish-actions.pod:4263 msgid "" "This command enables the libguestfs appliance to use the swap device or " "partition named C<device>. The increased memory is made available for all " @@ -25253,12 +25488,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4236 +#: ../fish/guestfish-actions.pod:4275 msgid "swapon-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4238 +#: ../fish/guestfish-actions.pod:4277 #, no-wrap msgid "" " swapon-file file\n" @@ -25266,17 +25501,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4240 +#: ../fish/guestfish-actions.pod:4279 msgid "This command enables swap to a file. See L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4243 +#: ../fish/guestfish-actions.pod:4282 msgid "swapon-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4245 +#: ../fish/guestfish-actions.pod:4284 #, no-wrap msgid "" " swapon-label label\n" @@ -25284,19 +25519,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4247 +#: ../fish/guestfish-actions.pod:4286 msgid "" "This command enables swap to a labeled swap partition. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4250 +#: ../fish/guestfish-actions.pod:4289 msgid "swapon-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4252 +#: ../fish/guestfish-actions.pod:4291 #, no-wrap msgid "" " swapon-uuid uuid\n" @@ -25304,19 +25539,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4254 +#: ../fish/guestfish-actions.pod:4293 msgid "" "This command enables swap to a swap partition with the given UUID. See " "L</swapon-device> for other notes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4257 +#: ../fish/guestfish-actions.pod:4296 msgid "sync" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4259 +#: ../fish/guestfish-actions.pod:4298 #, no-wrap msgid "" " sync\n" @@ -25324,12 +25559,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4267 +#: ../fish/guestfish-actions.pod:4306 msgid "tail" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4269 +#: ../fish/guestfish-actions.pod:4308 #, no-wrap msgid "" " tail path\n" @@ -25337,12 +25572,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4277 +#: ../fish/guestfish-actions.pod:4316 msgid "tail-n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4279 +#: ../fish/guestfish-actions.pod:4318 #, no-wrap msgid "" " tail-n nrlines path\n" @@ -25350,12 +25585,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4292 +#: ../fish/guestfish-actions.pod:4331 msgid "tar-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4294 +#: ../fish/guestfish-actions.pod:4333 #, no-wrap msgid "" " tar-in (tarfile|-) directory\n" @@ -25363,17 +25598,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4299 +#: ../fish/guestfish-actions.pod:4338 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4304 +#: ../fish/guestfish-actions.pod:4343 msgid "tar-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4306 +#: ../fish/guestfish-actions.pod:4345 #, no-wrap msgid "" " tar-out directory (tarfile|-)\n" @@ -25381,17 +25616,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4311 +#: ../fish/guestfish-actions.pod:4350 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4316 +#: ../fish/guestfish-actions.pod:4355 msgid "tgz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4318 +#: ../fish/guestfish-actions.pod:4357 #, no-wrap msgid "" " tgz-in (tarball|-) directory\n" @@ -25399,17 +25634,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4323 +#: ../fish/guestfish-actions.pod:4362 msgid "To upload an uncompressed tarball, use L</tar-in>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4327 +#: ../fish/guestfish-actions.pod:4366 msgid "tgz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4329 +#: ../fish/guestfish-actions.pod:4368 #, no-wrap msgid "" " tgz-out directory (tarball|-)\n" @@ -25417,17 +25652,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4334 +#: ../fish/guestfish-actions.pod:4373 msgid "To download an uncompressed tarball, use L</tar-out>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4338 +#: ../fish/guestfish-actions.pod:4377 msgid "touch" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4340 +#: ../fish/guestfish-actions.pod:4379 #, no-wrap msgid "" " touch path\n" @@ -25435,12 +25670,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4349 +#: ../fish/guestfish-actions.pod:4388 msgid "truncate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4351 +#: ../fish/guestfish-actions.pod:4390 #, no-wrap msgid "" " truncate path\n" @@ -25448,12 +25683,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4356 +#: ../fish/guestfish-actions.pod:4395 msgid "truncate-size" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4358 +#: ../fish/guestfish-actions.pod:4397 #, no-wrap msgid "" " truncate-size path size\n" @@ -25461,7 +25696,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4363 +#: ../fish/guestfish-actions.pod:4402 msgid "" "If the current file size is less than C<size> then the file is extended to " "the required size with zero bytes. This creates a sparse file (ie. disk " @@ -25470,12 +25705,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4369 +#: ../fish/guestfish-actions.pod:4408 msgid "tune2fs-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4371 +#: ../fish/guestfish-actions.pod:4410 #, no-wrap msgid "" " tune2fs-l device\n" @@ -25483,12 +25718,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4381 +#: ../fish/guestfish-actions.pod:4420 msgid "txz-in" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4383 +#: ../fish/guestfish-actions.pod:4422 #, no-wrap msgid "" " txz-in (tarball|-) directory\n" @@ -25496,12 +25731,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4390 +#: ../fish/guestfish-actions.pod:4429 msgid "txz-out" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4392 +#: ../fish/guestfish-actions.pod:4431 #, no-wrap msgid "" " txz-out directory (tarball|-)\n" @@ -25509,12 +25744,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4399 +#: ../fish/guestfish-actions.pod:4438 msgid "umask" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4401 +#: ../fish/guestfish-actions.pod:4440 #, no-wrap msgid "" " umask mask\n" @@ -25522,22 +25757,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4415 +#: ../fish/guestfish-actions.pod:4454 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4420 +#: ../fish/guestfish-actions.pod:4459 msgid "umount" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4422 +#: ../fish/guestfish-actions.pod:4461 msgid "unmount" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4424 +#: ../fish/guestfish-actions.pod:4463 #, no-wrap msgid "" " umount pathordevice\n" @@ -25545,17 +25780,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4430 +#: ../fish/guestfish-actions.pod:4469 msgid "umount-all" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4432 +#: ../fish/guestfish-actions.pod:4471 msgid "unmount-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4434 +#: ../fish/guestfish-actions.pod:4473 #, no-wrap msgid "" " umount-all\n" @@ -25563,12 +25798,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4440 +#: ../fish/guestfish-actions.pod:4479 msgid "upload" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4442 +#: ../fish/guestfish-actions.pod:4481 #, no-wrap msgid "" " upload (filename|-) remotefilename\n" @@ -25576,17 +25811,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4449 +#: ../fish/guestfish-actions.pod:4488 msgid "See also L</download>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4453 +#: ../fish/guestfish-actions.pod:4492 msgid "upload-offset" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4455 +#: ../fish/guestfish-actions.pod:4494 #, no-wrap msgid "" " upload-offset (filename|-) remotefilename offset\n" @@ -25594,7 +25829,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4467 +#: ../fish/guestfish-actions.pod:4506 msgid "" "Note that there is no limit on the amount of data that can be uploaded with " "this call, unlike with L</pwrite>, and this call always writes the full " @@ -25602,17 +25837,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4472 +#: ../fish/guestfish-actions.pod:4511 msgid "See also L</upload>, L</pwrite>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4476 +#: ../fish/guestfish-actions.pod:4515 msgid "utimens" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4478 +#: ../fish/guestfish-actions.pod:4517 #, no-wrap msgid "" " utimens path atsecs atnsecs mtsecs mtnsecs\n" @@ -25620,12 +25855,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4497 +#: ../fish/guestfish-actions.pod:4536 msgid "version" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4499 +#: ../fish/guestfish-actions.pod:4538 #, no-wrap msgid "" " version\n" @@ -25633,7 +25868,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4526 +#: ../fish/guestfish-actions.pod:4565 msgid "" "I<Note:> Don't use this call to test for availability of features. In " "enterprise distributions we backport features from later versions into " @@ -25642,12 +25877,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4532 +#: ../fish/guestfish-actions.pod:4571 msgid "vfs-label" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4534 +#: ../fish/guestfish-actions.pod:4573 #, no-wrap msgid "" " vfs-label device\n" @@ -25655,17 +25890,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4541 +#: ../fish/guestfish-actions.pod:4580 msgid "To find a filesystem from the label, use L</findfs-label>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4543 +#: ../fish/guestfish-actions.pod:4582 msgid "vfs-type" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4545 +#: ../fish/guestfish-actions.pod:4584 #, no-wrap msgid "" " vfs-type device\n" @@ -25673,12 +25908,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4555 +#: ../fish/guestfish-actions.pod:4594 msgid "vfs-uuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4557 +#: ../fish/guestfish-actions.pod:4596 #, no-wrap msgid "" " vfs-uuid device\n" @@ -25686,17 +25921,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4564 +#: ../fish/guestfish-actions.pod:4603 msgid "To find a filesystem from the UUID, use L</findfs-uuid>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4566 +#: ../fish/guestfish-actions.pod:4605 msgid "vg-activate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4568 +#: ../fish/guestfish-actions.pod:4607 #, no-wrap msgid "" " vg-activate true|false 'volgroups ...'\n" @@ -25704,12 +25939,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4581 +#: ../fish/guestfish-actions.pod:4620 msgid "vg-activate-all" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4583 +#: ../fish/guestfish-actions.pod:4622 #, no-wrap msgid "" " vg-activate-all true|false\n" @@ -25717,12 +25952,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4593 +#: ../fish/guestfish-actions.pod:4632 msgid "vgcreate" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4595 +#: ../fish/guestfish-actions.pod:4634 #, no-wrap msgid "" " vgcreate volgroup 'physvols ...'\n" @@ -25730,12 +25965,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4600 +#: ../fish/guestfish-actions.pod:4639 msgid "vglvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4602 +#: ../fish/guestfish-actions.pod:4641 #, no-wrap msgid "" " vglvuuids vgname\n" @@ -25743,24 +25978,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4607 +#: ../fish/guestfish-actions.pod:4646 msgid "" "You can use this along with L</lvs> and L</lvuuid> calls to associate " "logical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4610 +#: ../fish/guestfish-actions.pod:4649 msgid "See also L</vgpvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4612 +#: ../fish/guestfish-actions.pod:4651 msgid "vgpvuuids" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4614 +#: ../fish/guestfish-actions.pod:4653 #, no-wrap msgid "" " vgpvuuids vgname\n" @@ -25768,24 +26003,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4619 +#: ../fish/guestfish-actions.pod:4658 msgid "" "You can use this along with L</pvs> and L</pvuuid> calls to associate " "physical volumes and volume groups." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4622 +#: ../fish/guestfish-actions.pod:4661 msgid "See also L</vglvuuids>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4624 +#: ../fish/guestfish-actions.pod:4663 msgid "vgremove" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4626 +#: ../fish/guestfish-actions.pod:4665 #, no-wrap msgid "" " vgremove vgname\n" @@ -25793,12 +26028,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4633 +#: ../fish/guestfish-actions.pod:4672 msgid "vgrename" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4635 +#: ../fish/guestfish-actions.pod:4674 #, no-wrap msgid "" " vgrename volgroup newvolgroup\n" @@ -25806,12 +26041,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4639 +#: ../fish/guestfish-actions.pod:4678 msgid "vgs" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4641 +#: ../fish/guestfish-actions.pod:4680 #, no-wrap msgid "" " vgs\n" @@ -25819,17 +26054,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4649 +#: ../fish/guestfish-actions.pod:4688 msgid "See also L</vgs-full>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4651 +#: ../fish/guestfish-actions.pod:4690 msgid "vgs-full" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4653 +#: ../fish/guestfish-actions.pod:4692 #, no-wrap msgid "" " vgs-full\n" @@ -25837,12 +26072,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4658 +#: ../fish/guestfish-actions.pod:4697 msgid "vgscan" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4660 +#: ../fish/guestfish-actions.pod:4699 #, no-wrap msgid "" " vgscan\n" @@ -25850,12 +26085,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4665 +#: ../fish/guestfish-actions.pod:4704 msgid "vguuid" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4667 +#: ../fish/guestfish-actions.pod:4706 #, no-wrap msgid "" " vguuid vgname\n" @@ -25863,12 +26098,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4671 +#: ../fish/guestfish-actions.pod:4710 msgid "wc-c" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4673 +#: ../fish/guestfish-actions.pod:4712 #, no-wrap msgid "" " wc-c path\n" @@ -25876,12 +26111,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4678 +#: ../fish/guestfish-actions.pod:4717 msgid "wc-l" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4680 +#: ../fish/guestfish-actions.pod:4719 #, no-wrap msgid "" " wc-l path\n" @@ -25889,12 +26124,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4685 +#: ../fish/guestfish-actions.pod:4724 msgid "wc-w" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4687 +#: ../fish/guestfish-actions.pod:4726 #, no-wrap msgid "" " wc-w path\n" @@ -25902,12 +26137,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4692 +#: ../fish/guestfish-actions.pod:4731 msgid "write" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4694 +#: ../fish/guestfish-actions.pod:4733 #, no-wrap msgid "" " write path content\n" @@ -25915,12 +26150,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4702 +#: ../fish/guestfish-actions.pod:4741 msgid "write-file" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4704 +#: ../fish/guestfish-actions.pod:4743 #, no-wrap msgid "" " write-file path content size\n" @@ -25928,12 +26163,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4727 +#: ../fish/guestfish-actions.pod:4766 msgid "zegrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4729 +#: ../fish/guestfish-actions.pod:4768 #, no-wrap msgid "" " zegrep regex path\n" @@ -25941,12 +26176,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4737 +#: ../fish/guestfish-actions.pod:4776 msgid "zegrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4739 +#: ../fish/guestfish-actions.pod:4778 #, no-wrap msgid "" " zegrepi regex path\n" @@ -25954,12 +26189,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4747 +#: ../fish/guestfish-actions.pod:4786 msgid "zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4749 +#: ../fish/guestfish-actions.pod:4788 #, no-wrap msgid "" " zero device\n" @@ -25967,17 +26202,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4757 +#: ../fish/guestfish-actions.pod:4796 msgid "See also: L</zero-device>, L</scrub-device>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4759 +#: ../fish/guestfish-actions.pod:4798 msgid "zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4761 +#: ../fish/guestfish-actions.pod:4800 #, no-wrap msgid "" " zero-device device\n" @@ -25985,19 +26220,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4763 +#: ../fish/guestfish-actions.pod:4802 msgid "" "This command writes zeroes over the entire C<device>. Compare with L</zero> " "which just zeroes the first few blocks of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4770 +#: ../fish/guestfish-actions.pod:4809 msgid "zerofree" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4772 +#: ../fish/guestfish-actions.pod:4811 #, no-wrap msgid "" " zerofree device\n" @@ -26005,12 +26240,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4785 +#: ../fish/guestfish-actions.pod:4824 msgid "zfgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4787 +#: ../fish/guestfish-actions.pod:4826 #, no-wrap msgid "" " zfgrep pattern path\n" @@ -26018,12 +26253,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4795 +#: ../fish/guestfish-actions.pod:4834 msgid "zfgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4797 +#: ../fish/guestfish-actions.pod:4836 #, no-wrap msgid "" " zfgrepi pattern path\n" @@ -26031,12 +26266,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4805 +#: ../fish/guestfish-actions.pod:4844 msgid "zfile" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4807 +#: ../fish/guestfish-actions.pod:4846 #, no-wrap msgid "" " zfile meth path\n" @@ -26044,17 +26279,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:4814 +#: ../fish/guestfish-actions.pod:4853 msgid "Since 1.0.63, use L</file> instead which can now process compressed files." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4824 +#: ../fish/guestfish-actions.pod:4863 msgid "zgrep" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4826 +#: ../fish/guestfish-actions.pod:4865 #, no-wrap msgid "" " zgrep regex path\n" @@ -26062,12 +26297,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:4834 +#: ../fish/guestfish-actions.pod:4873 msgid "zgrepi" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:4836 +#: ../fish/guestfish-actions.pod:4875 #, no-wrap msgid "" " zgrepi regex path\n" @@ -26986,31 +27221,31 @@ msgid "B<-i> | B<--inspector>" msgstr "" #. type: =item -#: ../fuse/guestmount.pod:146 +#: ../fuse/guestmount.pod:151 msgid "B<-m dev[:mnt]> | B<--mount dev[:mnt]>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:148 +#: ../fuse/guestmount.pod:153 msgid "" "Mount the named partition or logical volume on the given mountpoint B<in the " "guest> (this has nothing to do with mountpoints in the host)." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:151 +#: ../fuse/guestmount.pod:156 msgid "" "If the mountpoint is omitted, it defaults to C</>. You have to mount " "something on C</>." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:154 +#: ../fuse/guestmount.pod:159 msgid "B<-n> | B<--no-sync>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:156 +#: ../fuse/guestmount.pod:161 msgid "" "By default, we attempt to sync the guest disk when the FUSE mountpoint is " "unmounted. If you specify this option, then we don't attempt to sync the " @@ -27018,17 +27253,17 @@ msgid "" msgstr "" #. type: =item -#: ../fuse/guestmount.pod:161 +#: ../fuse/guestmount.pod:166 msgid "B<-o option> | B<--option option>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:163 +#: ../fuse/guestmount.pod:168 msgid "Pass extra options to FUSE." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:165 +#: ../fuse/guestmount.pod:170 msgid "" "To get a list of all the extra options supported by FUSE, use the command " "below. Note that only the FUSE I<-o> options can be passed, and only some " @@ -27036,7 +27271,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fuse/guestmount.pod:169 +#: ../fuse/guestmount.pod:174 #, no-wrap msgid "" " guestmount --fuse-help\n" @@ -27044,37 +27279,37 @@ msgid "" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:171 +#: ../fuse/guestmount.pod:176 msgid "Some potentially useful FUSE options:" msgstr "" #. type: =item -#: ../fuse/guestmount.pod:175 +#: ../fuse/guestmount.pod:180 msgid "B<-o allow_other>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:177 +#: ../fuse/guestmount.pod:182 msgid "Allow other users to see the filesystem." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:179 +#: ../fuse/guestmount.pod:184 msgid "B<-o attr_timeout=N>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:181 +#: ../fuse/guestmount.pod:186 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:183 +#: ../fuse/guestmount.pod:188 msgid "B<-o kernel_cache>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:185 +#: ../fuse/guestmount.pod:190 msgid "" "Allow the kernel to cache files (reduces the number of reads that have to go " "through the L<guestfs(3)> API). This is generally a good idea if you can " @@ -27082,31 +27317,31 @@ msgid "" msgstr "" #. type: =item -#: ../fuse/guestmount.pod:189 +#: ../fuse/guestmount.pod:194 msgid "B<-o uid=N> B<-o gid=N>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:191 +#: ../fuse/guestmount.pod:196 msgid "" "Use these options to map all UIDs and GIDs inside the guest filesystem to " "the chosen values." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:196 +#: ../fuse/guestmount.pod:201 msgid "B<-r> | B<--ro>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:198 +#: ../fuse/guestmount.pod:203 msgid "" "Add devices and mount everything read-only. Also disallow writes and make " "the disk appear read-only to FUSE." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:201 +#: ../fuse/guestmount.pod:206 msgid "" "This is highly recommended if you are not going to edit the guest disk. If " "the guest is running and this option is I<not> supplied, then there is a " @@ -27115,64 +27350,64 @@ msgid "" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:206 +#: ../fuse/guestmount.pod:211 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:210 +#: ../fuse/guestmount.pod:215 msgid "Enable SELinux support for the guest." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:212 +#: ../fuse/guestmount.pod:217 msgid "B<-v> | B<--verbose>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:214 +#: ../fuse/guestmount.pod:219 msgid "Enable verbose messages from underlying libguestfs." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:216 +#: ../fuse/guestmount.pod:221 msgid "B<-V> | B<--version>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:218 +#: ../fuse/guestmount.pod:223 msgid "Display the program version and exit." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:220 +#: ../fuse/guestmount.pod:225 msgid "B<-w> | B<--rw>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:222 +#: ../fuse/guestmount.pod:227 msgid "" "This option does nothing at the moment. See L<guestfish(1)/OPENING DISKS " "FOR READ AND WRITE>." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:225 +#: ../fuse/guestmount.pod:230 msgid "B<-x> | B<--trace>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:227 +#: ../fuse/guestmount.pod:232 msgid "Trace libguestfs calls and entry into each FUSE function." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:229 +#: ../fuse/guestmount.pod:234 msgid "This also stops the daemon from forking into the background." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:235 +#: ../fuse/guestmount.pod:240 msgid "" "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, " "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, " |