msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
-"POT-Creation-Date: 2011-10-26 14:08+0200\n"
+"POT-Creation-Date: 2011-10-26 21:10+0200\n"
"PO-Revision-Date: 2011-10-19 15:46+0000\n"
"Last-Translator: rjones <rjones@redhat.com>\n"
"Language-Team: Japanese <trans-ja@lists.fedoraproject.org>\n"
#: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
#: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
-#: ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:403
-#: ../fish/guestfish-actions.pod:410 ../fish/guestfish-actions.pod:417
-#: ../fish/guestfish-actions.pod:1216 ../fish/guestfish-actions.pod:1220
-#: ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1228
-#: ../fish/guestfish-actions.pod:1236 ../fish/guestfish-actions.pod:1240
-#: ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1254
-#: ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1262
-#: ../fish/guestfish-actions.pod:1352 ../fish/guestfish-actions.pod:1356
-#: ../fish/guestfish-actions.pod:1361 ../fish/guestfish-actions.pod:1366
-#: ../fish/guestfish-actions.pod:1408 ../fish/guestfish-actions.pod:1412
-#: ../fish/guestfish-actions.pod:1417 ../fish/guestfish-actions.pod:1673
-#: ../fish/guestfish-actions.pod:1680 ../fish/guestfish-actions.pod:1687
-#: ../fish/guestfish-actions.pod:2090 ../fish/guestfish-actions.pod:2096
-#: ../fish/guestfish-actions.pod:2104 ../fish/guestfish-actions.pod:2111
-#: ../fish/guestfish-actions.pod:2118 ../fish/guestfish.pod:445
+#: ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449
+#: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463
+#: ../fish/guestfish-actions.pod:1262 ../fish/guestfish-actions.pod:1266
+#: ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1274
+#: ../fish/guestfish-actions.pod:1282 ../fish/guestfish-actions.pod:1286
+#: ../fish/guestfish-actions.pod:1290 ../fish/guestfish-actions.pod:1300
+#: ../fish/guestfish-actions.pod:1304 ../fish/guestfish-actions.pod:1308
+#: ../fish/guestfish-actions.pod:1398 ../fish/guestfish-actions.pod:1402
+#: ../fish/guestfish-actions.pod:1407 ../fish/guestfish-actions.pod:1412
+#: ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:1458
+#: ../fish/guestfish-actions.pod:1463 ../fish/guestfish-actions.pod:1719
+#: ../fish/guestfish-actions.pod:1726 ../fish/guestfish-actions.pod:1733
+#: ../fish/guestfish-actions.pod:2136 ../fish/guestfish-actions.pod:2142
+#: ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157
+#: ../fish/guestfish-actions.pod:2164 ../fish/guestfish.pod:445
#: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453
#: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393
#: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:359
#: ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54
#: ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64
#: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29
-#: ../src/guestfs-actions.pod:594 ../src/guestfs-actions.pod:602
-#: ../src/guestfs-actions.pod:609 ../src/guestfs-actions.pod:616
-#: ../src/guestfs-actions.pod:2024 ../src/guestfs-actions.pod:2028
-#: ../src/guestfs-actions.pod:2032 ../src/guestfs-actions.pod:2036
-#: ../src/guestfs-actions.pod:2044 ../src/guestfs-actions.pod:2048
-#: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2062
-#: ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:2070
-#: ../src/guestfs-actions.pod:2208 ../src/guestfs-actions.pod:2212
-#: ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2222
-#: ../src/guestfs-actions.pod:2283 ../src/guestfs-actions.pod:2287
-#: ../src/guestfs-actions.pod:2292 ../src/guestfs-actions.pod:2707
-#: ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:2721
-#: ../src/guestfs-actions.pod:3266 ../src/guestfs-actions.pod:3272
-#: ../src/guestfs-actions.pod:3280 ../src/guestfs-actions.pod:3287
-#: ../src/guestfs-actions.pod:3294 ../src/guestfs.pod:403
+#: ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649
+#: ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663
+#: ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2075
+#: ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:2083
+#: ../src/guestfs-actions.pod:2091 ../src/guestfs-actions.pod:2095
+#: ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2109
+#: ../src/guestfs-actions.pod:2113 ../src/guestfs-actions.pod:2117
+#: ../src/guestfs-actions.pod:2255 ../src/guestfs-actions.pod:2259
+#: ../src/guestfs-actions.pod:2264 ../src/guestfs-actions.pod:2269
+#: ../src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:2334
+#: ../src/guestfs-actions.pod:2339 ../src/guestfs-actions.pod:2754
+#: ../src/guestfs-actions.pod:2761 ../src/guestfs-actions.pod:2768
+#: ../src/guestfs-actions.pod:3313 ../src/guestfs-actions.pod:3319
+#: ../src/guestfs-actions.pod:3327 ../src/guestfs-actions.pod:3334
+#: ../src/guestfs-actions.pod:3341 ../src/guestfs.pod:403
#: ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417
#: ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431
#: ../src/guestfs.pod:436 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113
msgstr ""
#. type: =head2
-#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4349
+#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4395
msgid "path"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
-#: ../fish/guestfish-actions.pod:1404 ../fish/guestfish-actions.pod:1669
-#: ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:18
-#: ../src/guestfs-actions.pod:2279 ../src/guestfs-actions.pod:2703
-#: ../src/guestfs-actions.pod:3262 ../src/guestfs.pod:1685
+#: ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1715
+#: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:18
+#: ../src/guestfs-actions.pod:2326 ../src/guestfs-actions.pod:2750
+#: ../src/guestfs-actions.pod:3309 ../src/guestfs.pod:1685
#: ../tools/virt-win-reg.pl:717
msgid "Notes:"
msgstr ""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:168
-#: ../fish/guestfish-actions.pod:182
+#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214
+#: ../fish/guestfish-actions.pod:228
msgid ""
"I<This function is deprecated.> In new code, use the L</add_drive_opts> call "
"instead."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:171
-#: ../fish/guestfish-actions.pod:185 ../fish/guestfish-actions.pod:895
-#: ../fish/guestfish-actions.pod:930 ../fish/guestfish-actions.pod:1103
-#: ../fish/guestfish-actions.pod:1463 ../fish/guestfish-actions.pod:1477
-#: ../fish/guestfish-actions.pod:3247 ../fish/guestfish-actions.pod:3558
-#: ../fish/guestfish-actions.pod:3606 ../fish/guestfish-actions.pod:4533
-#: ../fish/guestfish-actions.pod:4556 ../fish/guestfish-actions.pod:4578
-#: ../fish/guestfish-actions.pod:4616 ../fish/guestfish-actions.pod:5265
-#: ../fish/guestfish-actions.pod:5371 ../src/guestfs-actions.pod:10
-#: ../src/guestfs-actions.pod:258 ../src/guestfs-actions.pod:279
-#: ../src/guestfs-actions.pod:1525 ../src/guestfs-actions.pod:1582
-#: ../src/guestfs-actions.pod:1865 ../src/guestfs-actions.pod:2364
-#: ../src/guestfs-actions.pod:2385 ../src/guestfs-actions.pod:5030
-#: ../src/guestfs-actions.pod:5552 ../src/guestfs-actions.pod:5652
-#: ../src/guestfs-actions.pod:6952 ../src/guestfs-actions.pod:6996
-#: ../src/guestfs-actions.pod:7030 ../src/guestfs-actions.pod:7093
-#: ../src/guestfs-actions.pod:8025 ../src/guestfs-actions.pod:8134
-#: ../src/guestfs-actions.pod:8317
+#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217
+#: ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:941
+#: ../fish/guestfish-actions.pod:976 ../fish/guestfish-actions.pod:1149
+#: ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1523
+#: ../fish/guestfish-actions.pod:3293 ../fish/guestfish-actions.pod:3604
+#: ../fish/guestfish-actions.pod:3652 ../fish/guestfish-actions.pod:4579
+#: ../fish/guestfish-actions.pod:4602 ../fish/guestfish-actions.pod:4624
+#: ../fish/guestfish-actions.pod:4662 ../fish/guestfish-actions.pod:5311
+#: ../fish/guestfish-actions.pod:5417 ../src/guestfs-actions.pod:10
+#: ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326
+#: ../src/guestfs-actions.pod:1572 ../src/guestfs-actions.pod:1629
+#: ../src/guestfs-actions.pod:1912 ../src/guestfs-actions.pod:2411
+#: ../src/guestfs-actions.pod:2432 ../src/guestfs-actions.pod:5077
+#: ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5699
+#: ../src/guestfs-actions.pod:6999 ../src/guestfs-actions.pod:7043
+#: ../src/guestfs-actions.pod:7077 ../src/guestfs-actions.pod:7140
+#: ../src/guestfs-actions.pod:8072 ../src/guestfs-actions.pod:8181
+#: ../src/guestfs-actions.pod:8364
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 "
#: ../fish/guestfish-actions.pod:39
#, no-wrap
msgid ""
-" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n"
+" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..] [readonlydisk:..]\n"
"\n"
msgstr ""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64
+#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65
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
-#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67
+#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71
+#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76
+#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77
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 default "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82
+#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89
+#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90
msgid ""
"If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
"passed instead of the domain name. The C<dom> string is treated as a UUID "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:76
+#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95
+msgid ""
+"The optional C<readonlydisk> parameter controls what we do for disks which "
+"are marked E<lt>readonly/E<gt> in the libvirt XML. Possible values are:"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101
+msgid "readonlydisk = \"error\""
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95
+#: ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103
+#: ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125
+msgid "If C<readonly> is false:"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105
+msgid ""
+"The whole call is aborted with an error if any disk with the E<lt>readonly/"
+"E<gt> flag is found."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100
+#: ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108
+#: ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129
+msgid "If C<readonly> is true:"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102
+#: ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110
+#: ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131
+msgid "Disks with the E<lt>readonly/E<gt> flag are added read-only."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112
+msgid "readonlydisk = \"read\""
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116
+msgid ""
+"Disks with the E<lt>readonly/E<gt> flag are added read-only. Other disks "
+"are added read/write."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123
+msgid "readonlydisk = \"write\" (default)"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127
+msgid "Disks with the E<lt>readonly/E<gt> flag are added read/write."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133
+msgid "readonlydisk = \"ignore\""
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135
+msgid "If C<readonly> is true or false:"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137
+msgid "Disks with the E<lt>readonly/E<gt> flag are skipped."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish-actions.pod:122
msgid ""
"The other optional parameters are passed directly through to L</add-drive-"
"opts>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:148
-#: ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:789
-#: ../fish/guestfish-actions.pod:810 ../fish/guestfish-actions.pod:848
-#: ../fish/guestfish-actions.pod:857 ../fish/guestfish-actions.pod:866
-#: ../fish/guestfish-actions.pod:880 ../fish/guestfish-actions.pod:2125
-#: ../fish/guestfish-actions.pod:3296 ../fish/guestfish-actions.pod:3459
-#: ../fish/guestfish-actions.pod:3594
+#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194
+#: ../fish/guestfish-actions.pod:624 ../fish/guestfish-actions.pod:835
+#: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:894
+#: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:912
+#: ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:2171
+#: ../fish/guestfish-actions.pod:3342 ../fish/guestfish-actions.pod:3505
+#: ../fish/guestfish-actions.pod:3640
msgid ""
"This command has one or more optional arguments. See L</OPTIONAL ARGUMENTS>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:81
+#: ../fish/guestfish-actions.pod:127
msgid "add-drive"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:83
+#: ../fish/guestfish-actions.pod:129
#, no-wrap
msgid ""
" add-drive filename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:85
+#: ../fish/guestfish-actions.pod:131
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:89
+#: ../fish/guestfish-actions.pod:135
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:96
+#: ../fish/guestfish-actions.pod:142
msgid "add-drive-opts"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:98
+#: ../fish/guestfish-actions.pod:144
msgid "add"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:100
+#: ../fish/guestfish-actions.pod:146
#, no-wrap
msgid ""
" add-drive-opts filename [readonly:..] [format:..] [iface:..] [name:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:161
+#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:166
+#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:172
+#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219
msgid "This call checks that C<filename> exists."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3258
-#: ../src/guestfs-actions.pod:174 ../src/guestfs-actions.pod:5067
+#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3304
+#: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5114
msgid "The optional arguments are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:178
+#: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225
msgid "C<readonly>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:180
+#: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227
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 "
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:184
+#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231
msgid "C<format>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:127
+#: ../fish/guestfish-actions.pod:173
msgid ""
"This forces the image format. If you omit this (or use L</add-drive> or L</"
"add-drive-ro>) then the format is automatically detected. Possible formats "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:190
+#: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237
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 "
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:195
+#: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242
msgid "C<iface>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:138
+#: ../fish/guestfish-actions.pod:184
msgid ""
"This rarely-used option lets you emulate the behaviour of the deprecated L</"
"add-drive-with-if> call (q.v.)"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:141 ../src/guestfs-actions.pod:200
+#: ../fish/guestfish-actions.pod:187 ../src/guestfs-actions.pod:247
msgid "C<name>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:143 ../src/guestfs-actions.pod:202
+#: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249
msgid ""
"The name the drive had in the original guest, e.g. /dev/sdb. This is used as "
"a hint to the guest inspection process if it is available."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:150
+#: ../fish/guestfish-actions.pod:196
msgid "add-drive-ro"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:152
+#: ../fish/guestfish-actions.pod:198
msgid "add-ro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:154
+#: ../fish/guestfish-actions.pod:200
#, no-wrap
msgid ""
" add-drive-ro filename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:156
+#: ../fish/guestfish-actions.pod:202
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:161
+#: ../fish/guestfish-actions.pod:207
msgid "add-drive-ro-with-if"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:163
+#: ../fish/guestfish-actions.pod:209
#, no-wrap
msgid ""
" add-drive-ro-with-if filename iface\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:165
+#: ../fish/guestfish-actions.pod:211
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:175
+#: ../fish/guestfish-actions.pod:221
msgid "add-drive-with-if"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:177
+#: ../fish/guestfish-actions.pod:223
#, no-wrap
msgid ""
" add-drive-with-if filename iface\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:179
+#: ../fish/guestfish-actions.pod:225
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:189
+#: ../fish/guestfish-actions.pod:235
msgid "aug-clear"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:191
+#: ../fish/guestfish-actions.pod:237
#, no-wrap
msgid ""
" aug-clear augpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:193 ../src/guestfs-actions.pod:296
+#: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343
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: =head2
-#: ../fish/guestfish-actions.pod:196
+#: ../fish/guestfish-actions.pod:242
msgid "aug-close"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:198
+#: ../fish/guestfish-actions.pod:244
#, no-wrap
msgid ""
" aug-close\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:200
+#: ../fish/guestfish-actions.pod:246
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:205
+#: ../fish/guestfish-actions.pod:251
msgid "aug-defnode"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:207
+#: ../fish/guestfish-actions.pod:253
#, no-wrap
msgid ""
" aug-defnode name expr val\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:209 ../src/guestfs-actions.pod:325
+#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372
msgid ""
"Defines a variable C<name> whose value is the result of evaluating C<expr>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:212
+#: ../fish/guestfish-actions.pod:258
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:216 ../src/guestfs-actions.pod:332
+#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379
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: =head2
-#: ../fish/guestfish-actions.pod:220
+#: ../fish/guestfish-actions.pod:266
msgid "aug-defvar"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:222
+#: ../fish/guestfish-actions.pod:268
#, no-wrap
msgid ""
" aug-defvar name expr\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:224 ../src/guestfs-actions.pod:349
+#: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396
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
-#: ../fish/guestfish-actions.pod:228 ../src/guestfs-actions.pod:353
+#: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400
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
-#: ../fish/guestfish-actions.pod:231
+#: ../fish/guestfish-actions.pod:277
msgid "aug-get"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:233
+#: ../fish/guestfish-actions.pod:279
#, no-wrap
msgid ""
" aug-get augpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:235 ../src/guestfs-actions.pod:366
+#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413
msgid ""
"Look up the value associated with C<path>. If C<path> matches exactly one "
"node, the C<value> is returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:238
+#: ../fish/guestfish-actions.pod:284
msgid "aug-init"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:240
+#: ../fish/guestfish-actions.pod:286
#, no-wrap
msgid ""
" aug-init root flags\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:242 ../src/guestfs-actions.pod:381
+#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:246
+#: ../fish/guestfish-actions.pod:292
msgid "You must call this before using any other L</aug-*> commands."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:249 ../src/guestfs-actions.pod:388
+#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435
msgid ""
"C<root> is the filesystem root. C<root> must not be NULL, use C</> instead."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:252 ../src/guestfs-actions.pod:391
+#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438
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
-#: ../fish/guestfish-actions.pod:258 ../src/guestfs-actions.pod:397
+#: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444
msgid "C<AUG_SAVE_BACKUP> = 1"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:260 ../src/guestfs-actions.pod:399
+#: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446
msgid "Keep the original file with a C<.augsave> extension."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:401
+#: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448
msgid "C<AUG_SAVE_NEWFILE> = 2"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:403
+#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450
msgid ""
"Save changes into a file with extension C<.augnew>, and do not overwrite "
"original. Overrides C<AUG_SAVE_BACKUP>."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:267 ../src/guestfs-actions.pod:406
+#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453
msgid "C<AUG_TYPE_CHECK> = 4"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:269 ../src/guestfs-actions.pod:408
+#: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455
msgid "Typecheck lenses."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:271
+#: ../fish/guestfish-actions.pod:317
msgid ""
"This option is only useful when debugging Augeas lenses. Use of this option "
"may require additional memory for the libguestfs appliance. You may need to "
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:276 ../src/guestfs-actions.pod:415
+#: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462
msgid "C<AUG_NO_STDINC> = 8"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:278 ../src/guestfs-actions.pod:417
+#: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464
msgid "Do not use standard load path for modules."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:280 ../src/guestfs-actions.pod:419
+#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466
msgid "C<AUG_SAVE_NOOP> = 16"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:282 ../src/guestfs-actions.pod:421
+#: ../fish/guestfish-actions.pod:328 ../src/guestfs-actions.pod:468
msgid "Make save a no-op, just record what would have been changed."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:284 ../src/guestfs-actions.pod:423
+#: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470
msgid "C<AUG_NO_LOAD> = 32"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:286
+#: ../fish/guestfish-actions.pod:332
msgid "Do not load the tree in L</aug-init>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:290
+#: ../fish/guestfish-actions.pod:336
msgid "To close the handle, you can call L</aug-close>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:292 ../src/guestfs-actions.pod:431
+#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478
msgid "To find out more about Augeas, see L<http://augeas.net/>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:294
+#: ../fish/guestfish-actions.pod:340
msgid "aug-insert"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:296
+#: ../fish/guestfish-actions.pod:342
#, no-wrap
msgid ""
" aug-insert augpath label true|false\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:445
+#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492
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
-#: ../fish/guestfish-actions.pod:302 ../src/guestfs-actions.pod:449
+#: ../fish/guestfish-actions.pod:348 ../src/guestfs-actions.pod:496
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
-#: ../fish/guestfish-actions.pod:306
+#: ../fish/guestfish-actions.pod:352
msgid "aug-load"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:308
+#: ../fish/guestfish-actions.pod:354
#, no-wrap
msgid ""
" aug-load\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:462
+#: ../fish/guestfish-actions.pod:356 ../src/guestfs-actions.pod:509
msgid "Load files into the tree."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:312 ../src/guestfs-actions.pod:464
+#: ../fish/guestfish-actions.pod:358 ../src/guestfs-actions.pod:511
msgid "See C<aug_load> in the Augeas documentation for the full gory details."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:315
+#: ../fish/guestfish-actions.pod:361
msgid "aug-ls"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:317
+#: ../fish/guestfish-actions.pod:363
#, no-wrap
msgid ""
" aug-ls augpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:319
+#: ../fish/guestfish-actions.pod:365
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:322
+#: ../fish/guestfish-actions.pod:368
msgid "aug-match"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:324
+#: ../fish/guestfish-actions.pod:370
#, no-wrap
msgid ""
" aug-match augpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:492
+#: ../fish/guestfish-actions.pod:372 ../src/guestfs-actions.pod:539
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:330
+#: ../fish/guestfish-actions.pod:376
msgid "aug-mv"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:332
+#: ../fish/guestfish-actions.pod:378
#, no-wrap
msgid ""
" aug-mv src dest\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:334 ../src/guestfs-actions.pod:509
+#: ../fish/guestfish-actions.pod:380 ../src/guestfs-actions.pod:556
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
-#: ../fish/guestfish-actions.pod:337
+#: ../fish/guestfish-actions.pod:383
msgid "aug-rm"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:339
+#: ../fish/guestfish-actions.pod:385
#, no-wrap
msgid ""
" aug-rm augpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:341 ../src/guestfs-actions.pod:522
+#: ../fish/guestfish-actions.pod:387 ../src/guestfs-actions.pod:569
msgid "Remove C<path> and all of its children."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:343 ../src/guestfs-actions.pod:524
+#: ../fish/guestfish-actions.pod:389 ../src/guestfs-actions.pod:571
msgid "On success this returns the number of entries which were removed."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:345
+#: ../fish/guestfish-actions.pod:391
msgid "aug-save"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:347
+#: ../fish/guestfish-actions.pod:393
#, no-wrap
msgid ""
" aug-save\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:349 ../src/guestfs-actions.pod:535
+#: ../fish/guestfish-actions.pod:395 ../src/guestfs-actions.pod:582
msgid "This writes all pending changes to disk."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:351
+#: ../fish/guestfish-actions.pod:397
msgid ""
"The flags which were passed to L</aug-init> affect exactly how files are "
"saved."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:354
+#: ../fish/guestfish-actions.pod:400
msgid "aug-set"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:356
+#: ../fish/guestfish-actions.pod:402
#, no-wrap
msgid ""
" aug-set augpath val\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:358 ../src/guestfs-actions.pod:551
+#: ../fish/guestfish-actions.pod:404 ../src/guestfs-actions.pod:598
msgid "Set the value associated with C<path> to C<val>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:360
+#: ../fish/guestfish-actions.pod:406
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:365
+#: ../fish/guestfish-actions.pod:411
msgid "available"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:367
+#: ../fish/guestfish-actions.pod:413
#, no-wrap
msgid ""
" available 'groups ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:369 ../src/guestfs-actions.pod:568
+#: ../fish/guestfish-actions.pod:415 ../src/guestfs-actions.pod:615
msgid ""
"This command is used to check the availability of some groups of "
"functionality in the appliance, which not all builds of the libguestfs "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:373
+#: ../fish/guestfish-actions.pod:419
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:378 ../src/guestfs-actions.pod:577
+#: ../fish/guestfish-actions.pod:424 ../src/guestfs-actions.pod:624
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 and "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:383 ../src/guestfs-actions.pod:582
+#: ../fish/guestfish-actions.pod:429 ../src/guestfs-actions.pod:629
msgid "The command returns no error if I<all> requested groups are available."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:385 ../src/guestfs-actions.pod:584
+#: ../fish/guestfish-actions.pod:431 ../src/guestfs-actions.pod:631
msgid ""
"It fails with an error if one or more of the requested groups is unavailable "
"in the appliance."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:388 ../src/guestfs-actions.pod:587
+#: ../fish/guestfish-actions.pod:434 ../src/guestfs-actions.pod:634
msgid ""
"If an unknown group name is included in the list of groups then an error is "
"always returned."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:391 ../src/guestfs-actions.pod:590
+#: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:637
msgid "I<Notes:>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:397
+#: ../fish/guestfish-actions.pod:443
msgid "You must call L</launch> before calling this function."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:399 ../src/guestfs-actions.pod:598
+#: ../fish/guestfish-actions.pod:445 ../src/guestfs-actions.pod:645
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
-#: ../fish/guestfish-actions.pod:405 ../src/guestfs-actions.pod:604
+#: ../fish/guestfish-actions.pod:451 ../src/guestfs-actions.pod:651
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:412 ../src/guestfs-actions.pod:611
+#: ../fish/guestfish-actions.pod:458 ../src/guestfs-actions.pod:658
msgid ""
"It is usually the job of distro packagers to build complete functionality "
"into the libguestfs appliance. Upstream libguestfs, if built from source "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:419
+#: ../fish/guestfish-actions.pod:465
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:426
+#: ../fish/guestfish-actions.pod:472
msgid "available-all-groups"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:428
+#: ../fish/guestfish-actions.pod:474
#, no-wrap
msgid ""
" available-all-groups\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:430
+#: ../fish/guestfish-actions.pod:476
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:436
+#: ../fish/guestfish-actions.pod:482
msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:438
+#: ../fish/guestfish-actions.pod:484
msgid "base64-in"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:440
+#: ../fish/guestfish-actions.pod:486
#, no-wrap
msgid ""
" base64-in (base64file|-) filename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:442 ../src/guestfs-actions.pod:655
+#: ../fish/guestfish-actions.pod:488 ../src/guestfs-actions.pod:702
msgid ""
"This command uploads base64-encoded data from C<base64file> to C<filename>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:445 ../fish/guestfish-actions.pod:454
-#: ../fish/guestfish-actions.pod:703 ../fish/guestfish-actions.pod:787
-#: ../fish/guestfish-actions.pod:808 ../fish/guestfish-actions.pod:979
-#: ../fish/guestfish-actions.pod:998 ../fish/guestfish-actions.pod:1372
-#: ../fish/guestfish-actions.pod:4836 ../fish/guestfish-actions.pod:4848
-#: ../fish/guestfish-actions.pod:4859 ../fish/guestfish-actions.pod:4870
-#: ../fish/guestfish-actions.pod:4922 ../fish/guestfish-actions.pod:4931
-#: ../fish/guestfish-actions.pod:4985 ../fish/guestfish-actions.pod:5008
+#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500
+#: ../fish/guestfish-actions.pod:749 ../fish/guestfish-actions.pod:833
+#: ../fish/guestfish-actions.pod:854 ../fish/guestfish-actions.pod:1025
+#: ../fish/guestfish-actions.pod:1044 ../fish/guestfish-actions.pod:1418
+#: ../fish/guestfish-actions.pod:4882 ../fish/guestfish-actions.pod:4894
+#: ../fish/guestfish-actions.pod:4905 ../fish/guestfish-actions.pod:4916
+#: ../fish/guestfish-actions.pod:4968 ../fish/guestfish-actions.pod:4977
+#: ../fish/guestfish-actions.pod:5031 ../fish/guestfish-actions.pod:5054
msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:447
+#: ../fish/guestfish-actions.pod:493
msgid "base64-out"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:449
+#: ../fish/guestfish-actions.pod:495
#, no-wrap
msgid ""
" base64-out filename (base64file|-)\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:451 ../src/guestfs-actions.pod:669
+#: ../fish/guestfish-actions.pod:497 ../src/guestfs-actions.pod:716
msgid ""
"This command downloads the contents of C<filename>, writing it out to local "
"file C<base64file> encoded as base64."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:456
+#: ../fish/guestfish-actions.pod:502
msgid "blockdev-flushbufs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:458
+#: ../fish/guestfish-actions.pod:504
#, no-wrap
msgid ""
" blockdev-flushbufs device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:460 ../src/guestfs-actions.pod:682
+#: ../fish/guestfish-actions.pod:506 ../src/guestfs-actions.pod:729
msgid ""
"This tells the kernel to flush internal buffers associated with C<device>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:474
-#: ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:493
-#: ../fish/guestfish-actions.pod:505 ../fish/guestfish-actions.pod:518
-#: ../fish/guestfish-actions.pod:526 ../fish/guestfish-actions.pod:537
-#: ../fish/guestfish-actions.pod:545 ../fish/guestfish-actions.pod:553
-#: ../src/guestfs-actions.pod:685 ../src/guestfs-actions.pod:702
-#: ../src/guestfs-actions.pod:717 ../src/guestfs-actions.pod:733
-#: ../src/guestfs-actions.pod:751 ../src/guestfs-actions.pod:770
-#: ../src/guestfs-actions.pod:784 ../src/guestfs-actions.pod:802
-#: ../src/guestfs-actions.pod:816 ../src/guestfs-actions.pod:830
+#: ../fish/guestfish-actions.pod:509 ../fish/guestfish-actions.pod:520
+#: ../fish/guestfish-actions.pod:529 ../fish/guestfish-actions.pod:539
+#: ../fish/guestfish-actions.pod:551 ../fish/guestfish-actions.pod:564
+#: ../fish/guestfish-actions.pod:572 ../fish/guestfish-actions.pod:583
+#: ../fish/guestfish-actions.pod:591 ../fish/guestfish-actions.pod:599
+#: ../src/guestfs-actions.pod:732 ../src/guestfs-actions.pod:749
+#: ../src/guestfs-actions.pod:764 ../src/guestfs-actions.pod:780
+#: ../src/guestfs-actions.pod:798 ../src/guestfs-actions.pod:817
+#: ../src/guestfs-actions.pod:831 ../src/guestfs-actions.pod:849
+#: ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:877
msgid "This uses the L<blockdev(8)> command."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:465
+#: ../fish/guestfish-actions.pod:511
msgid "blockdev-getbsz"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:467
+#: ../fish/guestfish-actions.pod:513
#, no-wrap
msgid ""
" blockdev-getbsz device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:469 ../src/guestfs-actions.pod:697
+#: ../fish/guestfish-actions.pod:515 ../src/guestfs-actions.pod:744
msgid "This returns the block size of a device."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:471 ../fish/guestfish-actions.pod:534
-#: ../src/guestfs-actions.pod:699 ../src/guestfs-actions.pod:799
+#: ../fish/guestfish-actions.pod:517 ../fish/guestfish-actions.pod:580
+#: ../src/guestfs-actions.pod:746 ../src/guestfs-actions.pod:846
msgid ""
"(Note this is different from both I<size in blocks> and I<filesystem block "
"size>)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:476
+#: ../fish/guestfish-actions.pod:522
msgid "blockdev-getro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:478
+#: ../fish/guestfish-actions.pod:524
#, no-wrap
msgid ""
" blockdev-getro device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:480 ../src/guestfs-actions.pod:714
+#: ../fish/guestfish-actions.pod:526 ../src/guestfs-actions.pod:761
msgid ""
"Returns a boolean indicating if the block device is read-only (true if read-"
"only, false if not)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:485
+#: ../fish/guestfish-actions.pod:531
msgid "blockdev-getsize64"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:487
+#: ../fish/guestfish-actions.pod:533
#, no-wrap
msgid ""
" blockdev-getsize64 device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:489 ../src/guestfs-actions.pod:729
+#: ../fish/guestfish-actions.pod:535 ../src/guestfs-actions.pod:776
msgid "This returns the size of the device in bytes."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:491
+#: ../fish/guestfish-actions.pod:537
msgid "See also L</blockdev-getsz>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:495
+#: ../fish/guestfish-actions.pod:541
msgid "blockdev-getss"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:497
+#: ../fish/guestfish-actions.pod:543
#, no-wrap
msgid ""
" blockdev-getss device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:499 ../src/guestfs-actions.pod:745
+#: ../fish/guestfish-actions.pod:545 ../src/guestfs-actions.pod:792
msgid ""
"This returns the size of sectors on a block device. Usually 512, but can be "
"larger for modern devices."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:502
+#: ../fish/guestfish-actions.pod:548
msgid ""
"(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:507
+#: ../fish/guestfish-actions.pod:553
msgid "blockdev-getsz"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:509
+#: ../fish/guestfish-actions.pod:555
#, no-wrap
msgid ""
" blockdev-getsz device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:511 ../src/guestfs-actions.pod:763
+#: ../fish/guestfish-actions.pod:557 ../src/guestfs-actions.pod:810
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
-#: ../fish/guestfish-actions.pod:514
+#: ../fish/guestfish-actions.pod:560
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:520
+#: ../fish/guestfish-actions.pod:566
msgid "blockdev-rereadpt"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:522
+#: ../fish/guestfish-actions.pod:568
#, no-wrap
msgid ""
" blockdev-rereadpt device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:524 ../src/guestfs-actions.pod:782
+#: ../fish/guestfish-actions.pod:570 ../src/guestfs-actions.pod:829
msgid "Reread the partition table on C<device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:528
+#: ../fish/guestfish-actions.pod:574
msgid "blockdev-setbsz"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:530
+#: ../fish/guestfish-actions.pod:576
#, no-wrap
msgid ""
" blockdev-setbsz device blocksize\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:532 ../src/guestfs-actions.pod:797
+#: ../fish/guestfish-actions.pod:578 ../src/guestfs-actions.pod:844
msgid "This sets the block size of a device."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:539
+#: ../fish/guestfish-actions.pod:585
msgid "blockdev-setro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:541
+#: ../fish/guestfish-actions.pod:587
#, no-wrap
msgid ""
" blockdev-setro device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:543 ../src/guestfs-actions.pod:814
+#: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:861
msgid "Sets the block device named C<device> to read-only."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:547
+#: ../fish/guestfish-actions.pod:593
msgid "blockdev-setrw"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:549
+#: ../fish/guestfish-actions.pod:595
#, no-wrap
msgid ""
" blockdev-setrw device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:551 ../src/guestfs-actions.pod:828
+#: ../fish/guestfish-actions.pod:597 ../src/guestfs-actions.pod:875
msgid "Sets the block device named C<device> to read-write."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:555
+#: ../fish/guestfish-actions.pod:601
msgid "btrfs-filesystem-resize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:557
+#: ../fish/guestfish-actions.pod:603
#, no-wrap
msgid ""
" btrfs-filesystem-resize mountpoint [size:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:559 ../src/guestfs-actions.pod:850
+#: ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:897
msgid "This command resizes a btrfs filesystem."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:561 ../src/guestfs-actions.pod:852
+#: ../fish/guestfish-actions.pod:607 ../src/guestfs-actions.pod:899
msgid ""
"Note that unlike other resize calls, the filesystem has to be mounted and "
"the parameter is the mountpoint not the device (this is a requirement of "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:565 ../fish/guestfish-actions.pod:3569
-#: ../src/guestfs-actions.pod:856 ../src/guestfs-actions.pod:5591
+#: ../fish/guestfish-actions.pod:611 ../fish/guestfish-actions.pod:3615
+#: ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:5638
msgid "The optional parameters are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:569 ../fish/guestfish-actions.pod:3573
-#: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:5595
+#: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3619
+#: ../src/guestfs-actions.pod:907 ../src/guestfs-actions.pod:5642
msgid "C<size>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:571 ../src/guestfs-actions.pod:862
+#: ../fish/guestfish-actions.pod:617 ../src/guestfs-actions.pod:909
msgid ""
"The new size (in bytes) of the filesystem. If omitted, the filesystem is "
"resized to the maximum size."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:576 ../src/guestfs-actions.pod:867
+#: ../fish/guestfish-actions.pod:622 ../src/guestfs-actions.pod:914
msgid "See also L<btrfs(8)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:580
+#: ../fish/guestfish-actions.pod:626
msgid "case-sensitive-path"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:582
+#: ../fish/guestfish-actions.pod:628
#, no-wrap
msgid ""
" case-sensitive-path path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:584 ../src/guestfs-actions.pod:901
+#: ../fish/guestfish-actions.pod:630 ../src/guestfs-actions.pod:948
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:906
+#: ../fish/guestfish-actions.pod:635 ../src/guestfs-actions.pod:953
msgid ""
"The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
"(and probably others), which is that although the underlying filesystem is "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:594 ../src/guestfs-actions.pod:911
+#: ../fish/guestfish-actions.pod:640 ../src/guestfs-actions.pod:958
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:600 ../src/guestfs-actions.pod:917
+#: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:964
msgid ""
"Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
"#posixfilenames1>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:603 ../src/guestfs-actions.pod:920
+#: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:967
msgid ""
"This function resolves the true case of each element in the path and returns "
"the case-sensitive path."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:606
+#: ../fish/guestfish-actions.pod:652
msgid ""
"Thus L</case-sensitive-path> (\"/Windows/System32\") might return C<\"/"
"WINDOWS/system32\"> (the exact return value would depend on details of how "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:611 ../src/guestfs-actions.pod:928
+#: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:975
msgid "I<Note>: This function does not handle drive names, backslashes etc."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:614
+#: ../fish/guestfish-actions.pod:660
msgid "See also L</realpath>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:616
+#: ../fish/guestfish-actions.pod:662
msgid "cat"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:618
+#: ../fish/guestfish-actions.pod:664
#, no-wrap
msgid ""
" cat path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:620 ../fish/guestfish-actions.pod:4003
-#: ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:6252
+#: ../fish/guestfish-actions.pod:666 ../fish/guestfish-actions.pod:4049
+#: ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:6299
msgid "Return the contents of the file named C<path>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:622
+#: ../fish/guestfish-actions.pod:668
msgid ""
"Note that this function cannot correctly handle binary files (specifically, "
"files containing C<\\0> character which is treated as end of string). For "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:627 ../fish/guestfish-actions.pod:762
-#: ../fish/guestfish-actions.pod:774 ../fish/guestfish-actions.pod:1057
-#: ../fish/guestfish-actions.pod:1067 ../fish/guestfish-actions.pod:1134
-#: ../fish/guestfish-actions.pod:1144 ../fish/guestfish-actions.pod:1336
-#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:1659
-#: ../fish/guestfish-actions.pod:1709 ../fish/guestfish-actions.pod:1724
-#: ../fish/guestfish-actions.pod:1734 ../fish/guestfish-actions.pod:1753
-#: ../fish/guestfish-actions.pod:3873 ../fish/guestfish-actions.pod:3888
-#: ../fish/guestfish-actions.pod:3964 ../fish/guestfish-actions.pod:3981
-#: ../fish/guestfish-actions.pod:3996 ../fish/guestfish-actions.pod:4677
-#: ../fish/guestfish-actions.pod:4723 ../fish/guestfish-actions.pod:4808
-#: ../fish/guestfish-actions.pod:4823 ../fish/guestfish-actions.pod:5229
-#: ../fish/guestfish-actions.pod:5241 ../fish/guestfish-actions.pod:5259
-#: ../fish/guestfish-actions.pod:5276 ../fish/guestfish-actions.pod:5286
-#: ../fish/guestfish-actions.pod:5343 ../fish/guestfish-actions.pod:5353
-#: ../fish/guestfish-actions.pod:5382 ../fish/guestfish-actions.pod:5392
-#: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:1133
-#: ../src/guestfs-actions.pod:1153 ../src/guestfs-actions.pod:1800
-#: ../src/guestfs-actions.pod:1819 ../src/guestfs-actions.pod:1922
-#: ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:2187
-#: ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2688
-#: ../src/guestfs-actions.pod:2753 ../src/guestfs-actions.pod:2777
-#: ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:2823
-#: ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:6060
-#: ../src/guestfs-actions.pod:6191 ../src/guestfs-actions.pod:6217
-#: ../src/guestfs-actions.pod:6241 ../src/guestfs-actions.pod:7208
-#: ../src/guestfs-actions.pod:7263 ../src/guestfs-actions.pod:7409
-#: ../src/guestfs-actions.pod:7433 ../src/guestfs-actions.pod:8098
-#: ../src/guestfs-actions.pod:8118 ../src/guestfs-actions.pod:8151
-#: ../src/guestfs-actions.pod:8170 ../src/guestfs-actions.pod:8189
-#: ../src/guestfs-actions.pod:8283 ../src/guestfs-actions.pod:8302
-#: ../src/guestfs-actions.pod:8348 ../src/guestfs-actions.pod:8367
+#: ../fish/guestfish-actions.pod:673 ../fish/guestfish-actions.pod:808
+#: ../fish/guestfish-actions.pod:820 ../fish/guestfish-actions.pod:1103
+#: ../fish/guestfish-actions.pod:1113 ../fish/guestfish-actions.pod:1180
+#: ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1382
+#: ../fish/guestfish-actions.pod:1695 ../fish/guestfish-actions.pod:1705
+#: ../fish/guestfish-actions.pod:1755 ../fish/guestfish-actions.pod:1770
+#: ../fish/guestfish-actions.pod:1780 ../fish/guestfish-actions.pod:1799
+#: ../fish/guestfish-actions.pod:3919 ../fish/guestfish-actions.pod:3934
+#: ../fish/guestfish-actions.pod:4010 ../fish/guestfish-actions.pod:4027
+#: ../fish/guestfish-actions.pod:4042 ../fish/guestfish-actions.pod:4723
+#: ../fish/guestfish-actions.pod:4769 ../fish/guestfish-actions.pod:4854
+#: ../fish/guestfish-actions.pod:4869 ../fish/guestfish-actions.pod:5275
+#: ../fish/guestfish-actions.pod:5287 ../fish/guestfish-actions.pod:5305
+#: ../fish/guestfish-actions.pod:5322 ../fish/guestfish-actions.pod:5332
+#: ../fish/guestfish-actions.pod:5389 ../fish/guestfish-actions.pod:5399
+#: ../fish/guestfish-actions.pod:5428 ../fish/guestfish-actions.pod:5438
+#: ../src/guestfs-actions.pod:1001 ../src/guestfs-actions.pod:1180
+#: ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1847
+#: ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:1969
+#: ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2234
+#: ../src/guestfs-actions.pod:2716 ../src/guestfs-actions.pod:2735
+#: ../src/guestfs-actions.pod:2800 ../src/guestfs-actions.pod:2824
+#: ../src/guestfs-actions.pod:2841 ../src/guestfs-actions.pod:2870
+#: ../src/guestfs-actions.pod:6081 ../src/guestfs-actions.pod:6107
+#: ../src/guestfs-actions.pod:6238 ../src/guestfs-actions.pod:6264
+#: ../src/guestfs-actions.pod:6288 ../src/guestfs-actions.pod:7255
+#: ../src/guestfs-actions.pod:7310 ../src/guestfs-actions.pod:7456
+#: ../src/guestfs-actions.pod:7480 ../src/guestfs-actions.pod:8145
+#: ../src/guestfs-actions.pod:8165 ../src/guestfs-actions.pod:8198
+#: ../src/guestfs-actions.pod:8217 ../src/guestfs-actions.pod:8236
+#: ../src/guestfs-actions.pod:8330 ../src/guestfs-actions.pod:8349
+#: ../src/guestfs-actions.pod:8395 ../src/guestfs-actions.pod:8414
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: =head2
-#: ../fish/guestfish-actions.pod:630
+#: ../fish/guestfish-actions.pod:676
msgid "checksum"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:632
+#: ../fish/guestfish-actions.pod:678
#, no-wrap
msgid ""
" checksum csumtype path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:634 ../src/guestfs-actions.pod:966
+#: ../fish/guestfish-actions.pod:680 ../src/guestfs-actions.pod:1013
msgid ""
"This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:637 ../src/guestfs-actions.pod:969
+#: ../fish/guestfish-actions.pod:683 ../src/guestfs-actions.pod:1016
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
-#: ../fish/guestfish-actions.pod:642 ../src/guestfs-actions.pod:974
+#: ../fish/guestfish-actions.pod:688 ../src/guestfs-actions.pod:1021
msgid "C<crc>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:644 ../src/guestfs-actions.pod:976
+#: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1023
msgid ""
"Compute the cyclic redundancy check (CRC) specified by POSIX for the "
"C<cksum> command."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:647 ../src/guestfs-actions.pod:979
+#: ../fish/guestfish-actions.pod:693 ../src/guestfs-actions.pod:1026
msgid "C<md5>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:981
+#: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1028
msgid "Compute the MD5 hash (using the C<md5sum> program)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:651 ../src/guestfs-actions.pod:983
+#: ../fish/guestfish-actions.pod:697 ../src/guestfs-actions.pod:1030
msgid "C<sha1>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:653 ../src/guestfs-actions.pod:985
+#: ../fish/guestfish-actions.pod:699 ../src/guestfs-actions.pod:1032
msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:655 ../src/guestfs-actions.pod:987
+#: ../fish/guestfish-actions.pod:701 ../src/guestfs-actions.pod:1034
msgid "C<sha224>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:989
+#: ../fish/guestfish-actions.pod:703 ../src/guestfs-actions.pod:1036
msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:659 ../src/guestfs-actions.pod:991
+#: ../fish/guestfish-actions.pod:705 ../src/guestfs-actions.pod:1038
msgid "C<sha256>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:661 ../src/guestfs-actions.pod:993
+#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1040
msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:663 ../src/guestfs-actions.pod:995
+#: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1042
msgid "C<sha384>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:665 ../src/guestfs-actions.pod:997
+#: ../fish/guestfish-actions.pod:711 ../src/guestfs-actions.pod:1044
msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:667 ../src/guestfs-actions.pod:999
+#: ../fish/guestfish-actions.pod:713 ../src/guestfs-actions.pod:1046
msgid "C<sha512>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:669 ../src/guestfs-actions.pod:1001
+#: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1048
msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:673 ../src/guestfs-actions.pod:1005
+#: ../fish/guestfish-actions.pod:719 ../src/guestfs-actions.pod:1052
msgid "The checksum is returned as a printable string."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:675
+#: ../fish/guestfish-actions.pod:721
msgid "To get the checksum for a device, use L</checksum-device>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:677
+#: ../fish/guestfish-actions.pod:723
msgid "To get the checksums for many files, use L</checksums-out>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:679
+#: ../fish/guestfish-actions.pod:725
msgid "checksum-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:681
+#: ../fish/guestfish-actions.pod:727
#, no-wrap
msgid ""
" checksum-device csumtype device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:683
+#: ../fish/guestfish-actions.pod:729
msgid ""
"This call computes the MD5, SHAx or CRC checksum of the contents of the "
"device named C<device>. For the types of checksums supported see the L</"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:687
+#: ../fish/guestfish-actions.pod:733
msgid "checksums-out"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:689
+#: ../fish/guestfish-actions.pod:735
#, no-wrap
msgid ""
" checksums-out csumtype directory (sumsfile|-)\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:691 ../src/guestfs-actions.pod:1040
+#: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1087
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
-#: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1044
+#: ../fish/guestfish-actions.pod:741 ../src/guestfs-actions.pod:1091
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:705
+#: ../fish/guestfish-actions.pod:751
msgid "chmod"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:707
+#: ../fish/guestfish-actions.pod:753
#, no-wrap
msgid ""
" chmod mode path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1063
+#: ../fish/guestfish-actions.pod:755 ../src/guestfs-actions.pod:1110
msgid ""
"Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are "
"supported."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:712 ../src/guestfs-actions.pod:1066
+#: ../fish/guestfish-actions.pod:758 ../src/guestfs-actions.pod:1113
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:716 ../fish/guestfish-actions.pod:3222
-#: ../fish/guestfish-actions.pod:3361 ../fish/guestfish-actions.pod:3371
-#: ../fish/guestfish-actions.pod:3381 ../src/guestfs-actions.pod:1070
-#: ../src/guestfs-actions.pod:4998 ../src/guestfs-actions.pod:5207
-#: ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5245
+#: ../fish/guestfish-actions.pod:762 ../fish/guestfish-actions.pod:3268
+#: ../fish/guestfish-actions.pod:3407 ../fish/guestfish-actions.pod:3417
+#: ../fish/guestfish-actions.pod:3427 ../src/guestfs-actions.pod:1117
+#: ../src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5254
+#: ../src/guestfs-actions.pod:5273 ../src/guestfs-actions.pod:5292
msgid "The mode actually set is affected by the umask."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:718
+#: ../fish/guestfish-actions.pod:764
msgid "chown"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:720
+#: ../fish/guestfish-actions.pod:766
#, no-wrap
msgid ""
" chown owner group path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:722 ../src/guestfs-actions.pod:1084
+#: ../fish/guestfish-actions.pod:768 ../src/guestfs-actions.pod:1131
msgid "Change the file owner to C<owner> and group to C<group>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:724 ../fish/guestfish-actions.pod:2657
-#: ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:4069
+#: ../fish/guestfish-actions.pod:770 ../fish/guestfish-actions.pod:2703
+#: ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:4116
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:728
+#: ../fish/guestfish-actions.pod:774
msgid "command"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:730
+#: ../fish/guestfish-actions.pod:776
#, no-wrap
msgid ""
" command 'arguments ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:732 ../src/guestfs-actions.pod:1100
+#: ../fish/guestfish-actions.pod:778 ../src/guestfs-actions.pod:1147
msgid ""
"This call runs a command from the guest filesystem. The filesystem must be "
"mounted, and must contain a compatible operating system (ie. something "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:737
+#: ../fish/guestfish-actions.pod:783
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:744 ../src/guestfs-actions.pod:1112
+#: ../fish/guestfish-actions.pod:790 ../src/guestfs-actions.pod:1159
msgid "The return value is anything printed to I<stdout> by the command."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:747 ../src/guestfs-actions.pod:1115
+#: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1162
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:751 ../src/guestfs-actions.pod:1119
+#: ../fish/guestfish-actions.pod:797 ../src/guestfs-actions.pod:1166
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:756 ../src/guestfs-actions.pod:1124
+#: ../fish/guestfish-actions.pod:802 ../src/guestfs-actions.pod:1171
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:765
+#: ../fish/guestfish-actions.pod:811
msgid "command-lines"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:767
+#: ../fish/guestfish-actions.pod:813
#, no-wrap
msgid ""
" command-lines 'arguments ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:769
+#: ../fish/guestfish-actions.pod:815
msgid ""
"This is the same as L</command>, but splits the result into a list of lines."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:772
+#: ../fish/guestfish-actions.pod:818
msgid "See also: L</sh-lines>"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:777
+#: ../fish/guestfish-actions.pod:823
msgid "compress-device-out"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:779
+#: ../fish/guestfish-actions.pod:825
#, no-wrap
msgid ""
" compress-device-out ctype device (zdevice|-) [level:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:781 ../src/guestfs-actions.pod:1174
+#: ../fish/guestfish-actions.pod:827 ../src/guestfs-actions.pod:1221
msgid ""
"This command compresses C<device> and writes it out to the local file "
"C<zdevice>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:784
+#: ../fish/guestfish-actions.pod:830
msgid ""
"The C<ctype> and optional C<level> parameters have the same meaning as in L</"
"compress-out>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:791
+#: ../fish/guestfish-actions.pod:837
msgid "compress-out"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:793
+#: ../fish/guestfish-actions.pod:839
#, no-wrap
msgid ""
" compress-out ctype file (zfile|-) [level:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:795 ../src/guestfs-actions.pod:1226
+#: ../fish/guestfish-actions.pod:841 ../src/guestfs-actions.pod:1273
msgid ""
"This command compresses C<file> and writes it out to the local file C<zfile>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:798 ../src/guestfs-actions.pod:1229
+#: ../fish/guestfish-actions.pod:844 ../src/guestfs-actions.pod:1276
msgid ""
"The compression program used is controlled by the C<ctype> parameter. "
"Currently this includes: C<compress>, C<gzip>, C<bzip2>, C<xz> or C<lzop>. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:804 ../src/guestfs-actions.pod:1235
+#: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1282
msgid ""
"The optional C<level> parameter controls compression level. The meaning and "
"default for this parameter depends on the compression program being used."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:812
+#: ../fish/guestfish-actions.pod:858
msgid "config"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:814
+#: ../fish/guestfish-actions.pod:860
#, no-wrap
msgid ""
" config qemuparam qemuvalue\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:816 ../src/guestfs-actions.pod:1276
+#: ../fish/guestfish-actions.pod:862 ../src/guestfs-actions.pod:1323
msgid ""
"This can be used to add arbitrary qemu command line parameters of the form "
"I<-param value>. Actually it's not quite arbitrary - we prevent you from "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:821 ../src/guestfs-actions.pod:1281
+#: ../fish/guestfish-actions.pod:867 ../src/guestfs-actions.pod:1328
msgid "The first character of C<param> string must be a C<-> (dash)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:823 ../src/guestfs-actions.pod:1283
+#: ../fish/guestfish-actions.pod:869 ../src/guestfs-actions.pod:1330
msgid "C<value> can be NULL."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:825
+#: ../fish/guestfish-actions.pod:871
msgid "copy-device-to-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:827
+#: ../fish/guestfish-actions.pod:873
#, no-wrap
msgid ""
" copy-device-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:829
+#: ../fish/guestfish-actions.pod:875
msgid ""
"The four calls L</copy-device-to-device>, L</copy-device-to-file>, L</copy-"
"file-to-device>, and L</copy-file-to-file> let you copy from a source "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:836 ../src/guestfs-actions.pod:1313
+#: ../fish/guestfish-actions.pod:882 ../src/guestfs-actions.pod:1360
msgid ""
"Partial copies can be made since you can specify optionally the source "
"offset, destination offset and size to copy. These values are all specified "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:842 ../src/guestfs-actions.pod:1319
+#: ../fish/guestfish-actions.pod:888 ../src/guestfs-actions.pod:1366
msgid ""
"The source and destination may be the same object. However overlapping "
"regions may not be copied correctly."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:845 ../src/guestfs-actions.pod:1322
+#: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1369
msgid ""
"If the destination is a file, it is created if required. If the destination "
"file is not large enough, it is extended."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:850
+#: ../fish/guestfish-actions.pod:896
msgid "copy-device-to-file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:852
+#: ../fish/guestfish-actions.pod:898
#, no-wrap
msgid ""
" copy-device-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:854 ../fish/guestfish-actions.pod:863
-#: ../fish/guestfish-actions.pod:872
+#: ../fish/guestfish-actions.pod:900 ../fish/guestfish-actions.pod:909
+#: ../fish/guestfish-actions.pod:918
msgid "See L</copy-device-to-device> for a general overview of this call."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:859
+#: ../fish/guestfish-actions.pod:905
msgid "copy-file-to-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:861
+#: ../fish/guestfish-actions.pod:907
#, no-wrap
msgid ""
" copy-file-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:868
+#: ../fish/guestfish-actions.pod:914
msgid "copy-file-to-file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:870
+#: ../fish/guestfish-actions.pod:916
#, no-wrap
msgid ""
" copy-file-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:875
+#: ../fish/guestfish-actions.pod:921
msgid ""
"This is B<not> the function you want for copying files. This is for copying "
"blocks within existing files. See L</cp>, L</cp-a> and L</mv> for general "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:882
+#: ../fish/guestfish-actions.pod:928
msgid "copy-size"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:884
+#: ../fish/guestfish-actions.pod:930
#, no-wrap
msgid ""
" copy-size src dest size\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:886 ../src/guestfs-actions.pod:1529
+#: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1576
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
-#: ../fish/guestfish-actions.pod:889 ../src/guestfs-actions.pod:1532
+#: ../fish/guestfish-actions.pod:935 ../src/guestfs-actions.pod:1579
msgid ""
"Note this will fail if the source is too short or if the destination is not "
"large enough."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:892 ../fish/guestfish-actions.pod:927
+#: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:973
msgid ""
"I<This function is deprecated.> In new code, use the L</"
"copy_device_to_device> call instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:899
+#: ../fish/guestfish-actions.pod:945
msgid "cp"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:901
+#: ../fish/guestfish-actions.pod:947
#, no-wrap
msgid ""
" cp src dest\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:903 ../src/guestfs-actions.pod:1551
+#: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1598
msgid ""
"This copies a file from C<src> to C<dest> where C<dest> is either a "
"destination filename or destination directory."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:906
+#: ../fish/guestfish-actions.pod:952
msgid "cp-a"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:908
+#: ../fish/guestfish-actions.pod:954
#, no-wrap
msgid ""
" cp-a src dest\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:910 ../src/guestfs-actions.pod:1565
+#: ../fish/guestfish-actions.pod:956 ../src/guestfs-actions.pod:1612
msgid ""
"This copies a file or directory from C<src> to C<dest> recursively using the "
"C<cp -a> command."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:913
+#: ../fish/guestfish-actions.pod:959
msgid "dd"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:915
+#: ../fish/guestfish-actions.pod:961
#, no-wrap
msgid ""
" dd src dest\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:917 ../src/guestfs-actions.pod:1586
+#: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1633
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:922
+#: ../fish/guestfish-actions.pod:968
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:934
+#: ../fish/guestfish-actions.pod:980
msgid "df"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:936
+#: ../fish/guestfish-actions.pod:982
#, no-wrap
msgid ""
" df\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:938 ../src/guestfs-actions.pod:1605
+#: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1652
msgid "This command runs the C<df> command to report disk space used."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:940 ../fish/guestfish-actions.pod:951
+#: ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:997
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:944
+#: ../fish/guestfish-actions.pod:990
msgid "df-h"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:946
+#: ../fish/guestfish-actions.pod:992
#, no-wrap
msgid ""
" df-h\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:948 ../src/guestfs-actions.pod:1621
+#: ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1668
msgid ""
"This command runs the C<df -h> command to report disk space used in human-"
"readable format."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:955
+#: ../fish/guestfish-actions.pod:1001
msgid "dmesg"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:957
+#: ../fish/guestfish-actions.pod:1003
#, no-wrap
msgid ""
" dmesg\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:959 ../src/guestfs-actions.pod:1638
+#: ../fish/guestfish-actions.pod:1005 ../src/guestfs-actions.pod:1685
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
-#: ../fish/guestfish-actions.pod:963
+#: ../fish/guestfish-actions.pod:1009
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> "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:968
+#: ../fish/guestfish-actions.pod:1014
msgid "download"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:970
+#: ../fish/guestfish-actions.pod:1016
#, no-wrap
msgid ""
" download remotefilename (filename|-)\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:972 ../fish/guestfish-actions.pod:985
-#: ../src/guestfs-actions.pod:1659 ../src/guestfs-actions.pod:1684
+#: ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1031
+#: ../src/guestfs-actions.pod:1706 ../src/guestfs-actions.pod:1731
msgid ""
"Download file C<remotefilename> and save it as C<filename> on the local "
"machine."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:975 ../fish/guestfish-actions.pod:4981
-#: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:7668
+#: ../fish/guestfish-actions.pod:1021 ../fish/guestfish-actions.pod:5027
+#: ../src/guestfs-actions.pod:1709 ../src/guestfs-actions.pod:7715
msgid "C<filename> can also be a named pipe."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:977
+#: ../fish/guestfish-actions.pod:1023
msgid "See also L</upload>, L</cat>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:981
+#: ../fish/guestfish-actions.pod:1027
msgid "download-offset"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:983
+#: ../fish/guestfish-actions.pod:1029
#, no-wrap
msgid ""
" download-offset remotefilename (filename|-) offset size\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:988 ../src/guestfs-actions.pod:1687
+#: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1734
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
-#: ../fish/guestfish-actions.pod:991
+#: ../fish/guestfish-actions.pod:1037
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:996
+#: ../fish/guestfish-actions.pod:1042
msgid "See also L</download>, L</pread>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1000
+#: ../fish/guestfish-actions.pod:1046
msgid "drop-caches"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1002
+#: ../fish/guestfish-actions.pod:1048
#, no-wrap
msgid ""
" drop-caches whattodrop\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1004 ../src/guestfs-actions.pod:1712
+#: ../fish/guestfish-actions.pod:1050 ../src/guestfs-actions.pod:1759
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1009 ../src/guestfs-actions.pod:1717
+#: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1764
msgid "Setting C<whattodrop> to 3 should drop everything."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1719
+#: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1766
msgid ""
"This automatically calls L<sync(2)> before the operation, so that the "
"maximum guest memory is freed."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1014
+#: ../fish/guestfish-actions.pod:1060
msgid "du"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1016
+#: ../fish/guestfish-actions.pod:1062
#, no-wrap
msgid ""
" du path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1018 ../src/guestfs-actions.pod:1732
+#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1779
msgid ""
"This command runs the C<du -s> command to estimate file space usage for "
"C<path>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1021 ../src/guestfs-actions.pod:1735
+#: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1782
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1025 ../src/guestfs-actions.pod:1739
+#: ../fish/guestfish-actions.pod:1071 ../src/guestfs-actions.pod:1786
msgid ""
"The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1028
+#: ../fish/guestfish-actions.pod:1074
msgid "e2fsck-f"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1030
+#: ../fish/guestfish-actions.pod:1076
#, no-wrap
msgid ""
" e2fsck-f device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1032 ../src/guestfs-actions.pod:1757
+#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1804
msgid ""
"This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
"on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1036
+#: ../fish/guestfish-actions.pod:1082
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:1039
+#: ../fish/guestfish-actions.pod:1085
msgid "echo-daemon"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1041
+#: ../fish/guestfish-actions.pod:1087
#, no-wrap
msgid ""
" echo-daemon 'words ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1043 ../src/guestfs-actions.pod:1774
+#: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1821
msgid ""
"This command concatenates the list of C<words> passed with single spaces "
"between them and returns the resulting string."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1046 ../src/guestfs-actions.pod:1777
+#: ../fish/guestfish-actions.pod:1092 ../src/guestfs-actions.pod:1824
msgid "You can use this command to test the connection through to the daemon."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1048
+#: ../fish/guestfish-actions.pod:1094
msgid "See also L</ping-daemon>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1050
+#: ../fish/guestfish-actions.pod:1096
msgid "egrep"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1052
+#: ../fish/guestfish-actions.pod:1098
#, no-wrap
msgid ""
" egrep regex path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1054 ../src/guestfs-actions.pod:1793
+#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1840
msgid ""
"This calls the external C<egrep> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1060
+#: ../fish/guestfish-actions.pod:1106
msgid "egrepi"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1062
+#: ../fish/guestfish-actions.pod:1108
#, no-wrap
msgid ""
" egrepi regex path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1812
+#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1859
msgid ""
"This calls the external C<egrep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1070
+#: ../fish/guestfish-actions.pod:1116
msgid "equal"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1072
+#: ../fish/guestfish-actions.pod:1118
#, no-wrap
msgid ""
" equal file1 file2\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1831
+#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1878
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
-#: ../fish/guestfish-actions.pod:1077 ../src/guestfs-actions.pod:1834
+#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1881
msgid "The external L<cmp(1)> program is used for the comparison."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1079
+#: ../fish/guestfish-actions.pod:1125
msgid "exists"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1081
+#: ../fish/guestfish-actions.pod:1127
#, no-wrap
msgid ""
" exists path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1083 ../src/guestfs-actions.pod:1846
+#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1893
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
-#: ../fish/guestfish-actions.pod:1086
+#: ../fish/guestfish-actions.pod:1132
msgid "See also L</is-file>, L</is-dir>, L</stat>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1088
+#: ../fish/guestfish-actions.pod:1134
msgid "fallocate"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1090
+#: ../fish/guestfish-actions.pod:1136
#, no-wrap
msgid ""
" fallocate path len\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1111
-#: ../src/guestfs-actions.pod:1869 ../src/guestfs-actions.pod:1888
+#: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157
+#: ../src/guestfs-actions.pod:1916 ../src/guestfs-actions.pod:1935
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
-#: ../fish/guestfish-actions.pod:1096 ../src/guestfs-actions.pod:1873
+#: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1920
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
-#: ../fish/guestfish-actions.pod:1100
+#: ../fish/guestfish-actions.pod:1146
msgid ""
"I<This function is deprecated.> In new code, use the L</fallocate64> call "
"instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1107
+#: ../fish/guestfish-actions.pod:1153
msgid "fallocate64"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1109
+#: ../fish/guestfish-actions.pod:1155
#, no-wrap
msgid ""
" fallocate64 path len\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1115
+#: ../fish/guestfish-actions.pod:1161
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:1118
+#: ../fish/guestfish-actions.pod:1164
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1900
+#: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1947
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: =head2
-#: ../fish/guestfish-actions.pod:1127
+#: ../fish/guestfish-actions.pod:1173
msgid "fgrep"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1129
+#: ../fish/guestfish-actions.pod:1175
#, no-wrap
msgid ""
" fgrep pattern path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1131 ../src/guestfs-actions.pod:1915
+#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1962
msgid ""
"This calls the external C<fgrep> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1137
+#: ../fish/guestfish-actions.pod:1183
msgid "fgrepi"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1139
+#: ../fish/guestfish-actions.pod:1185
#, no-wrap
msgid ""
" fgrepi pattern path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1141 ../src/guestfs-actions.pod:1934
+#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1981
msgid ""
"This calls the external C<fgrep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1147
+#: ../fish/guestfish-actions.pod:1193
msgid "file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1149
+#: ../fish/guestfish-actions.pod:1195
#, no-wrap
msgid ""
" file path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1151 ../src/guestfs-actions.pod:1952
+#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:1999
msgid ""
"This call uses the standard L<file(1)> command to determine the type or "
"contents of the file."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1154 ../src/guestfs-actions.pod:1955
+#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2002
msgid ""
"This call will also transparently look inside various types of compressed "
"file."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1157 ../src/guestfs-actions.pod:1958
+#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2005
msgid ""
"The exact command which runs is C<file -zb path>. Note in particular that "
"the filename is not prepended to the output (the I<-b> option)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1161 ../src/guestfs-actions.pod:1962
+#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2009
msgid ""
"The output depends on the output of the underlying L<file(1)> command and it "
"can change in future in ways beyond our control. In other words, the output "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1165
+#: ../fish/guestfish-actions.pod:1211
msgid ""
"See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
"(etc), L</is-zero>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1168
+#: ../fish/guestfish-actions.pod:1214
msgid "file-architecture"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1170
+#: ../fish/guestfish-actions.pod:1216
#, no-wrap
msgid ""
" file-architecture filename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1172 ../src/guestfs-actions.pod:1980
+#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2027
msgid ""
"This detects the architecture of the binary C<filename>, and returns it if "
"known."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:1983
+#: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2030
msgid "Currently defined architectures are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1179 ../src/guestfs-actions.pod:1987
+#: ../fish/guestfish-actions.pod:1225 ../src/guestfs-actions.pod:2034
msgid "\"i386\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1181 ../src/guestfs-actions.pod:1989
+#: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2036
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
-#: ../fish/guestfish-actions.pod:1184 ../src/guestfs-actions.pod:1992
+#: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2039
msgid "\"x86_64\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1186 ../src/guestfs-actions.pod:1994
+#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2041
msgid "64 bit x86-64."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1188 ../src/guestfs-actions.pod:1996
+#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2043
msgid "\"sparc\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1190 ../src/guestfs-actions.pod:1998
+#: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2045
msgid "32 bit SPARC."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1192 ../src/guestfs-actions.pod:2000
+#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2047
msgid "\"sparc64\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1194 ../src/guestfs-actions.pod:2002
+#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2049
msgid "64 bit SPARC V9 and above."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1196 ../src/guestfs-actions.pod:2004
+#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2051
msgid "\"ia64\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1198 ../src/guestfs-actions.pod:2006
+#: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2053
msgid "Intel Itanium."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2008
+#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2055
msgid "\"ppc\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1202 ../src/guestfs-actions.pod:2010
+#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2057
msgid "32 bit Power PC."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1204 ../src/guestfs-actions.pod:2012
+#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2059
msgid "\"ppc64\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1206 ../src/guestfs-actions.pod:2014
+#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2061
msgid "64 bit Power PC."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1210 ../src/guestfs-actions.pod:2018
+#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2065
msgid "Libguestfs may return other architecture strings in future."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1212 ../src/guestfs-actions.pod:2020
+#: ../fish/guestfish-actions.pod:1258 ../src/guestfs-actions.pod:2067
msgid "The function works on at least the following types of files:"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2026
+#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2073
msgid "many types of Un*x and Linux binary"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1222 ../src/guestfs-actions.pod:2030
+#: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2077
msgid "many types of Un*x and Linux shared library"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1226 ../src/guestfs-actions.pod:2034
+#: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2081
msgid "Windows Win32 and Win64 binaries"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2038
+#: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2085
msgid "Windows Win32 and Win64 DLLs"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2040
+#: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2087
msgid "Win32 binaries and DLLs return C<i386>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2042
+#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2089
msgid "Win64 binaries and DLLs return C<x86_64>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2046
+#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2093
msgid "Linux kernel modules"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2050
+#: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2097
msgid "Linux new-style initrd images"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2054
+#: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2101
msgid "some non-x86 Linux vmlinuz kernels"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2058
+#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2105
msgid "What it can't do currently:"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2064
+#: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2111
msgid "static libraries (libfoo.a)"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1260 ../src/guestfs-actions.pod:2068
+#: ../fish/guestfish-actions.pod:1306 ../src/guestfs-actions.pod:2115
msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2072
+#: ../fish/guestfish-actions.pod:1310 ../src/guestfs-actions.pod:2119
msgid "x86 Linux vmlinuz kernels"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1266 ../src/guestfs-actions.pod:2074
+#: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2121
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1273
+#: ../fish/guestfish-actions.pod:1319
msgid "filesize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1275
+#: ../fish/guestfish-actions.pod:1321
#, no-wrap
msgid ""
" filesize file\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:2092
+#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2139
msgid "This command returns the size of C<file> in bytes."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1279
+#: ../fish/guestfish-actions.pod:1325
msgid ""
"To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
"file> etc. To get the size of block devices, use L</blockdev-getsize64>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1283
+#: ../fish/guestfish-actions.pod:1329
msgid "fill"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1285
+#: ../fish/guestfish-actions.pod:1331
#, no-wrap
msgid ""
" fill c len path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1287 ../src/guestfs-actions.pod:2110
+#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2157
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 C<"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1291
+#: ../fish/guestfish-actions.pod:1337
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1296
+#: ../fish/guestfish-actions.pod:1342
msgid "fill-pattern"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1298
+#: ../fish/guestfish-actions.pod:1344
#, no-wrap
msgid ""
" fill-pattern pattern len path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1300
+#: ../fish/guestfish-actions.pod:1346
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1305
+#: ../fish/guestfish-actions.pod:1351
msgid "find"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1307
+#: ../fish/guestfish-actions.pod:1353
#, no-wrap
msgid ""
" find directory\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1309 ../src/guestfs-actions.pod:2156
+#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2203
msgid ""
"This command lists out all files and directories, recursively, starting at "
"C<directory>. It is essentially equivalent to running the shell command "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1314 ../src/guestfs-actions.pod:2161
+#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2208
msgid ""
"This returns a list of strings I<without any prefix>. Thus if the directory "
"structure was:"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1317 ../src/guestfs-actions.pod:2164
+#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2211
#, no-wrap
msgid ""
" /tmp/a\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1321
+#: ../fish/guestfish-actions.pod:1367
msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1324 ../src/guestfs-actions.pod:2171
+#: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2218
#, no-wrap
msgid ""
" a\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1329 ../src/guestfs-actions.pod:2176
+#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2223
msgid "If C<directory> is not a directory, then this command returns an error."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1332 ../src/guestfs-actions.pod:2179
+#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2226
msgid "The returned list is sorted."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1334
+#: ../fish/guestfish-actions.pod:1380
msgid "See also L</find0>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1339
+#: ../fish/guestfish-actions.pod:1385
msgid "find0"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1341
+#: ../fish/guestfish-actions.pod:1387
#, no-wrap
msgid ""
" find0 directory (files|-)\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1343 ../src/guestfs-actions.pod:2199
+#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2246
msgid ""
"This command lists out all files and directories, recursively, starting at "
"C<directory>, placing the resulting list in the external file called "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1347
+#: ../fish/guestfish-actions.pod:1393
msgid ""
"This command works the same way as L</find> with the following exceptions:"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1354 ../src/guestfs-actions.pod:2210
+#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2257
msgid "The resulting list is written to an external file."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1358 ../src/guestfs-actions.pod:2214
+#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2261
msgid ""
"Items (filenames) in the result are separated by C<\\0> characters. See "
"L<find(1)> option I<-print0>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219
+#: ../fish/guestfish-actions.pod:1409 ../src/guestfs-actions.pod:2266
msgid "This command is not limited in the number of names that it can return."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1368 ../src/guestfs-actions.pod:2224
+#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2271
msgid "The result list is not sorted."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1374
+#: ../fish/guestfish-actions.pod:1420
msgid "findfs-label"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1376
+#: ../fish/guestfish-actions.pod:1422
#, no-wrap
msgid ""
" findfs-label label\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2238
+#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2285
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
-#: ../fish/guestfish-actions.pod:1382
+#: ../fish/guestfish-actions.pod:1428
msgid "To find the label of a filesystem, use L</vfs-label>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1384
+#: ../fish/guestfish-actions.pod:1430
msgid "findfs-uuid"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1386
+#: ../fish/guestfish-actions.pod:1432
#, no-wrap
msgid ""
" findfs-uuid uuid\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1388 ../src/guestfs-actions.pod:2255
+#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2302
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
-#: ../fish/guestfish-actions.pod:1392
+#: ../fish/guestfish-actions.pod:1438
msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1394
+#: ../fish/guestfish-actions.pod:1440
msgid "fsck"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1396
+#: ../fish/guestfish-actions.pod:1442
#, no-wrap
msgid ""
" fsck fstype device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1398 ../src/guestfs-actions.pod:2273
+#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2320
msgid ""
"This runs the filesystem checker (fsck) on C<device> which should have "
"filesystem type C<fstype>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1401 ../src/guestfs-actions.pod:2276
+#: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2323
msgid ""
"The returned integer is the status. See L<fsck(8)> for the list of status "
"codes from C<fsck>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2285
+#: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2332
msgid "Multiple status codes can be summed together."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2289
+#: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2336
msgid ""
"A non-zero return code can mean \"success\", for example if errors have been "
"corrected on the filesystem."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2294
+#: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2341
msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2299
+#: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2346
msgid ""
"This command is entirely equivalent to running C<fsck -a -t fstype device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1426
+#: ../fish/guestfish-actions.pod:1472
msgid "get-append"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1428
+#: ../fish/guestfish-actions.pod:1474
#, no-wrap
msgid ""
" get-append\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1430 ../src/guestfs-actions.pod:2310
+#: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2357
msgid ""
"Return the additional kernel options which are added to the guest kernel "
"command line."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1433 ../src/guestfs-actions.pod:2313
+#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2360
msgid "If C<NULL> then no options are added."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1435
+#: ../fish/guestfish-actions.pod:1481
msgid "get-attach-method"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1437
+#: ../fish/guestfish-actions.pod:1483
#, no-wrap
msgid ""
" get-attach-method\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1439
+#: ../fish/guestfish-actions.pod:1485
msgid "Return the current attach method. See L</set-attach-method>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1441
+#: ../fish/guestfish-actions.pod:1487
msgid "get-autosync"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1443
+#: ../fish/guestfish-actions.pod:1489
#, no-wrap
msgid ""
" get-autosync\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1445 ../src/guestfs-actions.pod:2338
+#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2385
msgid "Get the autosync flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1447
+#: ../fish/guestfish-actions.pod:1493
msgid "get-direct"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1449
+#: ../fish/guestfish-actions.pod:1495
#, no-wrap
msgid ""
" get-direct\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1451 ../src/guestfs-actions.pod:2349
+#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2396
msgid "Return the direct appliance mode flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1453
+#: ../fish/guestfish-actions.pod:1499
msgid "get-e2label"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1455
+#: ../fish/guestfish-actions.pod:1501
#, no-wrap
msgid ""
" get-e2label device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1457 ../src/guestfs-actions.pod:2368
+#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2415
msgid ""
"This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1460
+#: ../fish/guestfish-actions.pod:1506
msgid ""
"I<This function is deprecated.> In new code, use the L</vfs_label> call "
"instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1467
+#: ../fish/guestfish-actions.pod:1513
msgid "get-e2uuid"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1469
+#: ../fish/guestfish-actions.pod:1515
#, no-wrap
msgid ""
" get-e2uuid device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1471 ../src/guestfs-actions.pod:2389
+#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2436
msgid ""
"This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1474
+#: ../fish/guestfish-actions.pod:1520
msgid ""
"I<This function is deprecated.> In new code, use the L</vfs_uuid> call "
"instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1481
+#: ../fish/guestfish-actions.pod:1527
msgid "get-memsize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1483
+#: ../fish/guestfish-actions.pod:1529
#, no-wrap
msgid ""
" get-memsize\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1485 ../src/guestfs-actions.pod:2402
+#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2449
msgid ""
"This gets the memory size in megabytes allocated to the qemu subprocess."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1488
+#: ../fish/guestfish-actions.pod:1534
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1549
-#: ../fish/guestfish-actions.pod:4329 ../fish/guestfish-actions.pod:4431
-#: ../src/guestfs-actions.pod:2409 ../src/guestfs-actions.pod:2501
-#: ../src/guestfs-actions.pod:6713 ../src/guestfs-actions.pod:6839
+#: ../fish/guestfish-actions.pod:1538 ../fish/guestfish-actions.pod:1595
+#: ../fish/guestfish-actions.pod:4375 ../fish/guestfish-actions.pod:4477
+#: ../src/guestfs-actions.pod:2456 ../src/guestfs-actions.pod:2548
+#: ../src/guestfs-actions.pod:6760 ../src/guestfs-actions.pod:6886
msgid ""
"For more information on the architecture of libguestfs, see L<guestfs(3)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1495
+#: ../fish/guestfish-actions.pod:1541
msgid "get-network"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1497
+#: ../fish/guestfish-actions.pod:1543
#, no-wrap
msgid ""
" get-network\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1499 ../src/guestfs-actions.pod:2421
+#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2468
msgid "This returns the enable network flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1501
+#: ../fish/guestfish-actions.pod:1547
msgid "get-path"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1503
+#: ../fish/guestfish-actions.pod:1549
#, no-wrap
msgid ""
" get-path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1505 ../src/guestfs-actions.pod:2432
+#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2479
msgid "Return the current search path."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1507 ../src/guestfs-actions.pod:2434
+#: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2481
msgid ""
"This is always non-NULL. If it wasn't set already, then this will return "
"the default path."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1510
+#: ../fish/guestfish-actions.pod:1556
msgid "get-pgroup"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1512
+#: ../fish/guestfish-actions.pod:1558
#, no-wrap
msgid ""
" get-pgroup\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1514 ../src/guestfs-actions.pod:2447
+#: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2494
msgid "This returns the process group flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1516
+#: ../fish/guestfish-actions.pod:1562
msgid "get-pid"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1518
+#: ../fish/guestfish-actions.pod:1564
msgid "pid"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1520
+#: ../fish/guestfish-actions.pod:1566
#, no-wrap
msgid ""
" get-pid\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1522 ../src/guestfs-actions.pod:2458
+#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2505
msgid ""
"Return the process ID of the qemu subprocess. If there is no qemu "
"subprocess, then this will return an error."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1525 ../src/guestfs-actions.pod:2461
+#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2508
msgid "This is an internal call used for debugging and testing."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1527
+#: ../fish/guestfish-actions.pod:1573
msgid "get-qemu"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1529
+#: ../fish/guestfish-actions.pod:1575
#, no-wrap
msgid ""
" get-qemu\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2472
+#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2519
msgid "Return the current qemu binary."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1533 ../src/guestfs-actions.pod:2474
+#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2521
msgid ""
"This is always non-NULL. If it wasn't set already, then this will return "
"the default qemu binary name."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1536
+#: ../fish/guestfish-actions.pod:1582
msgid "get-recovery-proc"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1538
+#: ../fish/guestfish-actions.pod:1584
#, no-wrap
msgid ""
" get-recovery-proc\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1540 ../src/guestfs-actions.pod:2487
+#: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2534
msgid "Return the recovery process enabled flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1542
+#: ../fish/guestfish-actions.pod:1588
msgid "get-selinux"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1544
+#: ../fish/guestfish-actions.pod:1590
#, no-wrap
msgid ""
" get-selinux\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1546
+#: ../fish/guestfish-actions.pod:1592
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:1552
+#: ../fish/guestfish-actions.pod:1598
msgid "get-smp"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1554
+#: ../fish/guestfish-actions.pod:1600
#, no-wrap
msgid ""
" get-smp\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1556 ../src/guestfs-actions.pod:2513
+#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2560
msgid "This returns the number of virtual CPUs assigned to the appliance."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1558
+#: ../fish/guestfish-actions.pod:1604
msgid "get-state"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1560
+#: ../fish/guestfish-actions.pod:1606
#, no-wrap
msgid ""
" get-state\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1562 ../src/guestfs-actions.pod:2524
+#: ../fish/guestfish-actions.pod:1608 ../src/guestfs-actions.pod:2571
msgid ""
"This returns the current state as an opaque integer. This is only useful "
"for printing debug and internal error messages."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1565 ../fish/guestfish-actions.pod:2524
-#: ../fish/guestfish-actions.pod:2542 ../fish/guestfish-actions.pod:2580
-#: ../fish/guestfish-actions.pod:2596 ../src/guestfs-actions.pod:2527
-#: ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3875
-#: ../src/guestfs-actions.pod:3936 ../src/guestfs-actions.pod:3963
+#: ../fish/guestfish-actions.pod:1611 ../fish/guestfish-actions.pod:2570
+#: ../fish/guestfish-actions.pod:2588 ../fish/guestfish-actions.pod:2626
+#: ../fish/guestfish-actions.pod:2642 ../src/guestfs-actions.pod:2574
+#: ../src/guestfs-actions.pod:3893 ../src/guestfs-actions.pod:3922
+#: ../src/guestfs-actions.pod:3983 ../src/guestfs-actions.pod:4010
msgid "For more information on states, see L<guestfs(3)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1567
+#: ../fish/guestfish-actions.pod:1613
msgid "get-trace"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1569
+#: ../fish/guestfish-actions.pod:1615
#, no-wrap
msgid ""
" get-trace\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2538
+#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2585
msgid "Return the command trace flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1573
+#: ../fish/guestfish-actions.pod:1619
msgid "get-umask"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1575
+#: ../fish/guestfish-actions.pod:1621
#, no-wrap
msgid ""
" get-umask\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1577
+#: ../fish/guestfish-actions.pod:1623
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:1580
+#: ../fish/guestfish-actions.pod:1626
msgid "get-verbose"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1582
+#: ../fish/guestfish-actions.pod:1628
#, no-wrap
msgid ""
" get-verbose\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1584 ../src/guestfs-actions.pod:2561
+#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2608
msgid "This returns the verbose messages flag."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1586
+#: ../fish/guestfish-actions.pod:1632
msgid "getcon"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1588
+#: ../fish/guestfish-actions.pod:1634
#, no-wrap
msgid ""
" getcon\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1590 ../src/guestfs-actions.pod:2572
+#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2619
msgid "This gets the SELinux security context of the daemon."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1592
+#: ../fish/guestfish-actions.pod:1638
msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1595
+#: ../fish/guestfish-actions.pod:1641
msgid "getxattr"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1597
+#: ../fish/guestfish-actions.pod:1643
#, no-wrap
msgid ""
" getxattr path name\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1599
+#: ../fish/guestfish-actions.pod:1645
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:2669
+#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1610 ../fish/guestfish-actions.pod:2676
-#: ../src/guestfs-actions.pod:2601 ../src/guestfs-actions.pod:4096
+#: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722
+#: ../src/guestfs-actions.pod:2648 ../src/guestfs-actions.pod:4143
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
-#: ../fish/guestfish-actions.pod:1613
+#: ../fish/guestfish-actions.pod:1659
msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1615
+#: ../fish/guestfish-actions.pod:1661
msgid "getxattrs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1617
+#: ../fish/guestfish-actions.pod:1663
#, no-wrap
msgid ""
" getxattrs path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1619 ../src/guestfs-actions.pod:2618
+#: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2665
msgid ""
"This call lists the extended attributes of the file or directory C<path>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2621
+#: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2668
msgid ""
"At the system call level, this is a combination of the L<listxattr(2)> and "
"L<getxattr(2)> calls."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1625
+#: ../fish/guestfish-actions.pod:1671
msgid "See also: L</lgetxattrs>, L<attr(5)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1627
+#: ../fish/guestfish-actions.pod:1673
msgid "glob-expand"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1629
+#: ../fish/guestfish-actions.pod:1675
#, no-wrap
msgid ""
" glob-expand pattern\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1631 ../src/guestfs-actions.pod:2638
+#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2685
msgid ""
"This command searches for all the pathnames matching C<pattern> according to "
"the wildcard expansion rules used by the shell."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1635 ../src/guestfs-actions.pod:2642
+#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2689
msgid ""
"If no paths match, then this returns an empty list (note: not an error)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1638 ../src/guestfs-actions.pod:2645
+#: ../fish/guestfish-actions.pod:1684 ../src/guestfs-actions.pod:2692
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: =head2
-#: ../fish/guestfish-actions.pod:1642
+#: ../fish/guestfish-actions.pod:1688
msgid "grep"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1644
+#: ../fish/guestfish-actions.pod:1690
#, no-wrap
msgid ""
" grep regex path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1646 ../src/guestfs-actions.pod:2662
+#: ../fish/guestfish-actions.pod:1692 ../src/guestfs-actions.pod:2709
msgid "This calls the external C<grep> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1652
+#: ../fish/guestfish-actions.pod:1698
msgid "grepi"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1654
+#: ../fish/guestfish-actions.pod:1700
#, no-wrap
msgid ""
" grepi regex path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1656 ../src/guestfs-actions.pod:2681
+#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2728
msgid ""
"This calls the external C<grep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1662
+#: ../fish/guestfish-actions.pod:1708
msgid "grub-install"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1664
+#: ../fish/guestfish-actions.pod:1710
#, no-wrap
msgid ""
" grub-install root device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1666 ../src/guestfs-actions.pod:2700
+#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2747
msgid ""
"This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
"with the root directory being C<root>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1675 ../src/guestfs-actions.pod:2709
+#: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2756
msgid ""
"There is currently no way in the API to install grub2, which is used by most "
"modern Linux guests. It is possible to run the grub2 command from the "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1682 ../src/guestfs-actions.pod:2716
+#: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2763
msgid ""
"This uses C<grub-install> from the host. Unfortunately grub is not always "
"compatible with itself, so this only works in rather narrow circumstances. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2723
+#: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2770
msgid ""
"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 C</boot/grub/"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1696 ../src/guestfs-actions.pod:2730
+#: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2777
#, no-wrap
msgid ""
" (hd0) /dev/vda\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1698 ../src/guestfs-actions.pod:2732
+#: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2779
msgid "replacing C</dev/vda> with the name of the installation device."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1702
+#: ../fish/guestfish-actions.pod:1748
msgid "head"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1704
+#: ../fish/guestfish-actions.pod:1750
#, no-wrap
msgid ""
" head path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1706 ../src/guestfs-actions.pod:2746
+#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2793
msgid ""
"This command returns up to the first 10 lines of a file as a list of strings."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1712
+#: ../fish/guestfish-actions.pod:1758
msgid "head-n"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1714
+#: ../fish/guestfish-actions.pod:1760
#, no-wrap
msgid ""
" head-n nrlines path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1716 ../src/guestfs-actions.pod:2765
+#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2812
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
-#: ../fish/guestfish-actions.pod:1719 ../src/guestfs-actions.pod:2768
+#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2815
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
-#: ../fish/guestfish-actions.pod:1722 ../fish/guestfish-actions.pod:4821
-#: ../src/guestfs-actions.pod:2771 ../src/guestfs-actions.pod:7427
+#: ../fish/guestfish-actions.pod:1768 ../fish/guestfish-actions.pod:4867
+#: ../src/guestfs-actions.pod:2818 ../src/guestfs-actions.pod:7474
msgid "If the parameter C<nrlines> is zero, this returns an empty list."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1727
+#: ../fish/guestfish-actions.pod:1773
msgid "hexdump"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1729
+#: ../fish/guestfish-actions.pod:1775
#, no-wrap
msgid ""
" hexdump path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1731 ../src/guestfs-actions.pod:2788
+#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2835
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: =head2
-#: ../fish/guestfish-actions.pod:1737
+#: ../fish/guestfish-actions.pod:1783
msgid "initrd-cat"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1739
+#: ../fish/guestfish-actions.pod:1785
#, no-wrap
msgid ""
" initrd-cat initrdpath filename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1741 ../src/guestfs-actions.pod:2807
+#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2854
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</> "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1745 ../src/guestfs-actions.pod:2811
+#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2858
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 "
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1749 ../src/guestfs-actions.pod:2815
+#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2862
#, no-wrap
msgid ""
" initrd-cat /boot/initrd-<version>.img init\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1751
+#: ../fish/guestfish-actions.pod:1797
msgid "See also L</initrd-list>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1756
+#: ../fish/guestfish-actions.pod:1802
msgid "initrd-list"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1758
+#: ../fish/guestfish-actions.pod:1804
#, no-wrap
msgid ""
" initrd-list path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1760 ../src/guestfs-actions.pod:2834
+#: ../fish/guestfish-actions.pod:1806 ../src/guestfs-actions.pod:2881
msgid "This command lists out files contained in an initrd."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2836
+#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2883
msgid ""
"The files are listed without any initial C</> character. The files are "
"listed in the order they appear (not necessarily alphabetical). Directory "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1766 ../src/guestfs-actions.pod:2840
+#: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2887
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1770
+#: ../fish/guestfish-actions.pod:1816
msgid "inotify-add-watch"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1772
+#: ../fish/guestfish-actions.pod:1818
#, no-wrap
msgid ""
" inotify-add-watch path mask\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1774 ../src/guestfs-actions.pod:2857
+#: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2904
msgid "Watch C<path> for the events listed in C<mask>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1776 ../src/guestfs-actions.pod:2859
+#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2906
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
-#: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2863
+#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2910
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
-#: ../fish/guestfish-actions.pod:1784
+#: ../fish/guestfish-actions.pod:1830
msgid "inotify-close"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1786
+#: ../fish/guestfish-actions.pod:1832
#, no-wrap
msgid ""
" inotify-close\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1788 ../src/guestfs-actions.pod:2876
+#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2923
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1792
+#: ../fish/guestfish-actions.pod:1838
msgid "inotify-files"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1794
+#: ../fish/guestfish-actions.pod:1840
#, no-wrap
msgid ""
" inotify-files\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1796
+#: ../fish/guestfish-actions.pod:1842
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1800
+#: ../fish/guestfish-actions.pod:1846
msgid "inotify-init"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1802
+#: ../fish/guestfish-actions.pod:1848
#, no-wrap
msgid ""
" inotify-init maxevents\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1804 ../src/guestfs-actions.pod:2905
+#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2952
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
-#: ../fish/guestfish-actions.pod:1808
+#: ../fish/guestfish-actions.pod:1854
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>, "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1818
+#: ../fish/guestfish-actions.pod:1864
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1824
+#: ../fish/guestfish-actions.pod:1870
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>). "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1831
+#: ../fish/guestfish-actions.pod:1877
msgid ""
"The handle should be closed after use by calling L</inotify-close>. This "
"also removes any watches automatically."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1835 ../src/guestfs-actions.pod:2936
+#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2983
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1840
+#: ../fish/guestfish-actions.pod:1886
msgid "inotify-read"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1842
+#: ../fish/guestfish-actions.pod:1888
#, no-wrap
msgid ""
" inotify-read\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2950
+#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:2997
msgid ""
"Return the complete queue of events that have happened since the previous "
"read call."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1847 ../src/guestfs-actions.pod:2953
+#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3000
msgid "If no events have happened, this returns an empty list."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1849 ../src/guestfs-actions.pod:2955
+#: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3002
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1855
+#: ../fish/guestfish-actions.pod:1901
msgid "inotify-rm-watch"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1857
+#: ../fish/guestfish-actions.pod:1903
#, no-wrap
msgid ""
" inotify-rm-watch wd\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1859
+#: ../fish/guestfish-actions.pod:1905
msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1862
+#: ../fish/guestfish-actions.pod:1908
msgid "inspect-get-arch"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1864
+#: ../fish/guestfish-actions.pod:1910
#, no-wrap
msgid ""
" inspect-get-arch root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1866
+#: ../fish/guestfish-actions.pod:1912
msgid ""
"This returns the architecture of the inspected operating system. The "
"possible return values are listed under L</file-architecture>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2990
+#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3037
msgid ""
"If the architecture could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1873 ../fish/guestfish-actions.pod:1968
-#: ../fish/guestfish-actions.pod:2047 ../fish/guestfish-actions.pod:2059
-#: ../fish/guestfish-actions.pod:2143 ../fish/guestfish-actions.pod:2205
-#: ../fish/guestfish-actions.pod:2226 ../fish/guestfish-actions.pod:2240
-#: ../fish/guestfish-actions.pod:2280 ../fish/guestfish-actions.pod:2316
-#: ../fish/guestfish-actions.pod:2329 ../fish/guestfish-actions.pod:2342
-#: ../fish/guestfish-actions.pod:2352 ../fish/guestfish-actions.pod:2362
-#: ../fish/guestfish-actions.pod:2374 ../fish/guestfish-actions.pod:2470
-#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:2993
-#: ../src/guestfs-actions.pod:3095 ../src/guestfs-actions.pod:3199
-#: ../src/guestfs-actions.pod:3218 ../src/guestfs-actions.pod:3349
-#: ../src/guestfs-actions.pod:3433 ../src/guestfs-actions.pod:3461
-#: ../src/guestfs-actions.pod:3482 ../src/guestfs-actions.pod:3535
-#: ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3599
-#: ../src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3636
-#: ../src/guestfs-actions.pod:3652 ../src/guestfs-actions.pod:3670
-#: ../src/guestfs-actions.pod:3772 ../src/guestfs-actions.pod:3813
+#: ../fish/guestfish-actions.pod:1919 ../fish/guestfish-actions.pod:2014
+#: ../fish/guestfish-actions.pod:2093 ../fish/guestfish-actions.pod:2105
+#: ../fish/guestfish-actions.pod:2189 ../fish/guestfish-actions.pod:2251
+#: ../fish/guestfish-actions.pod:2272 ../fish/guestfish-actions.pod:2286
+#: ../fish/guestfish-actions.pod:2326 ../fish/guestfish-actions.pod:2362
+#: ../fish/guestfish-actions.pod:2375 ../fish/guestfish-actions.pod:2388
+#: ../fish/guestfish-actions.pod:2398 ../fish/guestfish-actions.pod:2408
+#: ../fish/guestfish-actions.pod:2420 ../fish/guestfish-actions.pod:2516
+#: ../fish/guestfish-actions.pod:2550 ../src/guestfs-actions.pod:3040
+#: ../src/guestfs-actions.pod:3142 ../src/guestfs-actions.pod:3246
+#: ../src/guestfs-actions.pod:3265 ../src/guestfs-actions.pod:3396
+#: ../src/guestfs-actions.pod:3480 ../src/guestfs-actions.pod:3508
+#: ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:3582
+#: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:3646
+#: ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:3683
+#: ../src/guestfs-actions.pod:3699 ../src/guestfs-actions.pod:3717
+#: ../src/guestfs-actions.pod:3819 ../src/guestfs-actions.pod:3860
msgid "Please read L<guestfs(3)/INSPECTION> for more details."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1875
+#: ../fish/guestfish-actions.pod:1921
msgid "inspect-get-distro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1877
+#: ../fish/guestfish-actions.pod:1923
#, no-wrap
msgid ""
" inspect-get-distro root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:3006
+#: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3053
msgid ""
"This returns the distro (distribution) of the inspected operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1882 ../src/guestfs-actions.pod:3009
+#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3056
msgid "Currently defined distros are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1886 ../src/guestfs-actions.pod:3013
+#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3060
msgid "\"archlinux\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:3015
+#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3062
msgid "Arch Linux."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3017
+#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3064
msgid "\"centos\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1892 ../src/guestfs-actions.pod:3019
+#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3066
msgid "CentOS."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1894 ../src/guestfs-actions.pod:3021
+#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3068
msgid "\"debian\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1896 ../src/guestfs-actions.pod:3023
+#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3070
msgid "Debian."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1898 ../src/guestfs-actions.pod:3025
+#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3072
msgid "\"fedora\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1900 ../src/guestfs-actions.pod:3027
+#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3074
msgid "Fedora."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1902 ../src/guestfs-actions.pod:3029
+#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3076
msgid "\"gentoo\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:3031
+#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3078
msgid "Gentoo."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1906 ../src/guestfs-actions.pod:3033
+#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3080
msgid "\"linuxmint\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1908 ../src/guestfs-actions.pod:3035
+#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3082
msgid "Linux Mint."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1910 ../src/guestfs-actions.pod:3037
+#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3084
msgid "\"mageia\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1912 ../src/guestfs-actions.pod:3039
+#: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3086
msgid "Mageia."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1914 ../src/guestfs-actions.pod:3041
+#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3088
msgid "\"mandriva\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3043
+#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3090
msgid "Mandriva."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1918 ../src/guestfs-actions.pod:3045
+#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3092
msgid "\"meego\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:3047
+#: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3094
msgid "MeeGo."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1922 ../src/guestfs-actions.pod:3049
+#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3096
msgid "\"opensuse\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1924 ../src/guestfs-actions.pod:3051
+#: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3098
msgid "OpenSUSE."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1926 ../src/guestfs-actions.pod:3053
+#: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3100
msgid "\"pardus\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3055
+#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3102
msgid "Pardus."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1930 ../src/guestfs-actions.pod:3057
+#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3104
msgid "\"redhat-based\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3059
+#: ../fish/guestfish-actions.pod:1978 ../src/guestfs-actions.pod:3106
msgid "Some Red Hat-derived distro."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3061
+#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3108
msgid "\"rhel\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3063
+#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3110
msgid "Red Hat Enterprise Linux."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3065
+#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3112
msgid "\"scientificlinux\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3067
+#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3114
msgid "Scientific Linux."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3069
+#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3116
msgid "\"slackware\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3071
+#: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3118
msgid "Slackware."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3073
+#: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3120
msgid "\"ttylinux\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3075
+#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3122
msgid "ttylinux."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3077
+#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3124
msgid "\"ubuntu\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3079
+#: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3126
msgid "Ubuntu."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:2038
-#: ../fish/guestfish-actions.pod:2307 ../src/guestfs-actions.pod:3081
-#: ../src/guestfs-actions.pod:3190 ../src/guestfs-actions.pod:3570
+#: ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2084
+#: ../fish/guestfish-actions.pod:2353 ../src/guestfs-actions.pod:3128
+#: ../src/guestfs-actions.pod:3237 ../src/guestfs-actions.pod:3617
msgid "\"unknown\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3083
+#: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3130
msgid "The distro could not be determined."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:1958 ../fish/guestfish-actions.pod:2295
-#: ../src/guestfs-actions.pod:3085 ../src/guestfs-actions.pod:3558
+#: ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2341
+#: ../src/guestfs-actions.pod:3132 ../src/guestfs-actions.pod:3605
msgid "\"windows\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3087
+#: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3134
msgid ""
"Windows does not have distributions. This string is returned if the OS type "
"is Windows."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1965 ../fish/guestfish-actions.pod:2044
-#: ../fish/guestfish-actions.pod:2313 ../src/guestfs-actions.pod:3092
-#: ../src/guestfs-actions.pod:3196 ../src/guestfs-actions.pod:3576
+#: ../fish/guestfish-actions.pod:2011 ../fish/guestfish-actions.pod:2090
+#: ../fish/guestfish-actions.pod:2359 ../src/guestfs-actions.pod:3139
+#: ../src/guestfs-actions.pod:3243 ../src/guestfs-actions.pod:3623
msgid ""
"Future versions of libguestfs may return other strings here. The caller "
"should be prepared to handle any string."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:1970
+#: ../fish/guestfish-actions.pod:2016
msgid "inspect-get-drive-mappings"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1972
+#: ../fish/guestfish-actions.pod:2018
#, no-wrap
msgid ""
" inspect-get-drive-mappings root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3108
+#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3155
msgid ""
"This call is useful for Windows which uses a primitive system of assigning "
"drive letters (like \"C:\") to partitions. This inspection API examines the "
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3114
+#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3161
#, no-wrap
msgid ""
" C => /dev/vda2\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3118
+#: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3165
msgid ""
"Note that keys are drive letters. For Windows, the key is case insensitive "
"and just contains the drive letter, without the customary colon separator "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3122
+#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3169
msgid ""
"In future we may support other operating systems that also used drive "
"letters, but the keys for those might not be case insensitive and might be "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:3127
+#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3174
msgid ""
"For Windows guests, currently only hard drive mappings are returned. "
"Removable disks (eg. DVD-ROMs) are ignored."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3130
+#: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3177
msgid ""
"For guests that do not use drive mappings, or if the drive mappings could "
"not be determined, this returns an empty hash table."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:1999
+#: ../fish/guestfish-actions.pod:2045
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-mountpoints>, L</inspect-get-filesystems>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2003
+#: ../fish/guestfish-actions.pod:2049
msgid "inspect-get-filesystems"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2005
+#: ../fish/guestfish-actions.pod:2051
#, no-wrap
msgid ""
" inspect-get-filesystems root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3151
+#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3198
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2012 ../src/guestfs-actions.pod:3156
+#: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3203
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
-#: ../fish/guestfish-actions.pod:2015
+#: ../fish/guestfish-actions.pod:2061
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-mountpoints>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2018
+#: ../fish/guestfish-actions.pod:2064
msgid "inspect-get-format"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2020
+#: ../fish/guestfish-actions.pod:2066
#, no-wrap
msgid ""
" inspect-get-format root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2022 ../src/guestfs-actions.pod:3174
+#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3221
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
-#: ../fish/guestfish-actions.pod:2025 ../src/guestfs-actions.pod:3177
+#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3224
msgid "Currently defined formats are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2029 ../src/guestfs-actions.pod:3181
+#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3228
msgid "\"installed\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2031 ../src/guestfs-actions.pod:3183
+#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3230
msgid "This is an installed operating system."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2033 ../src/guestfs-actions.pod:3185
+#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3232
msgid "\"installer\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2035 ../src/guestfs-actions.pod:3187
+#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3234
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
-#: ../fish/guestfish-actions.pod:2040 ../src/guestfs-actions.pod:3192
+#: ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:3239
msgid "The format of this disk image is not known."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2049
+#: ../fish/guestfish-actions.pod:2095
msgid "inspect-get-hostname"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2051
+#: ../fish/guestfish-actions.pod:2097
#, no-wrap
msgid ""
" inspect-get-hostname root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3212
+#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3259
msgid ""
"This function returns the hostname of the operating system as found by "
"inspection of the guest's configuration files."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2056 ../src/guestfs-actions.pod:3215
+#: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3262
msgid ""
"If the hostname could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2061
+#: ../fish/guestfish-actions.pod:2107
msgid "inspect-get-icon"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2063
+#: ../fish/guestfish-actions.pod:2109
#, no-wrap
msgid ""
" inspect-get-icon root [favicon:..] [highquality:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2065 ../src/guestfs-actions.pod:3241
+#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3288
msgid ""
"This function returns an icon corresponding to the inspected operating "
"system. The icon is returned as a buffer containing a PNG image (re-encoded "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2069 ../src/guestfs-actions.pod:3245
+#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3292
msgid ""
"If it was not possible to get an icon this function returns a zero-length "
"(non-NULL) buffer. I<Callers must check for this case>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2072 ../src/guestfs-actions.pod:3248
+#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3295
msgid ""
"Libguestfs will start by looking for a file called C</etc/favicon.png> or "
"C<C:\\etc\\favicon.png> and if it has the correct format, the contents of "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2078 ../src/guestfs-actions.pod:3254
+#: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3301
msgid ""
"If finding the favicon fails, then we look in other places in the guest for "
"a suitable icon."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3257
+#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3304
msgid ""
"If the optional C<highquality> boolean is true then only high quality icons "
"are returned, which means only icons of high resolution with an alpha "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2092 ../src/guestfs-actions.pod:3268
+#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3315
msgid ""
"Unlike most other inspection API calls, the guest's disks must be mounted up "
"before you call this, since it needs to read information from the guest "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2098 ../src/guestfs-actions.pod:3274
+#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3321
msgid ""
"B<Security:> The icon data comes from the untrusted guest, and should be "
"treated with caution. PNG files have been known to contain exploits. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2106 ../src/guestfs-actions.pod:3282
+#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3329
msgid ""
"The PNG image returned can be any size. It might not be square. Libguestfs "
"tries to return the largest, highest quality icon available. The "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2113 ../src/guestfs-actions.pod:3289
+#: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3336
msgid ""
"Extracting icons from Windows guests requires the external C<wrestool> "
"program from the C<icoutils> package, and several programs (C<bmptopnm>, "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2120 ../src/guestfs-actions.pod:3296
+#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3343
msgid ""
"Operating system icons are usually trademarks. Seek legal advice before "
"using trademarks in applications."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2127
+#: ../fish/guestfish-actions.pod:2173
msgid "inspect-get-major-version"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2129
+#: ../fish/guestfish-actions.pod:2175
#, no-wrap
msgid ""
" inspect-get-major-version root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2131 ../src/guestfs-actions.pod:3337
+#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3384
msgid ""
"This returns the major version number of the inspected operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2134 ../src/guestfs-actions.pod:3340
+#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3387
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2141 ../fish/guestfish-actions.pod:2152
-#: ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3364
+#: ../fish/guestfish-actions.pod:2187 ../fish/guestfish-actions.pod:2198
+#: ../src/guestfs-actions.pod:3394 ../src/guestfs-actions.pod:3411
msgid "If the version could not be determined, then C<0> is returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2145
+#: ../fish/guestfish-actions.pod:2191
msgid "inspect-get-minor-version"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2147
+#: ../fish/guestfish-actions.pod:2193
#, no-wrap
msgid ""
" inspect-get-minor-version root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2149 ../src/guestfs-actions.pod:3361
+#: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3408
msgid ""
"This returns the minor version number of the inspected operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2154
+#: ../fish/guestfish-actions.pod:2200
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-major-version>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2157
+#: ../fish/guestfish-actions.pod:2203
msgid "inspect-get-mountpoints"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2159
+#: ../fish/guestfish-actions.pod:2205
#, no-wrap
msgid ""
" inspect-get-mountpoints root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2161 ../src/guestfs-actions.pod:3379
+#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3426
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2170 ../src/guestfs-actions.pod:3388
+#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3435
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2175 ../src/guestfs-actions.pod:3393
+#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3440
msgid ""
"Non-mounted devices such as swap devices are I<not> returned in this list."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2178
+#: ../fish/guestfish-actions.pod:2224
msgid ""
"For operating systems like Windows which still use drive letters, this call "
"will only return an entry for the first drive \"mounted on\" C</>. For "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2184
+#: ../fish/guestfish-actions.pod:2230
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-filesystems>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2187
+#: ../fish/guestfish-actions.pod:2233
msgid "inspect-get-package-format"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2189
+#: ../fish/guestfish-actions.pod:2235
#, no-wrap
msgid ""
" inspect-get-package-format root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2191
+#: ../fish/guestfish-actions.pod:2237
msgid ""
"This function and L</inspect-get-package-management> return the package "
"format and package management tool used by the inspected operating system. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2197 ../src/guestfs-actions.pod:3425
+#: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3472
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2201 ../src/guestfs-actions.pod:3429
+#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3476
msgid ""
"Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>, "
"C<pkgsrc>. Future versions of libguestfs may return other strings."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2207
+#: ../fish/guestfish-actions.pod:2253
msgid "inspect-get-package-management"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2209
+#: ../fish/guestfish-actions.pod:2255
#, no-wrap
msgid ""
" inspect-get-package-management root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2211
+#: ../fish/guestfish-actions.pod:2257
msgid ""
"L</inspect-get-package-format> and this function return the package format "
"and package management tool used by the inspected operating system. For "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2217 ../src/guestfs-actions.pod:3452
+#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3499
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3456
+#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3503
msgid ""
"Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
"derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>, C<zypper>. Future "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2228
+#: ../fish/guestfish-actions.pod:2274
msgid "inspect-get-product-name"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2230
+#: ../fish/guestfish-actions.pod:2276
#, no-wrap
msgid ""
" inspect-get-product-name root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2232 ../src/guestfs-actions.pod:3474
+#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3521
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2237 ../src/guestfs-actions.pod:3479
+#: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3526
msgid ""
"If the product name could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2242
+#: ../fish/guestfish-actions.pod:2288
msgid "inspect-get-product-variant"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2244
+#: ../fish/guestfish-actions.pod:2290
#, no-wrap
msgid ""
" inspect-get-product-variant root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2246 ../src/guestfs-actions.pod:3495
+#: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3542
msgid "This returns the product variant of the inspected operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3498
+#: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3545
msgid ""
"For Windows guests, this returns the contents of the Registry key C<HKLM"
"\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2258 ../src/guestfs-actions.pod:3507
+#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3554
msgid ""
"For enterprise Linux guests, in future we intend this to return the product "
"variant such as C<Desktop>, C<Server> and so on. But this is not "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3511
+#: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3558
msgid ""
"If the product variant could not be determined, then the string C<unknown> "
"is returned."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2265
+#: ../fish/guestfish-actions.pod:2311
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-product-name>, L</inspect-get-major-version>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2269
+#: ../fish/guestfish-actions.pod:2315
msgid "inspect-get-roots"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2271
+#: ../fish/guestfish-actions.pod:2317
#, no-wrap
msgid ""
" inspect-get-roots\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2273
+#: ../fish/guestfish-actions.pod:2319
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2277
+#: ../fish/guestfish-actions.pod:2323
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:2282
+#: ../fish/guestfish-actions.pod:2328
msgid "inspect-get-type"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2284
+#: ../fish/guestfish-actions.pod:2330
#, no-wrap
msgid ""
" inspect-get-type root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2286 ../src/guestfs-actions.pod:3549
+#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3596
msgid ""
"This returns the type of the inspected operating system. Currently defined "
"types are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3554
+#: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3601
msgid "\"linux\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2293 ../src/guestfs-actions.pod:3556
+#: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3603
msgid "Any Linux-based operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2297 ../src/guestfs-actions.pod:3560
+#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3607
msgid "Any Microsoft Windows operating system."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2299 ../src/guestfs-actions.pod:3562
+#: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3609
msgid "\"freebsd\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2301 ../src/guestfs-actions.pod:3564
+#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3611
msgid "FreeBSD."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2303 ../src/guestfs-actions.pod:3566
+#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3613
msgid "\"netbsd\""
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2305 ../src/guestfs-actions.pod:3568
+#: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3615
msgid "NetBSD."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2309 ../src/guestfs-actions.pod:3572
+#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3619
msgid "The operating system type could not be determined."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2318
+#: ../fish/guestfish-actions.pod:2364
msgid "inspect-get-windows-current-control-set"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2320
+#: ../fish/guestfish-actions.pod:2366
#, no-wrap
msgid ""
" inspect-get-windows-current-control-set root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2322 ../src/guestfs-actions.pod:3592
+#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3639
msgid ""
"This returns the Windows CurrentControlSet of the inspected guest. The "
"CurrentControlSet is a registry key name such as C<ControlSet001>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2325 ../src/guestfs-actions.pod:3595
+#: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3642
msgid ""
"This call assumes that the guest is Windows and that the Registry could be "
"examined by inspection. If this is not the case then an error is returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2331
+#: ../fish/guestfish-actions.pod:2377
msgid "inspect-get-windows-systemroot"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2333
+#: ../fish/guestfish-actions.pod:2379
#, no-wrap
msgid ""
" inspect-get-windows-systemroot root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2335 ../src/guestfs-actions.pod:3612
+#: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3659
msgid ""
"This returns the Windows systemroot of the inspected guest. The systemroot "
"is a directory path such as C</WINDOWS>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2338 ../src/guestfs-actions.pod:3615
+#: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3662
msgid ""
"This call assumes that the guest is Windows and that the systemroot could be "
"determined by inspection. If this is not the case then an error is returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2344
+#: ../fish/guestfish-actions.pod:2390
msgid "inspect-is-live"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2346
+#: ../fish/guestfish-actions.pod:2392
#, no-wrap
msgid ""
" inspect-is-live root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2348
+#: ../fish/guestfish-actions.pod:2394
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:2354
+#: ../fish/guestfish-actions.pod:2400
msgid "inspect-is-multipart"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2356
+#: ../fish/guestfish-actions.pod:2402
#, no-wrap
msgid ""
" inspect-is-multipart root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2358
+#: ../fish/guestfish-actions.pod:2404
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:2364
+#: ../fish/guestfish-actions.pod:2410
msgid "inspect-is-netinst"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2366
+#: ../fish/guestfish-actions.pod:2412
#, no-wrap
msgid ""
" inspect-is-netinst root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2368
+#: ../fish/guestfish-actions.pod:2414
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 self-"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2376
+#: ../fish/guestfish-actions.pod:2422
msgid "inspect-list-applications"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2378
+#: ../fish/guestfish-actions.pod:2424
#, no-wrap
msgid ""
" inspect-list-applications root\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2380 ../src/guestfs-actions.pod:3682
+#: ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3729
msgid "Return the list of applications installed in the operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2382
+#: ../fish/guestfish-actions.pod:2428
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>, "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2392 ../src/guestfs-actions.pod:3694
+#: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3741
msgid ""
"This returns an empty list if the inspection code was not able to determine "
"the list of applications."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2395 ../src/guestfs-actions.pod:3697
+#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3744
msgid "The application structure contains the following fields:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2399 ../src/guestfs-actions.pod:3701
+#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3748
msgid "C<app_name>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3703
+#: ../fish/guestfish-actions.pod:2447 ../src/guestfs-actions.pod:3750
msgid ""
"The name of the application. For Red Hat-derived and Debian-derived Linux "
"guests, this is the package name."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2404 ../src/guestfs-actions.pod:3706
+#: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3753
msgid "C<app_display_name>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2406 ../src/guestfs-actions.pod:3708
+#: ../fish/guestfish-actions.pod:2452 ../src/guestfs-actions.pod:3755
msgid ""
"The display name of the application, sometimes localized to the install "
"language of the guest operating system."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2409 ../src/guestfs-actions.pod:3711
+#: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3758
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
-#: ../fish/guestfish-actions.pod:2412 ../src/guestfs-actions.pod:3714
+#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3761
msgid "C<app_epoch>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:3716
+#: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3763
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
-#: ../fish/guestfish-actions.pod:2417 ../src/guestfs-actions.pod:3719
+#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3766
msgid "C<app_version>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2419 ../src/guestfs-actions.pod:3721
+#: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3768
msgid ""
"The version string of the application or package. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2422 ../src/guestfs-actions.pod:3724
+#: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3771
msgid "C<app_release>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2424 ../src/guestfs-actions.pod:3726
+#: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3773
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
-#: ../fish/guestfish-actions.pod:2428 ../src/guestfs-actions.pod:3730
+#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3777
msgid "C<app_install_path>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2430 ../src/guestfs-actions.pod:3732
+#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3779
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2435 ../src/guestfs-actions.pod:3737
+#: ../fish/guestfish-actions.pod:2481 ../src/guestfs-actions.pod:3784
msgid "If unavailable this is returned as an empty string C<\"\">."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2437 ../src/guestfs-actions.pod:3739
+#: ../fish/guestfish-actions.pod:2483 ../src/guestfs-actions.pod:3786
msgid "C<app_trans_path>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2439 ../src/guestfs-actions.pod:3741
+#: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3788
msgid ""
"The install path translated into a libguestfs path. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2442 ../src/guestfs-actions.pod:3744
+#: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3791
msgid "C<app_publisher>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2444 ../src/guestfs-actions.pod:3746
+#: ../fish/guestfish-actions.pod:2490 ../src/guestfs-actions.pod:3793
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
-#: ../fish/guestfish-actions.pod:2448 ../src/guestfs-actions.pod:3750
+#: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3797
msgid "C<app_url>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3752
+#: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3799
msgid ""
"The URL (eg. upstream URL) of the application. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:2453 ../src/guestfs-actions.pod:3755
+#: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3802
msgid "C<app_source_package>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3757
+#: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3804
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
-#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3760
+#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3807
msgid "C<app_summary>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2460 ../src/guestfs-actions.pod:3762
+#: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3809
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
-#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3765
+#: ../fish/guestfish-actions.pod:2509 ../src/guestfs-actions.pod:3812
msgid "C<app_description>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3767
+#: ../fish/guestfish-actions.pod:2511 ../src/guestfs-actions.pod:3814
msgid ""
"A longer description of the application or package. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2472
+#: ../fish/guestfish-actions.pod:2518
msgid "inspect-os"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2474
+#: ../fish/guestfish-actions.pod:2520
#, no-wrap
msgid ""
" inspect-os\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3785
+#: ../fish/guestfish-actions.pod:2522 ../src/guestfs-actions.pod:3832
msgid ""
"This function uses other libguestfs functions and certain heuristics to "
"inspect the disk(s) (usually disks belonging to a virtual machine), looking "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2480 ../src/guestfs-actions.pod:3789
+#: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3836
msgid "The list returned is empty if no operating systems were found."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2482 ../src/guestfs-actions.pod:3791
+#: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3838
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. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2489
+#: ../fish/guestfish-actions.pod:2535
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, "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2494
+#: ../fish/guestfish-actions.pod:2540
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2500 ../src/guestfs-actions.pod:3809
+#: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3856
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
-#: ../fish/guestfish-actions.pod:2506 ../fish/guestfish-actions.pod:2704
-#: ../fish/guestfish-actions.pod:2763
+#: ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2750
+#: ../fish/guestfish-actions.pod:2809
msgid "See also L</list-filesystems>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2508
+#: ../fish/guestfish-actions.pod:2554
msgid "is-blockdev"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2510
+#: ../fish/guestfish-actions.pod:2556
#, no-wrap
msgid ""
" is-blockdev path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2512 ../src/guestfs-actions.pod:3829
+#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3876
msgid ""
"This returns C<true> if and only if there is a block device with the given "
"C<path> name."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2515 ../fish/guestfish-actions.pod:2533
-#: ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2561
-#: ../fish/guestfish-actions.pod:2571 ../fish/guestfish-actions.pod:2605
-#: ../fish/guestfish-actions.pod:2614
+#: ../fish/guestfish-actions.pod:2561 ../fish/guestfish-actions.pod:2579
+#: ../fish/guestfish-actions.pod:2598 ../fish/guestfish-actions.pod:2607
+#: ../fish/guestfish-actions.pod:2617 ../fish/guestfish-actions.pod:2651
+#: ../fish/guestfish-actions.pod:2660
msgid "See also L</stat>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2517
+#: ../fish/guestfish-actions.pod:2563
msgid "is-busy"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2519
+#: ../fish/guestfish-actions.pod:2565
#, no-wrap
msgid ""
" is-busy\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2521 ../src/guestfs-actions.pod:3843
+#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3890
msgid ""
"This returns true iff this handle is busy processing a command (in the "
"C<BUSY> state)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2526
+#: ../fish/guestfish-actions.pod:2572
msgid "is-chardev"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2528
+#: ../fish/guestfish-actions.pod:2574
#, no-wrap
msgid ""
" is-chardev path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2530 ../src/guestfs-actions.pod:3858
+#: ../fish/guestfish-actions.pod:2576 ../src/guestfs-actions.pod:3905
msgid ""
"This returns C<true> if and only if there is a character device with the "
"given C<path> name."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2535
+#: ../fish/guestfish-actions.pod:2581
msgid "is-config"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2537
+#: ../fish/guestfish-actions.pod:2583
#, no-wrap
msgid ""
" is-config\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2539 ../src/guestfs-actions.pod:3872
+#: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:3919
msgid ""
"This returns true iff this handle is being configured (in the C<CONFIG> "
"state)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2544
+#: ../fish/guestfish-actions.pod:2590
msgid "is-dir"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2546
+#: ../fish/guestfish-actions.pod:2592
#, no-wrap
msgid ""
" is-dir path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2548 ../src/guestfs-actions.pod:3887
+#: ../fish/guestfish-actions.pod:2594 ../src/guestfs-actions.pod:3934
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
-#: ../fish/guestfish-actions.pod:2554
+#: ../fish/guestfish-actions.pod:2600
msgid "is-fifo"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2556
+#: ../fish/guestfish-actions.pod:2602
#, no-wrap
msgid ""
" is-fifo path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3903
+#: ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:3950
msgid ""
"This returns C<true> if and only if there is a FIFO (named pipe) with the "
"given C<path> name."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2563
+#: ../fish/guestfish-actions.pod:2609
msgid "is-file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2565
+#: ../fish/guestfish-actions.pod:2611
#, no-wrap
msgid ""
" is-file path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3918
+#: ../fish/guestfish-actions.pod:2613 ../src/guestfs-actions.pod:3965
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 directories."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2573
+#: ../fish/guestfish-actions.pod:2619
msgid "is-launching"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2575
+#: ../fish/guestfish-actions.pod:2621
#, no-wrap
msgid ""
" is-launching\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2577 ../src/guestfs-actions.pod:3933
+#: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3980
msgid ""
"This returns true iff this handle is launching the subprocess (in the "
"C<LAUNCHING> state)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2582
+#: ../fish/guestfish-actions.pod:2628
msgid "is-lv"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2584
+#: ../fish/guestfish-actions.pod:2630
#, no-wrap
msgid ""
" is-lv device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2586 ../src/guestfs-actions.pod:3948
+#: ../fish/guestfish-actions.pod:2632 ../src/guestfs-actions.pod:3995
msgid ""
"This command tests whether C<device> is a logical volume, and returns true "
"iff this is the case."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2589
+#: ../fish/guestfish-actions.pod:2635
msgid "is-ready"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2591
+#: ../fish/guestfish-actions.pod:2637
#, no-wrap
msgid ""
" is-ready\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2593 ../src/guestfs-actions.pod:3960
+#: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4007
msgid ""
"This returns true iff this handle is ready to accept commands (in the "
"C<READY> state)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2598
+#: ../fish/guestfish-actions.pod:2644
msgid "is-socket"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2600
+#: ../fish/guestfish-actions.pod:2646
#, no-wrap
msgid ""
" is-socket path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2602 ../src/guestfs-actions.pod:3975
+#: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4022
msgid ""
"This returns C<true> if and only if there is a Unix domain socket with the "
"given C<path> name."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2607
+#: ../fish/guestfish-actions.pod:2653
msgid "is-symlink"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2609
+#: ../fish/guestfish-actions.pod:2655
#, no-wrap
msgid ""
" is-symlink path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2611 ../src/guestfs-actions.pod:3990
+#: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4037
msgid ""
"This returns C<true> if and only if there is a symbolic link with the given "
"C<path> name."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2616
+#: ../fish/guestfish-actions.pod:2662
msgid "is-zero"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2618
+#: ../fish/guestfish-actions.pod:2664
#, no-wrap
msgid ""
" is-zero path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2620 ../src/guestfs-actions.pod:4005
+#: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4052
msgid ""
"This returns true iff the file exists and the file is empty or it contains "
"all zero bytes."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2623
+#: ../fish/guestfish-actions.pod:2669
msgid "is-zero-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2625
+#: ../fish/guestfish-actions.pod:2671
#, no-wrap
msgid ""
" is-zero-device device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2627 ../src/guestfs-actions.pod:4018
+#: ../fish/guestfish-actions.pod:2673 ../src/guestfs-actions.pod:4065
msgid "This returns true iff the device exists and contains all zero bytes."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2629 ../src/guestfs-actions.pod:4020
+#: ../fish/guestfish-actions.pod:2675 ../src/guestfs-actions.pod:4067
msgid "Note that for large devices this can take a long time to run."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2631
+#: ../fish/guestfish-actions.pod:2677
msgid "kill-subprocess"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2633
+#: ../fish/guestfish-actions.pod:2679
#, no-wrap
msgid ""
" kill-subprocess\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:4031
+#: ../fish/guestfish-actions.pod:2681 ../src/guestfs-actions.pod:4078
msgid "This kills the qemu subprocess. You should never need to call this."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2637
+#: ../fish/guestfish-actions.pod:2683
msgid "launch"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2639
+#: ../fish/guestfish-actions.pod:2685
msgid "run"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2641
+#: ../fish/guestfish-actions.pod:2687
#, no-wrap
msgid ""
" launch\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2643 ../src/guestfs-actions.pod:4042
+#: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4089
msgid ""
"Internally libguestfs is implemented by running a virtual machine using "
"L<qemu(1)>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:4045
+#: ../fish/guestfish-actions.pod:2692 ../src/guestfs-actions.pod:4092
msgid ""
"You should call this after configuring the handle (eg. adding drives) but "
"before performing any actions."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2649
+#: ../fish/guestfish-actions.pod:2695
msgid "lchown"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2651
+#: ../fish/guestfish-actions.pod:2697
#, no-wrap
msgid ""
" lchown owner group path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2653
+#: ../fish/guestfish-actions.pod:2699
msgid ""
"Change the file owner to C<owner> and group to C<group>. This is like L</"
"chown> but if C<path> is a symlink then the link itself is changed, not the "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2661
+#: ../fish/guestfish-actions.pod:2707
msgid "lgetxattr"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2663
+#: ../fish/guestfish-actions.pod:2709
#, no-wrap
msgid ""
" lgetxattr path name\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2665 ../src/guestfs-actions.pod:4085
+#: ../fish/guestfish-actions.pod:2711 ../src/guestfs-actions.pod:4132
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
-#: ../fish/guestfish-actions.pod:2679
+#: ../fish/guestfish-actions.pod:2725
msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2681
+#: ../fish/guestfish-actions.pod:2727
msgid "lgetxattrs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2683
+#: ../fish/guestfish-actions.pod:2729
#, no-wrap
msgid ""
" lgetxattrs path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2685
+#: ../fish/guestfish-actions.pod:2731
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:2689
+#: ../fish/guestfish-actions.pod:2735
msgid "list-9p"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2691
+#: ../fish/guestfish-actions.pod:2737
#, no-wrap
msgid ""
" list-9p\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2693 ../src/guestfs-actions.pod:4128
+#: ../fish/guestfish-actions.pod:2739 ../src/guestfs-actions.pod:4175
msgid ""
"List all 9p filesystems attached to the guest. A list of mount tags is "
"returned."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2696
+#: ../fish/guestfish-actions.pod:2742
msgid "list-devices"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2698
+#: ../fish/guestfish-actions.pod:2744
#, no-wrap
msgid ""
" list-devices\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2700 ../src/guestfs-actions.pod:4142
+#: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4189
msgid "List all the block devices."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2702 ../src/guestfs-actions.pod:4144
+#: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4191
msgid "The full block device names are returned, eg. C</dev/sda>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2706
+#: ../fish/guestfish-actions.pod:2752
msgid "list-dm-devices"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2708
+#: ../fish/guestfish-actions.pod:2754
#, no-wrap
msgid ""
" list-dm-devices\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2710 ../src/guestfs-actions.pod:4159
+#: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4206
msgid "List all device mapper devices."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2712
+#: ../fish/guestfish-actions.pod:2758
msgid ""
"The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
"previous call to L</luks-open>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2715
+#: ../fish/guestfish-actions.pod:2761
msgid ""
"Device mapper devices which correspond to logical volumes are I<not> "
"returned in this list. Call L</lvs> if you want to list logical volumes."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2719
+#: ../fish/guestfish-actions.pod:2765
msgid "list-filesystems"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2721
+#: ../fish/guestfish-actions.pod:2767
#, no-wrap
msgid ""
" list-filesystems\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2723 ../src/guestfs-actions.pod:4179
+#: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4226
msgid ""
"This inspection command looks for filesystems on partitions, block devices "
"and logical volumes, returning a list of devices containing filesystems and "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2727 ../src/guestfs-actions.pod:4183
+#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4230
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
-#: ../fish/guestfish-actions.pod:2731 ../src/guestfs-actions.pod:4187
+#: ../fish/guestfish-actions.pod:2777 ../src/guestfs-actions.pod:4234
#, no-wrap
msgid ""
" \"/dev/sda1\" => \"ntfs\"\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2736 ../src/guestfs-actions.pod:4192
+#: ../fish/guestfish-actions.pod:2782 ../src/guestfs-actions.pod:4239
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
-#: ../fish/guestfish-actions.pod:2740
+#: ../fish/guestfish-actions.pod:2786
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2744
+#: ../fish/guestfish-actions.pod:2790
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2752
+#: ../fish/guestfish-actions.pod:2798
msgid "list-partitions"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2754
+#: ../fish/guestfish-actions.pod:2800
#, no-wrap
msgid ""
" list-partitions\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4221
+#: ../fish/guestfish-actions.pod:2802 ../src/guestfs-actions.pod:4268
msgid "List all the partitions detected on all block devices."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2758 ../src/guestfs-actions.pod:4223
+#: ../fish/guestfish-actions.pod:2804 ../src/guestfs-actions.pod:4270
msgid "The full partition device names are returned, eg. C</dev/sda1>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2760
+#: ../fish/guestfish-actions.pod:2806
msgid ""
"This does not return logical volumes. For that you will need to call L</"
"lvs>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2765
+#: ../fish/guestfish-actions.pod:2811
msgid "ll"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2767
+#: ../fish/guestfish-actions.pod:2813
#, no-wrap
msgid ""
" ll directory\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4242
+#: ../fish/guestfish-actions.pod:2815 ../src/guestfs-actions.pod:4289
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
-#: ../fish/guestfish-actions.pod:2772 ../src/guestfs-actions.pod:4245
+#: ../fish/guestfish-actions.pod:2818 ../src/guestfs-actions.pod:4292
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
-#: ../fish/guestfish-actions.pod:2775
+#: ../fish/guestfish-actions.pod:2821
msgid "ln"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2777
+#: ../fish/guestfish-actions.pod:2823
#, no-wrap
msgid ""
" ln target linkname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2779 ../src/guestfs-actions.pod:4260
+#: ../fish/guestfish-actions.pod:2825 ../src/guestfs-actions.pod:4307
msgid "This command creates a hard link using the C<ln> command."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2781
+#: ../fish/guestfish-actions.pod:2827
msgid "ln-f"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2783
+#: ../fish/guestfish-actions.pod:2829
#, no-wrap
msgid ""
" ln-f target linkname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2785 ../src/guestfs-actions.pod:4273
+#: ../fish/guestfish-actions.pod:2831 ../src/guestfs-actions.pod:4320
msgid ""
"This command creates a hard link using the C<ln -f> command. The I<-f> "
"option removes the link (C<linkname>) if it exists already."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2788
+#: ../fish/guestfish-actions.pod:2834
msgid "ln-s"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2790
+#: ../fish/guestfish-actions.pod:2836
#, no-wrap
msgid ""
" ln-s target linkname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2792 ../src/guestfs-actions.pod:4287
+#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4334
msgid "This command creates a symbolic link using the C<ln -s> command."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2794
+#: ../fish/guestfish-actions.pod:2840
msgid "ln-sf"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2796
+#: ../fish/guestfish-actions.pod:2842
#, no-wrap
msgid ""
" ln-sf target linkname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2798 ../src/guestfs-actions.pod:4300
+#: ../fish/guestfish-actions.pod:2844 ../src/guestfs-actions.pod:4347
msgid ""
"This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
"option removes the link (C<linkname>) if it exists already."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2801
+#: ../fish/guestfish-actions.pod:2847
msgid "lremovexattr"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2803
+#: ../fish/guestfish-actions.pod:2849
#, no-wrap
msgid ""
" lremovexattr xattr path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2805
+#: ../fish/guestfish-actions.pod:2851
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:2809
+#: ../fish/guestfish-actions.pod:2855
msgid "ls"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2811
+#: ../fish/guestfish-actions.pod:2857
#, no-wrap
msgid ""
" ls directory\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2813 ../src/guestfs-actions.pod:4328
+#: ../fish/guestfish-actions.pod:2859 ../src/guestfs-actions.pod:4375
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 shown."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2817
+#: ../fish/guestfish-actions.pod:2863
msgid ""
"This command is mostly useful for interactive sessions. Programs should "
"probably use L</readdir> instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2820
+#: ../fish/guestfish-actions.pod:2866
msgid "lsetxattr"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2822
+#: ../fish/guestfish-actions.pod:2868
#, no-wrap
msgid ""
" lsetxattr xattr val vallen path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2824
+#: ../fish/guestfish-actions.pod:2870
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:2828
+#: ../fish/guestfish-actions.pod:2874
msgid "lstat"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2830
+#: ../fish/guestfish-actions.pod:2876
#, no-wrap
msgid ""
" lstat path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2832 ../fish/guestfish-actions.pod:4656
-#: ../src/guestfs-actions.pod:4364 ../src/guestfs-actions.pod:7167
+#: ../fish/guestfish-actions.pod:2878 ../fish/guestfish-actions.pod:4702
+#: ../src/guestfs-actions.pod:4411 ../src/guestfs-actions.pod:7214
msgid "Returns file information for the given C<path>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2834
+#: ../fish/guestfish-actions.pod:2880
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: textblock
-#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4370
+#: ../fish/guestfish-actions.pod:2884 ../src/guestfs-actions.pod:4417
msgid "This is the same as the C<lstat(2)> system call."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2840
+#: ../fish/guestfish-actions.pod:2886
msgid "lstatlist"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2842
+#: ../fish/guestfish-actions.pod:2888
#, no-wrap
msgid ""
" lstatlist path 'names ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2844
+#: ../fish/guestfish-actions.pod:2890
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4389
+#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4436
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, "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2853
+#: ../fish/guestfish-actions.pod:2899
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2861
+#: ../fish/guestfish-actions.pod:2907
msgid "luks-add-key"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2863
+#: ../fish/guestfish-actions.pod:2909
#, no-wrap
msgid ""
" luks-add-key device keyslot\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2865 ../src/guestfs-actions.pod:4417
+#: ../fish/guestfish-actions.pod:2911 ../src/guestfs-actions.pod:4464
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2870
+#: ../fish/guestfish-actions.pod:2916
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:2874 ../fish/guestfish-actions.pod:2896
-#: ../fish/guestfish-actions.pod:2909 ../fish/guestfish-actions.pod:2923
-#: ../fish/guestfish-actions.pod:2949 ../fish/guestfish-actions.pod:2959
+#: ../fish/guestfish-actions.pod:2920 ../fish/guestfish-actions.pod:2942
+#: ../fish/guestfish-actions.pod:2955 ../fish/guestfish-actions.pod:2969
+#: ../fish/guestfish-actions.pod:2995 ../fish/guestfish-actions.pod:3005
msgid ""
"This command has one or more key or passphrase parameters. Guestfish will "
"prompt for these separately."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2877
+#: ../fish/guestfish-actions.pod:2923
msgid "luks-close"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2879
+#: ../fish/guestfish-actions.pod:2925
#, no-wrap
msgid ""
" luks-close device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2881
+#: ../fish/guestfish-actions.pod:2927
msgid ""
"This closes a LUKS device that was created earlier by L</luks-open> or L</"
"luks-open-ro>. The C<device> parameter must be the name of the LUKS mapping "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2887
+#: ../fish/guestfish-actions.pod:2933
msgid "luks-format"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2889
+#: ../fish/guestfish-actions.pod:2935
#, no-wrap
msgid ""
" luks-format device keyslot\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2891 ../src/guestfs-actions.pod:4458
+#: ../fish/guestfish-actions.pod:2937 ../src/guestfs-actions.pod:4505
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2899 ../fish/guestfish-actions.pod:2912
-#: ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3650
-#: ../fish/guestfish-actions.pod:4190 ../fish/guestfish-actions.pod:4527
-#: ../fish/guestfish-actions.pod:4550 ../fish/guestfish-actions.pod:4572
-#: ../fish/guestfish-actions.pod:5318 ../src/guestfs-actions.pod:4465
-#: ../src/guestfs-actions.pod:4488 ../src/guestfs-actions.pod:4631
-#: ../src/guestfs-actions.pod:5724 ../src/guestfs-actions.pod:6530
-#: ../src/guestfs-actions.pod:6981 ../src/guestfs-actions.pod:7011
-#: ../src/guestfs-actions.pod:7044 ../src/guestfs-actions.pod:8243
+#: ../fish/guestfish-actions.pod:2945 ../fish/guestfish-actions.pod:2958
+#: ../fish/guestfish-actions.pod:3045 ../fish/guestfish-actions.pod:3696
+#: ../fish/guestfish-actions.pod:4236 ../fish/guestfish-actions.pod:4573
+#: ../fish/guestfish-actions.pod:4596 ../fish/guestfish-actions.pod:4618
+#: ../fish/guestfish-actions.pod:5364 ../src/guestfs-actions.pod:4512
+#: ../src/guestfs-actions.pod:4535 ../src/guestfs-actions.pod:4678
+#: ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:6577
+#: ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7058
+#: ../src/guestfs-actions.pod:7091 ../src/guestfs-actions.pod:8290
msgid ""
"B<This command is dangerous. Without careful use you can easily destroy all "
"your data>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2902
+#: ../fish/guestfish-actions.pod:2948
msgid "luks-format-cipher"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2904
+#: ../fish/guestfish-actions.pod:2950
#, no-wrap
msgid ""
" luks-format-cipher device keyslot cipher\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2906
+#: ../fish/guestfish-actions.pod:2952
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:2915
+#: ../fish/guestfish-actions.pod:2961
msgid "luks-kill-slot"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2917
+#: ../fish/guestfish-actions.pod:2963
#, no-wrap
msgid ""
" luks-kill-slot device keyslot\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2919 ../src/guestfs-actions.pod:4505
+#: ../fish/guestfish-actions.pod:2965 ../src/guestfs-actions.pod:4552
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
-#: ../fish/guestfish-actions.pod:2926
+#: ../fish/guestfish-actions.pod:2972
msgid "luks-open"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2928
+#: ../fish/guestfish-actions.pod:2974
#, no-wrap
msgid ""
" luks-open device mapname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2930 ../src/guestfs-actions.pod:4525
+#: ../fish/guestfish-actions.pod:2976 ../src/guestfs-actions.pod:4572
msgid ""
"This command opens a block device which has been encrypted according to the "
"Linux Unified Key Setup (LUKS) standard."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2933 ../src/guestfs-actions.pod:4528
+#: ../fish/guestfish-actions.pod:2979 ../src/guestfs-actions.pod:4575
msgid "C<device> is the encrypted block device or partition."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4530
+#: ../fish/guestfish-actions.pod:2981 ../src/guestfs-actions.pod:4577
msgid ""
"The caller must supply one of the keys associated with the LUKS block "
"device, in the C<key> parameter."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2938 ../src/guestfs-actions.pod:4533
+#: ../fish/guestfish-actions.pod:2984 ../src/guestfs-actions.pod:4580
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2942
+#: ../fish/guestfish-actions.pod:2988
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: textblock
-#: ../fish/guestfish-actions.pod:2946
+#: ../fish/guestfish-actions.pod:2992
msgid "Use L</list-dm-devices> to list all device mapper devices."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2952
+#: ../fish/guestfish-actions.pod:2998
msgid "luks-open-ro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2954
+#: ../fish/guestfish-actions.pod:3000
#, no-wrap
msgid ""
" luks-open-ro device mapname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2956
+#: ../fish/guestfish-actions.pod:3002
msgid ""
"This is the same as L</luks-open> except that a read-only mapping is created."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2962
+#: ../fish/guestfish-actions.pod:3008
msgid "lvcreate"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2964
+#: ../fish/guestfish-actions.pod:3010
#, no-wrap
msgid ""
" lvcreate logvol volgroup mbytes\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2966 ../src/guestfs-actions.pod:4579
+#: ../fish/guestfish-actions.pod:3012 ../src/guestfs-actions.pod:4626
msgid ""
"This creates an LVM logical volume called C<logvol> on the volume group "
"C<volgroup>, with C<size> megabytes."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2969
+#: ../fish/guestfish-actions.pod:3015
msgid "lvm-canonical-lv-name"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2971
+#: ../fish/guestfish-actions.pod:3017
#, no-wrap
msgid ""
" lvm-canonical-lv-name lvname\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2973 ../src/guestfs-actions.pod:4592
+#: ../fish/guestfish-actions.pod:3019 ../src/guestfs-actions.pod:4639
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 C</dev/VG/"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2977 ../src/guestfs-actions.pod:4596
+#: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4643
msgid ""
"This command returns an error if the C<lvname> parameter does not refer to a "
"logical volume."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2980
+#: ../fish/guestfish-actions.pod:3026
msgid "See also L</is-lv>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2982
+#: ../fish/guestfish-actions.pod:3028
msgid "lvm-clear-filter"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2984
+#: ../fish/guestfish-actions.pod:3030
#, no-wrap
msgid ""
" lvm-clear-filter\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2986
+#: ../fish/guestfish-actions.pod:3032
msgid ""
"This undoes the effect of L</lvm-set-filter>. LVM will be able to see every "
"block device."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2989 ../fish/guestfish-actions.pod:3020
-#: ../src/guestfs-actions.pod:4614 ../src/guestfs-actions.pod:4656
+#: ../fish/guestfish-actions.pod:3035 ../fish/guestfish-actions.pod:3066
+#: ../src/guestfs-actions.pod:4661 ../src/guestfs-actions.pod:4703
msgid ""
"This command also clears the LVM cache and performs a volume group scan."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:2992
+#: ../fish/guestfish-actions.pod:3038
msgid "lvm-remove-all"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:2994
+#: ../fish/guestfish-actions.pod:3040
#, no-wrap
msgid ""
" lvm-remove-all\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:2996 ../src/guestfs-actions.pod:4626
+#: ../fish/guestfish-actions.pod:3042 ../src/guestfs-actions.pod:4673
msgid ""
"This command removes all LVM logical volumes, volume groups and physical "
"volumes."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3002
+#: ../fish/guestfish-actions.pod:3048
msgid "lvm-set-filter"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3004
+#: ../fish/guestfish-actions.pod:3050
#, no-wrap
msgid ""
" lvm-set-filter 'devices ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3006 ../src/guestfs-actions.pod:4642
+#: ../fish/guestfish-actions.pod:3052 ../src/guestfs-actions.pod:4689
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3010 ../src/guestfs-actions.pod:4646
+#: ../fish/guestfish-actions.pod:3056 ../src/guestfs-actions.pod:4693
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4659
+#: ../fish/guestfish-actions.pod:3069 ../src/guestfs-actions.pod:4706
msgid "You can filter whole block devices or individual partitions."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3025 ../src/guestfs-actions.pod:4661
+#: ../fish/guestfish-actions.pod:3071 ../src/guestfs-actions.pod:4708
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
-#: ../fish/guestfish-actions.pod:3029
+#: ../fish/guestfish-actions.pod:3075
msgid "lvremove"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3031
+#: ../fish/guestfish-actions.pod:3077
#, no-wrap
msgid ""
" lvremove device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3033 ../src/guestfs-actions.pod:4675
+#: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4722
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
-#: ../fish/guestfish-actions.pod:3036 ../src/guestfs-actions.pod:4678
+#: ../fish/guestfish-actions.pod:3082 ../src/guestfs-actions.pod:4725
msgid ""
"You can also remove all LVs in a volume group by specifying the VG name, C</"
"dev/VG>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3039
+#: ../fish/guestfish-actions.pod:3085
msgid "lvrename"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3041
+#: ../fish/guestfish-actions.pod:3087
#, no-wrap
msgid ""
" lvrename logvol newlogvol\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3043 ../src/guestfs-actions.pod:4692
+#: ../fish/guestfish-actions.pod:3089 ../src/guestfs-actions.pod:4739
msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3045
+#: ../fish/guestfish-actions.pod:3091
msgid "lvresize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3047
+#: ../fish/guestfish-actions.pod:3093
#, no-wrap
msgid ""
" lvresize device mbytes\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4705
+#: ../fish/guestfish-actions.pod:3095 ../src/guestfs-actions.pod:4752
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
-#: ../fish/guestfish-actions.pod:3053
+#: ../fish/guestfish-actions.pod:3099
msgid "lvresize-free"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3055
+#: ../fish/guestfish-actions.pod:3101
#, no-wrap
msgid ""
" lvresize-free lv percent\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3057 ../src/guestfs-actions.pod:4720
+#: ../fish/guestfish-actions.pod:3103 ../src/guestfs-actions.pod:4767
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3063
+#: ../fish/guestfish-actions.pod:3109
msgid "lvs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3065
+#: ../fish/guestfish-actions.pod:3111
#, no-wrap
msgid ""
" lvs\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3067 ../src/guestfs-actions.pod:4735
+#: ../fish/guestfish-actions.pod:3113 ../src/guestfs-actions.pod:4782
msgid ""
"List all the logical volumes detected. This is the equivalent of the L<lvs"
"(8)> command."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3070 ../src/guestfs-actions.pod:4738
+#: ../fish/guestfish-actions.pod:3116 ../src/guestfs-actions.pod:4785
msgid ""
"This returns a list of the logical volume device names (eg. C</dev/"
"VolGroup00/LogVol00>)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3073
+#: ../fish/guestfish-actions.pod:3119
msgid "See also L</lvs-full>, L</list-filesystems>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3075
+#: ../fish/guestfish-actions.pod:3121
msgid "lvs-full"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3077
+#: ../fish/guestfish-actions.pod:3123
#, no-wrap
msgid ""
" lvs-full\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3079 ../src/guestfs-actions.pod:4754
+#: ../fish/guestfish-actions.pod:3125 ../src/guestfs-actions.pod:4801
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: =head2
-#: ../fish/guestfish-actions.pod:3082
+#: ../fish/guestfish-actions.pod:3128
msgid "lvuuid"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3084
+#: ../fish/guestfish-actions.pod:3130
#, no-wrap
msgid ""
" lvuuid device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3086 ../src/guestfs-actions.pod:4769
+#: ../fish/guestfish-actions.pod:3132 ../src/guestfs-actions.pod:4816
msgid "This command returns the UUID of the LVM LV C<device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3088
+#: ../fish/guestfish-actions.pod:3134
msgid "lxattrlist"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3090
+#: ../fish/guestfish-actions.pod:3136
#, no-wrap
msgid ""
" lxattrlist path 'names ...'\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3092 ../src/guestfs-actions.pod:4783
+#: ../fish/guestfish-actions.pod:3138 ../src/guestfs-actions.pod:4830
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3096 ../src/guestfs-actions.pod:4787
+#: ../fish/guestfish-actions.pod:3142 ../src/guestfs-actions.pod:4834
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>. "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3106
+#: ../fish/guestfish-actions.pod:3152
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3114
+#: ../fish/guestfish-actions.pod:3160
msgid "mkdir"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3116
+#: ../fish/guestfish-actions.pod:3162
#, no-wrap
msgid ""
" mkdir path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3118 ../src/guestfs-actions.pod:4817
+#: ../fish/guestfish-actions.pod:3164 ../src/guestfs-actions.pod:4864
msgid "Create a directory named C<path>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3120
+#: ../fish/guestfish-actions.pod:3166
msgid "mkdir-mode"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3122
+#: ../fish/guestfish-actions.pod:3168
#, no-wrap
msgid ""
" mkdir-mode path mode\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4830
+#: ../fish/guestfish-actions.pod:3170 ../src/guestfs-actions.pod:4877
msgid ""
"This command creates a directory, setting the initial permissions of the "
"directory to C<mode>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4833
+#: ../fish/guestfish-actions.pod:3173 ../src/guestfs-actions.pod:4880
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3131
+#: ../fish/guestfish-actions.pod:3177
msgid "See also L</mkdir>, L</umask>"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3133
+#: ../fish/guestfish-actions.pod:3179
msgid "mkdir-p"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3135
+#: ../fish/guestfish-actions.pod:3181
#, no-wrap
msgid ""
" mkdir-p path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3137 ../src/guestfs-actions.pod:4849
+#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4896
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
-#: ../fish/guestfish-actions.pod:3140
+#: ../fish/guestfish-actions.pod:3186
msgid "mkdtemp"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3142
+#: ../fish/guestfish-actions.pod:3188
#, no-wrap
msgid ""
" mkdtemp template\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3144 ../src/guestfs-actions.pod:4862
+#: ../fish/guestfish-actions.pod:3190 ../src/guestfs-actions.pod:4909
msgid ""
"This command creates a temporary directory. The C<template> parameter "
"should be a full pathname for the temporary directory name with the final "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3149 ../src/guestfs-actions.pod:4867
+#: ../fish/guestfish-actions.pod:3195 ../src/guestfs-actions.pod:4914
msgid ""
"For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
"being suitable for Windows filesystems."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3152 ../src/guestfs-actions.pod:4870
+#: ../fish/guestfish-actions.pod:3198 ../src/guestfs-actions.pod:4917
msgid "The name of the temporary directory that was created is returned."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3155 ../src/guestfs-actions.pod:4873
+#: ../fish/guestfish-actions.pod:3201 ../src/guestfs-actions.pod:4920
msgid "The temporary directory is created with mode 0700 and is owned by root."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3158 ../src/guestfs-actions.pod:4876
+#: ../fish/guestfish-actions.pod:3204 ../src/guestfs-actions.pod:4923
msgid ""
"The caller is responsible for deleting the temporary directory and its "
"contents after use."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3161 ../src/guestfs-actions.pod:4879
+#: ../fish/guestfish-actions.pod:3207 ../src/guestfs-actions.pod:4926
msgid "See also: L<mkdtemp(3)>"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3163
+#: ../fish/guestfish-actions.pod:3209
msgid "mke2fs-J"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3165
+#: ../fish/guestfish-actions.pod:3211
#, no-wrap
msgid ""
" mke2fs-J fstype blocksize device journal\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3167 ../src/guestfs-actions.pod:4895
+#: ../fish/guestfish-actions.pod:3213 ../src/guestfs-actions.pod:4942
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
-#: ../fish/guestfish-actions.pod:3171 ../src/guestfs-actions.pod:4899
+#: ../fish/guestfish-actions.pod:3217 ../src/guestfs-actions.pod:4946
#, no-wrap
msgid ""
" mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3173
+#: ../fish/guestfish-actions.pod:3219
msgid "See also L</mke2journal>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3175
+#: ../fish/guestfish-actions.pod:3221
msgid "mke2fs-JL"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3177
+#: ../fish/guestfish-actions.pod:3223
#, no-wrap
msgid ""
" mke2fs-JL fstype blocksize device label\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3179 ../src/guestfs-actions.pod:4916
+#: ../fish/guestfish-actions.pod:3225 ../src/guestfs-actions.pod:4963
msgid ""
"This creates an ext2/3/4 filesystem on C<device> with an external journal on "
"the journal labeled C<label>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3182
+#: ../fish/guestfish-actions.pod:3228
msgid "See also L</mke2journal-L>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3184
+#: ../fish/guestfish-actions.pod:3230
msgid "mke2fs-JU"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3186
+#: ../fish/guestfish-actions.pod:3232
#, no-wrap
msgid ""
" mke2fs-JU fstype blocksize device uuid\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3188 ../src/guestfs-actions.pod:4934
+#: ../fish/guestfish-actions.pod:3234 ../src/guestfs-actions.pod:4981
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
-#: ../fish/guestfish-actions.pod:3191
+#: ../fish/guestfish-actions.pod:3237
msgid "See also L</mke2journal-U>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3193
+#: ../fish/guestfish-actions.pod:3239
msgid "mke2journal"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3195
+#: ../fish/guestfish-actions.pod:3241
#, no-wrap
msgid ""
" mke2journal blocksize device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3197 ../src/guestfs-actions.pod:4950
+#: ../fish/guestfish-actions.pod:3243 ../src/guestfs-actions.pod:4997
msgid ""
"This creates an ext2 external journal on C<device>. It is equivalent to the "
"command:"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4953
+#: ../fish/guestfish-actions.pod:3246 ../src/guestfs-actions.pod:5000
#, no-wrap
msgid ""
" mke2fs -O journal_dev -b blocksize device\n"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3202
+#: ../fish/guestfish-actions.pod:3248
msgid "mke2journal-L"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3204
+#: ../fish/guestfish-actions.pod:3250
#, no-wrap
msgid ""
" mke2journal-L blocksize label device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3206 ../src/guestfs-actions.pod:4967
+#: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:5014
msgid "This creates an ext2 external journal on C<device> with label C<label>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3208
+#: ../fish/guestfish-actions.pod:3254
msgid "mke2journal-U"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3210
+#: ../fish/guestfish-actions.pod:3256
#, no-wrap
msgid ""
" mke2journal-U blocksize uuid device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3212 ../src/guestfs-actions.pod:4981
+#: ../fish/guestfish-actions.pod:3258 ../src/guestfs-actions.pod:5028
msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3214
+#: ../fish/guestfish-actions.pod:3260
msgid "mkfifo"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3216
+#: ../fish/guestfish-actions.pod:3262
#, no-wrap
msgid ""
" mkfifo mode path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3218
+#: ../fish/guestfish-actions.pod:3264
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:3224
+#: ../fish/guestfish-actions.pod:3270
msgid "mkfs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3226
+#: ../fish/guestfish-actions.pod:3272
#, no-wrap
msgid ""
" mkfs fstype device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3228 ../src/guestfs-actions.pod:5011
+#: ../fish/guestfish-actions.pod:3274 ../src/guestfs-actions.pod:5058
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
-#: ../fish/guestfish-actions.pod:3232
+#: ../fish/guestfish-actions.pod:3278
msgid "mkfs-b"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3234
+#: ../fish/guestfish-actions.pod:3280
#, no-wrap
msgid ""
" mkfs-b fstype blocksize device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3236
+#: ../fish/guestfish-actions.pod:3282
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3241 ../fish/guestfish-actions.pod:3268
-#: ../src/guestfs-actions.pod:5039 ../src/guestfs-actions.pod:5077
+#: ../fish/guestfish-actions.pod:3287 ../fish/guestfish-actions.pod:3314
+#: ../src/guestfs-actions.pod:5086 ../src/guestfs-actions.pod:5124
msgid ""
"For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
"cluster size."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3244
+#: ../fish/guestfish-actions.pod:3290
msgid ""
"I<This function is deprecated.> In new code, use the L</mkfs_opts> call "
"instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3251
+#: ../fish/guestfish-actions.pod:3297
msgid "mkfs-opts"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3253
+#: ../fish/guestfish-actions.pod:3299
#, no-wrap
msgid ""
" mkfs-opts fstype device [blocksize:..] [features:..] [inode:..] [sectorsize:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3255 ../src/guestfs-actions.pod:5064
+#: ../fish/guestfish-actions.pod:3301 ../src/guestfs-actions.pod:5111
msgid ""
"This function creates a filesystem on C<device>. The filesystem type is "
"C<fstype>, for example C<ext3>."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3262 ../src/guestfs-actions.pod:5071
+#: ../fish/guestfish-actions.pod:3308 ../src/guestfs-actions.pod:5118
msgid "C<blocksize>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3264 ../src/guestfs-actions.pod:5073
+#: ../fish/guestfish-actions.pod:3310 ../src/guestfs-actions.pod:5120
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3271 ../src/guestfs-actions.pod:5080
+#: ../fish/guestfish-actions.pod:3317 ../src/guestfs-actions.pod:5127
msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3273 ../src/guestfs-actions.pod:5082
+#: ../fish/guestfish-actions.pod:3319 ../src/guestfs-actions.pod:5129
msgid "C<features>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3275 ../src/guestfs-actions.pod:5084
+#: ../fish/guestfish-actions.pod:3321 ../src/guestfs-actions.pod:5131
msgid "This passes the I<-O> parameter to the external mkfs program."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3277 ../src/guestfs-actions.pod:5086
+#: ../fish/guestfish-actions.pod:3323 ../src/guestfs-actions.pod:5133
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
-#: ../fish/guestfish-actions.pod:3281 ../src/guestfs-actions.pod:5090
+#: ../fish/guestfish-actions.pod:3327 ../src/guestfs-actions.pod:5137
msgid ""
"You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
"type."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3284 ../src/guestfs-actions.pod:5093
+#: ../fish/guestfish-actions.pod:3330 ../src/guestfs-actions.pod:5140
msgid "C<inode>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3286 ../src/guestfs-actions.pod:5095
+#: ../fish/guestfish-actions.pod:3332 ../src/guestfs-actions.pod:5142
msgid ""
"This passes the I<-I> parameter to the external L<mke2fs(8)> program which "
"sets the inode size (only for ext2/3/4 filesystems at present)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5098
+#: ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:5145
msgid "C<sectorsize>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3291 ../src/guestfs-actions.pod:5100
+#: ../fish/guestfish-actions.pod:3337 ../src/guestfs-actions.pod:5147
msgid ""
"This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which "
"sets sector size for ufs filesystem."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3298
+#: ../fish/guestfish-actions.pod:3344
msgid "mkmountpoint"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3300
+#: ../fish/guestfish-actions.pod:3346
#, no-wrap
msgid ""
" mkmountpoint exemptpath\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3302
+#: ../fish/guestfish-actions.pod:3348
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:3306 ../src/guestfs-actions.pod:5143
+#: ../fish/guestfish-actions.pod:3352 ../src/guestfs-actions.pod:5190
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3310 ../src/guestfs-actions.pod:5147
+#: ../fish/guestfish-actions.pod:3356 ../src/guestfs-actions.pod:5194
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 "
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3315 ../src/guestfs-actions.pod:5152
+#: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5199
#, no-wrap
msgid ""
" add-ro Fedora-11-i686-Live.iso\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3324 ../src/guestfs-actions.pod:5161
+#: ../fish/guestfish-actions.pod:3370 ../src/guestfs-actions.pod:5208
msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3326
+#: ../fish/guestfish-actions.pod:3372
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3330
+#: ../fish/guestfish-actions.pod:3376
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3335 ../src/guestfs-actions.pod:5172
+#: ../fish/guestfish-actions.pod:3381 ../src/guestfs-actions.pod:5219
msgid ""
"For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3337
+#: ../fish/guestfish-actions.pod:3383
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3341
+#: ../fish/guestfish-actions.pod:3387
msgid "mknod"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3343
+#: ../fish/guestfish-actions.pod:3389
#, no-wrap
msgid ""
" mknod mode devmajor devminor path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3345 ../src/guestfs-actions.pod:5191
+#: ../fish/guestfish-actions.pod:3391 ../src/guestfs-actions.pod:5238
msgid ""
"This call creates block or character special devices, or named pipes (FIFOs)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3348 ../src/guestfs-actions.pod:5194
+#: ../fish/guestfish-actions.pod:3394 ../src/guestfs-actions.pod:5241
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3353
+#: ../fish/guestfish-actions.pod:3399
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3363
+#: ../fish/guestfish-actions.pod:3409
msgid "mknod-b"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3365
+#: ../fish/guestfish-actions.pod:3411
#, no-wrap
msgid ""
" mknod-b mode devmajor devminor path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3367
+#: ../fish/guestfish-actions.pod:3413
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3373
+#: ../fish/guestfish-actions.pod:3419
msgid "mknod-c"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3375
+#: ../fish/guestfish-actions.pod:3421
#, no-wrap
msgid ""
" mknod-c mode devmajor devminor path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3377
+#: ../fish/guestfish-actions.pod:3423
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3383
+#: ../fish/guestfish-actions.pod:3429
msgid "mkswap"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3385
+#: ../fish/guestfish-actions.pod:3431
#, no-wrap
msgid ""
" mkswap device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5257
+#: ../fish/guestfish-actions.pod:3433 ../src/guestfs-actions.pod:5304
msgid "Create a swap partition on C<device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3389
+#: ../fish/guestfish-actions.pod:3435
msgid "mkswap-L"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3391
+#: ../fish/guestfish-actions.pod:3437
#, no-wrap
msgid ""
" mkswap-L label device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3393 ../src/guestfs-actions.pod:5270
+#: ../fish/guestfish-actions.pod:3439 ../src/guestfs-actions.pod:5317
msgid "Create a swap partition on C<device> with label C<label>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3395 ../src/guestfs-actions.pod:5272
+#: ../fish/guestfish-actions.pod:3441 ../src/guestfs-actions.pod:5319
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 the kernel "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3399
+#: ../fish/guestfish-actions.pod:3445
msgid "mkswap-U"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3401
+#: ../fish/guestfish-actions.pod:3447
#, no-wrap
msgid ""
" mkswap-U uuid device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3403 ../src/guestfs-actions.pod:5287
+#: ../fish/guestfish-actions.pod:3449 ../src/guestfs-actions.pod:5334
msgid "Create a swap partition on C<device> with UUID C<uuid>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3405
+#: ../fish/guestfish-actions.pod:3451
msgid "mkswap-file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3407
+#: ../fish/guestfish-actions.pod:3453
#, no-wrap
msgid ""
" mkswap-file path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3409 ../src/guestfs-actions.pod:5299
+#: ../fish/guestfish-actions.pod:3455 ../src/guestfs-actions.pod:5346
msgid "Create a swap file."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3411
+#: ../fish/guestfish-actions.pod:3457
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:3414
+#: ../fish/guestfish-actions.pod:3460
msgid "modprobe"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3416
+#: ../fish/guestfish-actions.pod:3462
#, no-wrap
msgid ""
" modprobe modulename\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3418 ../src/guestfs-actions.pod:5314
+#: ../fish/guestfish-actions.pod:3464 ../src/guestfs-actions.pod:5361
msgid "This loads a kernel module in the appliance."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3420 ../src/guestfs-actions.pod:5316
+#: ../fish/guestfish-actions.pod:3466 ../src/guestfs-actions.pod:5363
msgid ""
"The kernel module must have been whitelisted when libguestfs was built (see "
"C<appliance/kmod.whitelist.in> in the source)."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3423
+#: ../fish/guestfish-actions.pod:3469
msgid "mount"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3425
+#: ../fish/guestfish-actions.pod:3471
#, no-wrap
msgid ""
" mount device mountpoint\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3427 ../src/guestfs-actions.pod:5330
+#: ../fish/guestfish-actions.pod:3473 ../src/guestfs-actions.pod:5377
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3433 ../src/guestfs-actions.pod:5336
+#: ../fish/guestfish-actions.pod:3479 ../src/guestfs-actions.pod:5383
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3438 ../src/guestfs-actions.pod:5341
+#: ../fish/guestfish-actions.pod:3484 ../src/guestfs-actions.pod:5388
msgid ""
"The mounted filesystem is writable, if we have sufficient permissions on the "
"underlying device."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3441
+#: ../fish/guestfish-actions.pod:3487
msgid ""
"Before libguestfs 1.13.16, this call implicitly added the options C<sync> "
"and C<noatime>. The C<sync> option greatly slowed writes and caused many "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3448
+#: ../fish/guestfish-actions.pod:3494
msgid "mount-9p"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3450
+#: ../fish/guestfish-actions.pod:3496
#, no-wrap
msgid ""
" mount-9p mounttag mountpoint [options:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3452 ../src/guestfs-actions.pod:5370
+#: ../fish/guestfish-actions.pod:3498 ../src/guestfs-actions.pod:5417
msgid ""
"Mount the virtio-9p filesystem with the tag C<mounttag> on the directory "
"C<mountpoint>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3455 ../src/guestfs-actions.pod:5373
+#: ../fish/guestfish-actions.pod:3501 ../src/guestfs-actions.pod:5420
msgid ""
"If required, C<trans=virtio> will be automatically added to the options. "
"Any other options required can be passed in the optional C<options> "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3461
+#: ../fish/guestfish-actions.pod:3507
msgid "mount-loop"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3463
+#: ../fish/guestfish-actions.pod:3509
#, no-wrap
msgid ""
" mount-loop file mountpoint\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3465 ../src/guestfs-actions.pod:5412
+#: ../fish/guestfish-actions.pod:3511 ../src/guestfs-actions.pod:5459
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3469
+#: ../fish/guestfish-actions.pod:3515
msgid "mount-options"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3471
+#: ../fish/guestfish-actions.pod:3517
#, no-wrap
msgid ""
" mount-options options device mountpoint\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3473
+#: ../fish/guestfish-actions.pod:3519
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: textblock
-#: ../fish/guestfish-actions.pod:3477 ../src/guestfs-actions.pod:5432
+#: ../fish/guestfish-actions.pod:3523 ../src/guestfs-actions.pod:5479
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: =head2
-#: ../fish/guestfish-actions.pod:3481
+#: ../fish/guestfish-actions.pod:3527
msgid "mount-ro"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3483
+#: ../fish/guestfish-actions.pod:3529
#, no-wrap
msgid ""
" mount-ro device mountpoint\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3485
+#: ../fish/guestfish-actions.pod:3531
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:3488
+#: ../fish/guestfish-actions.pod:3534
msgid "mount-vfs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3490
+#: ../fish/guestfish-actions.pod:3536
#, no-wrap
msgid ""
" mount-vfs options vfstype device mountpoint\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3492
+#: ../fish/guestfish-actions.pod:3538
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:3496
+#: ../fish/guestfish-actions.pod:3542
msgid "mountpoints"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3498
+#: ../fish/guestfish-actions.pod:3544
#, no-wrap
msgid ""
" mountpoints\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3500
+#: ../fish/guestfish-actions.pod:3546
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3504
+#: ../fish/guestfish-actions.pod:3550
msgid "mounts"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3506
+#: ../fish/guestfish-actions.pod:3552
#, no-wrap
msgid ""
" mounts\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3508 ../src/guestfs-actions.pod:5493
+#: ../fish/guestfish-actions.pod:3554 ../src/guestfs-actions.pod:5540
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
-#: ../fish/guestfish-actions.pod:3511 ../src/guestfs-actions.pod:5496
+#: ../fish/guestfish-actions.pod:3557 ../src/guestfs-actions.pod:5543
msgid "Some internal mounts are not shown."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3513
+#: ../fish/guestfish-actions.pod:3559
msgid "See also: L</mountpoints>"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3515
+#: ../fish/guestfish-actions.pod:3561
msgid "mv"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3517
+#: ../fish/guestfish-actions.pod:3563
#, no-wrap
msgid ""
" mv src dest\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3519 ../src/guestfs-actions.pod:5513
+#: ../fish/guestfish-actions.pod:3565 ../src/guestfs-actions.pod:5560
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
-#: ../fish/guestfish-actions.pod:3522
+#: ../fish/guestfish-actions.pod:3568
msgid "ntfs-3g-probe"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3524
+#: ../fish/guestfish-actions.pod:3570
#, no-wrap
msgid ""
" ntfs-3g-probe true|false device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3526 ../src/guestfs-actions.pod:5527
+#: ../fish/guestfish-actions.pod:3572 ../src/guestfs-actions.pod:5574
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 read-"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5531
+#: ../fish/guestfish-actions.pod:3576 ../src/guestfs-actions.pod:5578
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3534 ../src/guestfs-actions.pod:5535
+#: ../fish/guestfish-actions.pod:3580 ../src/guestfs-actions.pod:5582
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: =head2
-#: ../fish/guestfish-actions.pod:3538
+#: ../fish/guestfish-actions.pod:3584
msgid "ntfsresize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3540
+#: ../fish/guestfish-actions.pod:3586
#, no-wrap
msgid ""
" ntfsresize device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3542 ../fish/guestfish-actions.pod:3566
-#: ../src/guestfs-actions.pod:5556 ../src/guestfs-actions.pod:5588
+#: ../fish/guestfish-actions.pod:3588 ../fish/guestfish-actions.pod:3612
+#: ../src/guestfs-actions.pod:5603 ../src/guestfs-actions.pod:5635
msgid ""
"This command resizes an NTFS filesystem, expanding or shrinking it to the "
"size of the underlying device."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3545 ../src/guestfs-actions.pod:5559
+#: ../fish/guestfish-actions.pod:3591 ../src/guestfs-actions.pod:5606
msgid ""
"I<Note:> After the resize operation, the filesystem is marked as requiring a "
"consistency check (for safety). You have to boot into Windows to perform "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3553 ../fish/guestfish-actions.pod:3592
-#: ../src/guestfs-actions.pod:5567 ../src/guestfs-actions.pod:5614
+#: ../fish/guestfish-actions.pod:3599 ../fish/guestfish-actions.pod:3638
+#: ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:5661
msgid "See also L<ntfsresize(8)>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3555 ../fish/guestfish-actions.pod:3603
+#: ../fish/guestfish-actions.pod:3601 ../fish/guestfish-actions.pod:3649
msgid ""
"I<This function is deprecated.> In new code, use the L</ntfsresize_opts> "
"call instead."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3562
+#: ../fish/guestfish-actions.pod:3608
msgid "ntfsresize-opts"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3564
+#: ../fish/guestfish-actions.pod:3610
#, no-wrap
msgid ""
" ntfsresize-opts device [size:..] [force:..]\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3575 ../src/guestfs-actions.pod:5597
+#: ../fish/guestfish-actions.pod:3621 ../src/guestfs-actions.pod:5644
msgid ""
"The new size (in bytes) of the filesystem. If omitted, the filesystem is "
"resized to fit the container (eg. partition)."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3578 ../src/guestfs-actions.pod:5600
+#: ../fish/guestfish-actions.pod:3624 ../src/guestfs-actions.pod:5647
msgid "C<force>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3580 ../src/guestfs-actions.pod:5602
+#: ../fish/guestfish-actions.pod:3626 ../src/guestfs-actions.pod:5649
msgid ""
"If this option is true, then force the resize of the filesystem even if the "
"filesystem is marked as requiring a consistency check."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3583
+#: ../fish/guestfish-actions.pod:3629
msgid ""
"After the resize operation, the filesystem is always marked as requiring a "
"consistency check (for safety). You have to boot into Windows to perform "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3596
+#: ../fish/guestfish-actions.pod:3642
msgid "ntfsresize-size"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3598
+#: ../fish/guestfish-actions.pod:3644
#, no-wrap
msgid ""
" ntfsresize-size device size\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3600
+#: ../fish/guestfish-actions.pod:3646
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:3610
+#: ../fish/guestfish-actions.pod:3656
msgid "part-add"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3612
+#: ../fish/guestfish-actions.pod:3658
#, no-wrap
msgid ""
" part-add device prlogex startsect endsect\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3614
+#: ../fish/guestfish-actions.pod:3660
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:3617 ../src/guestfs-actions.pod:5675
+#: ../fish/guestfish-actions.pod:3663 ../src/guestfs-actions.pod:5722
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3622 ../src/guestfs-actions.pod:5680
+#: ../fish/guestfish-actions.pod:3668 ../src/guestfs-actions.pod:5727
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3626
+#: ../fish/guestfish-actions.pod:3672
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:3629
+#: ../fish/guestfish-actions.pod:3675
msgid "part-del"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3631
+#: ../fish/guestfish-actions.pod:3677
#, no-wrap
msgid ""
" part-del device partnum\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3633 ../src/guestfs-actions.pod:5698
+#: ../fish/guestfish-actions.pod:3679 ../src/guestfs-actions.pod:5745
msgid "This command deletes the partition numbered C<partnum> on C<device>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3635 ../src/guestfs-actions.pod:5700
+#: ../fish/guestfish-actions.pod:3681 ../src/guestfs-actions.pod:5747
msgid ""
"Note that in the case of MBR partitioning, deleting an extended partition "
"also deletes any logical partitions it contains."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3639
+#: ../fish/guestfish-actions.pod:3685
msgid "part-disk"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3641
+#: ../fish/guestfish-actions.pod:3687
#, no-wrap
msgid ""
" part-disk device parttype\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3643
+#: ../fish/guestfish-actions.pod:3689
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:3647
+#: ../fish/guestfish-actions.pod:3693
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:3653
+#: ../fish/guestfish-actions.pod:3699
msgid "part-get-bootable"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3655
+#: ../fish/guestfish-actions.pod:3701
#, no-wrap
msgid ""
" part-get-bootable device partnum\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3657 ../src/guestfs-actions.pod:5736
+#: ../fish/guestfish-actions.pod:3703 ../src/guestfs-actions.pod:5783
msgid ""
"This command returns true if the partition C<partnum> on C<device> has the "
"bootable flag set."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3660
+#: ../fish/guestfish-actions.pod:3706
msgid "See also L</part-set-bootable>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3662
+#: ../fish/guestfish-actions.pod:3708
msgid "part-get-mbr-id"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3664
+#: ../fish/guestfish-actions.pod:3710
#, no-wrap
msgid ""
" part-get-mbr-id device partnum\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3666 ../src/guestfs-actions.pod:5752
+#: ../fish/guestfish-actions.pod:3712 ../src/guestfs-actions.pod:5799
msgid ""
"Returns the MBR type byte (also known as the ID byte) from the numbered "
"partition C<partnum>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3669 ../fish/guestfish-actions.pod:3813
+#: ../fish/guestfish-actions.pod:3715 ../fish/guestfish-actions.pod:3859
msgid ""
"Note that only MBR (old DOS-style) partitions have type bytes. You will get "
"undefined results for other partition table types (see L</part-get-"
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3673
+#: ../fish/guestfish-actions.pod:3719
msgid "part-get-parttype"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3675
+#: ../fish/guestfish-actions.pod:3721
#, no-wrap
msgid ""
" part-get-parttype device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3677 ../src/guestfs-actions.pod:5769
+#: ../fish/guestfish-actions.pod:3723 ../src/guestfs-actions.pod:5816
msgid ""
"This command examines the partition table on C<device> and returns the "
"partition table type (format) being used."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3680
+#: ../fish/guestfish-actions.pod:3726
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3685
+#: ../fish/guestfish-actions.pod:3731
msgid "part-init"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3687
+#: ../fish/guestfish-actions.pod:3733
#, no-wrap
msgid ""
" part-init device parttype\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3689 ../src/guestfs-actions.pod:5789
+#: ../fish/guestfish-actions.pod:3735 ../src/guestfs-actions.pod:5836
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> "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3693
+#: ../fish/guestfish-actions.pod:3739
msgid ""
"Initially there are no partitions. Following this, you should call L</part-"
"add> for each partition required."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3696 ../src/guestfs-actions.pod:5796
+#: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5843
msgid "Possible values for C<parttype> are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3700 ../src/guestfs-actions.pod:5800
+#: ../fish/guestfish-actions.pod:3746 ../src/guestfs-actions.pod:5847
msgid "B<efi>"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3702 ../src/guestfs-actions.pod:5802
+#: ../fish/guestfish-actions.pod:3748 ../src/guestfs-actions.pod:5849
msgid "B<gpt>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3704 ../src/guestfs-actions.pod:5804
+#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5851
msgid "Intel EFI / GPT partition table."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3706 ../src/guestfs-actions.pod:5806
+#: ../fish/guestfish-actions.pod:3752 ../src/guestfs-actions.pod:5853
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 "
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3710 ../src/guestfs-actions.pod:5810
+#: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5857
msgid "B<mbr>"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3712 ../src/guestfs-actions.pod:5812
+#: ../fish/guestfish-actions.pod:3758 ../src/guestfs-actions.pod:5859
msgid "B<msdos>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3714 ../src/guestfs-actions.pod:5814
+#: ../fish/guestfish-actions.pod:3760 ../src/guestfs-actions.pod:5861
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3721 ../src/guestfs-actions.pod:5821
+#: ../fish/guestfish-actions.pod:3767 ../src/guestfs-actions.pod:5868
msgid ""
"Other partition table types that may work but are not supported include:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3726 ../src/guestfs-actions.pod:5826
+#: ../fish/guestfish-actions.pod:3772 ../src/guestfs-actions.pod:5873
msgid "B<aix>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3728 ../src/guestfs-actions.pod:5828
+#: ../fish/guestfish-actions.pod:3774 ../src/guestfs-actions.pod:5875
msgid "AIX disk labels."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3730 ../src/guestfs-actions.pod:5830
+#: ../fish/guestfish-actions.pod:3776 ../src/guestfs-actions.pod:5877
msgid "B<amiga>"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3732 ../src/guestfs-actions.pod:5832
+#: ../fish/guestfish-actions.pod:3778 ../src/guestfs-actions.pod:5879
msgid "B<rdb>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3734 ../src/guestfs-actions.pod:5834
+#: ../fish/guestfish-actions.pod:3780 ../src/guestfs-actions.pod:5881
msgid "Amiga \"Rigid Disk Block\" format."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3736 ../src/guestfs-actions.pod:5836
+#: ../fish/guestfish-actions.pod:3782 ../src/guestfs-actions.pod:5883
msgid "B<bsd>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3738 ../src/guestfs-actions.pod:5838
+#: ../fish/guestfish-actions.pod:3784 ../src/guestfs-actions.pod:5885
msgid "BSD disk labels."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3740 ../src/guestfs-actions.pod:5840
+#: ../fish/guestfish-actions.pod:3786 ../src/guestfs-actions.pod:5887
msgid "B<dasd>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5842
+#: ../fish/guestfish-actions.pod:3788 ../src/guestfs-actions.pod:5889
msgid "DASD, used on IBM mainframes."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3744 ../src/guestfs-actions.pod:5844
+#: ../fish/guestfish-actions.pod:3790 ../src/guestfs-actions.pod:5891
msgid "B<dvh>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3746 ../src/guestfs-actions.pod:5846
+#: ../fish/guestfish-actions.pod:3792 ../src/guestfs-actions.pod:5893
msgid "MIPS/SGI volumes."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3748 ../src/guestfs-actions.pod:5848
+#: ../fish/guestfish-actions.pod:3794 ../src/guestfs-actions.pod:5895
msgid "B<mac>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3750 ../src/guestfs-actions.pod:5850
+#: ../fish/guestfish-actions.pod:3796 ../src/guestfs-actions.pod:5897
msgid "Old Mac partition format. Modern Macs use C<gpt>."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3752 ../src/guestfs-actions.pod:5852
+#: ../fish/guestfish-actions.pod:3798 ../src/guestfs-actions.pod:5899
msgid "B<pc98>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3754 ../src/guestfs-actions.pod:5854
+#: ../fish/guestfish-actions.pod:3800 ../src/guestfs-actions.pod:5901
msgid "NEC PC-98 format, common in Japan apparently."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3756 ../src/guestfs-actions.pod:5856
+#: ../fish/guestfish-actions.pod:3802 ../src/guestfs-actions.pod:5903
msgid "B<sun>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3758 ../src/guestfs-actions.pod:5858
+#: ../fish/guestfish-actions.pod:3804 ../src/guestfs-actions.pod:5905
msgid "Sun disk labels."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3762
+#: ../fish/guestfish-actions.pod:3808
msgid "part-list"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3764
+#: ../fish/guestfish-actions.pod:3810
#, no-wrap
msgid ""
" part-list device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3766 ../src/guestfs-actions.pod:5872
+#: ../fish/guestfish-actions.pod:3812 ../src/guestfs-actions.pod:5919
msgid ""
"This command parses the partition table on C<device> and returns the list of "
"partitions found."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3769 ../src/guestfs-actions.pod:5875
+#: ../fish/guestfish-actions.pod:3815 ../src/guestfs-actions.pod:5922
msgid "The fields in the returned structure are:"
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3773 ../src/guestfs-actions.pod:5879
+#: ../fish/guestfish-actions.pod:3819 ../src/guestfs-actions.pod:5926
msgid "B<part_num>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3775 ../src/guestfs-actions.pod:5881
+#: ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5928
msgid "Partition number, counting from 1."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3777 ../src/guestfs-actions.pod:5883
+#: ../fish/guestfish-actions.pod:3823 ../src/guestfs-actions.pod:5930
msgid "B<part_start>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3779
+#: ../fish/guestfish-actions.pod:3825
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: =item
-#: ../fish/guestfish-actions.pod:3782 ../src/guestfs-actions.pod:5888
+#: ../fish/guestfish-actions.pod:3828 ../src/guestfs-actions.pod:5935
msgid "B<part_end>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3784 ../src/guestfs-actions.pod:5890
+#: ../fish/guestfish-actions.pod:3830 ../src/guestfs-actions.pod:5937
msgid "End of the partition in bytes."
msgstr ""
#. type: =item
-#: ../fish/guestfish-actions.pod:3786 ../src/guestfs-actions.pod:5892
+#: ../fish/guestfish-actions.pod:3832 ../src/guestfs-actions.pod:5939
msgid "B<part_size>"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3788 ../src/guestfs-actions.pod:5894
+#: ../fish/guestfish-actions.pod:3834 ../src/guestfs-actions.pod:5941
msgid "Size of the partition in bytes."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3792
+#: ../fish/guestfish-actions.pod:3838
msgid "part-set-bootable"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3794
+#: ../fish/guestfish-actions.pod:3840
#, no-wrap
msgid ""
" part-set-bootable device partnum true|false\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3796 ../src/guestfs-actions.pod:5912
+#: ../fish/guestfish-actions.pod:3842 ../src/guestfs-actions.pod:5959
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
-#: ../fish/guestfish-actions.pod:3799 ../src/guestfs-actions.pod:5915
+#: ../fish/guestfish-actions.pod:3845 ../src/guestfs-actions.pod:5962
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3803
+#: ../fish/guestfish-actions.pod:3849
msgid "part-set-mbr-id"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3805
+#: ../fish/guestfish-actions.pod:3851
#, no-wrap
msgid ""
" part-set-mbr-id device partnum idbyte\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3807 ../src/guestfs-actions.pod:5931
+#: ../fish/guestfish-actions.pod:3853 ../src/guestfs-actions.pod:5978
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3817
+#: ../fish/guestfish-actions.pod:3863
msgid "part-set-name"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3819
+#: ../fish/guestfish-actions.pod:3865
#, no-wrap
msgid ""
" part-set-name device partnum name\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3821 ../src/guestfs-actions.pod:5953
+#: ../fish/guestfish-actions.pod:3867 ../src/guestfs-actions.pod:6000
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
-#: ../fish/guestfish-actions.pod:3824 ../src/guestfs-actions.pod:5956
+#: ../fish/guestfish-actions.pod:3870 ../src/guestfs-actions.pod:6003
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
-#: ../fish/guestfish-actions.pod:3827
+#: ../fish/guestfish-actions.pod:3873
msgid "part-to-dev"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3829
+#: ../fish/guestfish-actions.pod:3875
#, no-wrap
msgid ""
" part-to-dev partition\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3831 ../src/guestfs-actions.pod:5969
+#: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:6016
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
-#: ../fish/guestfish-actions.pod:3835 ../fish/guestfish-actions.pod:3847
+#: ../fish/guestfish-actions.pod:3881 ../fish/guestfish-actions.pod:3893
msgid ""
"The named partition must exist, for example as a string returned from L</"
"list-partitions>."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3838
+#: ../fish/guestfish-actions.pod:3884
msgid "See also L</part-to-partnum>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3840
+#: ../fish/guestfish-actions.pod:3886
msgid "part-to-partnum"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3842
+#: ../fish/guestfish-actions.pod:3888
#, no-wrap
msgid ""
" part-to-partnum partition\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:5989
+#: ../fish/guestfish-actions.pod:3890 ../src/guestfs-actions.pod:6036
msgid ""
"This function takes a partition name (eg. \"/dev/sdb1\") and returns the "
"partition number (eg. C<1>)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3850
+#: ../fish/guestfish-actions.pod:3896
msgid "See also L</part-to-dev>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3852
+#: ../fish/guestfish-actions.pod:3898
msgid "ping-daemon"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3854
+#: ../fish/guestfish-actions.pod:3900
#, no-wrap
msgid ""
" ping-daemon\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3856 ../src/guestfs-actions.pod:6004
+#: ../fish/guestfish-actions.pod:3902 ../src/guestfs-actions.pod:6051
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3861
+#: ../fish/guestfish-actions.pod:3907
msgid "pread"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3863
+#: ../fish/guestfish-actions.pod:3909
#, no-wrap
msgid ""
" pread path count offset\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3865 ../src/guestfs-actions.pod:6022
+#: ../fish/guestfish-actions.pod:3911 ../src/guestfs-actions.pod:6069
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
-#: ../fish/guestfish-actions.pod:3868 ../fish/guestfish-actions.pod:3883
-#: ../src/guestfs-actions.pod:6025 ../src/guestfs-actions.pod:6051
+#: ../fish/guestfish-actions.pod:3914 ../fish/guestfish-actions.pod:3929
+#: ../src/guestfs-actions.pod:6072 ../src/guestfs-actions.pod:6098
msgid ""
"This may read fewer bytes than requested. For further details see the "
"L<pread(2)> system call."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3871
+#: ../fish/guestfish-actions.pod:3917
msgid "See also L</pwrite>, L</pread-device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3876
+#: ../fish/guestfish-actions.pod:3922
msgid "pread-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3878
+#: ../fish/guestfish-actions.pod:3924
#, no-wrap
msgid ""
" pread-device device count offset\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3880 ../src/guestfs-actions.pod:6048
+#: ../fish/guestfish-actions.pod:3926 ../src/guestfs-actions.pod:6095
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
-#: ../fish/guestfish-actions.pod:3886
+#: ../fish/guestfish-actions.pod:3932
msgid "See also L</pread>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3891
+#: ../fish/guestfish-actions.pod:3937
msgid "pvcreate"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3893
+#: ../fish/guestfish-actions.pod:3939
#, no-wrap
msgid ""
" pvcreate device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:6071
+#: ../fish/guestfish-actions.pod:3941 ../src/guestfs-actions.pod:6118
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
-#: ../fish/guestfish-actions.pod:3899
+#: ../fish/guestfish-actions.pod:3945
msgid "pvremove"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3901
+#: ../fish/guestfish-actions.pod:3947
#, no-wrap
msgid ""
" pvremove device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3903 ../src/guestfs-actions.pod:6085
+#: ../fish/guestfish-actions.pod:3949 ../src/guestfs-actions.pod:6132
msgid ""
"This wipes a physical volume C<device> so that LVM will no longer recognise "
"it."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3906 ../src/guestfs-actions.pod:6088
+#: ../fish/guestfish-actions.pod:3952 ../src/guestfs-actions.pod:6135
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 "
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3910
+#: ../fish/guestfish-actions.pod:3956
msgid "pvresize"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3912
+#: ../fish/guestfish-actions.pod:3958
#, no-wrap
msgid ""
" pvresize device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3914 ../src/guestfs-actions.pod:6102
+#: ../fish/guestfish-actions.pod:3960 ../src/guestfs-actions.pod:6149
msgid ""
"This resizes (expands or shrinks) an existing LVM physical volume to match "
"the new size of the underlying device."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3917
+#: ../fish/guestfish-actions.pod:3963
msgid "pvresize-size"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3919
+#: ../fish/guestfish-actions.pod:3965
#, no-wrap
msgid ""
" pvresize-size device size\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3921
+#: ../fish/guestfish-actions.pod:3967
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:3924
+#: ../fish/guestfish-actions.pod:3970
msgid "pvs"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3926
+#: ../fish/guestfish-actions.pod:3972
#, no-wrap
msgid ""
" pvs\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3928 ../src/guestfs-actions.pod:6128
+#: ../fish/guestfish-actions.pod:3974 ../src/guestfs-actions.pod:6175
msgid ""
"List all the physical volumes detected. This is the equivalent of the L<pvs"
"(8)> command."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3931 ../src/guestfs-actions.pod:6131
+#: ../fish/guestfish-actions.pod:3977 ../src/guestfs-actions.pod:6178
msgid ""
"This returns a list of just the device names that contain PVs (eg. C</dev/"
"sda2>)."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3934
+#: ../fish/guestfish-actions.pod:3980
msgid "See also L</pvs-full>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3936
+#: ../fish/guestfish-actions.pod:3982
msgid "pvs-full"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3938
+#: ../fish/guestfish-actions.pod:3984
#, no-wrap
msgid ""
" pvs-full\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3940 ../src/guestfs-actions.pod:6147
+#: ../fish/guestfish-actions.pod:3986 ../src/guestfs-actions.pod:6194
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: =head2
-#: ../fish/guestfish-actions.pod:3943
+#: ../fish/guestfish-actions.pod:3989
msgid "pvuuid"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3945
+#: ../fish/guestfish-actions.pod:3991
#, no-wrap
msgid ""
" pvuuid device\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3947 ../src/guestfs-actions.pod:6162
+#: ../fish/guestfish-actions.pod:3993 ../src/guestfs-actions.pod:6209
msgid "This command returns the UUID of the LVM PV C<device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3949
+#: ../fish/guestfish-actions.pod:3995
msgid "pwrite"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3951
+#: ../fish/guestfish-actions.pod:3997
#, no-wrap
msgid ""
" pwrite path content offset\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:6178
+#: ../fish/guestfish-actions.pod:3999 ../src/guestfs-actions.pod:6225
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
-#: ../fish/guestfish-actions.pod:3956 ../src/guestfs-actions.pod:6181
+#: ../fish/guestfish-actions.pod:4002 ../src/guestfs-actions.pod:6228
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3962
+#: ../fish/guestfish-actions.pod:4008
msgid "See also L</pread>, L</pwrite-device>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3967
+#: ../fish/guestfish-actions.pod:4013
msgid "pwrite-device"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3969
+#: ../fish/guestfish-actions.pod:4015
#, no-wrap
msgid ""
" pwrite-device device content offset\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3971 ../src/guestfs-actions.pod:6205
+#: ../fish/guestfish-actions.pod:4017 ../src/guestfs-actions.pod:6252
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
-#: ../fish/guestfish-actions.pod:3974 ../src/guestfs-actions.pod:6208
+#: ../fish/guestfish-actions.pod:4020 ../src/guestfs-actions.pod:6255
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 "
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3979
+#: ../fish/guestfish-actions.pod:4025
msgid "See also L</pwrite>."
msgstr ""
#. type: =head2
-#: ../fish/guestfish-actions.pod:3984
+#: ../fish/guestfish-actions.pod:4030
msgid "read-file"
msgstr ""
#. type: verbatim
-#: ../fish/guestfish-actions.pod:3986
+#: ../fish/guestfish-actions.pod:4032
#, no-wrap
msgid ""
" read-file path\n"
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3988 ../src/guestfs-actions.pod:6229
+#: ../fish/guestfish-actions.pod:4034 ../src/guestfs-actions.pod:6276
msgid "This calls returns the contents of the file C<path> as a buffer."
msgstr ""
#. type: textblock
-#: ../fish/guestfish-actions.pod:3991
+#: ../fish/guestfish-actions.pod:4037
msgid ""
"Unlike L</cat>, this function can correctly handle files that contain "
"embedded ASCII NUL characters. However unlike L</download>, this function "
git.annexia.org / libguestfs.git / commitdiff